排查流程
按顺序检查,减少误判
1. 先确认连接状态
尽量直连手柄并唤醒,在打开测试页前确认操作系统已经识别。蓝牙可能仍连接到另一台主机,而只有充电功能的线材可以供电却不能传输数据。
- 换一根确认能传数据的线,并直连电脑接口。
- 蓝牙设备先移除旧配对,再连接到当前主机。
- 关闭可能独占手柄的映射器、启动器或其他测试页面。
2. 安全地激活网页
很多浏览器只有在页面获得焦点并按下一次按键后,才会把新连接的手柄公开给 Gamepad API。网页不需要额外硬件权限,只会在你主动操作后读取浏览器 API。
- 点击页面,按下一个普通按键并等待片刻。
- 确认页面不是后台标签,也不是限制输入的嵌入框架。
- 可以用没有安装重映射扩展的浏览器配置复测。
3. 判断是否只是浏览器问题
如果操作系统和另一个浏览器都能看到手柄,而本页不能,通常应先查焦点、浏览器支持或映射层。如果所有应用都看不到,再排查线材、配对、驱动或硬件。
- 在同一个系统账号下分别比较 USB 和蓝牙。
- 记录浏览器、连接方式和设备名称,便于复现。
- 不要仅因为网页为空就安装驱动或刷固件。
手柄识别不到、摇杆漂移和死区:如何理解结果
先确认按键和坐标会变化,再松开左右摇杆比较静止位置,随后缓慢推动并观察整个行程。保存报告时记录连接方式和测试条件,方便之后在相同环境下比较。
能力与限制参考:Gamepad API
测试前后都可以复用
- 确认操作系统已经看到手柄。
- 使用数据线或重新完成蓝牙配对。
- 让页面获得焦点并按一次按键激活 Gamepad API。
- 换浏览器对比后再考虑硬件维修。
关于结果边界的说明
为什么手柄已连接,网页却没有显示?
浏览器可能在等待按键、页面没有焦点、其他应用独占了设备,或者设备没有通过 Gamepad API 暴露。应对比另一个浏览器和系统设备列表。
只有充电功能的 USB 线会导致这个问题吗?
会。它可以给手柄供电,但没有数据通道。请换一根确认能传数据的线并直连。
网页列表为空就能证明手柄坏了吗?
不能。这只说明当时本页没有收到 Gamepad API 设备。还需要排查连接方式、页面焦点、浏览器支持和其他应用表现。
