TrollAutoScript

https://docs.trollautoscript.com/docs/
Admin
TrollAutoScript is an automation testing framework for iOS and iPad devices with TrollStore, using...
Tokens:68,252
Snippets:484
Trust Score:4.9
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Registering notifications for view changes, system notifications, alerts, and app launch

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/registerSystemNotifiation

Shows four separate registrations in one example block: notification 1000 (view controller changed), 1008 (system notifications, printing extra info if present), 1006 (system or app alert, tapping the '无线局域网与蜂窝网络' button when the title matches '允许使用无线数据'), and 5000 (app launch event). Each callback receives id, node, and info; node may be nil, and info may be nil. The 1006 example uses node:match and node:matchText to locate and tap UI elements.

```lua
  
nodeView.registerSystemNotifiation(   --注册一个 视图控制器发生改变通知   
    1000,  
    function(id, node, info)  
        --当接收到通知时 打印出当前通知ID ,如果节点信息存在 就打印出 触发该通知的应用bundldeId 否则打印nil  
        print(id, node and node:bundleId() or nil)    
    end  
)  
  
  
nodeView.registerSystemNotifiation(  -- 注册一个 监听系统通知  
    1008,  
    function(id, node, info)  
        -- 当系统出现通知时, 会调用回调函数.    
        -- 回调函数中的 通知id: 当前注册监听的通知id, 节点对象: 触发该通知的节点对象 该值可能为nil,  信息: 触发该通知的额外信息 该值可能为nil  
        print(id, node and node:bundleId() or nil, info)  
        -- 如果是通知，info 信息中会携带 通知的消息内容  
        print(type(info) == "table" and info.data and info.data or "") --如果存在 data字段我们就打印出来  
    end  
)  
  
  
--以下是一个 处理系统弹窗的示例  
nodeView.registerSystemNotifiation( -- 注册一个监控 系统或app弹窗   
    1006,  
    function(id, node, info)  
        -- 当系统或APP 弹出窗口时, 调用回调函数.  
        local nodes = node:match(function (info)    --查找出弹窗的标题  
            if info.traits:find("alert") then  
                return true  
            end  
        end, false)  
        --获取弹窗的标题 如果存在的话.  
        local title = #nodes > 0 and nodes[1].text and  nodes[1].text or nil  
        -- 把无用的字符删除掉  
        if title then  
            title = title:gsub("“.-”" ,""):gsub("？" ,"")    
        end  
  
        if (title == "允许使用无线数据") then     --如果是网络授权弹窗  
            node:matchText("无线局域网与蜂窝网络",true)[1]:tap() --查找 "无线局域网与蜂窝网络" 按钮并点击它  
        end  
    end  
)  
  
-- 注册监听 app 启动事件  
nodeView.registerSystemNotifiation(  
    5000,  
    function (id, node, info)  
        print(info.displayName, "被启动" );  
    end  
)  
  
  
  
```

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

### Example Script: Draw Visible Nodes Using screenDraw

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/forVisible

This script retrieves visible node information with nodeView.forVisible(), decodes the JSON, and uses the screenDraw API to visualize each node. It stores draw views in a table to prevent garbage collection, recursively enumerates subviews, and then sleeps for 10 seconds before ending.

```lua
local drawViews = {}  -- 绘制对像存储 防止自动回收  
local enumerationInfo --屏幕绘制函数  
enumerationInfo = function (info)  
    local drawView = screenDraw.init(info.frame.x, info.frame.y, info.frame.width, info.frame.height, info.text and info.text or "")  
    table.insert(drawViews, drawView)             
    drawView:show()  
    if (type(info.subviews) == "table") then  
        for key, value in pairs(info.subviews) do  
            enumerationInfo(value)  
        end  
    end  
end  
  
local info = nodeView.forVisible()  --获取可见的节点信息  
  
for k,v in pairs(json.decode(info)) do   --使用屏幕绘制函数 绘制出来  
    enumerationInfo(v)  
end  
  
sys.msleep(10000) -- 延迟等待 10000毫秒后结束脚本  

```

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

### Example: unregister notification 1000

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/unregisterSystemNotification

Example call to unregister the notification for view controller changes (id 1000). Note the source uses registerSystemNotifiation in the example, but the function being documented is unregisterSystemNotifiation.

```plaintext
  
nodeView.registerSystemNotifiation(1000) -- 取消 视图控制器发生改变通知  
  
```

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

### screen.init(坐标系)

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.init

初始化取色或坐标系的方向。参数为整数型，0 表示 home 键在下，1 表示 home 键在右，2 表示 home 键在左。

```APIDOC
## screen.init(坐标系)

### Description
初始化取色或坐标系的方向。

### Method
Function Call

### Endpoint
screen.init(坐标系)

### Parameters
#### Function Parameters
- **坐标系** (整数型) - Required - 0 表示 home 键在下，1 表示 home 键在右，2 表示 home 键在左。

### Request Example
```
screen.init(0) -- 设置home键在下
screen.init(1) -- 设置home键在右
screen.init(2) -- 设置home键在左
```

### Response
#### Success Response
无返回值。
```

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

### screen.init 示例：设置 home 键方向

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.init

示例展示了 screen.init 的三种调用方式，分别设置 home 键在下、右、左。

```lua
screen.init(0) -- 设置home键在下  
screen.init(1) -- 设置home键在右  
screen.init(2) -- 设置home键在左  
```

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

### screen.unkeep usage example

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.unkeep

Example usage of screen.unkeep with a comment indicating it cancels screen hold and releases memory.

```plaintext
screen.unkeep()  -- 取消屏幕保持 释放内存  
```

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

### Lua 脚本代码 - 加载网页并设置消息回调

Source: https://docs.trollautoscript.com/docs/webView%E6%A8%A1%E5%9D%97/setMessageCallback

在脚本中加载网页，并设置接收消息的回调。使用 webView.init 创建视图，设置参数，然后调用 view:show() 和 view:setMessageCallback 接收消息，最后延迟 10 秒停止脚本。

```lua
local view =  
    webView.init {  
    x = 0, --屏幕横坐标  int  整数  必填  
    y = 0, -- 屏幕纵坐标 int  整数 必填  
    width = 1125, -- 宽度         int  整数 必填  
    height = 2436, --高度          int  整数 必填  
    html = [[<!DOCTYPE html>  
<html>  
<head>  
    <meta charset="utf-8">  
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">  
    <title>TAS WebView 交互测试</title>  
      
    <style>  
        body {  
            display: flex;  
            justify-content: center;  
            align-items: center;  
            height: 100vh;  
            margin: 0;  
            background-color: #f0f0f0;  
            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;  
        }  
        button {  
            padding: 15px 30px;  
            font-size: 18px;  
            color: white;  
            background-color: #007AFF; /* iOS 默认的蓝色 */  
            border: none;  
            border-radius: 10px; /* 圆角 */  
            box-shadow: 0 4px 6px rgba(0,0,0,0.1);  
        }  
        button:active {  
            background-color: #0056b3;  
        }  
    </style>  
</head>  
<body>  
    <button onclick="sendMessage()">点我发送消息给 TAS</button>  
  
    <script>  
        function sendMessage() {  
            // 向 TAS 脚本发送字符串消息  
            window.webkit.messageHandlers.tsBridge.postMessage("你好，我是来自网页的消息！");  
        }  
    </script>  
</body>  
</html>]], -- html   可选 和url 字段 必须存在一项  文本  
    alpha = 100, -- 透明度 可选 默认 0 -100  整数 默认100  
    -- rotate = 90,                       --向右旋转90度  可选   -90 为左旋转。 默认 0  
    radius = 5.0, -- 圆角 可选  
    hit = true, --是否可拖动  可选 默认 true  
    userInteractionEnabled = true --  是否可交互 为false 时  拖动失效 可选 默认 true  
}  
view:show()  
  
view:setMessageCallback(  
    function(message) --接收来自webView 的消息  
        print("收到网页消息: " .. message)  
    end  
)  
  
sys.msleep(10000) --延迟10秒 在停止脚本  
```

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

### screen.visionOcr

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.visionOcr

Documentation for the screen.visionOcr function, including parameters, return value, and usage examples.

```APIDOC
## screen.visionOcr

### Description
Performs OCR (Optical Character Recognition) on the screen within a specified rectangular region, returning recognized text along with its coordinates. Supports multiple languages.

### Method
Function call

### Endpoint
`screen.visionOcr([语言], [起始横坐标, 起始纵坐标, 结束横坐标, 结束纵坐标])`

### Parameters
- **语言** (文本型) - Optional - Recognition language code. Default is `zh-Hans`. Supported languages: `en-US`, `fr-FR`, `it-IT`, `de-DE`, `es-ES`, `pt-BR`, `zh-Hans`, `zh-Hant`, `yue-Hans`, `yue-Hant`, `ko-KR`, `ja-JP`, `ru-RU`, `uk-UA`. Note: availability may vary by iOS version.
- **起始横坐标** (整数型) - Optional - Starting X coordinate of the recognition region. Default is `0`.
- **起始纵坐标** (整数型) - Optional - Starting Y coordinate of the recognition region. Default is `0`.
- **结束横坐标** (整数型) - Optional - Ending X coordinate of the recognition region. Default is screen width.
- **结束纵坐标** (整数型) - Optional - Ending Y coordinate of the recognition region. Default is screen height.

### Return Value
- **识别结果** (数组型) - A text array containing recognized text and its coordinates.

### Example
```lua
-- Simple example
local result = screen.visionOcr()       -- Full-screen recognition, Chinese language
print("识别结果", result)

local result = screen.visionOcr(100,100,200,200)    -- Region recognition, Chinese language
print("识别结果", result)

local result = screen.visionOcr("ko-KR", 100,100,200,200)    -- Region recognition, Korean language
print("识别结果", result)

local result = screen.visionOcr("en-US", 100,100,200,200)    -- Region recognition, English language
print("识别结果", result)
```
```

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

### screen.init 函数签名

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.init

screen.init 函数接受一个整数参数，用于设置屏幕坐标系方向。

```lua
screen.init(坐标系)   
```

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

### screen.visionOcr usage examples with binarization

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.visionOcr

Lua examples for screen.visionOcr. Shows full-screen and region-based recognition with default Chinese, Korean (ko-KR), and English (en-US). Also demonstrates binarization with screen.image() and img:binarization("0x1D2746-0x505050") before calling visionOcr. The language list comment notes that different iOS versions may not support all languages.

```lua
 --简单的示例  
local result = screen.visionOcr()       --全屏识别 识别语言为中文  
print("识别结果" , result)  
  
local result = screen.visionOcr(100,100,200,200)    --范围识别 识别语言为中文  
print("识别结果",result)  
  
local result = screen.visionOcr("ko-KR", 100,100,200,200)    --范围识别 识别语言为韩文  
print("识别结果",result)  
  
  
local result = screen.visionOcr("en-US", 100,100,200,200)    --范围识别 识别语言为英文  
print("识别结果",result)  
  
--以下是支持的语言列表  不同的系统版本 可能还未支持  
-- en-US：美式英语  
-- fr-FR：法语  
-- it-IT：意大利语  
-- de-DE：德语  
-- es-ES：西班牙语  
-- pt-BR：葡萄牙语  
-- zh-Hans：简体中文  
-- zh-Hant：繁体中文  
-- yue-Hans：粤语简体  
-- yue-Hant：粤语繁体  
-- ko-KR：韩语  
-- ja-JP：日语  
-- ru-RU：俄语  
-- uk-UA：乌克兰语  
  
  
local img = screen.image()  --全屏二值化识别  
local newImg = img:binarization("0x1D2746-0x505050")    
local result = newImg:visionOcr()  
print("全屏二值化识别结果",result)  
  
local img = screen.image(100,100,200,200)  --范围二值化识别  
local newImg = img:binarization("0x1D2746-0x505050")    
local result = newImg:visionOcr()  
print("范围二值化识别结果",result)  
```

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

### Get current Wi-Fi SSID with device.currentSSID()

Source: https://docs.trollautoscript.com/docs/%E8%AE%BE%E5%A4%87%E6%A8%A1%E5%9D%97/currentSSID

Returns the SSID of the currently connected Wi-Fi network as a string. Use this function to retrieve the network name for display or logic.

```lua
device.currentSSID()  
```

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

### Load Dm OCR font from text

Source: https://docs.trollautoscript.com/docs/dm/loadFromText

Loads a Dm OCR font library from a text string using dmOcr.loadFromText. The example includes a complete font data string and a comment indicating the operation.

```lua
local dm = dmOcr.loadFromText([[  
0380380003803807038030070380700703807007FFFFFFFFFFFFFFFFFFFFFFFE0380C0000381C000038180000383800000000300000003800018038010380380381C03003C1E07001C0F07000E0787000703C700078187000300060000000E0000000E0000001F00FFFFFFFFFFFFFFFF00001E0000000C0000001C0000001C00$抖$0.0.324$32.32]])   --从文本加载大漠字库  
```

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

### Initialization

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/TomatoOCR

Initializes the TomatoOCR module and sets the license key.

```APIDOC
## init(path)

### Description
Initializes the TomatoOCR module with the required model resources.

### Method
N/A (Lua function)

### Parameters
- **path** (string) - Required - The directory path containing the OCR model resources.

### Request Example
```lua
tomatoOCR.init(path.."/res/")
```

### Response
No return value.

## setLicense(license, remark)

### Description
Validates and sets the license for the OCR module.

### Method
N/A (Lua function)

### Parameters
- **license** (string) - Required - The license key.
- **remark** (string) - Optional - Additional remarks.

### Request Example
```lua
local flag = tomatoOCR.setLicense(license, remark)
print(flag)
```

### Response
- **flag** (boolean) - Whether license was successfully set.
```

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

### nodeView.matchText example

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/matchText

Finds nodes containing the text "首页" on the page and prints the result. The function only works on native control text, may not find all matches, and does not support regular expressions.

```lua
local node = nodeView.matchText("首页") -- 查找包含 通用文本的节点  
print(node) --打印出来  
```

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

### screen.size()

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.size

screen.size() 函数用于获取当前设备屏幕的宽度和高度，返回两个整数，分别表示屏幕的宽度和高度。该函数不受初始化屏幕方向 (screen.init) 函数的影响。

```APIDOC
## screen.size()

### Description
获取当前设备屏幕的宽度和高度，不受初始化屏幕方向 (screen.init) 函数影响。

### Method
screen.size()

### Parameters
无参数。

### Return Value
- **屏幕宽度** (整数型) - 当前设备屏幕的宽度。
- **屏幕高度** (整数型) - 当前设备屏幕的高度。

### Example
```lua
local width, height = screen.size()
print(string.format("屏幕尺寸为:%d ,%d", width, height))
```
```

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

### nodeView.matchForMainWindow(匹配函数, 是否返回对象)

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/matchForMainWindow

根据节点信息筛选出符合条件的节点，只匹配 keyWindow 下的节点信息。匹配函数返回 true 时记录节点信息，否则不记录。此方法只能在 2.3.0 以上版本中使用。

```APIDOC
## nodeView.matchForMainWindow(匹配函数, 是否返回对象)

### Description
根据节点信息筛选出符合条件的节点，只匹配 keyWindow 下的节点信息。匹配函数返回 true 时记录节点信息，否则不记录。此方法只能在 2.3.0 以上版本中使用。

### Method
Function Call

### Endpoint
nodeView.matchForMainWindow(匹配函数, 是否返回对象)

### Parameters
#### Function Parameters
- **匹配函数** (function) - Required - 当前遍历的节点信息作为参数，返回 true 时记录节点信息。
- **是否返回对象** (boolean) - Optional - 默认 false。为 true 时返回节点对象数组，否则返回节点信息数组。

### Return Value
- **节点信息** (array) - 当第二个参数为 false 或省略时返回节点信息数组。
- **节点对象数组** (array) - 当第二个参数为 true 时返回节点对象数组。

### Example
```lua
local node = nodeView.matchForMainWindow(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点信息 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end )  
print(node)  
  
local node = nodeView.matchForMainWindow(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点对象数组 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end ,true)   --第二个参数为 true 时 返回 对象数组  
print(node[1]:info()) --打印出第一个节点信息  
```
```

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

### 调用 file.list 获取文件信息数组

Source: https://docs.trollautoscript.com/docs/%E6%96%87%E4%BB%B6%E6%A8%A1%E5%9D%97/%E9%81%8D%E5%8E%86%E6%96%87%E4%BB%B6%E5%A4%B9%2Bfile.list%2B%2B0dc6c432-4f13-4d92-b24b-5b48fc245aa4

调用此函数遍历指定文件夹下的所有文件信息，返回文件信息数组。该函数不会递归子文件夹。

```lua
文件信息数组 = file.list(文件夹路径)  
```

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

### key.down(按键码)

Source: https://docs.trollautoscript.com/docs/%E6%A8%A1%E6%8B%9F%E6%8C%89%E9%94%AE%E6%A8%A1%E5%9D%97/%E6%8C%89%E9%94%AE%E6%8C%89%E4%B8%8B%2Bkey.down%2B%2Be329b2ad-ec8a-4e6f-a374-50eb042e0e0e

模拟按下指定按键。该函数接受一个文本类型的按键码，用于触发键盘按键按下事件。示例中演示了按下 "a" 键，并配合 sys.msleep 和 key.up 完成完整的按键操作。

```APIDOC
## key.down(按键码)

### Description
模拟按下指定按键。该函数接受一个文本类型的按键码，用于触发键盘按键按下事件。

### Function Signature
key.down(按键码)

### Parameters
- **按键码** (文本型) - 必须 - 要按下的按键标识，例如 "a"。

### Example
key.down("a") --模拟按下a键  
sys.msleep(50)  
key.up("a")  --抬起按键

```

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

### 获取并绘制节点信息示例

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/viewInfo

示例展示了如何获取节点信息并递归绘制所有子节点。使用screenDraw.init绘制每个节点，然后递归遍历子节点，最后延迟10000毫秒结束脚本。

```lua
local drawViews = {}  -- 绘制对像存储 防止自动回收  
local enumerationInfo --屏幕绘制函数  
enumerationInfo = function (info)     
    local drawView = screenDraw.init(info.frame.x, info.frame.y, info.frame.width, info.frame.height, info.text and info.text or "")  
    table.insert(drawViews, drawView)  
    drawView:show()  
    if (type(info.subviews) == "table") then  
        for key, value in pairs(info.subviews) do  
            enumerationInfo(value)  
        end  
    end  
end  
  
local info = nodeView.info()        -- 获取节点信息  
enumerationInfo(json.decode(info)[1]) -- 绘制节点信息  
  
sys.msleep(10000) -- 延迟等待 10000毫秒后结束脚本  
  
```

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

### obj:match(匹配函数, [是否返回对象])

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/objMatch

根据匹配函数筛选所有 UIWindow 节点信息，返回匹配的节点信息数组和可选的节点对象数组。

```APIDOC
## obj:match(匹配函数, [是否返回对象])

### Description
根据匹配函数筛选所有 UIWindow 节点信息，返回匹配的节点信息数组和可选的节点对象数组。

### Method
Function

### Endpoint
obj:match(匹配函数, [是否返回对象])

### Parameters
#### Function Parameters
- **匹配函数** (function) - Required - 用于判断当前遍历的节点信息是否匹配，返回 true 时记录该节点信息。
- **是否返回对象** (boolean) - Optional - 默认 false，若为 true 则返回节点对象数组。

### Return Value
- **节点信息** (array) - 匹配的节点信息数组。
- **节点对象数组** (array) - 当是否返回对象为 true 时返回的节点对象数组。

### Notes
- 该函数匹配所有 UIWindow 节点信息。
- 匹配函数参数为当前遍历的节点信息。
- 此方法只能在 3.0.3 以上版本中使用。

### Example
参考 `nodeView.match()` 示例。
```

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

### 获取子节点示例：匹配节点并打印子节点信息

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/children

使用 matchForMainWindow 匹配节点信息（label==点赞，class==AWEFeedVideoButton），第二个参数为 true 时返回对象数组。然后通过 childrens() 获取子节点并打印第一个子节点的信息。

```lua
local node = nodeView.matchForMainWindow(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点对象数组 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end ,true)   --第二个参数为 true 时 返回 对象数组  
print(node[1]:childrens()[1]:info()) --打印出子节点中的 第一个节点信息  
```

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

### 示例：绘制 keyWindow 节点信息的 Lua 脚本

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/infoForMainWindow

用于获取 keyWindow 节点信息并递归绘制所有子视图。脚本使用 screenDraw 绘制每个节点的边框和文本，先获取 JSON 节点信息，解码后递归遍历 subviews，最后延迟 10000 毫秒结束。注意 drawViews 表用于防止绘制对象被自动回收，需要适时清理以避免内存泄漏。

```lua
local drawViews = {}  -- 绘制对像存储 防止自动回收  
local enumerationInfo --屏幕绘制函数  
enumerationInfo = function (info)     
    local drawView = screenDraw.init(info.frame.x, info.frame.y, info.frame.width, info.frame.height, info.text and info.text or "")  
    table.insert(drawViews, drawView)  
    drawView:show()  
    if (type(info.subviews) == "table") then  
        for key, value in pairs(info.subviews) do  
            enumerationInfo(value)  
        end  
    end  
end  
  
local info = nodeView.infoForMainWindow()        -- 获取 keyWindow 节点信息  
enumerationInfo(json.decode(info)[1]) -- 绘制节点信息  
  
sys.msleep(10000) -- 延迟等待 10000毫秒后结束脚本  
  
```

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

### nodeView.match(匹配函数, [是否返回对象])

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/match

根据匹配函数筛选所有UIWindow节点，返回节点信息数组或节点对象数组。匹配函数接收当前节点信息，返回 true 时记录该节点。可选参数控制是否返回节点对象。

```APIDOC
## nodeView.match(匹配函数, [是否返回对象])

### Description
根据匹配函数筛选所有UIWindow节点，返回节点信息数组或节点对象数组。匹配函数接收当前节点信息，返回 true 时记录该节点。可选参数控制是否返回节点对象。

### Method
函数调用

### Endpoint
nodeView.match(匹配函数, [是否返回对象])

### Parameters
- **匹配函数** (函数型) - 必填 - 接收当前遍历的节点信息，返回 true 时记录该节点。
- **是否返回对象** (布尔型) - 可选 - 默认 false，为 true 时返回节点对象数组。

### Return Value
- **节点信息** (数组型) - 匹配的节点信息数组。
- **节点对象数组** (数组型) - 当是否返回对象为 true 时，返回节点对象数组。

### Example
```lua
local node = nodeView.match(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点信息 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end )  
print(node)  
  
local node = nodeView.match(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点信息 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end ,true)  
print(node[1]:info())  
sys.msleep(1000)  
```

### Notes
- 该函数匹配所有UIWindow节点信息。
- 此方法只能在 2.3.0以上版本中使用。
```

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

### screenDraw.setHideWindowMode(是否隐藏)

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E7%BB%98%E5%88%B6%E6%A8%A1%E5%9D%97/setHideWindowMode

设置绘制隐藏模式，控制绘制窗口的可见性，不影响脚本的触摸和截图功能。

```APIDOC
## screenDraw.setHideWindowMode(是否隐藏)

### Description
设置绘制隐藏模式。该模式下绘制只有肉眼可见，不影响脚本的触摸和截图。

### Method
Function

### Signature
screenDraw.setHideWindowMode(是否隐藏)

### Parameters
- **是否隐藏** (布尔型) - 必填 - true 为隐藏，false 为显示

### Example
```lua
screenDraw.setHideWindowMode(true) --隐藏绘制
```
```

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

### logWindow.setHideWindowMode(true) 隐藏日志窗口示例

Source: https://docs.trollautoscript.com/docs/%E6%97%A5%E5%BF%97%E7%AA%97%E5%8F%A3%E6%A8%A1%E5%9D%97/setHideWindowMode

调用示例，隐藏日志窗口，不影响脚本的触摸找图找色。

```lua
logWindow.setHideWindowMode(true) --隐藏日志窗口  
```

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

### 遍历文件夹并打印文件信息

Source: https://docs.trollautoscript.com/docs/%E6%96%87%E4%BB%B6%E6%A8%A1%E5%9D%97/%E9%81%8D%E5%8E%86%E6%96%87%E4%BB%B6%E5%A4%B9%2Bfile.list%2B%2B0dc6c432-4f13-4d92-b24b-5b48fc245aa4

示例展示了如何使用 file.list 遍历指定文件夹下的所有文件，并通过 for 循环打印每个文件的信息。

```lua
local fileList = file.list("/var/mobile/Media")  
  
for k,v in pairs(fileList) do       --遍历文件  
    print(v)  
end  
```

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

### logWindow.setHideWindowMode(是否隐藏)

Source: https://docs.trollautoscript.com/docs/%E6%97%A5%E5%BF%97%E7%AA%97%E5%8F%A3%E6%A8%A1%E5%9D%97/setHideWindowMode

设置日志窗口隐藏模式的函数文档

```APIDOC
## logWindow.setHideWindowMode(是否隐藏)

### Description
设置日志窗口的隐藏模式。该模式下日志窗口仅肉眼可见，不影响脚本的触摸、找图、找色功能。

### Method
logWindow.setHideWindowMode

### Parameters
- **是否隐藏** (布尔型) - 必填 - true 为隐藏，false 为显示

### Request Example
```lua
logWindow.setHideWindowMode(true) --隐藏日志窗口
```

### Response
无返回值。
```

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

### 获取节点所有属性: obj:info()

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/info

获取节点对象的所有属性可视化。该函数只能在2.3.0以上版本中使用。成功返回数组，失败返回nil。

```lua
节点信息 =  obj:info()  
```

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

### dmOcr.loadFromFile 加载字库示例

Source: https://docs.trollautoscript.com/docs/dm/loadFromFile

从文件加载大漠字库，示例路径为 /var/mobile/Media/svip/res/dm.txt。

```lua
local dm = dmOcr.loadFromFile("/var/mobile/Media/svip/res/dm.txt")   --从文件加载大漠字库  
```

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

### screen.size() 使用示例

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.size

获取屏幕尺寸并格式化输出。

```lua
local width ,height = screen.size()  
print(string.format("屏幕尺寸为:%d ,%d" ,width ,height))  
```

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

### 范围找图 且查找多个目标（相似度 90）

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.findImage

从图片文件加载图片对象，以 90 的相似度在指定范围（100,100,400,600）内查找所有匹配目标（find_all）。找到后打印坐标。

```lua
--另一个示例 从图片文件加载图片对象   
local x ,y = screen.findImage(screen.loadImageFile("/var/mobile/Media/test.png") , 90, "find_all" ,100,100,400,600 )       --范围找图 相似度为 90  查找多个目标  
if x ~= -1 and y ~= -1 then  
    print(string.format("成功找到图片拉坐标: x= %d, y= %d" ,x ,y))  
end  

```

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

### 匹配节点并调用 tap() 示例

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/tap

使用 nodeView.matchForMainWindow 匹配主窗口中 label 为“点赞”且 class 为“AWEFeedVideoButton”的节点，第二个参数为 true 时返回节点对象数组，然后对数组第一个元素调用 tap() 模拟触摸控件。

```lua
  
local node = nodeView.matchForMainWindow(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点对象数组 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end ,true)   --第二个参数为 true 时 返回 对象数组  
node[1]:tap() -- 模拟触摸控件  
```

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

### 节点信息 = nodeView.infoForMainWindow() 函数调用语法

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/infoForMainWindow

调用时返回当前前台运行 app 的 KeyWindow 节点信息 JSON 文本。仅支持 2.3.0 以上版本使用。

```javascript
节点信息 =  nodeView.infoForMainWindow()  
```

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

### nodeView.switchBulletinBoard(是否显示)

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/switchBulletinBoard

显示或隐藏通知中心。此方法只能在 3.0.3 以上版本中使用。

```APIDOC
## nodeView.switchBulletinBoard(是否显示)

### Description
显示或隐藏通知中心。此方法只能在 3.0.3 以上版本中使用。

### Method
nodeView.switchBulletinBoard

### Parameters
- **是否显示** (布尔型) - Required - 如果为 true 表示显示控制中心，如果为 false 表示隐藏控制中心。

### Request Example
```
nodeView.switchBulletinBoard(true) -- 显示控制中心
nodeView.switchBulletinBoard(false) -- 隐藏控制中心
```

### Response
无返回值。
```

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

### dmOcr.loadFromFile(字库文件路径)

Source: https://docs.trollautoscript.com/docs/dm/loadFromFile

从文件加载大漠字库，返回大漠对象。该函数接受一个文本类型的字库文件路径参数，并返回一个对象类型的大漠对象。

```APIDOC
## dmOcr.loadFromFile(字库文件路径)

### Description
从文件加载大漠字库，返回大漠对象。

### Method
loadFromFile

### Parameters
- **字库文件路径** (文本型) - 必填 - 字库文件的路径。

### Return Value
- **大漠对象** (对象型) - 返回加载后的大漠对象。

### Example
```lua
local dm = dmOcr.loadFromFile("/var/mobile/Media/svip/res/dm.txt")   --从文件加载大漠字库
```
```

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

### 获取节点文本属性 :text()

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/text

获取节点对象的文本属性。成功返回文本，失败返回 nil。此方法仅在 2.3.0 及以上版本中可用。

```lua
文本内容 =  obj:text()  
```

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

### 触摸对象:move_ex(屏幕横坐标, 屏幕纵坐标, [角度])

Source: https://docs.trollautoscript.com/docs/%E6%A8%A1%E6%8B%9F%E8%A7%A6%E6%91%B8%E6%A8%A1%E5%9D%97/move_ex

模拟手指在屏幕中滑动，支持指定角度，内置贝塞尔曲线。返回触摸对象以支持链式调用。

```APIDOC
## 触摸对象:move_ex(屏幕横坐标, 屏幕纵坐标, [角度])

### Description
模拟手指在屏幕中滑动，支持指定角度，内置贝塞尔曲线。返回触摸对象以支持链式调用。

### Method
N/A (SDK function)

### Endpoint
N/A (SDK function)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```lua
-- 简单示例
touch.down(100,100):move_ex(200,200,30):up()
```

### Response
#### Success Response (200)
- **触摸对象** (对象型) - 返回触摸对象，支持链式调用

#### Response Example
```lua
local t = touch.down(100,100)
t:move_ex(200,200,30)
t:up()
```

### Error Handling
无
```

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

### screen.paddleOcr 使用示例

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.paddleOcr

示例代码，展示全屏识别、范围识别以及将识别结果用屏幕绘制框圈起来。使用screenDraw.init绘制矩形框，最后延时10秒。

```lua
  --简单的示例  
local result = screen.paddleOcr()       --全屏识别  
print("识别结果" , result)  
  
local result = screen.paddleOcr(100,100,200,200)    --范围识别  
print("识别结果",result)  
  
--全屏识别并圈起来  
local result = screen.paddleOcr()     
print(result)  
local tab = {}  
for k,v in pairs(result) do  
    local drawView = screenDraw.init( math.ceil( v.x ),math.ceil( v.y ),math.ceil( v.w ), math.ceil( v.h ), v.string ,0x00ff00 , 1.0 , 12, 0x00ff00)  
    table.insert(tab, drawView)  
    drawView:show()  
end  
sys.msleep(1000*10)  

```

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

### screen.size() 函数签名

Source: https://docs.trollautoscript.com/docs/%E5%B1%8F%E5%B9%95%E6%A8%A1%E5%9D%97/screen.size

获取屏幕宽度和高度，返回两个整数。

```lua
屏幕宽度, 屏幕高度 = screen.size()  
```

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

### 获取地址属性 (:addres)

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/addres

获取节点对象的地址属性。成功返回文本，失败返回 nil。此方法仅在 2.3.0 以上版本中可用。

```lua
地址 =  obj:addres()  
```

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

### 使用 obj:label() 打印节点标签

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/label

示例展示如何使用 matchForMainWindow 匹配节点并打印标签。函数返回节点对象数组，此处通过索引访问第一个节点并打印其标签属性。适用于 2.3.0 以上版本。

```lua

  
  
local node = nodeView.matchForMainWindow(function (info)   --匹配节点信息  label==点赞 class==AWEFeedVideoButton  此函数返回节点对象数组 数组型  
    return info.label == "点赞" and info.class == "AWEFeedVideoButton"  
end ,true)   --第二个参数为 true 时 返回 对象数组  
print(node[1]:label()) --打印出标签属性  
  
```

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

### 发送消息至 WebView: webView:postMessage

Source: https://docs.trollautoscript.com/docs/webView%E6%A8%A1%E5%9D%97/postMessage

向 WebView 内部的网页发送消息。消息内容为字符串类型，会被自动 JSON 序列化，因此包含引号或换行符也不会导致 JavaScript 执行错误。

```lua
webView:postMessage(消息内容)  
```

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

### webView:setLoadCallback(回调函数)

Source: https://docs.trollautoscript.com/docs/webView%E6%A8%A1%E5%9D%97/setLoadCallback

设置网页加载完成时的回调函数。当网页内容完全加载完毕时，该回调函数会被触发。

```APIDOC
## webView:setLoadCallback(回调函数)

### Description
设置网页加载完成时的回调函数。当网页内容完全加载完毕时，该回调函数会被触发。

### Method
setLoadCallback

### Endpoint
webView:setLoadCallback(回调函数)

### Parameters
#### 参数
- **回调函数** (function) - 必填 - function() 形式的无参函数。

### Request Example
```lua
local view =  
    webView.init {  
    x = 0, --屏幕横坐标  int  整数  必填  
    y = 0, -- 屏幕纵坐标 int  整数 必填  
    width = 1125, -- 宽度         int  整数 必填  
    height = 2436, --高度          int  整数 必填  
    url = "https://www.baidu.com",  
    alpha = 100, -- 透明度 可选 默认 0 -100  整数 默认100  
    -- rotate = 90,                       --向右旋转90度  可选   -90 为左旋转。 默认 0  
    radius = 5.0, -- 圆角 可选  
    hit = true, --是否可拖动  可选 默认 true  
    userInteractionEnabled = true --  是否可交互 为false 时  拖动失效 可选 默认 true  
}  
view:show()  
  
view:setLoadCallback(   --页面加载完成回调  
    function()  
        print("网页已经加载完成啦...")  
    end  
)  
  
sys.msleep(10000) --延迟10秒 在停止脚本  
```

### Response
#### Success Response
无返回值。

```

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

### nodeView.info() 函数定义

Source: https://docs.trollautoscript.com/docs/%E8%8A%82%E7%82%B9%E6%A8%A1%E5%9D%97new/viewInfo

返回当前正在前台运行app的节点信息json文本。此方法只能在2.3.0以上版本中使用。

```lua
节点信息 =  nodeView.info()  
```
Tokens:
Raw