无需登录 数据私有 本地保存

游戏手柄测试器 - Gamepad API在线检测按键

开发工具 检测工具 Gamepad 测试 游戏手柄
54
0
0
0
等待手柄连接... 🎮 Gamepad #1
刷新率: -- Hz
请按下手柄任意按键以激活检测（Chrome浏览器需先交互）
未检测到游戏手柄

请通过USB或蓝牙连接手柄，然后按下任意按键

支持 Xbox / PlayStation / Switch Pro / 通用手柄

LB
RB
L3 pressed
R3 pressed
A
B
X
Y
摇杆轴数据
左摇杆 X: 0.00
左摇杆 Y: 0.00
右摇杆 X: 0.00
右摇杆 Y: 0.00
左摇杆可能存在漂移 右摇杆可能存在漂移
按键历史
等待按键...
按键详情
索引名称状态力度计数
无数据
常见问题 (FAQ)

Gamepad API 是浏览器内置的JavaScript接口，允许网页直接读取连接在设备上的游戏手柄输入。它通过 navigator.getGamepads() 方法获取手柄列表，返回每个手柄的按键状态（buttons数组）和摇杆轴数据（axes数组）。由于安全原因，Chrome等浏览器需要用户先按下手柄按键才能激活数据读取。该API支持标准手柄映射，兼容Xbox、PlayStation、Switch Pro等主流手柄。

Gamepad API在主流现代浏览器中均获得良好支持：Chrome 35+、Firefox 29+、Edge 12+、Safari 10.1+、Opera 22+。移动端浏览器如Chrome for Android也支持。需要注意的是，Safari的某些版本对手柄映射的支持可能不完整，且iOS上的支持较为有限。建议使用最新版浏览器以获得最佳体验。

常见原因包括：
1. Chrome安全策略：需要先按下手柄上的任意按键（如A键或摇杆），浏览器才会开始报告手柄数据；
2. 连接问题：检查USB线是否插紧，或蓝牙是否配对成功；
3. 驱动问题：部分第三方手柄可能需要安装驱动或切换模式（如DirectInput/XInput切换）；
4. 浏览器权限：确保没有扩展程序阻止Gamepad API；
5. 尝试刷新页面后再按手柄按键。

支持所有符合HID标准的游戏手柄，包括：Xbox Series/One/360、PS5/PS4/PS3、Nintendo Switch Pro、以及各类第三方PC手柄。标准映射中，16个按钮索引对应：0-3为ABXY（右侧动作键）、4-5为LB/RB肩键、6-7为LT/RT扳机键（模拟值）、8-9为Select/Start、10-11为摇杆按下（L3/R3）、12-15为十字键方向。4个轴分别对应左右摇杆的水平和垂直方向。

摇杆漂移（Stick Drift）是指摇杆在未被触碰时，仍然持续输出微小的偏移信号。这通常是由于电位器磨损或灰尘积累导致的硬件问题。本工具会自动检测漂移：当摇杆静置时（未按下摇杆按钮），如果轴值持续超过±0.12的阈值，工具会显示漂移警告。轻微漂移（0.05-0.12）属于正常容差范围，严重漂移（>0.2）则建议清洁或维修手柄。

与普通按键的开关状态不同，LT（左扳机）和RT（右扳机）是模拟按键，输出的value值范围从0（完全松开）到1（完全按下）。这使得它们在赛车游戏中可以精确控制油门和刹车力度。在本工具中，扳机键的按压程度通过手柄顶部触发器区域的蓝色填充高度来可视化显示，同时在按键详情表格中可以看到精确的力度数值。
🔧 相关工具