节点参考
虚拟按键与虚拟摇杆字段
说明虚拟按键、虚拟摇杆、触发虚拟按键和切换虚拟控件方案的字段。
虚拟按键 VirtualButton
虚拟按键用于注册运行态控件，由变量或触发动作驱动真实点击、长按或滑动。适合游戏、半自动脚本和需要用户参与的场景。
controlId/displayName— 控件标识和显示名。triggerVarKey— 触发变量。triggerMode支持EDGE、HOLD。pressType—TAP、LONG_PRESS、SWIPE。x/y与xPct/yPct— 按键目标坐标。coordJitterMinPx/coordJitterMaxPx— 坐标随机偏移范围。pointVarKey— 从变量读取点击点。swipeTargetMode—STATIC_POINT、VARIABLE_POINT、DIRECTION_DISTANCE。swipeToPointVarKey、swipeToX/Y、swipeDirection、swipeAngleDeg、swipeDistancePx— 控制滑动目标。swipeMode、swipeHoldBeforeMoveMs、swipeHoldAfterMoveMs、swipeDurationMs— 控制滑动节奏。overlayVisible、overlaySizeScale、cooldownMs、longPressMs— 控制悬浮显示和触发节流。
虚拟摇杆 VirtualJoystick
虚拟摇杆用于把目标点变量转换成持续摇杆拖动。AI 应明确参考点、摇杆中心、半径、死区和更新频率。
controlId/displayName— 控件标识和显示名。targetPointVarKey— 目标点变量。referenceMode—SCREEN_CENTER、STATIC_POINT、VARIABLE_POINT。referencePointVarKey、referenceX/Y、referenceXPct/YPct— 参考点。joystickCenterX/Y、joystickCenterXPct/YPct— 摇杆中心。joystickRadiusPx、deadZonePx— 摇杆半径和死区。smoothFactor、updateIntervalMs、releaseDelayMs— 平滑、刷新和松开延迟。overlayVisible— 是否显示悬浮控件。
触发与方案切换
虚拟控件可先注册，再由脚本或用户触发。切换方案用于在不同页面或玩法下使用不同虚拟控件布局。
TriggerVirtualButton— 字段controlId、controlName、triggerType、longPressMs。triggerType支持DEFAULT_ACTION、TAP、LONG_PRESS_RELEASE、PRESS_DOWN、RELEASE。SwitchVirtualControlScheme— 字段schemeId、schemeName，用于切换虚拟控件方案。- AI 建议 — 虚拟输入不适合解释为后台无人值守能力，应说明需要用户授权、前台运行和目标应用可见。