Switch Pro 手柄测试如何映射每个按键
Switch Pro 手柄测试按照标准浏览器 Gamepad 布局中的实体位置显示按键。在 Switch 风格的正面按键区，B 是底部按键，A 是右侧按键，Y 是左侧按键，X 是顶部按键。在浏览器标准索引中，这些位置对应 0、1、2、3。因此，即使实体按键工作正常，Switch Pro 手柄测试显示的标签也可能和 Xbox 风格测试器不同。
Switch Pro 手柄测试还会把 L/R 和 ZL/ZR 分开。L 和 R 是上方肩键，对应索引 4 和 5；ZL 和 ZR 是后方较大的扳机，对应索引 6 和 7。许多 Switch Pro 兼容手柄会把这些扳机作为数字按键暴露给浏览器，所以数值可能直接从 0 跳到 1，而不是像赛车手柄的模拟扳机那样平滑变化。
- B、A、Y、X 按 Nintendo 风格实体位置点亮。
- 方向键上、下、左、右使用标准按键索引 12 到 15。
- 左摇杆按下和右摇杆按下分别按 L3、R3 检查。
- Home 和 Capture 单独显示，因为不同浏览器的支持可能不同。
什么时候运行 Switch Pro 手柄测试
在把手柄与 PC 配对后、从蓝牙切换到 USB 后、使用转接器时、购买二手手柄前，或游戏显示错误按键提示时，都适合运行 Switch Pro 手柄测试。这个测试要回答的是一个实际问题：浏览器看到的输入，是否就是你正在按下的实体控制。
如果 Switch Pro 手柄测试显示响应正常，但游戏里的表现不同，请继续检查 Steam Input、模拟器配置、游戏内重映射、系统驱动或转接器模式。浏览器结果是有用证据，但游戏可能在手柄到达浏览器之后再套一层输入处理。
- 需要最简单的连接基准时，先用 USB 测试。
- 如果实际使用蓝牙游玩，请再用蓝牙重复 Switch Pro 手柄测试。
- 当转接器改变按键索引时，请保持原始输入面板可见。
- 只有症状能复现后，再生成本地报告。
摇杆、方向键、震动和运动功能边界
Switch Pro 手柄测试会检查浏览器通常能通过 Gamepad API 暴露的输入：按键、摇杆轴、扳机数值、原始索引，有时还包括震动。请缓慢把每个摇杆推到边缘，按下两个摇杆，依次按方向键四个方向，再逐个按正面按键。如果摇杆静止时偏离中心，请先使用漂移和死区模块判断，再决定是否认为手柄损坏。
运动控制、NFC、主机配对行为、玩家指示灯、固件功能和唤醒主机能力，并不是可靠的浏览器信号。Switch Pro 手柄测试不会写入固件、改变校准或访问主机专用功能，只关注可以安全观察的本地浏览器读数。
Local testing and privacy boundaries
Gamepad input is read by the browser and rendered on the page. The site does not upload button values, axis values, controller names, microphone audio, or generated reports to a server. 在“Switch Pro 手柄测试”页面，请把这个限制视为“Switch Pro 手柄测试”结果的一部分，而不是单独的结论。
Microphone recording starts only after you press the recording button and grant browser permission. Playback and deletion happen locally in the browser. 使用此“Switch Pro 手柄测试”页面时，请把这条说明与特定设备的映射行为、连接方式差异、输入症状和功能暴露的实时模块一起判断。
Browser and hardware limits
Gamepad API support, haptic feedback, MediaRecorder, and WebHID are exposed differently across Chrome, Edge, Firefox, Safari, Linux, mobile browsers, USB, Bluetooth, and third-party drivers. 在“Switch Pro 手柄测试”页面，请把这个限制视为“Switch Pro 手柄测试”结果的一部分，而不是单独的结论。
A missing feature in the browser does not prove that the controller is damaged. Use the live readings as diagnostic hints and compare results across connection methods when possible. 使用此“Switch Pro 手柄测试”页面时，请把这条说明与特定设备的映射行为、连接方式差异、输入症状和功能暴露的实时模块一起判断。