开始测试
运行 Controller Test
选择与游戏手柄最接近的配置，然后按照固定顺序在实时工具中检查每一个控制项。
使用这个 Controller Test 检查浏览器能否识别已连接的游戏手柄，以及按键、摇杆、扳机、方向键和逻辑映射是否按预期响应。先选择对应的手柄类型，通过 USB 或已经完成配对的无线连接接入设备，按下任意按键唤醒手柄，再把每个实际操作与页面中的实时反馈进行对照。本工具适合快速检测输入、排查映射问题和游戏前检查，但不能修复硬件或直接修改手柄映射。
开始测试
选择与游戏手柄最接近的配置，然后按照固定顺序在实时工具中检查每一个控制项。
当前测试配置
建议从这里开始，查看浏览器输出的逻辑按键索引、摇杆轴数值和实时输入记录。
互动测试由 ControllerTest.io 通过 iframe 提供。手柄访问能力和可用功能会受到浏览器、操作系统、驱动程序及连接方式影响。
嵌入服务：ControllerTest.io
建立可重复的检测流程
有效的手柄检测应该有固定顺序。每次按照同样的步骤操作，才能更容易发现遗漏输入并重复验证问题。
使用确认能够传输数据的 USB 线、受支持的无线适配器，或者已经在操作系统中完成的蓝牙配对。仅支持充电的 USB 线可能让手柄亮灯却无法传输数据；如果设备只充电但始终不出现，请先更换数据线。
需要查看底层逻辑索引时，从手柄按键映射测试开始。Xbox、PS5、Joy-Con 或 Switch Pro 专用视图更便于按照实体布局核对。页面中的图示只是参照，最终数据仍由浏览器和驱动映射决定。
保持当前标签页可见，然后按一个面键或推动摇杆。出于隐私和交互要求，浏览器可能要等到用户主动操作手柄后才把设备公开给网页。如果没有反应，先在嵌入区域点击一次，再按手柄按键。
依次按下并松开面键、肩键、扳机、摇杆按压、方向键和菜单控制。确认每一次明确按压都会点亮正确位置，而且松开后提示能够立即恢复。
先让摇杆在中心静止，再缓慢检查水平轴和垂直轴，最后沿边缘转动一整圈。观察中心是否稳定、移动是否连续、相反方向的行程是否接近，以及松手后能否回到接近零的位置。
重新连接手柄并刷新嵌入工具；条件允许时，对比有线和无线模式。判断硬件故障前，还应在真实游戏或厂商官方工具中复测，避免仅凭一次浏览器结果下结论。
不要根据一次闪动或一个意外标签直接判断故障，而应寻找可以重复出现的规律。重新连接后仍能复现，并且在另一个应用中表现相同，结果才更有诊断价值。
建议从连接链路开始向外排查。每次只改变一个变量并重新测试，才能明确是哪项调整影响了结果。
保持页面可见，并在加载完成后按一下手柄按键。浏览器可能要等到用户主动输入后才公开已经连接的设备。先在嵌入区域点击一次，再按 A、叉键或其他面键。如果仍然没有出现设备，请先确认操作系统本身能够识别它。
使用 USB 时，请换成确定能传输数据的线材，并尝试不经过无供电集线器的其他接口。使用无线连接时，确认手柄实际配对到当前电脑，而不是自动重新连接到了主机、手机或另一个适配器。
首先按照实体位置对照，而不是只看印刷字母。任天堂和 Xbox 的字母顺序不同。然后查看 Gamepad 映射是 standard 还是原始顺序。Steam Input、DS4 类转换工具、手柄固件模式和虚拟手柄驱动都可能有意把 PlayStation、任天堂或通用设备转换成 Xbox 兼容的逻辑布局。
如果浏览器映射始终一致，但游戏中的表现不同，应检查游戏自身键位和启动器级别的重映射。浏览器工具只能报告它收到的输入，无法知道另一个游戏如何再次转换这些输入。
零点附近很小的变化可能只是正常传感器噪声。完全松开摇杆，不要把手指搭在上面，并连续观察几秒。能够持续存在并足以推动光标或角色的偏移，比轻微数值跳动更有意义。重新连接后复测，并与游戏中的死区设置进行对照。
浏览器可视化工具可以发现症状，却无法直接判断原因是磨损、灰尘、校准、固件还是驱动转换。在拆卸手柄之前，优先使用厂商官方校准工具。
原始模式和旧式手柄模式可能采用与 Standard Gamepad 不同的方式公开控制。扳机在一种模式中可能表现为模拟轴，在另一种模式中则表现为带压力值的按键。一些旧式或非标准设备会通过轴或帽形开关表示方向键，而不是四个独立按键。
这类差异并不一定是缺陷。请记录控制的实际表现，确认完整行程能够到达；如果目标游戏要求标准布局，再选择兼容性更好的手柄模式。
互动区域来自外部服务商，因此内容拦截器、严格的网络过滤、DNS 问题或服务商临时故障都可能阻止加载。先使用重新加载按钮一次；如果浏览器拦截嵌入内容，请允许该内容；仍不可用时可更换浏览器或网络进行验证。
即使外部工具离线，页面周围的检测指南仍然可以阅读，但实时手柄输入必须等嵌入应用成功加载后才能运行。
更多测试说明
下面将说明浏览器能够检测哪些输入、标准映射如何工作，以及常见手柄类型分别应该检查什么。
嵌入式工作区读取浏览器通过 Gamepad API 提供的手柄信息。页面出现响应，说明当前操作已经沿着连接方式、操作系统驱动和浏览器这条链路到达网页。这可以帮助检查按键是否注册、模拟量是否变化，以及浏览器是否把设备整理为已知的标准映射。
页面显示的结果不是手柄内部电路的直接测量。固件、USB 或蓝牙传输、操作系统驱动、重映射软件、浏览器行为和嵌入式可视化工具都位于实体控制和屏幕反馈之间。因此应把它当作一个诊断观察点：它可以缩小问题范围，但无法单独识别所有原因。
检查每个按键能否被识别、松开后是否恢复，以及逻辑控制是否符合预期。重复触发或持续点亮时，应更换连接方式再次验证。
观察左右摇杆的水平和垂直数值。静止摇杆通常应稳定在零附近，推到边缘时应接近标准化范围的两端。
有些驱动把扳机公开为带压力值的按键，也可能采用其他形式。重点是数值变化连续、松开可靠，而且左右表现接近。
把实体按键与浏览器报告的索引、标签进行对照。意外标签可能来自任天堂按键顺序、非标准设备、驱动转换或重映射层。
不同游戏手柄并不会按照完全相同的物理顺序报告控制。浏览器先从操作系统获取数据，如果能够识别设备，就可能把它重新映射为 Standard Gamepad 标准布局。此时 Gamepad 对象会报告 standard 映射，并把常见控制放到统一的按键和轴索引。如果设备没有被识别，浏览器仍可能以空映射字符串和厂商自定义顺序公开原始输入。
标准布局描述的是实体位置，而不是品牌印刷的字母。右侧面键组中，索引 0 是下方按键，索引 1 是右侧按键，索引 2 是左侧按键，索引 3 是上方按键。任天堂手柄在这些位置使用的字母与 Xbox 不同，因此通用工具使用 Xbox 风格 ABXY 标签时，看起来可能像是按键颠倒。只要物理位置对应稳定，手柄本身可能完全正常。
模拟轴数值由浏览器标准化。常见双摇杆布局中，轴 0 和轴 1 表示左摇杆水平、垂直运动，轴 2 和轴 3 表示右摇杆。正负数值代表相反方向。中心出现很小的非零值并不少见，应根据偏移是否持续、幅度大小以及在真实软件中是否造成移动来判断漂移，而不是要求每一刻都等于数学上的零。
| API 索引 | 标准实体控制 | 需要确认的表现 |
|---|---|---|
| 按键 0–3 | 下、右、左、上四个面键 | 每个实体面键只点亮一个位置，松开后立即恢复。 |
| 按键 4–5 | 左右上肩键 | LB/RB 或 L1/R1 能够分别响应，不漏按。 |
| 按键 6–7 | 左右下方控制或模拟扳机 | 支持模拟值时，压力连续上升并在松开后顺利归零。 |
| 按键 8–9 | 中部左、右控制 | View/Select 与 Menu/Start 能够区分。 |
| 按键 10–11 | 左、右摇杆按压 | 按下摇杆时可以注册，而且无需明显推动摇杆。 |
| 按键 12–15 | 方向键上、下、左、右 | 四个方向彼此独立；斜向操作同时触发两个方向属于正常情况。 |
| 按键 16 | 中部或 Home 类控制 | 系统保留按键不一定会公开给浏览器，因此可用性可能不同。 |
| 轴 0–3 | 左 X/Y 与右 X/Y 摇杆运动 | 中心稳定性、完整行程、方向与回中过程保持一致。 |
不同手柄的检测重点
下拉框改变的是嵌入工具的可视化视图，不会修改驱动或固件。请选择最方便与实体布局对照的配置；需要确认浏览器实际输出时，再切回按键映射测试。
xbox controller test
在 PC 上，Xbox Controller Test 通常最容易与 Standard Gamepad 布局对应，因为实体 ABXY 顺序与标准右侧按键组的位置一致：A 在下方、B 在右侧、X 在左侧、Y 在上方。建议先检查四个面键，再依次检查 LB、RB、LT、RT、左右摇杆按压、方向键、View 和 Menu。Xbox 键可能被操作系统或游戏覆盖层保留，因此不一定会传递给浏览器。
模拟扳机需要缓慢检查，而不是只按一下。逐渐按下左右扳机，比较数值上升和回落过程。如果一侧开始响应明显更晚、始终达不到相似最大值，或者松开后仍保持激活，请改用 USB 连接并在另一个应用中复测，以区分物理磨损、无线连接、驱动或浏览器差异。
ps5 controller test
PS5 Controller Test 应重点检查叉、圆、方、三角四个面键、双摇杆、方向键、L1/R1、L2/R2，以及浏览器能够公开的中部控制。通用浏览器映射通常会把四个实体位置转换为标准布局使用的逻辑索引，因此某些图示可能按照位置显示 ABXY，而实体手柄使用 PlayStation 符号。
Gamepad API 不保证能够访问 DualSense 的每一项功能。触控板详细数据、运动传感器、自适应扳机阻力、扬声器、麦克风和高级触觉反馈可能需要额外浏览器支持、WebHID 权限、特定平台驱动或原生软件。按键和摇杆测试成功，只能说明基本浏览器输入正常，不能证明全部 DualSense 功能都兼容。
joy-con controller test
当左右 Joy-Con 已按操作系统和浏览器支持的方式完成配对时，可以使用 Joy-Con Controller Test。Joy-Con 的结构不同于一体式手柄；根据平台、配对方式和转换软件，浏览器可能把左右手柄分别公开，也可能通过虚拟设备合并。如果只出现一侧，请先在浏览器之外检查系统配对状态。
任天堂把 A 放在右侧、B 放在下方，而标准位置映射把逻辑按键 0 放在下方、按键 1 放在右侧。因此 Xbox 风格的通用显示可能像是把任天堂字母对调，即使输入完全正常。使用 Joy-Con 视图核对实体布局，再通过映射视图记录网页软件真正收到的逻辑索引。
switch pro controller test
Switch Pro Controller Test 将常见的双摇杆结构与任天堂面键字母结合。建议先使用任天堂专用配置，让 A、B、X、Y 更容易与实体对照；如果 PC 游戏显示 Xbox 风格提示，再切换到按键映射测试。两个视图可以帮助区分真正的漏按和印刷标签与标准实体索引之间的正常差异。
检查两个摇杆的静止状态，依次按方向键单方向和斜方向，并测试 L、R、ZL、ZR、Plus、Minus、Home 和 Capture 中浏览器能够识别的部分。某些中部或系统控制可能被操作系统、驱动或平台软件拦截；浏览器中没有显示并不能直接证明实体按键损坏。
gamepad controller test
通用手柄可能被识别为标准 Gamepad、未知 HID 设备、DirectInput 风格手柄，或者由转换软件创建的虚拟 Xbox 控制器。先使用通用视图确认整体输入，再打开映射测试，记录每个控制的实际索引。不要假设按键上印刷的名称一定决定浏览器索引。
第三方手柄上的模式开关可能大幅改变测试结果。提供 XInput、DInput、Switch 或 Android 模式的手柄，在不同模式下可能呈现不同设备 ID、按键数量、轴顺序和扳机行为。切换模式前先断开设备，重新连接并刷新测试，并为每种配置单独记录映射。
本页面嵌入了第三方手柄应用。iframe 会根据浏览器权限策略和页面授予的能力访问手柄。服务商声明手柄输入在浏览器本地处理，但嵌入文档仍由该服务商提供和运行。如果你不希望第三方嵌入应用访问已连接的手柄，可以在浏览器站点权限中进行限制。
浏览器 Controller Test 可以显示输入状态，但不能提供实验室级延迟测量。屏幕刷新、轮询行为、连接传输、操作系统调度、浏览器渲染以及页面反馈都会引入不确定性。不要把实体按压到屏幕点亮之间的目测时间当成精确的端到端延迟数值。
本工具也不能修复漂移、重新校准固件、修改映射或证明所有功能在游戏主机上都正常。平台保留按键、专有触觉反馈、扬声器、麦克风、触控表面、自适应扳机和运动传感器不一定能被浏览器访问。最终应使用厂商官方工具、真实游戏或目标主机确认。
常见问题
以下回答用于解释实体控制、浏览器映射和游戏内表现之间最常见的差异。