DeviceMotionEvent:accelerationIncludingGravity 属性

基线 2023

新发布

2023 年 9 月起,此功能在最新的设备和浏览器版本中均有效。此功能可能在旧版设备或浏览器中无效。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在部分或所有支持浏览器中可用。

accelerationIncludingGravityDeviceMotionEvent 接口的只读属性,它返回设备记录的加速度,单位为米每平方秒 (m/s²)。与DeviceMotionEvent.acceleration 相比,该属性不补偿重力的影响,它的值是用户引起的设备加速度和与重力引起的加速度大小相等、方向相反的加速度的总和。换句话说,它测量的是重力加速度。实际上,此值表示由加速度计测量的原始数据。

此值通常不如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 轴上的加速度,即上下轴

规范

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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅