OrientationSensor
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.
Die OrientationSensor
-Schnittstelle der Sensor APIs ist die Basisklasse für Orientierungssensoren. Diese Schnittstelle kann nicht direkt verwendet werden. Stattdessen bietet sie Eigenschaften und Methoden, auf die über Schnittstellen zugegriffen wird, die von ihr erben.
Diese Funktion kann durch eine auf Ihrem Server gesetzte Permissions Policy blockiert werden.
Schnittstellen basierend auf OrientationSensor
Nachfolgend finden Sie eine Liste von Schnittstellen, die auf der OrientationSensor-Schnittstelle basieren.
Instanz-Eigenschaften
OrientationSensor.quaternion
Nur lesbar-
Gibt ein vierteiliges
Array
zurück, dessen Elemente die Komponenten des Einheitsquaternions enthalten, das die Ausrichtung des Geräts darstellt.
Instanz-Methoden
OrientationSensor.populateMatrix()
-
Befüllt das angegebene Objekt mit der Rotationsmatrix basierend auf der neuesten Sensorablesung.
Beispiele
Einfaches Beispiel
Das folgende Beispiel, das lose auf Intels Orientation Phone-Demo basiert, instanziiert einen AbsoluteOrientationSensor
mit einer Frequenz von 60 Mal pro Sekunde. Bei jeder Ablesung verwendet es OrientationSensor.quaternion
, um ein visuelles Modell eines Telefons zu drehen.
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();
Berechtigungsbeispiel
Die Verwendung von Orientierungssensoren erfordert das Anfordern von Berechtigungen für mehrere Gerätesensoren. Da die Permissions
-Schnittstelle Versprechungen verwendet, ist ein guter Weg, um Berechtigungen anzufordern, die Verwendung von 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.");
}
});
Spezifikationen
Specification |
---|
Orientation Sensor # orientationsensor-interface |
Browser-Kompatibilität
BCD tables only load in the browser