输入、触摸手势与意图层
输入设备报告的是按键、触点与位移,游戏需要的是移动、瞄准、确认与取消。中间应有一层把设备事件转换成意图,使键盘、鼠标和触摸都能驱动同一套规则。否则微信触摸适配会不断侵入角色、技能和界面代码,测试也只能靠人工点屏幕。
事件是瞬时的,意图可以持续
按下移动键设置方向,松开清除方向;逻辑更新读取当前意图。攻击按下则进入命令队列,只消费一次。不能每收到一次 touchmove 就移动固定距离,因为设备采样频率和手指速度都会改变角色速率。触点位置应该决定目标或摇杆方向,位移由模拟时间决定。
type Intent = { moveX: number; moveY: number; attackPressed: boolean };
const intent: Intent = { moveX: 0, moveY: 0, attackPressed: false };
function consumeTick(): Intent {
const result = { ...intent };
intent.attackPressed = false;
return result;
}
function resetInput() {
intent.moveX = 0; intent.moveY = 0; intent.attackPressed = false;
}
示例适用于一次待消费攻击;若可能在两个 tick 之间连续按多次,需要队列保存每个命令及序号。暂停、失焦、切后台或输入层销毁时都应重置持续意图,防止恢复后角色继续跑。输入重置属于生命周期行为,不应依赖最后一条松手事件一定会到达。
每根手指有自己的身份
虚拟摇杆通常捕获第一次落在左侧操作区的触点 ID,只有这根手指更新摇杆;另一根手指可以按攻击。若只读取“最新触点”,右手攻击会把左手方向拖走。触点结束或取消时只释放对应的控制,不能一根手指离开就把所有触摸状态清空。
摇杆可固定中心,也可按下时生成浮动中心。固定中心容易形成肌肉记忆,浮动中心适应手指落点;两者都要定义半径与死区。位移长度 d 小于死区时输出零;大于死区可线性重映射到 0~1,再将长度夹到 1。直接归一化所有非零位移,会让轻微抖动也产生满速移动。
UI 的按钮范围、可见图像与点击范围可以不同。移动端小图标需要足够触达空间,但相邻按钮不能相互重叠导致误触。按下后滑出是取消还是继续持有,要根据按钮用途决定;“蓄力松开发射”与“点击购买确认”显然不应共享未经区分的行为。
手势识别是一台小状态机
点击可以定义为持续时间和移动距离都在阈值内;拖拽在位移越过阈值后成立;长按需要时间达到阈值且没有被取消;双击还需要时间间隔与位置范围。阈值应使用清楚的 UI 单位与时钟,避免设备像素比变化后手势突然变难。
同一触点一旦被识别为拖拽,结束时通常不再触发点击。长按已触发后是否还触发点击也要明确。列表里滑动与按钮点击会竞争,常见做法是保留候选点击,达到拖动阈值后取消候选。这样比同时执行 click 和 drag 后再补偿结果更容易推理。
Creator 的全局与节点事件
Creator 3.8 可用 input 监听全局输入,节点事件适合按钮与区域交互。不要照搬旧 systemEvent 示例。节点触摸有 start、move、end、cancel;多点触摸会分别派发。注册与解绑应成对,复用组件时避免 onEnable 反复添加监听而未在 onDisable 清理。
节点层级、捕获/冒泡与输入拦截会影响事件路由;全屏透明节点也可能阻挡下面区域。调试时显示当前命中的输入区域与触点归属。不要把“相机看不见该节点”直接当成“它不会接收输入”的通用保证,应核对所用 UI 组织与组件状态。
输入坐标需要匹配目标空间。Canvas 的 UI 点不能直接与世界敌人 position 比较;屏幕点选世界时通过对应相机转换,再交给规则系统。摇杆 UI 的局部坐标只负责算方向,不必被误解释成世界位置。
鼠标测试覆盖不了什么
桌面鼠标适合验证单指流程和命令次数,却难以覆盖双指同时移动与攻击、触点取消、系统边缘手势、遮挡和误触。微信开发者工具模拟同样不能代替真机。至少在真实设备检查双指、按住时切后台、滑出按钮、触摸密集时的响应和不同屏幕操作区。
输入延迟也要分层:事件何时到达、意图何时被 tick 消费、画面何时显示。只打印回调时间不能证明端到端延迟。先用触点可视化和 tick 日志定位软件路径,再用适当的录像或设备工具评估实际手感,不虚构毫秒数据。
输入冲突要有归属规则
暂停菜单出现时,原本按住的战斗触点应被取消或冻结归属;关闭菜单后不能自动把它解释成新的攻击。触摸从摇杆区滑到按钮区时,是继续属于摇杆还是转交按钮,也应统一决定。通常一次触摸从开始到结束维持归属,能减少边界附近的意外切换,但特殊拖放操作可以采用另一套明确协议。
键盘映射同样需要优先级。聊天框或文本输入激活时,方向键与空格不应同时驱动战斗;调试快捷键也不应与正式操作冲突。把“当前哪个输入上下文拥有事件”显式建模,比在每个技能组件里判断菜单是否打开更容易维护。
录制输入时保存规则意图与命令序号,可以减少设备差异;调试原始触摸问题时则同时保存原始事件和坐标转换结果。两类日志用途不同:前者重放规则,后者定位设备适配。只保存最终方向无法解释为何手指按右却得到向上,只有原始坐标与空间信息才能查清。
操作区还要进行真实握持验证。按钮技术上位于屏幕内,可能仍被手掌遮住关键目标;浮动摇杆也可能在边缘与系统手势竞争。开发者可以用浏览器先验证布局与状态机,最终以目标设备的双手操作为依据,记录具体问题位置,而不笼统写“移动端已适配”。
AI 输入任务与验收
用 Creator 3.8.8 建键盘与双指触摸共用的 Intent 层:左侧摇杆、右侧攻击,按触点 ID 归属;实现死区、幅度夹取、松开/取消/暂停重置。加触点位置、归属、原始向量、最终意图和命令序号覆盖层。组件禁用时取消订阅。
验收:斜向不加速;轻推有低速;右手攻击不抢摇杆;每次按下只产生一次攻击;按住时切后台再恢复方向归零;反复进入场景不增加回调次数。Web 单指和微信真机双指结果分别记录。
来源与适用边界
核查日期:2026-11-17。具体 API 基于 Creator 3.8,示例目标 3.8.8;微信原生 touch 文档本次未能打开,未声称平台取消语义已核实。