UD5工具箱
术语表
Gamepad API
Gamepad API是W3C制定的Web标准接口，允许JavaScript程序通过浏览器访问和读取游戏手柄设备的输入数据。它提供了手柄的按钮状态、摇杆位置、扳机行程等信息的标准化访问方式。Gamepad API支持所有符合HID标准的游戏手柄设备，包括Xbox、PlayStation、Switch Pro等主流手柄。该API是本工具实现手柄检测和数据采集的核心技术基础。
采样率
采样率指的是在录制过程中每秒钟采集手柄输入数据的次数，单位为fps（frames per second，帧每秒）。采样率越高，录制的数据越精确地反映手柄状态的实时变化，但同时也会产生更大的数据量。在手柄按钮序列录制器中，提供60fps、30fps、20fps和10fps四种采样率选项供用户选择。60fps对应大多数游戏的运行帧率，能够完整捕捉每一次按键操作。
回放速度
回放速度是指在重放已录制的操作序列时的时间缩放比例。1倍速度表示按照录制时的原始速度进行回放，0.5倍速度则为原始速度的一半，以此类推。本工具提供0.25x、0.5x、1x、2x、3x和4x共六种回放速度。慢速回放用于精细分析操作时序，快速回放用于快速验证和批量测试场景。
按钮映射
按钮映射（Button Mapping）是指将手柄上的物理按钮与软件层面的数字标识符建立对应关系的过程。不同的手柄制造商可能使用不同的按钮命名和编号规则，Gamepad API通过标准化的索引编号和按钮名称来统一处理这些差异。常见的按钮映射标准包括标准游戏手柄映射（Standard Gamepad Layout），它定义了A/B/X/Y、十字键、扳机等按钮的标准位置。
摇杆死区
摇杆死区（Dead Zone）是指摇杆中心附近的一个区域，在此区域内摇杆的微小位移不会被识别为有效的输入。这是为了防止摇杆在自然状态下因物理特性产生的微小漂移导致误操作。在手柄测试中，了解摇杆死区的设置对于精确测试摇杆的灵敏度和响应特性非常重要。不同手柄的默认死区设置可能有所不同。
JSON格式
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，以文本方式存储和传输结构化数据。本工具使用JSON格式来导出和导入录制数据，其中包含了录制的元数据（如采样率、时间戳、持续时长）以及逐帧的按钮和摇杆状态数据。JSON格式具有可读性强、体积小、通用性好的优点，非常适合用于测试数据的存储和团队间共享。
HID协议
HID（Human Interface Device）协议是一种广泛使用的USB设备通信标准，最初为键盘鼠标等输入设备设计，后来也被应用于游戏手柄。大多数现代游戏手柄都通过HID协议与主机通信。Gamepad API在底层依赖于操作系统的HID接口来访问手柄设备。了解HID协议有助于理解为什么某些特殊手柄可能需要额外的驱动程序才能被浏览器识别。