UD5工具箱
常见问题
手柄按钮序列录制器的工作原理是什么？
本工具基于浏览器原生的Web Gamepad API实现。当您在页面上点击"开始录制"后，工具会按照您设定的采样率频率（例如每秒60次、30次等）调用navigator.getGamepads()方法来读取当前手柄的完整状态，包括所有按钮的按下状态、摇杆的X/Y轴位置以及扳机的行程值。每次采样得到的状态数据会作为一个"帧"保存到内存中的录制序列里，同时记录该帧的时间戳。录制结束后，这些帧数据被组织成完整的录制对象，可以进行回放、导出等操作。
本工具支持哪些类型的手柄？
理论上，所有被操作系统识别且符合HID标准的游戏手柄都可以被本工具使用。这包括但不限于：Xbox Series X/S手柄、Xbox One手柄、Xbox 360手柄（需有线连接）、PlayStation DualSense手柄、DualShock 4手柄、Nintendo Switch Pro手柄、以及大量第三方手柄如雷蛇、赛睿、罗技等品牌的产品。需要特别注意的是，不同手柄的按钮映射可能有所不同，界面上的可视化显示会根据标准Gamepad Layout进行适配。
我的手柄连接后没有被检测到，怎么办？
如果手柄连接后未被识别，请按以下步骤排查：首先确认手柄已通过USB线缆或蓝牙正确连接到电脑，可以在操作系统的设备管理器中查看是否出现手柄设备。其次，请确保使用的是现代浏览器（Chrome 65+、Edge 79+、Firefox 84+、Safari 13.1+），较旧的浏览器可能不支持Gamepad API。然后刷新本工具页面，有时需要在手柄已连接的状态下刷新页面才能正确识别。部分手柄可能需要特定的驱动程序，例如某些Xbox 360手柄在Windows上需要安装Microsoft的官方驱动。最后，请确保浏览器有权限访问Gamepad API，某些安全策略可能会限制该接口的使用。
录制的数据保存在哪里？安全吗？
所有录制数据都保存在您当前使用的浏览器的本地存储中，不会上传到任何远程服务器。数据存储在浏览器的内存和IndexedDB中，当您关闭页面或刷新浏览器后，如果没有主动导出，录制数据将会丢失。因此建议在录制完成后及时导出为JSON文件进行备份。从数据安全的角度来说，由于数据完全在本地处理和存储，不存在数据泄露的风险。但如果您的电脑被他人使用，请注意浏览器数据的安全保护。您也可以在工具中清除所有录制数据以确保彻底删除。
回放能否真正控制游戏？
不能。本工具的回放功能仅在工具内部模拟和重显录制时的手柄状态，并不会向操作系统或外部游戏发送真实的按键输入信号。换句话说，回放时可视化界面上会正确显示录制的操作序列，但如果您同时打开了一个游戏，该游戏并不会接收到这些回放的输入。如果需要在游戏中实现真实的输入回放功能，需要使用专门的输入模拟工具或驱动级别的解决方案。本工具的定位是帮助开发者录制、分析和验证手柄输入数据，而非直接控制游戏。
我应该选择哪种采样率？
采样率的选择取决于您的具体测试需求。60fps采样率适合需要精确捕捉快速连招和复杂操作时序的场景，例如格斗游戏的帧精确测试或节奏游戏的输入时序验证。30fps采样率在精度和数据量之间取得了良好平衡，适合大多数常规的游戏测试和UI交互测试。20fps采样率进一步降低了数据量，适合持续时间较长的操作录制。10fps采样率适合仅需记录大致操作流程而不需要精确时序信息的场景。建议从30fps开始，根据实际需要逐步调整。
本工具在哪些浏览器上可以正常使用？
本工具支持所有实现了Gamepad API的现代浏览器。推荐使用Chrome 65及以上版本或Edge 79及以上版本，这两个浏览器对Gamepad API的支持最为完善和稳定。Firefox 84及以上版本同样提供了良好的Gamepad API支持。Safari 13.1及以上版本也支持Gamepad API，但在某些Mac设备上可能存在蓝牙手柄连接的兼容性问题。建议在使用前将浏览器更新到最新版本。不推荐使用Internet Explorer等老旧浏览器，它们不支持Gamepad API。