OrientationSensor

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

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

OrientationSensor 介面是 感測器 API 的基類,用於方向感測器。此介面不能直接使用。它提供了由繼承它的介面訪問的屬性和方法。

此功能可能會被您伺服器上設定的 Permissions Policy 阻止。

EventTarget Sensor OrientationSensor

基於 OrientationSensor 的介面

以下是基於 OrientationSensor 介面的介面列表。

例項屬性

OrientationSensor.quaternion 只讀

返回一個包含四元素的 Array,其元素包含表示裝置方向的單位四元數的元件。

例項方法

OrientationSensor.populateMatrix()

使用最新的感測器讀數填充給定的物件,其中包含旋轉矩陣。

示例

基本示例

下面的示例(大致基於 Intel 的 Orientation Phone 演示)以每秒 60 次的頻率例項化了一個 AbsoluteOrientationSensor。每次讀取時,它都使用 OrientationSensor.quaternion 來旋轉手機的視覺模型。

js
const options = { frequency: 60, referenceFrame: "device" };
const sensor = new AbsoluteOrientationSensor(options);

sensor.addEventListener("reading", () => {
  // model is a Three.js object instantiated elsewhere.
  model.quaternion.fromArray(sensor.quaternion).inverse();
});
sensor.addEventListener("error", (error) => {
  if (event.error.name === "NotReadableError") {
    console.log("Sensor is not available.");
  }
});
sensor.start();

許可權示例

使用方向感測器需要請求多個裝置感測器的許可權。由於 Permissions 介面使用 Promise,因此請求許可權的一種好方法是使用 Promise.all

js
const sensor = new AbsoluteOrientationSensor();
Promise.all([
  navigator.permissions.query({ name: "accelerometer" }),
  navigator.permissions.query({ name: "magnetometer" }),
  navigator.permissions.query({ name: "gyroscope" }),
]).then((results) => {
  if (results.every((result) => result.state === "granted")) {
    sensor.start();
    // …
  } else {
    console.log("No permissions to use AbsoluteOrientationSensor.");
  }
});

規範

規範
方向感測器
# orientationsensor-interface

瀏覽器相容性