节点参考

无障碍控件节点字段

说明控件点击、输入、等待、清空、聚焦、勾选、控件滑动和无控件输入字段。

当前:无障碍控件节点字段
节点参考

无障碍控件节点字段

说明控件点击、输入、等待、清空、聚焦、勾选、控件滑动和无控件输入字段。

`NodeSelector` 控件选择器

无障碍节点动作适合按钮、输入框、列表项等具有文本、描述、ID 或状态属性的控件。AI 应优先给出稳定的选择器组合。

  • packageName — 目标应用包名。
  • viewId — 控件资源 ID,最稳定时优先使用。
  • text / description — 文本和无障碍描述。
  • className — 控件类名,例如按钮、输入框、列表项。
  • textMode / descriptionMode — 匹配方式,支持 EXACTCONTAINSFUZZY
  • clickablelongClickableenablededitablescrollableselectedcheckedvisibleToUser — 控件状态过滤。
  • depthindexInParentstablePath — 用于复杂控件树中的辅助定位。

控件点击与等待

控件点击比纯坐标更适合普通应用页面。AI 输出时应写清楚按钮文本、描述、ID 或候选定位方式。

  • FindAndClick — 旧版语义点击。字段:viewIdtextdescriptionclassNameclickable
  • NodeClick — 点击 selector 命中的控件。
  • NodeDoubleClick — 双击控件,intervalMs 是两次点击间隔。
  • NodeLongPress — 长按控件。
  • WaitNode — 等待控件出现或消失。appear 为 true 表示等待出现,false 表示等待消失;timeoutMsintervalMs 控制超时与轮询。

输入与控件状态

输入动作要考虑是否先清空、是否提交、是否校验输入成功。AI 应优先推荐 NodeInput,目标无法定位时再使用 NoControlInput

  • FindAndInput — 旧版语义输入。字段:inputTexttargetViewIdtargetTexttargetDescriptiontargetClassName
  • NodeInput — 控件输入。字段:selectorinputTextinputTextVarKeyclearBeforeInputsubmitModeenterX/enterY、百分比回车坐标、verify
  • InputSubmitModeNONETAP_COORDINATEENTER_KEY
  • InputVerifyConfigmodetimeoutMsuseCustomSelectorselector、OCR 区域和 ocrCaseSensitive
  • NodeClearInput — 清空输入框。
  • NodeFocus — 聚焦控件。
  • NodeSetChecked — 设置勾选状态,checked 控制目标状态。
  • NodeSwipe — 在控件上滑动,directiondistanceRatiodurationMs 控制方向、距离比例和时长。
  • NoControlInput — 无控件输入,字段包括 inputTextinputTextVarKey、focus 坐标、paste 坐标、triggerlongPressMs、enter 坐标、backspace 坐标、doEntersubmitModedoBackspaceverify