Датчик ориентации

Интерфейс OrientationSensor из API датчиков является базовым классом для датчиков ориентации. Этот интерфейс нельзя использовать напрямую. Вместо этого он предоставляет свойства и методы, к которым обращаются интерфейсы, наследующие от него.

Эта функция может быть заблокирована политикой Разрешений, установленной на вашем сервере.

Ниже приведен список интерфейсов, основанных на интерфейсе OrientationSensor.

• AbsoluteOrientationSensor
• RelativeOrientationSensor

OrientationSensor.quaternion Только для чтения

Возвращает массив Array из четырёх элементов, содержащих компоненты единичного кватерниона, представляющего ориентацию устройства.

OrientationSensor.populateMatrix()

Заполняет заданный объект матрицей вращения на основе последнего считывания датчика.

Следующий пример, частично основанный на демонстрации Intel Orientation Phone, создаёт AbsoluteOrientationSensor с частотой 60 раз в секунду. При каждом считывании он использует OrientationSensor.quaternion для вращения визуальной модели телефона.

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.all.

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.");
  }
});