如何在浏览器中测试手柄？

通过 USB 或蓝牙连接，然后按任意按键。测试通过 Gamepad API 自动检测手柄并实时显示所有按键、摇杆和扳机状态。

支持哪些手柄？

浏览器识别的任何手柄均可：Xbox（One、Series X/S）、PlayStation（DualShock 4、DualSense）、Nintendo Switch Pro 及大多数标准映射的通用 USB/蓝牙手柄。

连接后按任意按键 — 浏览器需要按键操作来激活 Gamepad API。如仍检测不到，换 USB 口、重新配对蓝牙或检查其他应用是否独占。

不会。Gamepad API 完全在 JavaScript 中运行。输入值通过 requestAnimationFrame 轮询读取，不会离开浏览器。

连接手柄并按任意按键开始。本测试实时读取 Gamepad API — 显示按键状态、摇杆位置、扳机值和振动支持。100%浏览器端，零数据上传。

通过 requestAnimationFrame 轮询 Gamepad API，实时显示所有按键状态、摇杆 X/Y 轴（±1.0 范围）、扳机压力（0–1.0）和振动马达支持。

Gamepad API 标准映射最多 17 个按键和 4 个轴；Xbox、PlayStation 和 Switch Pro 手柄均遵循标准映射。

Connect a gamepad and press any button

Supports Xbox, PlayStation, Switch, and generic controllers

Result	Range	Meaning
良好	所有按键和摇杆正确响应	每个输入映射到预期的按键索引，摇杆松开后回到中心（0, 0），扳机报告完整的 0–1.0 范围 — 手柄完全正常。
注意	摇杆漂移或扳机范围不完整	摇杆静止时不归零表示摇杆漂移 — 电位器磨损。扳机范围不完整可能是机械限位或校准问题。
异常	按键无响应或手柄未被检测到	按键无响应说明触点故障。如果完全检测不到，检查驱动程序、换 USB 口或重新配对蓝牙。

浏览器检测不到手柄

连接后按任意按键 — Gamepad API 需要物理按键激活。如仍未检测到，换 USB 口、重新配对蓝牙或关闭可能独占手柄的其他应用。

摇杆静止时显示漂移（非零值）

摇杆漂移由摇杆模块内磨损的电位器引起。在游戏设置中增大死区作为临时方案，或更换摇杆模块永久解决。