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。