RelativeOrientationSensor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das RelativeOrientationSensor-Interface der Sensor APIs beschreibt die physikalische Ausrichtung des Geräts, ohne das Bezugssystem der Erde zu berücksichtigen.

Um diesen Sensor zu verwenden, muss der Benutzer die Berechtigung für die Gerätesensoren 'accelerometer' und 'gyroscope' über die Permissions API erteilen. Zusätzlich kann dieses Feature durch eine auf Ihrem Server gesetzte Permissions Policy blockiert werden.

Konstruktor

RelativeOrientationSensor(): Erstellt ein neues RelativeOrientationSensor-Objekt.

Instanz-Eigenschaften

Keine spezifischen Eigenschaften; erbt Eigenschaften von seinen Vorfahren OrientationSensor und Sensor.

Instanz-Methoden

Keine spezifischen Methoden; erbt Methoden von seinen Vorfahren OrientationSensor und Sensor.

Ereignisse

Keine spezifischen Ereignisse; erbt Ereignisse von seinem Vorfahren, Sensor.

Beispiele

Einfaches Beispiel

Das folgende Beispiel, das lose auf Intels Orientation Phone Demo basiert, instanziiert ein RelativeOrientationSensor mit einer Frequenz von 60 Mal pro Sekunde.

Hinweis: Das Intel-Demo, auf dem dieses basiert, verwendet den AbsoluteOrientationSensor. Bei jeder Messung wird OrientationSensor.quaternion verwendet, um ein visuelles Modell eines Telefons zu drehen.

const options = { frequency: 60, referenceFrame: "device" };
const sensor = new RelativeOrientationSensor(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();

Berechtigungsbeispiel

Die Verwendung von Orientierungssensoren erfordert das Anfordern von Berechtigungen für mehrere Gerätesensoren. Da das Permissions-Interface Versprechen verwendet, ist es eine gute Methode, Berechtigungen mit Promise.all anzufordern.

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

Spezifikationen

Specification
Orientation Sensor # relativeorientationsensor-interface

Browser-Kompatibilität

BCD tables only load in the browser