DeviceMotionEvent: accelerationIncludingGravity 属性
accelerationIncludingGravity 是 DeviceMotionEvent 接口的一个只读属性,它以 米/秒² (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。