WG手柄资料里的摇杆读数为什么会有负数,而按键常显示零到一?

在 W3C Gamepad 接口里,轴表示可向中心两侧移动的输入,通常规范为负一到正一;按钮的模拟值为零到一。记录 WG手柄相关浏览器资料时,先注明读数属于哪个轴或按钮,再说明实际动作,不把负数当作报错。

为什么轴数值需要正负两边

规范给出的轴值以中心附近为零,并让两个方向分别落入负和正的一侧。横向或纵向的符号对照要看映射说明,不能见到负一就写成向左,因为这也可能是某根纵轴上的读数。试着只移动一个方向一次,写下哪一个数组位置改变,再单独移动另一个方向。若两项都变化,保留两项变化范围,不把它们算成一次按钮按下。

按钮刻度回答的是另一个问题

Gamepad 规范给按钮提供一个零到一之间的模拟值,同时按钮还有是否按下的标记。摇杆轴的负半边用来表达反向偏移,按钮值则主要描述在其输入范围内的程度。因此,某个按钮显示零点三,并不是摇杆向正方向移了三成。给截图标注时可把轴和按钮放在不同的表,不使用“读数”这个大标题而让人猜字段所属。

回到中间未必只看一帧

做一般输入资料记录时,可先让摇杆静置,观察中心附近读数,再分别向两侧移动后放回。若回中读数有轻微变化,只能说明当时观察到了这些值;要讨论设备是否需要校准,还需更长的记录或对应设备文档。不要拿某篇文章的读数作为所有设备的固定门槛。若页面没有读到轴信息,也只记未读出,不把缺失替换成零值。

映射方式不同,要把物理标签保留下来

文档区分标准映射与设备自身的映射。对照时写下实际拨动的部位和浏览器报告的轴序号,并注明接口报告的映射。这样就能区别“右摇杆实际被拨动”和“报告的第二条轴变了”。如果另一台设备的数组顺序不同,先按实际动作重新观察,别把第一台设备的编号复制过去。公开文章写明是标准浏览器机制的例子,不据此保证某款产品的支持情况。如报告有标准映射,横向轴的负值通常对应左、正值对应右,纵向则通常以前后或上下区分。为免不同观看角度导致误读,记录时直接写清“按住手柄的哪一侧移动”。可用同样动作在另一页面看是否得到一致方向,但需保留两次测试的来源与设备条件。

常见问题

Q1 问:摇杆负数代表设备故障吗?

A1 答:不代表;负值可正常表示轴的一个方向。

Q2 问:按钮有负数才算完整范围吗?

A2 答:标准按钮模拟值范围为零到一,不需要负半边。

Q3 问:轴返回零等于没有读到轴吗?

A3 答:不是。零是具体读数;没有相应报告要单列为未读到。