节点参考
虚拟按键与虚拟摇杆字段
说明虚拟按键、虚拟摇杆、触发虚拟按键和切换虚拟控件方案的字段。
虚拟按键 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 建议：虚拟输入不适合解释为后台无人值守能力，应说明需要用户授权、前台运行和目标应用可见。