手柄测试

手柄测试通过 W3C Gamepad API 读取控制器发送给浏览器的信号，并实时展示：每一次按键、摇杆位置、扳机深度、方向键方向和震动马达。它是开打前确认手柄是否正常、排查面键连击、发现老手柄摇杆漂移、验证双震动马达是否都工作的最快方式。页面在 Xbox 风格的布局上高亮每一个输入，显示摇杆和扳机的原始数值，并保留简短的事件记录。由于 Gamepad API 只有在你按下手柄上的按键后才会暴露控制器，页面会先提示你按任意键——这是浏览器的安全规则，不是手柄故障。所有操作都在浏览器本地完成，输入数据不会离开你的设备。

浏览器通过 W3C Gamepad API 暴露手柄。一个控制器由从 navigator.getGamepads() 获取的 Gamepad 对象表示，该函数返回最多四个槽位。每个 gamepad 携带一个 id 字符串（厂商和产品）、一个 mapping 字段（Xbox 布局设备为 'standard'，否则为空）、一个 buttons 数组和一个 axes 数组。 在标准映射下，buttons 有 17 项：四个面键（A/B/X/Y）、两个肩键（LB/RB）、两个模拟扳机（LT/RT）、Select/Start、两个摇杆按下（L3/R3）、四个方向键和 Home/Guide 键。每个按钮暴露 .pressed（布尔）和 .value（0 到 1——扳机是模拟量，数字按键为 0 或 1）。axes 数组保存四个 -1 到 1 的值：左摇杆 X/Y，再右摇杆 X/Y。 该 API 是轮询式而非事件式，因此页面运行 requestAnimationFrame 循环，每帧读取一个新快照。为避免手柄静止时无意义的重渲染，仅当 gamepad.timestamp 变化时才更新状态——该时间戳在每份新输入报告上递增。连接和断开通过 window 的 gamepadconnected 和 gamepaddisconnected 事件到达。 出于安全，gamepad 对象在用户按下手柄上的按键前保持 null，因此页面无法静默读取刚插入的手柄。震动是可选功能：如果 gamepad.vibrationActuator 存在，调用 playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) 即可驱动两个马达；Safari 和部分 Chromium 版本未实现该功能，这也是页面做特性检测并在不支持时禁用按钮的原因。

• navigator.getGamepads() 返回最多四个槽位；只有在按下手柄按键后对应槽位才非 null。
• 标准映射：buttons[0-3] 面键、[4-5] 肩键、[6-7] 模拟扳机、[8-9] Select/Start、[10-11] L3/R3、[12-15] 方向键、[16] Home。
• axes[0-1] 为左摇杆（X、Y），axes[2-3] 为右摇杆，取值范围均为 -1 到 1。
• 轮询模型：requestAnimationFrame 循环读取快照；以 gamepad.timestamp 作为门控，静止帧不做任何更新。
• 震动通过 gamepad.vibrationActuator.playEffect('dual-rumble', ...) 实现——需特性检测，并非所有浏览器都支持。
• gamepadconnected / gamepaddisconnected 事件表示连接和断开；手柄的 .index 标识其槽位。