Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

DeviceOrientationEvent

Baseline
Weitgehend verfügbar
*

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2023 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

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

Die DeviceOrientationEvent-Schnittstelle der Device Orientation Events stellt Webentwicklern Informationen über die räumliche Ausrichtung des Geräts bereit, auf dem die Webseite ausgeführt wird.

Event DeviceOrientationEvent

Konstruktor

DeviceOrientationEvent.DeviceOrientationEvent()

Erstellt ein neues DeviceOrientationEvent.

Instanzeigenschaften

DeviceOrientationEvent.absolute Schreibgeschützt

Ein boolescher Wert, der angibt, ob das Gerät absolute Ausrichtungsdaten bereitstellt.

DeviceOrientationEvent.alpha Schreibgeschützt

Eine Zahl, die die Drehung des Geräts um die z-Achse in Grad angibt. Der Wertebereich reicht von 0 (einschließlich) bis 360 (ausschließlich).

DeviceOrientationEvent.beta Schreibgeschützt

Eine Zahl, die die Drehung des Geräts um die x-Achse in Grad angibt. Der Wertebereich reicht von -180 (einschließlich) bis 180 (ausschließlich). Dies beschreibt eine Vorwärts- und Rückwärtsbewegung des Geräts.

DeviceOrientationEvent.gamma Schreibgeschützt

Eine Zahl, die die Drehung des Geräts um die y-Achse in Grad angibt. Der Wertebereich reicht von -90 (einschließlich) bis 90 (ausschließlich). Dies beschreibt eine Bewegung des Geräts nach links und rechts.

DeviceOrientationEvent.webkitCompassHeading Schreibgeschützt

Eine Zahl, die den Winkel zwischen der Ausrichtung des Geräts um die z-Achse des Weltkoordinatensystems und der Nordrichtung in Grad angibt. Der Wertebereich reicht von 0 bis 360.

DeviceOrientationEvent.webkitCompassAccuracy Schreibgeschützt

Die Genauigkeit des Kompasses gibt die mögliche positive oder negative Abweichung an. Sie beträgt üblicherweise 10.

Statische Methoden

DeviceOrientationEvent.requestPermission()

Fordert die Berechtigung des Benutzers zum Zugriff auf Ausrichtungsdaten des Geräts an. Gibt ein Promise zurück, das mit der Zeichenfolge "granted" oder "denied" erfüllt wird.

Beispiel

js
window.addEventListener("deviceorientation", (event) => {
  console.log(`${event.alpha} : ${event.beta} : ${event.gamma}`);
});

Spezifikationen

Spezifikation
Device Orientation and Motion
# deviceorientation

Browser-Kompatibilität

Siehe auch