手柄连接指南

浏览器检测不到手柄?先排查浏览器路径,再判断硬件

只有操作系统通过 Gamepad API 把手柄公开给浏览器后,网页才能开始测试。先从线材或配对状态查起,再核对页面焦点,并区分浏览器限制和设备故障。

编写:Jemdo · 依据浏览器可见的诊断结果

打开手柄测试 →确认浏览器可见性,检查按键与摇杆,并保存本地观测结果。
排查流程

按顺序检查,减少误判

1. 先确认连接状态

尽量直连手柄并唤醒,在打开测试页前确认操作系统已经识别。蓝牙可能仍连接到另一台主机,而只有充电功能的线材可以供电却不能传输数据。

  • 换一根确认能传数据的线,并直连电脑接口。
  • 蓝牙设备先移除旧配对,再连接到当前主机。
  • 关闭可能独占手柄的映射器、启动器或其他测试页面。

2. 安全地激活网页

很多浏览器只有在页面获得焦点并按下一次按键后,才会把新连接的手柄公开给 Gamepad API。网页不需要额外硬件权限,只会在你主动操作后读取浏览器 API。

  • 点击页面,按下一个普通按键并等待片刻。
  • 确认页面不是后台标签,也不是限制输入的嵌入框架。
  • 可以用没有安装重映射扩展的浏览器配置复测。

3. 判断是否只是浏览器问题

如果操作系统和另一个浏览器都能看到手柄,而本页不能,通常应先查焦点、浏览器支持或映射层。如果所有应用都看不到,再排查线材、配对、驱动或硬件。

  • 在同一个系统账号下分别比较 USB 和蓝牙。
  • 记录浏览器、连接方式和设备名称,便于复现。
  • 不要仅因为网页为空就安装驱动或刷固件。

手柄识别不到、摇杆漂移和死区:如何理解结果

先确认按键和坐标会变化,再松开左右摇杆比较静止位置,随后缓慢推动并观察整个行程。保存报告时记录连接方式和测试条件,方便之后在相同环境下比较。

能力与限制参考:Gamepad API

快速清单

测试前后都可以复用

  1. 确认操作系统已经看到手柄。
  2. 使用数据线或重新完成蓝牙配对。
  3. 让页面获得焦点并按一次按键激活 Gamepad API。
  4. 换浏览器对比后再考虑硬件维修。
常见问题

关于结果边界的说明

为什么手柄已连接,网页却没有显示?

浏览器可能在等待按键、页面没有焦点、其他应用独占了设备,或者设备没有通过 Gamepad API 暴露。应对比另一个浏览器和系统设备列表。

只有充电功能的 USB 线会导致这个问题吗?

会。它可以给手柄供电,但没有数据通道。请换一根确认能传数据的线并直连。

网页列表为空就能证明手柄坏了吗?

不能。这只说明当时本页没有收到 Gamepad API 设备。还需要排查连接方式、页面焦点、浏览器支持和其他应用表现。