Node reference

触控动作节点字段

说明点击、连点、长按、滑动、拖拽、多点触控等触控动作的作用和字段含义。

延迟与点击类动作

触控动作适合目标位置稳定的场景。AI 应尽量使用百分比坐标或识别结果变量，避免只写固定像素坐标。

Delay — 等待动作。millis 为等待毫秒数；millisVarKey 不为空时从变量读取等待时间。
Tap — 点击。x/y 为像素坐标；xPct/yPct 为百分比坐标；duration 为按下时长；pointVarKey 可引用视觉识别出的点。
MultiTap — 连点/双击。count 为点击次数；intervalMs 为点击间隔；duration 为每次点击时长；也支持百分比坐标和 pointVarKey。
LongPress — 长按。x/y 或 xPct/yPct 定位；duration 为长按时长；pointVarKey 可引用动态目标。

这组动作适合需要分段控制手势的场景，例如按住后移动、拖动滑块、模拟长按拖拽。

TouchDown — 按下不松开。pointerId 是触点编号；holdMs 是最长保持时长；支持坐标、百分比坐标和 pointVarKey。
MovePointer — 移动已按下触点。touchDownRefId 可引用按下动作；x/y、xPct/yPct 或 pointVarKey 指定终点；duration 控制移动时间；pathType 支持 POINT、LINE、POLYLINE、RECORD、CURVE。
TouchUp — 松开触点。pointerId 与 TouchDown 配对；releaseMs 是松开模拟时长。

滑动和多点触控适合列表滚动、页面切换、缩放、游戏摇杆等场景。AI 必须说明起点、终点、时长和坐标来源。

Swipe — 滑动。fromX/fromY 到 toX/toY；也支持百分比坐标、fromPointVarKey、toPointVarKey；useBezierCurve 可使用曲线；fromSourceType/toSourceType 可为 COORDINATE、IMAGE、TEXT、COLOR。
DragToTarget — 拖拽到目标。起点用 startX/startY 或百分比；targetType 支持 COORDINATE、NODE、VISION；waitTimeoutMs 和 waitIntervalMs 控制等待目标出现。
SingleTouch — 单指轨迹。TouchPointer 包含 points、duration、pathType、targetPointVarKey、targetSourceType、targetCondition、targetSelector。
MultiTouch — 多指轨迹。pointers 是多个 TouchPointer，可用于双指缩放或组合手势。
AI 建议：能用节点或视觉定位终点时，不要让用户手填难以适配的固定终点坐标。