通用手柄测试器
测试任何 USB 或蓝牙游戏手柄
Universal 诊断模式 工具
Select a tool below to diagnose your gamepad.
完整指南：测试第三方和通用手柄
HTML5 Gamepad API 旨在与操作系统识别为标准游戏手柄输入设备的任何手柄一起工作。这意味着我们的测试器可与大量第三方手柄、专用游戏手柄、格斗摇杆、赛车方向盘甚至复古主机适配器配合使用。
支持的手柄品牌
- 八位堂：Ultimate、Pro 2、SN30 Pro+ 以及所有有线和无线型号。八位堂手柄通过蓝牙、USB-C 或随附的 2.4GHz 无线适配器（仅限 USB 模式用于浏览器检测）完全兼容。
- 罗技：F310、F710、罗技游戏手柄 F510 和专用手柄。F310/F710 有一个硬件开关（XInput 与 DirectInput） — 确保将其设置为 XInput 模式（X 位置）以便浏览器正确检测。
- 雷蛇：Wolverine V2、Raion 和通过 USB 连接的 Kishi 型号。雷蛇的专有无线协议可能不会被浏览器检测到。
- 赛睿：Stratus Duo、Nimbus+ 以及其他支持蓝牙的型号。
- SCUF：Reflex、Instinct、Prestige — 这些是改装的第一方手柄，工作方式与标准索尼/微软游戏手柄完全相同。 PowerA、HORI、PDP：预算型和授权第三方手柄。这些通常使用 XInput 或 HID 协议，完全兼容。
通用手柄故障排除
The joystick drift epidemic has driven a new wave of "drift-free" controllers using <strong>Hall Effect sensors</strong>. Understanding the difference between the two technologies is crucial when evaluating your controller's health:
- <strong>Potentiometer (Standard):</strong> Uses physical carbon tracks and metal wipers to measure resistance. As the carbon wears away from friction over time, the resistance changes unpredictably, creating the phantom inputs known as "stick drift". Found in almost all standard controllers (DualSense, Xbox Series, Joy-Cons, DualShock 4).
- <strong>Hall Effect (Modern):</strong> Uses magnets attached to the stick and magnetic sensors (Hall Effect sensors) on the circuit board. The sensors detect the position of the magnets without any physical contact. Zero contact = zero wear = zero drift. Used in: DualSense Edge, 8BitDo Ultimate, GuliKit KingKong 2 Pro, Flydigi Vader 3 Pro.
如果您的手柄未出现在测试器中，请尝试以下步骤：
按键映射问题
相关工具
If your controller isn't appearing in the tester, try these steps:
- Ensure Chrome or Edge is fully updated (Gamepad API requires a modern browser).
- Press any button on the controller first — the Gamepad API only activates after a user interaction.
- Check if the controller has a mode switch (DirectInput vs XInput). Set it to XInput mode.
- Try a different USB port, ideally a rear motherboard port.
- On Windows, check Device Manager → "Human Interface Devices" to verify the OS recognizes the controller.
Xbox 手柄测试器
测试 Xbox One、Series X|S 和 Elite 手柄的功能。
PS5 DualSense 测试器
PS4 DualShock 4 测试器
测试您的 DualShock 4 的按键、摇杆、触摸板和光条。
Nintendo Switch 测试器
诊断 Joy-Con 漂移、Pro 手柄和 HD 震动。 手柄未被浏览器检测到的最常见原因是其使用的输入协议。Windows 支持两种游戏手柄协议： 如果您的手柄有物理开关（常见于罗技 F310、F710 和一些八位堂型号），请将其设置为“X”模式（XInput）而不是“D”模式（DirectInput），以获得最佳浏览器兼容性。 除了标准游戏手柄，Gamepad API 还能检测到许多专用手柄：
PS4 DualShock 4 Tester
Test buttons, sticks, touchpad, and light bar on your DualShock 4.
Nintendo Switch 测试
Diagnose Joy-Con drift, Pro 手柄, and HD Rumble.
The single most common reason a controller isn't detected by a browser is the input protocol it uses. Windows supports two gamepad protocols:
If your controller has a physical switch (common on Logitech F310, F710, and some 8BitDo models), set it to "X" mode (XInput) rather than "D" mode (DirectInput) for the best browser compatibility.
Beyond standard gamepads, the Gamepad API also detects many specialty controllers:
- XInput (Modern): Microsoft's protocol, designed for Xbox controllers. It provides a standardized 16-button layout with two analog sticks and two analog triggers. The browser Gamepad API works best with XInput controllers. Xbox, modern 8BitDo, and most new third-party controllers use XInput by default.
- DirectInput (Legacy): The older Windows protocol that supports up to 128 buttons and 8 axes, but with no standardized layout. Some older or specialty controllers (some Logitech models, certain HOTAS controllers) only support DirectInput and may appear with incorrect button mapping or not at all.
- Fight Sticks / Arcade Sticks: Hori Fight Stick Alpha, Qanba Obsidian, Mayflash F500, and Victrix Pro FS all work via USB. They report 8-12 buttons and directional inputs. Use the 按键测试 to map every button.
- Racing Wheels: Logitech G29/G920, Thrustmaster T300RS, and Fanatec wheels are detected as gamepad devices. The steering axis, accelerator, and brake pedals map to analog axes. Force feedback cannot be triggered through the browser.
- Flight Sticks / HOTAS: Thrustmaster T.16000M, Logitech Extreme 3D Pro, and similar joysticks are partially compatible. Multiple axes (pitch, yaw, roll, throttle) are reported. Use the 死区测试 to calibrate each axis.
- Retro Adapters: USB adapters for SNES, N64, GameCube, and Genesis controllers typically use DirectInput and may need XInput wrapper software (like x360ce) for full browser compatibility.
Understanding XInput vs DirectInput: Why Your 手柄 Might Not Work
The single most common reason a controller isn't detected by a browser is the input protocol it uses. Windows supports two gamepad protocols:
- XInput (Modern): Microsoft's protocol, designed for Xbox controllers. It provides a standardized 16-button layout with two analog sticks and two analog triggers. The browser Gamepad API works best with XInput controllers. Xbox, modern 8BitDo, and most new third-party controllers use XInput by default.
- DirectInput (Legacy): The older Windows protocol that supports up to 128 buttons and 8 axes, but with no standardized layout. Some older or specialty controllers (some Logitech models, certain HOTAS controllers) only support DirectInput and may appear with incorrect button mapping or not at all.
If your controller has a physical switch (common on Logitech F310, F710, and some 8BitDo models), set it to "X" mode (XInput) rather than "D" mode (DirectInput) for the best browser compatibility.
Testing Specialty 手柄s: Fight Sticks, Racing Wheels & Flight Sticks
Beyond standard gamepads, the Gamepad API also detects many specialty controllers:
- Fight Sticks / Arcade Sticks: Hori Fight Stick Alpha, Qanba Obsidian, Mayflash F500, and Victrix Pro FS all work via USB. They report 8-12 buttons and directional inputs. Use the 按键测试 to map every button.
- Racing Wheels: Logitech G29/G920, Thrustmaster T300RS, and Fanatec wheels are detected as gamepad devices. The steering axis, accelerator, and brake pedals map to analog axes. Force feedback cannot be triggered through the browser.
- Flight Sticks / HOTAS: Thrustmaster T.16000M, Logitech Extreme 3D Pro, and similar joysticks are partially compatible. Multiple axes (pitch, yaw, roll, throttle) are reported. Use the 死区测试 to calibrate each axis.
- Retro Adapters: USB adapters for SNES, N64, GameCube, and Genesis controllers typically use DirectInput and may need XInput wrapper software (like x360ce) for full browser compatibility.
❓ Frequently Asked Questions: Generic & Third-Party 手柄s
为什么我的手柄在浏览器中未被检测到？
首先按下任意按键 — Gamepad API 仅在用户交互后激活。确保您使用的是 Chrome、Edge 或 Firefox。检查您的手柄是否有 DirectInput/XInput 开关，并将其设置为 XInput（“X”位置）。尝试不同的 USB 端口（最好是主板后部的端口）。在 Windows 上，验证操作系统是否在设备管理器中识别了该手柄。
XInput 和 DirectInput 有什么区别？
XInput 是微软为 Xbox 式手柄设计的现代协议，具有标准的 16 按键布局。DirectInput 是较旧的协议，支持更多按键/轴，但没有标准化映射。浏览器更倾向于 XInput 以获得可靠的检测。罗技 F310/F710 有一个物理开关（“X” vs “D”）来在两者之间切换。
格斗摇杆和街机摇杆能与此测试器一起工作吗？
可以！通过 USB 连接的格斗摇杆（Hori、Qanba、Mayflash、Victrix）会被 Gamepad API 完全检测到。它们通常报告 8-12 个按键和一个映射为苦力帽开关的方向键。按键测试页面显示原始按键索引，便于映射。
赛车方向盘能与此测试器一起工作吗？
罗技 G29/G920、图马斯特 T300RS 和 Fanatec 方向盘被检测为游戏手柄设备。方向盘旋转和踏板映射到模拟轴。使用死区测试校准每个轴。注意：力反馈效果无法通过浏览器 API 触发。
为什么我的手柄按键映射不正确？
通用手柄可能使用自定义按键映射，而不是标准的 Xbox 布局。Gamepad API 报告一个映射属性 — 如果它显示“standard”，按键遵循 Xbox 布局；如果为空，则手柄使用自定义索引。使用按键测试通过单独按下每个按键来识别您的特定布局。
我可以测试连接到手机的手柄吗？
可以！在 Android 上，打开 Chrome 或 Edge 并导航到 GPad 手柄测试器。通过蓝牙或 USB OTG 连接您的手柄并按下任意按键。在 iOS 上，从 iOS 16.4 开始，Safari 对 Gamepad API 的支持有限。由于使用 WebKit 引擎，iOS 上的 Chrome 不支持它。