端末方向イベント
端末方向イベントは、端末の物理的な方向を検出したり、端末の動きを検出したりするイベントです。
概念と使用方法
モバイル端末には、一般的にジャイロスコープ、コンパス、加速度などのセンサーがあり、端末上で動作するアプリケーションが端末の方向や動きを検出することができます。
方向イベントによって、ユーザーの端末の向きに応じて動作を変えたり、ユーザーが端末を移されたときに反応したりするウェブアプリケーションを書くことができます。
端末方向イベントを使用する典型的な機能には、以下のようなものがあります。
-
ウェブベースのゲームにおいて、ユーザーが端末を傾けたり移動させたりすることによって、ゲーム内のキャラクターやオブジェクトの動きを制御することを可能にすること。
-
地図アプリケーションにおいて、端末の位置に基づいて地図の方向を変えたり、ユーザーの動きに合わせて更新される道順を提供したりするため。
-
ジェスチャー認識 — 例えば、「シェイク」ジェスチャーを認識し、ユーザーが機器を振ったときに入力エリアをクリアするなどのアクションを実行するために使用します。
メモ: この API はモバイルブラウザーが広く対応しています。デスクトップ専用のブラウザーでは、ハードウェアの違いによる制約もありますが、センサーを搭載した端末でのこの API の主な用途を考えると、これらの制約が重要な意味を持つことはほとんどありません。
インターフェイス
DeviceOrientationEvent
-
端末の物理的な方向の変化を表します。
DeviceMotionEvent
-
端末の加速度を、回転数に加えて表します。
DeviceMotionEventAcceleration
-
端末が経験している加速度を、 3 軸すべてで表します。
DeviceMotionEventRotationRate
-
端末が回転する速度を、 3 軸すべてで表します。
イベント
deviceorientation
-
地球座標フレームと比較した端末の現在の方向に関する、新しいデータが端末から利用できるときに発行されます。
devicemotion
-
一定間隔で発行され、その時点で端末が受けている加速度の物理的な力の大きさと、端末の回転速度を示します。
deviceorientationabsolute
-
端末の絶対的な方向が変化したときに発行されます。
仕様書
Specification |
---|
Device Orientation and Motion |
ブラウザーの互換性
api.Window.deviceorientation_event
BCD tables only load in the browser
api.Window.devicemotion_event
BCD tables only load in the browser
api.Window.deviceorientationabsolute_event
BCD tables only load in the browser
api.DeviceOrientationEvent
BCD tables only load in the browser
api.DeviceMotionEvent
BCD tables only load in the browser
api.DeviceMotionEventAcceleration
BCD tables only load in the browser
api.DeviceMotionEventRotationRate
BCD tables only load in the browser
関連情報
- Device Orientation & Motion (web.dev)