Lazy Person Elf API

http://www.lrappsoft.com/lrword/api/
Admin
Lazy Person Elf is an automation scripting platform that provides comprehensive APIs for Android and...
Tokens:205,434
Snippets:1,082
Trust Score:2.1
Update:8 months ago
Show doc for...
Tokens:
Raw
### Get Installed App Info (Lua)

Retrieves detailed information about all installed applications on the device as a JSON string. Returns nil if the operation fails.

```lua
local json = getInsallAppInfos()
if json ~= nil then print(json) end
```

--------------------------------

### 获取字典值 (QDictionary.get)

使用QDictionary:get(key)函数根据键名从字典中检索值。该函数能够自动识别并返回存储的数据类型。如果键不存在，则返回nil。示例演示了如何获取不同类型的值。

```lua
local dict = QDictionary.open("data_dict")

-- 存储测试数据
dict:put("product", "手机")
dict:put("quantity", 5)
dict:put("price", 2999.99)
dict:put("available", true)

-- 获取值（自动识别类型）
local product = dict:get("product")
local quantity = dict:get("quantity")
local price = dict:get("price")
local available = dict:get("available")
local notExist = dict:get("not_exist_key")

print("产品:", product, type(product))
print("数量:", quantity, type(quantity))
print("价格:", price, type(price))
print("可用:", available, type(available))
print("不存在的键:", notExist)
```

--------------------------------

### Install APK (Lua)

Installs an APK file on the device given its absolute path. This function does not return any value.

```lua
installApk("/mnt/sdcard/test.apk")
```

--------------------------------

### QDictionary Comprehensive Example

Demonstrates the comprehensive application of QDictionary for configuration management, including initialization, reading, updating, validation, and backup.

```APIDOC
## POST /websites/lrappsoft_lrword_api/QDictionary/comprehensive_example

### Description
This endpoint provides a comprehensive example of using QDictionary for application configuration management. It covers initializing default configurations, reading settings, updating values, validating and repairing configurations, and performing backups.

### Method
POST

### Endpoint
`/websites/lrappsoft_lrword_api/QDictionary/comprehensive_example`

### Response
#### Success Response (200)
- **message** (string) - A message indicating the status of the configuration management operations.
```

--------------------------------

### Get Product Name (Lua)

Fetches the product name of the device. The product name is returned as a string.

```lua
print(getProduct())
```

--------------------------------

### Start a Thread (`beginThread`) - Lua

Starts a new thread to execute a callback function. It accepts a callback function and a variable number of arguments to pass to the callback. The function returns a thread object. Note that the number of concurrently running threads cannot exceed 10.

```lua
local var = {
	exit = true,
	data = 0,
}

function thread_func(arg)
	while var.exit do
		print("我是子线程:"..arg.." 共享数据:"..var.data)
		sleep(100)
	end
end

for i=1,1 do --同时可运行线程数不能超过10个
	beginThread(thread_func,i)
end

for i=1,10 do
	local tick = 10 - i
	var.data = tick
	print("倒计时"..tick.."秒后结束线程")
	sleep(1000)
end

var.exit = false
print("线程结束")
sleep(100000)
```

--------------------------------

### Start a New Thread (Thread.newThread)

Creates and starts a new thread with a specified callback function and arguments. This is an alternative method for thread creation. The thread can be controlled using its stopThread method.

```lua
function thread_func(arg)
    while var.exit do
        print("我是子线程")
        sleep(1000)
    end
end


local thread = Thread.newThread(thread_func,11)
sleep(3000)
thread:stopThread()
```

--------------------------------

### Get Build Fingerprint (Lua)

Retrieves the build fingerprint of the device's software. The fingerprint is returned as a string.

```lua
print(getFingerprint())
```

--------------------------------

### Get Bootloader Version (Lua)

Retrieves the version number of the device's bootloader. The version is returned as a string.

```lua
print(getBootLoader())
```

--------------------------------

### Comprehensive QDictionary Example

Demonstrates the complete configuration management workflow using QDictionary. This includes initializing default configurations, reading, updating, validating, and backing up configurations. It showcases various QDictionary methods like put, commit, size, getType, contains, and clear.

```lua
-- 综合示例：应用配置管理
local config = QDictionary.open("app_config")

-- 1. 初始化默认配置
if config:size() == 0 then
    print("初始化默认配置...")
    config:put("app_name", "我的应用")
    config:put("version", "1.0.0")
    config:put("max_users", 1000)
    config:put("default_theme", "dark")
    config:put("enable_logging", true)
    config:put("log_level", 2)
    config:put("timeout", 30.5)
    config:commit()
end

-- 2. 读取配置
print("=== 应用配置 ===")
print("应用名称:", config:getString("app_name"))
print("版本:", config:getString("version"))
print("最大用户数:", config:getInt("max_users"))
print("默认主题:", config:getString("default_theme"))
print("启用日志:", config:getBool("enable_logging"))
print("日志级别:", config:getInt("log_level"))
print("超时时间:", config:getDouble("timeout"))

-- 3. 更新配置
config:put("last_launch", os.date())
config:put("launch_count", (config:getInt("launch_count", 0) + 1))

-- 4. 配置验证和修复
if not config:contains("default_language") then
    config:put("default_language", "zh-CN")
    print("添加缺失的默认语言配置")
end

-- 5. 批量操作演示
print("\n=== 配置统计 ===")
print("配置项数量:", config:size())

-- 找出所有字符串类型的配置
local stringKeys = {}
local allKeys = {"app_name", "version", "default_theme", "default_language", "last_launch"}
for _, key in ipairs(allKeys) do
    if config:getType(key) == "string" then
        table.insert(stringKeys, key)
    end
end

print("字符串配置项:", table.concat(stringKeys, ", "))

-- 6. 保存配置
if config:commit() then
    print("配置保存成功")
else
    print("配置保存失败")
end

-- 7. 配置备份
local backupConfig = QDictionary.open("app_config_backup")
backupConfig:clear()

-- 复制所有配置
for _, key in ipairs(allKeys) do
    if config:contains(key) then
        local valueType = config:getType(key)
        if valueType == "string" then
            backupConfig:put(key, config:getString(key))
        elseif valueType == "int" then
            backupConfig:put(key, config:getInt(key))
        elseif valueType == "double" then
            backupConfig:put(key, config:getDouble(key))
        elseif valueType == "bool" then
            backupConfig:put(key, config:getBool(key))
        end
    end
end

backupConfig:commit()
print("配置备份完成，备份项数量:", backupConfig:size())
```

--------------------------------

### Match Package Name Starting With String in Lua

Selects nodes where the 'packageName' attribute starts with a specified string. This is useful for targeting applications from a specific developer or group. The example finds TextViews in packages starting with 'com.nx'.

```lua
local sel = packageNameStartsWith("com.nx"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end
```

--------------------------------

### Match Class Name Starting With String in Lua

Selects nodes where the 'className' attribute starts with a specified string. This is helpful for matching components within a certain hierarchy or library. The example finds class names starting with 'android.widget'.

```lua
local sel = classNameStartsWith("android.widget")
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end
```

--------------------------------

### Create and Execute UI Command Queue (Lua)

Demonstrates how to create a UI command queue using ui.beginUiQueue, add various UI elements like layouts, edit texts, buttons, and checkboxes, and then execute the queue with ui.endUiQueue. It also shows loading a profile after the UI operations.

```lua
function onClick()
	print(ui.getValue("ckId1"))
	ui.saveProfile("/sdcard/test.txt")
end
ui.beginUiQueue()
ui.newLayout("layout1")
ui.addEditText("layout1","editId1","中国牛逼")
ui.newRow("layout1","row1")
ui.addButton("layout1","btn1","点击我", 250, 50)
ui.newRow("layout1","row2")
ui.addButton("layout1","btn2","测试按钮2", 250, 50)
ui.newRow("layout1","row2")
ui.addButton("layout1","btn3","测试按钮3", 250, 50)
ui.newRow("layout1","row3")
ui.addButton("layout1","btn4","测试按钮4", 250, 50)
ui.newRow("layout1","row4")
ui.addButton("layout1","btn5","测试按钮5", 250, 50)
ui.newRow("layout1","row5")
ui.addButton("layout1","btn6","测试按钮6", 250, 50)
ui.newRow("layout1","row6")
ui.addButton("layout1","btn7","测试按钮7", 250, 50)
ui.newRow("layout1","row7")
ui.addCheckBox("layout1","ckId1","选项1")
ui.setOnClick("btn1","onClick()")
ui.show("layout1")
ui.endUiQueue()
sleep(1000)
ui.loadProfile("/sdcard/test.txt")

sleep(100000)
```

--------------------------------

### Get Drawing Order (node:drawingOrder) - Lua

Retrieves the drawing order index of the current node. This indicates the order in which the node is rendered. The example shows how to get and print this index for a TextView node.

```lua
local sel = className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:drawingOrder())
end
```

--------------------------------

### Create Directory (mkdir)

Creates a new directory at the specified absolute path. Returns a boolean indicating success or failure.

```lua
local path = "/mnt/sdcard/lr"
print(mkdir(path))
sleep(100000)
```

--------------------------------

### Get Node Depth (node:depth) - Lua

Retrieves the depth index of the current node within the hierarchy. This indicates how deep the node is nested. The example demonstrates getting and printing the depth for a TextView node.

```lua
local sel = className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:depth())
end
```

--------------------------------

### Get Parent Node (node:parent) - Lua

Retrieves the parent node of the current node. This function is useful for navigating up the node hierarchy. The example demonstrates printing the bounds of the parent node.

```lua
local sel=index(1):text("192.168.1.3"):desc("")
local node = sel:findOne(10000)
if node~= nil then
	local p = node:parent()
	print(p:bounds())
end
```

--------------------------------

### 打开或创建字典 (QDictionary.open)

使用QDictionary.open(name)函数打开或创建一个用于存储键值对的字典。该函数接收字典名称作为参数，成功时返回QDictionary对象，失败时返回nil。示例展示了如何打开字典并存储、读取不同类型的数据。

```lua
-- 示例1: 打开一个字典
local dict = QDictionary.open("user_settings")
if dict then
    print("字典打开成功")
else
    print("字典打开失败")
end

-- 示例2: 存储和读取数据
local appConfig = QDictionary.open("app_config")

-- 存储不同类型的数据
appConfig:put("username", "张三")
appConfig:put("age", 25)
appConfig:put("score", 95.5)
appConfig:put("is_vip", true)

-- 读取数据
local name = appConfig:getString("username")
local age = appConfig:getInt("age")
local score = appConfig:getDouble("score")
local isVip = appConfig:getBool("is_vip")

print("用户名:", name)
print("年龄:", age)
print("分数:", score)
print("VIP:", isVip)

-- 保存到文件
appConfig:commit()
```

--------------------------------

### Create IMGUI Window

Creates an IMGUI window with a specified title, position, size, and close button visibility.

```APIDOC
## imgui.createWindow(title, x, y, width, height, showclose)

### Description
Creates an IMGUI window with specified properties.

### Method
POST

### Endpoint
/imgui/createWindow

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **title** (string) - Required - The title of the window.
- **x** (number) - Required - The X coordinate of the window's top-left corner relative to the screen.
- **y** (number) - Required - The Y coordinate of the window's top-left corner relative to the screen.
- **width** (number) - Required - The width of the window.
- **height** (number) - Required - The height of the window.
- **showclose** (boolean) - Required - Whether to display the close button.

### Request Example
```json
{
  "method": "imgui.createWindow",
  "params": {
    "title": "My Window",
    "x": 100,
    "y": 100,
    "width": 400,
    "height": 300,
    "showclose": true
  }
}
```

### Response
#### Success Response (200)
- **window_handle** (string) - The handle of the created window.

#### Response Example
```json
{
  "window_handle": "window_123"
}
```
```

--------------------------------

### Match Class Name with Regex in Lua

Selects nodes where the 'className' attribute matches a given regular expression. This offers the most flexibility for matching class names. The example uses a regex to find class names starting with 'android' and ending with 'TextView'.

```lua
local sel = classNameMatches("^android.*TextView$")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end
```

--------------------------------

### Get Specific Table View Row Data with Lua

Fetches data for a specific row from a table view, identified by its name and row index. The data is returned as a JSON formatted string, which can be decoded into a Lua table. Row indexing starts at 0. Invalid row indices will result in a nil return value.

```lua
-- 创建简单表格
ui.newLayout("layout1")
local headers = {"ID", "名称", "年龄"}
local data = {
    {"1", "李明", "25"},
    {"2", "萧红", "30"},
    {"3", "小咪", "28"}
}
ui.addTableView("layout1", "tableview", headers, data, 600, 400)
ui.newRow("layout1","row1")
-- 添加按钮获取第二行数据
ui.addButton("layout1", "btnGetRow", "获取第二行数据")
ui.setOnClick("btnGetRow", [[
    -- 行索引从0开始，所以第二行索引为1
    local jsonData = ui.getTableViewRowData("tableview", 1)
    if jsonData then
        local rowData = jsonLib.decode(jsonData)
        toast("第二行数据: " .. table.concat(rowData, ", "), 0, 0, 20)
        print("行数据:", rowData[1], rowData[2], rowData[3])
    else
        toast("获取行数据失败", 0, 0, 20)
    end
]])

ui.show("layout1")
sleep(10000000)
```

--------------------------------

### Show IMGUI Window

Creates and displays an independent IMGUI window with various configuration options for its appearance and position.

```APIDOC
## imgui.showWindow(config)

### Description
Creates and displays an independent IMGUI window with customizable properties.

### Method
POST

### Endpoint
/imgui/showWindow

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **config** (table) - Required - Configuration table for the window. Includes fields like x, y, width, height, title, colors, and button visibility.
  - **x** (number) - Optional - Window X coordinate. Defaults to 0.
  - **y** (number) - Optional - Window Y coordinate. Defaults to 0.
  - **width** (number) - Optional - Window width. Defaults to 600.
  - **height** (number) - Optional - Window height. Defaults to 600.
  - **hastitle** (boolean) - Optional - Whether to display the title bar. Defaults to true.
  - **title** (string) - Optional - Window title text. Defaults to "".
  - **titlecolor** (number) - Optional - Title text color (ARGB format). Defaults to 0xFFFFFFFF.
  - **titlebgcolor** (number) - Optional - Title bar background color (ARGB format). Defaults to 0xFF87CEFA.
  - **hasclose** (boolean) - Optional - Whether to display the close button. Defaults to true.
  - **closecolor** (number) - Optional - Close button color (ARGB format). Defaults to 0xFFFFFFFF.
  - **hasresize** (boolean) - Optional - Whether to display the resize button. Defaults to true.
  - **resizecolor** (number) - Optional - Resize button color (ARGB format). Defaults to 0xFFFFFFFF.
  - **hastoggle** (boolean) - Optional - Whether to display the toggle (collapse) button. Defaults to true.
  - **togglecolor** (number) - Optional - Toggle button color (ARGB format). Defaults to 0xFFFFFFFF.
  - **fontsize** (number) - Optional - Title font size. Defaults to 100.

### Request Example
```json
{
  "method": "imgui.showWindow",
  "params": {
    "config": {
      "title": "My Custom Window",
      "width": 800,
      "height": 500,
      "hasclose": false
    }
  }
}
```

### Response
#### Success Response (200)
- **success** (boolean) - True if the window was created successfully, false otherwise.

#### Response Example
```json
{
  "success": true
}
```

### Notes
- This method differs from `imgui.show`; `imgui.show` uses the entire screen as a canvas, while `imgui.showWindow` creates a smaller window as a canvas for rendering IMGUI content.
- By default, the first IMGUI window created will fill the size of the window created by this function.
```

--------------------------------

### imgui.createButton

Creates a button with specified position, size, and text. Returns a handle to the created button.

```APIDOC
## imgui.createButton(x, y, width, height, text)

### Description
Creates a button with specified position, size, and text. Returns a handle to the created button.

### Method
N/A (Function Call)

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local buttonHandle = imgui.createButton(50, 50, 100, 30, "Click Me")
```

### Response
#### Success Response (200)
- **Return Value** (integer) - The handle of the newly created button.

#### Response Example
```lua
-- Returns an integer handle, e.g., 67890
```

### Notes
- Buttons inherit the parent container's layout direction (vertical/horizontal).
- If width/height is 0, size is calculated based on text content.
- If width/height is -1, the button fills the available parent space.
- A valid parent container must be created first.
- Button click events must be set using the `setOnClick` callback.
```

--------------------------------

### 执行异步 HTTP GET 请求 (Lua)

使用 asynHttpGet 函数执行异步 HTTP GET 请求。该函数需要一个回调函数、URL、可选的超时时间和请求头。回调函数在服务器响应时被调用，并接收响应内容和状态码。

```lua
function callback(response, code)
    print(response)
end
asynHttpGet(callback, "http://www.baidu.com")
while true do
    sleep(1000)
end
```

--------------------------------

### HTTP GET Request

Performs an HTTP GET request to the specified URL. Supports optional timeout and headers.

```APIDOC
## HTTP GET Request

### Description
Performs an HTTP GET request to the specified URL. Supports optional timeout and headers.

### Method
GET

### Endpoint
`httpGet(url, [timeout], [header])`

### Parameters
#### Path Parameters
- **url** (string) - Required - The network address for the GET request, can include parameters.
- **timeout** (number) - Optional - The request timeout in seconds. Defaults to 30 seconds.
- **header** (table) - Optional - HTTP request headers. Defaults to empty.

### Request Example
```lua
local ret, code = httpGet("http://www.baidu.com")
print(ret)
```

### Response
#### Success Response
- **ret** (string) - The response body from the server.
- **code** (number) - The HTTP status code.
```

--------------------------------

### 执行 HTTP GET 请求 (Lua)

使用 httpGet 函数执行 HTTP GET 请求。该函数接受 URL、可选的超时时间和请求头。它返回服务器的响应内容和状态码。默认超时时间为 30 秒。

```lua
local ret, code = httpGet("http://www.baidu.com")
print(ret)
```

--------------------------------

### Create Web View Control (ui.addWebView)

Creates a web view control within a specified layout, loading a given URL. Requires layout name, identifier, and URL. Additional parameters for dimensions can be provided. Returns a boolean indicating success or failure.

```lua
ui.newLayout("layout1")
ui.addWebView("layout1","webId","www.baidu.com",500,500)
ui.show("layout1")
sleep(100000)
```

--------------------------------

### Create directory (mkdir)

Creates a new directory at the specified path.

```APIDOC
## mkdir

### Description
Creates a new directory at the specified path.

### Method
`mkdir(dir)`

### Parameters
#### Path Parameters
- **dir** (string) - Required - The absolute path of the directory to create.

### Return Value
- **boolean** - `true` if the directory was created successfully, `false` otherwise.

### Request Example
```lua
local path = getWorkPath().."/mydir"
print(mkdir(path))
```

### Response
#### Success Response
- **success** (boolean) - `true` if the directory was created successfully.

#### Response Example
```lua
-- true
```
```

--------------------------------

### HTTP GET Request

This endpoint performs an HTTP GET request to a specified URL with optional parameters and timeout using LuaEngine.httpGet.

```APIDOC
## GET /api/httpGet

### Description
Performs an HTTP GET request to a specified URL.

### Method
GET

### Endpoint
/api/httpGet

### Parameters
#### Query Parameters
- **url** (string) - Required - The URL to send the GET request to.
- **params** (table) - Required - A table of key-value pairs for request parameters.
- **timeout** (number) - Required - The timeout for the request in seconds.

### Request Example
```json
{
  "url": "https://www.baidu.com",
  "params": {},
  "timeout": 30
}
```

### Response
#### Success Response (200)
- **response** (string) - The response body from the HTTP GET request.

#### Response Example
```json
{
  "response": "<html>...</html>"
}
```
```

--------------------------------

### imgui.setOnClick

Sets a callback function to be executed when a button is clicked. Requires the button handle and the callback function.

```APIDOC
## imgui.setOnClick(buttonHandle, callback)

### Description
Sets a callback function to be executed when a button is clicked. Requires the button handle and the callback function.

### Method
N/A (Function Call)

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
imgui.setOnClick(myButtonHandle, function(handle)
  print("Button clicked!")
end)
```

### Response
#### Success Response (200)
- **Return Value** (nil) - No return value.

#### Response Example
N/A

### Notes
- Must be called after the button is successfully created.
- The callback function executes in the UI thread; avoid long-running operations.
- Setting a callback multiple times will overwrite the previous one.
- Use `imgui.post` for delayed UI modifications within the callback.
- Do not directly destroy the button itself within the callback.
```

--------------------------------

### Asynchronous HTTP GET Request

Performs an asynchronous HTTP GET request. A callback function is invoked upon receiving a response.

```APIDOC
## Asynchronous HTTP GET Request

### Description
Performs an asynchronous HTTP GET request. A callback function is invoked upon receiving a response.

### Method
GET (Asynchronous)

### Endpoint
`asynHttpGet(callback, url, [timeout], [header])`

### Parameters
#### Path Parameters
- **callback** (function) - Required - The function to be called when the server responds.
- **url** (string) - Required - The network address for the GET request, can include parameters.
- **timeout** (number) - Optional - The request timeout in seconds. Defaults to 30 seconds.
- **header** (table) - Optional - HTTP request headers. Defaults to empty.

### Request Example
```lua
function callback(response, code)
    print(response)
end
asynHttpGet(callback, "http://www.baidu.com")
while true do
    sleep(1000)
end
```

### Response
#### Success Response
The `callback` function will be invoked with:
- **response** (string) - The response body from the server.
- **code** (number) - The HTTP status code.
```

--------------------------------

### imgui.createTableView

Creates a table view with a specified parent, title, number of columns, and header visibility. Width and height can also be set.

```APIDOC
## imgui.createTableView(parent, title, columns, showheader, width, height)

### Description
Creates a table view with a specified parent, title, number of columns, and header visibility. Width and height can also be set.

### Method
N/A (This is a function call, not an HTTP request)

### Endpoint
N/A

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
* **parent** (string) - Required - The parent container handle (integer).
* **title** (string) - Required - The table title text (string).
* **columns** (number) - Required - The number of columns (integer).
* **showheader** (boolean) - Required - Whether to display the table header (boolean).
* **width** (number) - Optional - The table width (float). Use -1 for default size.
* **height** (number) - Optional - The table height (float). Use -1 for default size.

### Request Example
```lua
local tableViewHandle = imgui.createTableView(parentHandle, "Data Table", 3, true, 500, 400)
```

### Response
#### Success Response (N/A)
* **integer** - The control handle for the table view (on success).

#### Error Response (nil)
* **nil** - Failure (error information can be retrieved using imgui.getLastError()).
```

--------------------------------

### Connect to MySQL Database (connectSQL)

Establishes a connection to a MySQL database.

```APIDOC
## POST /websites/lrappsoft_lrword_api/connectSQL

### Description
Connects to a MySQL database.

### Method
POST

### Endpoint
/websites/lrappsoft_lrword_api/connectSQL

### Parameters
#### Request Body
- **host** (string) - Required - The MySQL server address.
- **port** (number) - Required - The MySQL server port number.
- **database** (string) - Required - The name of the database to access.
- **user** (string) - Optional - The username for accessing the database.
- **password** (string) - Optional - The password for accessing the database.
- **timeout** (number) - Required - The connection timeout in milliseconds.

### Request Example
```json
{
  "host": "192.168.1.24",
  "port": 3306,
  "database": "mydatabase",
  "user": "root",
  "password": "mtest@123",
  "timeout": 20000
}
```

### Response
#### Success Response (200)
- **handle** (object) - A connection handle object if successful, or null if connection failed.
- **error** (string) - An error message if the connection failed.

#### Response Example
```json
{
  "handle": {},
  "error": null
}
```
```

--------------------------------

### Match Node by Text Prefix (Lua)

Finds a UI node whose 'text' attribute starts with a given string. This is useful for matching elements with common starting phrases. It returns a selector object.

```lua
local sel = textStartsWith("懒人")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end
```

--------------------------------

### Create Directory with mkdir

The `mkdir` function creates a new directory at the specified absolute path. It returns `true` if the directory was created successfully and `false` if it failed. This is essential for organizing files and managing project structures.

```lua
local path = getWorkPath().."/mydir"
print(mkdir(path))
```

--------------------------------

### Get Last Inserted ID with SQlite3.last_insert_id

Retrieves the auto-incrementing ID of the last inserted row. This function is useful after performing an INSERT operation to get the unique identifier of the newly added record. It returns an integer representing the ID.

```lua
local db = SQlite3.open(getWorkPath() .. "/test.db")

-- 创建带自增主键的表
db:execute([[ 
    CREATE TABLE IF NOT EXISTS orders (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        product_name TEXT,
        quantity INTEGER,
        order_date DATETIME DEFAULT CURRENT_TIMESTAMP
    )
]])

-- 插入多条记录并获取ID
local products = {"iPhone", "iPad", "MacBook"}

for i, product in ipairs(products) do
    local sql = string.format("INSERT INTO orders (product_name, quantity) VALUES ('%s', %d)",
        product, i * 2)
    db:execute(sql)
    
    local lastId = db:last_insert_id()
    print("插入记录ID:", lastId, "产品:", product)
end

-- 批量插入并获取最后一个ID
db:execute("INSERT INTO orders (product_name, quantity) VALUES ('AirPods', 10)")
db:execute("INSERT INTO orders (product_name, quantity) VALUES ('Watch', 5)")

local finalId = db:last_insert_id()
print("最后插入的ID:", finalId)

-- 验证最后插入的记录
local lastRecord = db:query("SELECT * FROM orders WHERE id = " .. finalId)
print("最后插入的记录:", lastRecord)
```

--------------------------------

### Perform HTTP GET Request using LuaEngine.httpGet

This function performs an HTTP GET request to a specified URL. It accepts parameters as a key-value table and a timeout value in seconds. The function returns the response from the server.

```lua
import('java.lang.*')
import('java.util.*')
import('com.nx.assist.lua.LuaEngine')
local headers = {}
headers["User-Agent"] = "Mozilla/5.0 (Windows; U; Windows NT 5.1; zh-CN; rv:1.9.0.3) Gecko/2008092417 Firefox/3.0.3"

local getRet = LuaEngine.httpGet("https://www.baidu.com", headers, 30)
print(getRet)
```

--------------------------------

### Open or Create SQLite Database with SQlite3.open

Opens an existing SQLite database file or creates a new one if it doesn't exist. It returns a SQlite3 object upon success or nil and an error message upon failure. This function is the entry point for all SQLite database operations.

```lua
-- 示例1: 打开或创建数据库
local dbPath = getWorkPath() .. "/test.db"
local db, err = SQlite3.open(dbPath)

if db then
    print("数据库打开成功:", dbPath)
else
    print("数据库打开失败:", err)
end

-- 示例2: 创建表
if db then
    local sql = [[
        CREATE TABLE IF NOT EXISTS users (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            name TEXT NOT NULL,
            age INTEGER,
            email TEXT UNIQUE,
            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
        )
    ]]
    
    local success = db:execute(sql)
    if success then
        print("用户表创建成功")
    else
        print("用户表创建失败")
    end
end
```

--------------------------------

### Get All Control Values using ui.getData (Lua)

Fetches the values of all controls on the current interface as a table. This is a convenient way to get a snapshot of the entire UI's state. The returned table uses control names as keys.

```lua
function onClick()
	local ret = ui.getData()
	print(ret.ckId1)
end

ui.newLayout("layout1")
ui.addButton("layout1","btn1","点击我", 250, 50)
ui.addCheckBox("layout1","ckId1","选项1")
ui.setOnClick("btn1","onClick()")
ui.show("layout1")
sleep(100000)
```

--------------------------------

### 获取 CPU 架构 (Lua)

获取设备的 CPU 架构，返回一个整数表示架构类型（0=x86，1=arm，2=arm64）。此函数无需参数。

```lua
local t = getCpuArch()
if t == 0 then
  print("x86")
elseif t == 1 then
  print("arm")
elseif t == 2 then
  print("arm64")
end
```

--------------------------------

### Get UI Enable State (getUIEnable) - Lua

Gets the enabled status of a UI control. It takes the window handle, page index, and control ID as input. The function returns a boolean indicating whether the control is currently enabled or disabled.

```lua
function onUIEvent(handle, event, arg1, arg2, arg3) 
    if event == "onclick" then
        setUIEnable(handle, arg1, arg2, false)
        local enable = getUIEnable(handle, arg1, arg2)
        if enable then
            print("控件:" .. arg2 .. "可用")
        else
            print("控件:" .. arg2 .. "被禁用")
        end
    elseif event == "onclose" then
        print("关闭窗口", arg1)
        closeWindow(handle, arg1)
        if arg1 == false then
            exitScript()
        end
    end
end

showUI("uidemo.ui", -1, -1, onUIEvent)
```

--------------------------------

### 创建下拉框 (ui.addSpinner)

ui.addSpinner 函数用于在指定的布局中创建一个下拉框控件。它接受布局名称、控件名称、选项列表以及默认选中的索引作为必需参数。成功返回 true，失败返回 false。

```lua
ui.newLayout("layout1")
ui.addSpinner("layout1","spinId1",{"选项1", "选项2", "选项3"},0)
ui.show("layout1")
sleep(100000)
```

--------------------------------

### Start a New Thread (beginThread)

Initiates a new thread to execute a callback function. It supports variable arguments and has a concurrency limit of 10 threads. Note that new threads cannot use exitScript or restartScript directly but can communicate with the main thread for such actions.

```lua
local var = {
    exit = true,
    data = 0,
}

function thread_func(arg)
    while var.exit do
        print("我是子线程:"..arg.." 共享数据:"..var.data)
        sleep(100)
    end
end


for i=1,5 do --同时可运行线程数不能超过10个
    beginThread(thread_func,i)
end


for i=1,10 do
    local tick = 10 - i
    var.data = tick
    toast("倒计时【"..tick.."】秒后结束线程",0,0,20)
    sleep(1000)
end


var.exit = false
tOast("线程结束",0,0,20)
sleep(100000)
```

--------------------------------

### Path.setStartTime

Sets the start time for a swipe gesture.

```APIDOC
## POST /websites/lrappsoft_lrword_api/Path/setStartTime

### Description
Sets the start time for a swipe gesture, indicating when the swipe should begin after an event trigger.

### Method
POST

### Endpoint
/websites/lrappsoft_lrword_api/Path/setStartTime

### Parameters
#### Request Body
- **path_id** (string) - Required - Identifier for the Path object.
- **time** (integer) - Required - The delay in milliseconds from the event trigger before the swipe begins.

### Request Example
```json
{
  "path_id": "unique_path_identifier",
  "time": 100
}
```

### Response
#### Success Response (200)
No specific return value mentioned, implies success if no error.

#### Response Example
```json
{
  "message": "Start time set successfully."
}
```
```

--------------------------------

### Display UI Framework

Displays the IMGUI UI framework. Can be configured for touch interaction, custom fonts, and font sizes.

```APIDOC
## imgui.show([touchable], [font], [fontsize])

### Description
Displays the IMGUI UI framework with optional touch interaction, font, and font size.

### Method
POST

### Endpoint
/imgui/show

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **touchable** (boolean) - Optional - Whether to allow touch interaction. Defaults to true.
- **font** (string) - Optional - Path to the font file. Defaults to the system default font.
- **fontsize** (number) - Optional - Font size. Defaults to 45.0.

### Request Example
```json
{
  "method": "imgui.show",
  "params": {
    "touchable": true,
    "font": "/path/to/font.ttf",
    "fontsize": 50.0
  }
}
```

### Response
#### Success Response (200)
- **success** (boolean) - True if the UI was displayed successfully, false otherwise.

#### Response Example
```json
{
  "success": true
}
```

### Notes
- Parameter order does not affect function calls; the function automatically matches parameters by type.
- If the specified font file does not exist, the default font will be used.
- Duplicate parameter types will cause an error (e.g., passing two number arguments).
- If `touchable` is true, the function will not return until the IMGUI framework is closed.
```

--------------------------------

### Get Android Context (LuaEngine.getContext)

Retrieves the Android context object.

```APIDOC
## GET /websites/lrappsoft_lrword_api/getContext

### Description
Gets the Android application context.

### Method
GET

### Endpoint
/websites/lrappsoft_lrword_api/getContext

### Parameters
None

### Request Example
```json
{}
```

### Response
#### Success Response (200)
- **context** (object) - The Android context object.

#### Response Example
```json
{
  "context": {
    "getPackageName": "function"
  }
}
```
```

--------------------------------

### ui.show - Display a layout

Displays a previously created layout on the screen. This function makes the specified layout visible to the user.

```APIDOC
## POST /ui/show

### Description
Displays a previously created layout on the screen. This function makes the specified layout visible to the user.

### Method
POST

### Endpoint
/ui/show

### Parameters
#### Query Parameters
- **name** (string) - Required - The name of the layout to display.

### Request Example
```json
{
  "name": "layout1"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - True if the layout was displayed successfully, false otherwise.

#### Response Example
```json
{
  "success": true
}
```
```

--------------------------------

### Set Text Selection Range (Lua)

The `node:setSelection(start, end)` function allows you to define the start and end indices for selected text within a text input field or editable text area. It returns a boolean indicating if the selection was set successfully. The indices are zero-based.

```lua
local sel = className("android.widget.EditText")
local node = sel:findOne(10000)
if node~= nil then
	print(node:setSelection(1,3))
end
```

--------------------------------

### Find All Matching Nodes (nodeLib.findAll)

Finds and returns all UI nodes that match the provided selector. Supports fuzzy matching using regular expressions for more flexible searching.

```lua
local ret = nodeLib.findAll({class="android.widget.TextView",id="",package="com.nx.nxproj",text="名称: tmp.lr"},false)
if ret ~= nil then
    print(ret)
end
```

--------------------------------

### Get Screen Rotation

Retrieves the current screen rotation direction (0/1/2/3).

```APIDOC
## GET /getDisplayRotate

### Description
Retrieves the current screen rotation direction (0/1/2/3).

### Method
GET

### Endpoint
/getDisplayRotate

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **rotation** (integer) - The screen rotation value (0, 1, 2, or 3).

#### Response Example
```json
{
  "rotation": 0
}
```
```

--------------------------------

### Get Screen Resolution

Retrieves the screen resolution, returning the width and height.

```APIDOC
## GET /getDisplaySize

### Description
Retrieves the screen resolution, returning the width and height.

### Method
GET

### Endpoint
/getDisplaySize

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **width** (integer) - The screen width.
- **height** (integer) - The screen height.

#### Response Example
```json
{
  "width": 1080,
  "height": 1920
}
```
```

--------------------------------

### imgui.createSwitch

Creates a switch control (toggle) with a label and an optional initial state and height.

```APIDOC
## imgui.createSwitch(parent, label, checked, height)

### Description
Creates a switch control (toggle) with a label and an optional initial state and height.

### Method
N/A (Function Call)

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
```lua
local switchHandle = imgui.createSwitch(parentHandle, "Enable Notifications", false, 25)
```

### Response
#### Success Response (200)
- **Return Value** (integer) - The handle of the switch control (greater than 0).

#### Response Example
```lua
-- Returns an integer handle, e.g., 77889
```

### Notes
- `imgui.isSupport()` must be called first.
- If height is 0, the system DPI determines the size.
- Label text supports UTF-8 encoding.
- Switch colors can be customized using `imgui.setStyleColor`.
- Returns 0 on failure; use `imgui.getLastError()` for details.
```

--------------------------------

### IMGUI Support Check

Checks if the current environment supports IMGUI functionalities. It's recommended to call this before any other IMGUI functions.

```APIDOC
## imgui.isSupport()

### Description
Checks if the current environment supports IMGUI.

### Method
GET

### Endpoint
/imgui/isSupport

### Parameters
#### Path Parameters
None

#### Query Parameters
None

### Request Example
```json
{
  "method": "imgui.isSupport"
}
```

### Response
#### Success Response (200)
- **isSupported** (boolean) - True if IMGUI is supported, false otherwise.

#### Response Example
```json
{
  "isSupported": true
}
```

### Notes
- Call this before other imgui functions.
- Calling other imgui functions when this returns false may lead to undefined behavior.
- Typical unsupported scenarios include running on incompatible Android versions, missing OpenGL ES 3 support, or insufficient system memory.
```

--------------------------------

### node:depth - Get Depth Index

Retrieves the depth index of the current node.

```APIDOC
## node:depth Get Depth Index

### Description
Retrieves the depth index of the current node.

### Method
`node:depth()`

### Parameters
None

### Request Example
```lua
local sel = className("android.widget.TextView")
local node = sel:findOne(10000)
if node ~= nil then
    print(node:depth())
end
```

### Response
#### Success Response
- **Type**: any
- **Description**: The depth index of the current node.

#### Response Example
(Example output: `3`)
```
Tokens:
Raw