裝置方向事件

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

裝置方向事件允許您檢測裝置的物理方向,並允許您檢測裝置的運動

概念與用法

移動裝置通常配備有陀螺儀、指南針和加速度計等感測器,這些感測器可以使裝置上的應用程式檢測裝置的朝向和運動。

裝置方向事件使您能夠編寫 Web 應用程式,這些應用程式可以根據使用者裝置的朝向更改其行為,並在使用者移動裝置時做出響應。

您可能希望使用裝置方向事件的一些典型功能包括:

  • 在基於 Web 的遊戲中,允許使用者透過傾斜和移動裝置來控制遊戲中角色或物件的運動

  • 在地圖應用程式中,根據裝置位置重新定向地圖,或提供隨使用者移動而更新的逐嚮導航

  • 用於手勢識別 — 例如,識別“搖晃”手勢並用它來執行某些操作,例如當用戶搖晃裝置時清除輸入區域

注意:此 API 在移動瀏覽器上得到廣泛支援。雖然一些僅限桌面使用的瀏覽器由於硬體差異可能存在限制,但鑑於該 API 主要在配備感測器的裝置上使用,這些限制很少會很顯著。

介面

DeviceMotionEvent

表示裝置加速的變化以及旋轉速率。

DeviceMotionEventAcceleration

表示裝置在所有三個軸上經歷的加速度。

DeviceMotionEventRotationRate

表示裝置繞所有三個軸旋轉的速率。

DeviceOrientationEvent

表示裝置物理方向的變化。

其他介面的擴充套件

devicemotion 事件

以固定間隔觸發,以指示裝置在此時接收到的加速度的物理力大小以及裝置的旋轉速率。

deviceorientation 事件

當裝置提供關於裝置相對於地球座標系的當前方向的新資料時觸發。

deviceorientationabsolute 事件

當絕對裝置方向發生變化時觸發。

規範

規範
裝置方向和運動

瀏覽器相容性

api.Window.deviceorientation_event

api.Window.devicemotion_event

api.Window.deviceorientationabsolute_event

api.DeviceOrientationEvent

api.DeviceMotionEvent

api.DeviceMotionEventAcceleration

api.DeviceMotionEventRotationRate

另見