DeviceMotionEvent: accelerationIncludingGravity プロパティ
Baseline 2023
Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
accelerationIncludingGravity
プロパティは、端末が記録した加速度をメートル毎秒毎秒 (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 となります。
値
仕様書
Specification |
---|
Device Orientation and Motion # ref-for-dom-devicemotionevent-accelerationincludinggravity④ |
ブラウザーの互換性
BCD tables only load in the browser