有限范围抓取¶
用途¶
此节点只分析 Android 画面中的一个矩形区域，支持图像模板匹配和 OCR。它适合目标只会出现在固定区域、需要减少误匹配，或希望用固定次数重试而不是无限等待的场景。
当前运行时只支持 ADB 目标。画布上的“ADB（可选）”表示地址可以由 Debug 目标或自动发现补齐，不表示支持桌面截图。
添加路径¶
Shift+A → 自动化 → 有限范围抓取
搜索“有限范围抓取-图像匹配”或“有限范围抓取-OCR模式”可直接按对应模式创建。
执行行为¶
节点按搜索范围裁切每一帧，再进行识别。关闭“循环匹配”时只尝试一次；开启后最多尝试“循环上限”次，相邻尝试之间等待“匹配间隔”。命中或用尽次数后都会写出结果并继续执行；准备目标、模板或识别运行资源失败才会终止路线。
图像模式使用置信阈值；OCR 模式使用内置识别阈值。OCR 查询为空时，只要范围内识别到非空文字就视为命中。
输入端口¶
| 端口 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 执行输入 | 执行 | 是 | 开始有限识别计划。 |
| ADB 地址 | 字符串 | 否 | 非空连接值优先；为空时可使用节点地址、Debug 目标或首个自动发现目标。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 执行输出 | 执行 | 命中或重试耗尽后继续。 |
| 匹配结果 | 布尔 | 是否在任一尝试中命中。 |
| 识别文字 | 字符串 | OCR 模式最后一次识别到的文本；图像模式为空。 |
属性¶
双击节点进入区域编辑器，可导入/截取预览并直接拖动搜索矩形。
| 属性 | 默认值 | 说明 |
|---|---|---|
| ADB | 空 | 固定地址；不填时可由运行目标补齐。 |
| 抓取模式 | 图像匹配 | 可切换 OCR 模式。 |
| 目标图像 | 未设置 | 图像模式必需，可在编辑器导入或截取。 |
| OCR 字符串 | 空 | OCR 模式的包含查询；空值表示接受任意非空识别结果。 |
| 搜索范围 | 全屏 | 归一化矩形，最小宽高为画面的 0.1%。 |
| 置信阈值 | 0.82 | 图像模式使用，范围 0–1。 |
| 禁止缩放 | 开启 | 开启时原尺寸匹配；关闭时允许约 ±20% 模板缩放。 |
| 循环匹配 | 关闭 | 是否进行有限重试。 |
| 匹配间隔 | 1 秒 | 0.01–3600 秒。 |
| 循环上限 | 5 | 1–10000 次。 |
最小示例¶
开始 → 查找运行中ADB安卓实例 → 有限范围抓取 → 分支
连接单个 ADB 地址，双击设置模板和目标区域，再把 匹配结果连接到分支条件。
常见错误¶
- 用屏幕或窗口 Debug 目标：当前节点只接受 ADB Debug 目标。
- 图像模式缺少模板：双击节点导入/截取目标图像后再运行。
- 连接的 ADB 地址与准备目标不同：实时资源会在执行前准备；直接连接“查找运行中ADB安卓实例”的单个地址，或使用固定地址。
- OCR 返回文字但匹配为否：查询字符串不包含在识别结果中；清空查询可接受任意非空文本。
- 关闭缩放后仍识别不稳：确认模板和目标设备使用相同分辨率与缩放。