gamepad api 依赖轮询而非事件监听，需持续调用 navigator.getgamepads() 获取手柄状态，并结合 gamepadconnected/gamepaddisconnected 事件管理插拔；按钮点击需帧间比对 pressed 状态，摇杆需设死区并映射方向；chrome/edge 支持良好，firefox 需手动启用，safari 不支持。
Gamepad API 不是靠监听“点击”或“按下”这类事件来工作的，它本质依赖轮询（polling）获取实时状态。真正要做的，是持续调用 navigator.getGamepads() 并解析返回的手柄数据，再结合连接/断开事件做基础管理。
监听手柄的插拔状态
浏览器会自动触发两个原生事件，用于感知硬件变化：
-
gamepadconnected：手柄插入后立即触发，
event.gamepad提供完整设备信息，包括id、index、mapping和初始按钮/轴值； - gamepaddisconnected：拔出手柄时触发，可据此清理缓存、关闭轮询或更新界面提示。
注意：index 是浏览器分配的临时编号，同一手柄每次重连可能不同；id 才是相对稳定的标识符，适合用于识别设备型号或用户偏好设置。
轮询获取实时输入数据
所有按钮和摇杆状态都必须通过 navigator.getGamepads() 主动读取——它返回一个数组，每个有效元素是一个 Gamepad 实例。常见用法如下：
- 遍历
gamepad.buttons数组，检查每个button.pressed判断是否被按下，用button.value获取压力值（0～1，支持模拟按键）； - 读取
gamepad.axes数组，例如axes[0]和axes[1]通常是左摇杆 X/Y 轴，范围在 -1.0 到 +1.0 之间； - 推荐使用
requestAnimationFrame驱动轮询循环，保证与屏幕刷新同步，避免丢帧或延迟。
处理常见交互逻辑
光读数据还不够，得把原始输入转化成游戏行为。几个实用技巧：
- 按钮“点击”检测：记录上一帧的
pressed状态，当前帧为true且上一帧为false，即视为一次有效点击； - 摇杆方向映射：把
axes[0]和axes[1]合成向量，用Math.atan2(axes[1], axes[0])算角度，或直接用于角色移动速度的 X/Y 分量； - 防抖与死区：摇杆回中时往往不完全归零，建议设定 ±0.15 的死区阈值，低于该值统一按 0 处理，避免漂移；
- 多手柄支持：数组索引不等于玩家编号，应优先用
gamepad.index关联本地状态对象，或根据gamepad.id做唯一绑定。
调试与兼容性注意事项
开发阶段容易踩坑，提前注意这些点能省不少时间：
- Chrome 和 Edge 支持最稳定；Firefox 对部分蓝牙手柄（如 Switch Pro）需手动启用
dom.gamepad.enabled；Safari 目前不支持； - 首次连接手柄时，必须由用户主动交互（如点击页面、按键）才能激活 API 权限，否则
getGamepads()返回全空数组； - 没有真正的“模拟手柄事件”机制，测试时可用 polyfill 劫持
navigator.getGamepads()，返回自定义假实例，绕过硬件依赖； - VR 手柄（如 Oculus Touch、Vive Controller）额外提供
pose属性，含位置和朝向，适用于空间交互，但普通网页游戏一般用不到。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
