需结合 gamepadconnected 事件与 50ms 轮询检测手柄连接，每帧 requestanimationframe 内调用 navigator.getgamepads() 获取快照并做边沿检测，注意 safari 非 https 下禁用、手柄需用户交互后才激活。
如何用 navigator.getGamepads() 检测手柄是否连接
浏览器不会主动通知手柄插拔，navigator.getGamepads() 返回的是当前已知手柄快照，不是实时事件。必须靠轮询才能发现新连接的手柄——但别每帧都调，会浪费 CPU。
- 首次检测建议在
gamepadconnected事件触发后开始轮询，而不是页面加载就开跑 - 轮询间隔设为
50ms左右较稳妥；太短（如16ms）在低端设备上可能拖慢主循环 -
navigator.getGamepads()返回数组，未连接位置是null，不能直接对length判定数量，得用filter(p => p) - 注意：Safari 在非 HTTPS 环境下完全禁用 Gamepad API，本地
file://协议也无效
怎么读取按键和摇杆状态而不卡顿
手柄数据必须在动画帧内读取（比如 requestAnimationFrame 回调里），否则拿到的是过期值；且不能在事件回调里直接读 buttons 或 axes ——它们只在帧内保证一致。
- 每次渲染帧开头调一次
const pads = navigator.getGamepads(); const pad = pads[0];，之后所有逻辑基于这个pad实例操作 -
pad.buttons[0].pressed表示 A 键是否按下，pad.buttons[0].value是模拟按键（如扳机）的 0–1 浮点值 - 摇杆是
pad.axes[0]（X）和pad.axes[1]（Y），范围 -1 到 +1；注意 Y 轴正方向通常是向下（和屏幕坐标系相反） - 不要对
pad.buttons[i].pressed做连续 true 判断来实现长按——它每帧都可能是 true；应记录上一帧状态做边沿检测
gamepadconnected 和 gamepaddisconnected 事件为什么有时不触发
这两个事件依赖底层系统报告，Chrome 和 Firefox 支持较好，但某些蓝牙手柄（尤其第三方 Xbox 风格）在 Windows 上可能只在首次配对时触发 connected，拔插不再上报；macOS 对部分手柄也有延迟或丢失。
- 务必同时监听事件 + 主动轮询，不能只信事件
- 事件对象里的
e.gamepad是有效手柄实例，可直接缓存，无需再从getGamepads()查找 - 断连事件可能滞后 1–2 秒，所以 UI 上的“手柄已断开”提示最好加个 500ms 防抖，避免误报
- 某些游戏本（如部分联想 Legion）的内置手柄模拟器会出现在
getGamepads()中，但不触发任何事件——需靠轮询识别其id是否长期不变来判断是否真实设备
常见错误：pad.buttons 是空数组或全是 undefined
这不是代码写错了，而是手柄尚未被浏览器“激活”。Gamepad API 要求用户至少一次交互（如按键、摇杆偏移）后才允许暴露完整输入数据，否则 buttons 和 axes 保持空或零值。
- 页面需有明确提示：“请按下任意键启用手柄”
- 不能靠
pad.connected === true就认为能读输入；要加判断pad.buttons && pad.buttons.length > 0 - 部分手柄（如 PS4 DualShock）在 Chrome 中需先按
PS键才会激活；而 Switch Pro 手柄在 Firefox 中可能需先晃动摇杆 - 若始终无法激活，检查是否启用了“USB 游戏控制器”系统权限（Windows 设置 → 蓝牙和其他设备 → 相关选项）
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
