DeviceMotionEvent: accelerationIncludingGravity 属性

Baseline 2023
新推出

自 2023 年 9 月起,此功能可在最新的设备和浏览器版本上使用。此功能可能无法在较旧的设备或浏览器上使用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

accelerationIncludingGravityDeviceMotionEvent 接口的一个只读属性,它以 米/秒² (m/s²) 为单位返回设备记录的加速度。与 DeviceMotionEvent.acceleration(它会补偿重力的影响)不同,该属性的值是用户引起的设备加速度与重力引起的加速度(方向相反)的总和。换句话说,它测量的是 重力加速度(g-force)。实际上,这个值代表了 加速度计 测量的原始数据。

这个值通常不如 DeviceMotionEvent.acceleration 有用,但它可能是无法从加速度数据中移除重力的设备(例如没有陀螺仪的设备)上唯一可用的值。

注意:accelerationIncludingGravity 的名称可能会引起误解。该属性表示包含重力影响的加速度。例如,如果设备平放在水平表面上,屏幕朝上,则 Z 轴上的重力为 -9.8,而 acceleration.z 为 0,accelerationIncludingGravity.z 为 9.8。同样,如果设备在自由落体中,屏幕水平且朝上,则 Z 轴上的重力为 -9.8,而 acceleration.z 为 -9.8,accelerationIncludingGravity.z 为 0。

accelerationIncludingGravity 属性是一个提供三个轴上加速度信息的对象。每个轴都用自己的属性表示。

x

表示 X 轴上的加速度,即西到东方向。

y

表示 Y 轴上的加速度,即南到北方向。

z

表示 Z 轴上的加速度,即向下到向上的方向。

规范

规范
设备方向和运动
# dom-devicemotionevent-accelerationincludinggravity

浏览器兼容性

另见