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 となります。

値

accelerationIncludingGravity プロパティは、3 軸の加速度に関する情報を指定されたオブジェクトです。それぞれの軸は、自分自身でプロパティを使って表します。

x

西から東へ向かう軸である X 軸の加速度を表します。

y

南から北へ向かう軸である Y 軸の加速度を表します。

z

下から上へ向かう軸である Z 軸の加速度を表します。

仕様書

Specification
DeviceOrientation Event Specification
# ref-for-dom-devicemotionevent-accelerationincludinggravity④

ブラウザーの互換性

BCD tables only load in the browser

関連情報