手柄按钮序列录制器 - 记录并回放 Gamepad 操作

本工具基于浏览器内置的 Web Gamepad API 实现，无需安装任何驱动或插件。只需将手柄通过USB或蓝牙连接到电脑，打开本页面即可自动检测。工具会实时读取手柄的按钮按压、摇杆位移、扳机深度等数据，并支持将这些操作序列录制下来进行可视化回放。适用于操作复盘、Speedrun练习分析、手柄状态检测等场景。

兼容所有支持标准Gamepad映射（Standard Mapping）的手柄，包括：
• Xbox Series X/S & Xbox One手柄（Windows/macOS原生支持）
• PlayStation 5 DualSense & PS4 DualShock 4（通过有线连接或蓝牙，Chrome/Edge支持良好）
• Nintendo Switch Pro手柄
• 各类第三方兼容手柄（如8BitDo、PowerA等）
注意：部分手柄在蓝牙模式下可能需要先按一下按钮才能被浏览器检测到，这是浏览器的安全策略。

常见原因及解决方法：
1. 浏览器兼容性：请使用Chrome、Edge或Firefox最新版本。Safari对Gamepad API的支持有限。
2. 需要用户交互：浏览器要求用户先与页面进行交互（如点击页面），然后按下手柄上的任意按钮，手柄才会被识别。
3. 连接问题：尝试重新插拔USB线或重新配对蓝牙。
4. 驱动问题：在Windows上，确保系统已正确识别手柄（可在"设备和打印机"中查看）。
5. HTTP vs HTTPS：某些浏览器在HTTPS环境下对Gamepad API的支持更好。

录制的序列数据默认存储在浏览器的localStorage中，关闭页面后数据依然保留。您也可以使用导出功能将序列保存为JSON文件到本地磁盘，方便备份或分享给他人。导入功能支持加载之前导出的JSON文件。序列数据包含完整的按钮状态、摇杆位置和时间戳信息。

不能。由于浏览器安全沙箱的限制，Web API 不支持模拟或注入游戏手柄输入信号。回放功能是在本工具的手柄可视化界面上重现录制的操作序列，帮助您回顾和分析操作过程。这对于练习复盘、操作演示教学、手柄状态分析等场景非常有用。如果需要实际自动化控制，需要使用专门的硬件或驱动级工具。

• 60fps（16ms）：最高精度，适合捕捉快速连打和精确摇杆操作，但数据量较大。
• 30fps（33ms，默认推荐）：平衡精度与数据量，适合大多数录制场景。
• 20fps（50ms）：适合较慢的操作记录，数据量更小。
• 10fps（100ms）：仅适合粗略记录，数据量最小。
对于Speedrun练习或格斗游戏操作分析，建议使用30fps或60fps以获得更精确的操作时间线。

Web Gamepad API是W3C标准，主流浏览器支持情况：
• Chrome/Edge 35+：✅ 全面支持
• Firefox 29+：✅ 支持良好
• Safari 10.1+：⚠️ 部分支持（macOS较好，iOS有限）
• Opera 22+：✅ 支持
建议使用基于Chromium的浏览器（Chrome/Edge）以获得最佳兼容性和最低延迟。