3D近距离特征物查找¶
用途¶
此节点在 3D 画面中主动改变视角或持续前进，直到找到指定目标。目标可由图像模板、OCR 文字或识图类 ONNX 模型定义。命中后可把目标移到屏幕中心并点击。
添加路径¶
Shift+A → 自动化 → 3D近距离特征物查找
执行行为¶
节点先在当前画面识别。视角模式未命中时按配置拖动视角并逐帧重试；固定位移模式则按住前进轮盘，按串行识别间隔检查目标，命中后先释放轮盘并重新确认。搜索耗尽、重新确认失败或居中失败时输出 完成 = false；成功找到并完成后置动作时输出 true。两者都会继续执行。
“每次识别前点击扫描键”开启时，两种查找模式都会先点击指定位置再截图。
输入端口¶
| 端口 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 执行输入 | 执行 | 是 | 开始搜索。 |
| ADB | 字符串 | 与桌面二选一 | Android 目标地址。固定位移模式必须使用 ADB。 |
| 桌面 | 字符串 | 与 ADB 二选一 | 视角模式的窗口/后台目标。 |
| OCR 文本 | 字符串 | OCR 模式必填 | 有效连接值优先于节点属性。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 执行输出 | 执行 | 搜索成功或业务失败后继续。 |
| 完成 | 布尔 | 是否找到目标并完成居中/点击要求。 |
属性¶
双击节点进入“屏幕预览”和“查找与操作选项”。
目标识别¶
| 属性 | 默认值 | 说明 |
|---|---|---|
| 目标类型 | 目标图像 | 可选图像、OCR 或识图模型。 |
| 目标模板 / OCR / 模型 | 未设置或内置模型 | 对应模式的识别依据；模型可按类别标签或 class_id过滤，留空表示全部。 |
| 查找区域 | 全屏 | 在预览中拖动；识别只分析该区域。 |
| 匹配/置信阈值 | 0.65 | 图像/OCR 使用匹配阈值，模型使用置信阈值。 |
| 扫描键前置 | 关闭 | 每次识别前点击一次可拖动位置。 |
模型模式会先按类别和置信度过滤，再选取同帧中离屏幕中心最近的目标。
找到前¶
| 模式 | 主要属性 | 行为 |
|---|---|---|
| 视角模式 | 共同起点、水平/垂直方向与最大长度、横向次数 2、竖向次数 3 | 先原地识别，再按多行扫描顺序拖动视角。 |
| 快速查找 | 开关，默认关闭 | 固定横向满距离拖动 4 次，不做垂直扫描，并忽略次数属性。 |
| 固定位移 | 轮盘中心、前进半径、识别间隔 0.5 秒 | 只支持 ADB；持续前进并串行识别，不堆积并发请求。 |
固定位移还可要求目标框与查找区域的交集面积达到指定比例，默认面积门槛关闭，预设比例为 5%。
找到后¶
| 属性 | 默认值 | 说明 |
|---|---|---|
| 移到屏幕中心 | 关闭 | 反复微调视角，直到目标中心进入圆形容差区。 |
| 中心容差 | 短边 10% | 可调 0.1%–50%。 |
| 最大居中修正次数 | 15 | 范围 1–15。 |
| 找到后点击 | 开启 | 在最终目标框中心点击。 |
最小示例¶
开始 → 3D近距离特征物查找 → 分支
选择目标图像，导入模板，连接 ADB 地址并用默认视角模式搜索；根据 完成分别进入交互或失败恢复路线。
常见错误¶
- 图像模式没有模板，或 OCR 文本为空：节点会在执行前/执行开始时拒绝运行。
- 固定位移连接桌面目标：该模式只支持 ADB，改用视角模式或更换目标。
- 前进后目标一闪而过：缩短理想识别间隔；小于 0.1 秒时仍受截图和识别耗时限制，任务不会并发堆积。
- 目标找到却最终为失败：开启居中后，目标没有在最大修正次数内进入容差圆。
- 模型看见目标却不命中：检查类别过滤、类别编号和置信度阈值。