WG手柄资料里,按钮已按下和按钮数值为什么要分开?

浏览器 Gamepad 接口能分别报告按钮是否按下与按下的数值。模拟量按钮可在零到一之间变化,是否按下由设备或浏览器按阈值判断。查 WG相关手柄资料时,应记下用的是哪个控制器和哪一个按钮。

在同一个按钮上看两类数据

W3C 的 Gamepad 接口将按钮的状态和数值表示成不同字段。pressed 提供是否按下的状态,value 表示标准化到零至一范围的量。用网页检测工具观察时,先选一个实际控制器,再从完全松开开始,试着缓慢按下其中一个按键。逐次记录显示的按钮编号、状态和值。某些硬件按键只会跳到两个端点,另一些扳机按压时可以看到中间数值。把这两种例子分别记下来,有助于说明浏览器检测到了怎样的输入。测试纸上可安排松开、轻按、按到底三个位置,并给每一次采样留时间。若只记下最深的一次,就无法展示数值和布尔状态何时一起改变。

状态阈值和界面操作要单独核对

W3C 规范对具有模拟量的按钮描述了按下状态如何取值,硬件可提供判断,也可能由浏览器选择阈值。写资料时,可将接口报告为已按下与页面看到某种动作分别记录。假设某网页显示了扳机在改变,但界面要在更深位置才执行动作,这时应该先对照页面采用的是按钮状态还是自设门槛。如果没有网页实现说明,可以只记输入变化和实际操作效果,不为它指定原因。比较另一款手柄时也要注明按键布局和浏览器报告的映射。界面说明若仅写第六键,读者可以照着状态表查看自己触发的是哪个编号,再与设备标识核对。

按三段记录可以区分设备差异和页面差异

从松开开始,分别记录数值和状态。随后慢慢增加按压力度,观察从什么状态变化成已按下。最后松手看数值是否回到原来位置。比较两台设备时保持同一网页、同样的动作顺序,并写下两边设备的名称、连接方式和浏览器。读取不到时,先记录浏览器是否识别设备以及有没有输入,再查工具的支持说明。对于 WG相关资料,用这一张记录只能说明当前环境识别了哪些标准输入。某个应用能不能使用该输入,仍要在应用自己给出的合法测试条件下看控制说明或逐项验证。不给未测试的设备作结果判断,读者才能据此复现观察。

常见问题

Q1 问:按钮值为零到一是什么意思?

A1 答:这是接口为按钮数值给出的标准化范围。对应到实际设备的压力或位置需要具体检测。

Q2 问:数值已经大于零,pressed 一定为真吗?

A2 答:要看设备或浏览器对按下状态的判断。观察时两项应分别记录。

Q3 问:看到网页有按键变化就能判断所有应用可用吗?

A3 答:当前结果说明网页读到了输入。应用是否使用同样的映射要另查。