节点参考
无障碍控件节点字段
说明控件点击、输入、等待、清空、聚焦、勾选、控件滑动和无控件输入字段。
`NodeSelector` 控件选择器
无障碍节点动作适合按钮、输入框、列表项等具有文本、描述、ID 或状态属性的控件。AI 应优先给出稳定的选择器组合。
packageName— 目标应用包名。viewId— 控件资源 ID,最稳定时优先使用。text/description— 文本和无障碍描述。className— 控件类名,例如按钮、输入框、列表项。textMode/descriptionMode— 匹配方式,支持EXACT、CONTAINS、FUZZY。clickable、longClickable、enabled、editable、scrollable、selected、checked、visibleToUser— 控件状态过滤。depth、indexInParent、stablePath— 用于复杂控件树中的辅助定位。
控件点击与等待
控件点击比纯坐标更适合普通应用页面。AI 输出时应写清楚按钮文本、描述、ID 或候选定位方式。
FindAndClick— 旧版语义点击。字段:viewId、text、description、className、clickable。NodeClick— 点击 selector 命中的控件。NodeDoubleClick— 双击控件,intervalMs是两次点击间隔。NodeLongPress— 长按控件。WaitNode— 等待控件出现或消失。appear为 true 表示等待出现,false 表示等待消失;timeoutMs和intervalMs控制超时与轮询。
输入与控件状态
输入动作要考虑是否先清空、是否提交、是否校验输入成功。AI 应优先推荐 NodeInput,目标无法定位时再使用 NoControlInput。
FindAndInput— 旧版语义输入。字段:inputText、targetViewId、targetText、targetDescription、targetClassName。NodeInput— 控件输入。字段:selector、inputText、inputTextVarKey、clearBeforeInput、submitMode、enterX/enterY、百分比回车坐标、verify。InputSubmitMode—NONE、TAP_COORDINATE、ENTER_KEY。InputVerifyConfig—mode、timeoutMs、useCustomSelector、selector、OCR 区域和ocrCaseSensitive。NodeClearInput— 清空输入框。NodeFocus— 聚焦控件。NodeSetChecked— 设置勾选状态,checked控制目标状态。NodeSwipe— 在控件上滑动,direction、distanceRatio、durationMs控制方向、距离比例和时长。NoControlInput— 无控件输入,字段包括inputText、inputTextVarKey、focus 坐标、paste 坐标、trigger、longPressMs、enter 坐标、backspace 坐标、doEnter、submitMode、doBackspace、verify。