Device orientation events
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Geräteorientierungsereignisse sind Ereignisse, die es ermöglichen, die physikalische Ausrichtung eines Geräts zu erkennen sowie die Bewegung des Geräts zu detektieren.
Konzepte und Verwendung
Mobile Geräte verfügen häufig über Sensoren wie Gyroskope, Kompasse und Beschleunigungsmesser, die es Anwendungen auf dem Gerät ermöglichen, die Ausrichtung und Bewegung des Geräts zu erkennen.
Die Geräteorientierungsereignisse ermöglichen es Ihnen, Webanwendungen zu schreiben, die ihr Verhalten basierend auf der Ausrichtung des Benutzergeräts ändern und reagieren können, wenn der Benutzer das Gerät bewegt.
Einige typische Funktionen, für die Sie die Geräteorientierungsereignisse nutzen möchten, umfassen:
-
in webbasierten Spielen, um dem Benutzer zu ermöglichen, die Bewegung von Charakteren oder Objekten im Spiel durch Kippen und Bewegen des Geräts zu steuern
-
in Kartierungsanwendungen, um eine Karte basierend auf der Position des Geräts neu zu orientieren oder Schritt-für-Schritt-Anweisungen bereitzustellen, die sich mit den Bewegungen des Benutzers aktualisieren
-
für Gestenerkennung — beispielsweise das Erkennen einer "Shake"-Geste und deren Verwendung, um eine Aktion wie das Löschen eines Eingabebereichs auszuführen, wenn der Benutzer das Gerät schüttelt
Einige Benutzeragenten erfordern eine ausdrückliche Erlaubnis, bevor sie den Zugriff auf Sensordaten gestatten. In diesen Umgebungen können DeviceMotionEvent.requestPermission() und DeviceOrientationEvent.requestPermission() verwendet werden, um diese Erlaubnis über eine flüchtige Benutzeraktivierung wie einen Tastendruck anzufordern. Weitere Details finden Sie unter Erlaubnis anfordern.
Hinweis: Diese API wird in mobilen Browsern weitgehend unterstützt. Während einige nur für Desktops konzipierte Browser aufgrund von Hardwareunterschieden Einschränkungen aufweisen können, sind diese Einschränkungen selten bedeutsam, da die API hauptsächlich auf sensorausgestatteten Geräten verwendet wird.
Schnittstellen
DeviceMotionEvent-
Repräsentiert Änderungen in der Beschleunigung eines Geräts sowie die Rotationsrate.
DeviceMotionEventAcceleration-
Repräsentiert die Menge an Beschleunigung, die das Gerät entlang aller drei Achsen erfährt.
DeviceMotionEventRotationRate-
Repräsentiert die Geschwindigkeit, mit der das Gerät um alle drei Achsen rotiert.
DeviceOrientationEvent-
Repräsentiert Änderungen in der physikalischen Ausrichtung eines Geräts.
Erweiterungen zu anderen Schnittstellen
devicemotionEreignis-
Wird in regelmäßigen Abständen ausgelöst, um die Menge an physikalischer Beschleunigungskraft anzuzeigen, die das Gerät zu diesem Zeitpunkt erfährt, und die Rotationsgeschwindigkeit des Geräts.
deviceorientationEreignis-
Wird ausgelöst, wenn frische Daten vom Gerät über die aktuelle Ausrichtung des Geräts im Vergleich zum Koordinatensystem der Erde verfügbar sind.
deviceorientationabsoluteEreignis-
Wird ausgelöst, wenn sich die absolute Geräteausrichtung ändert.
Spezifikationen
| Specification |
|---|
| Device Orientation and Motion> |
Browser-Kompatibilität
>api.Window.deviceorientation_event
api.Window.devicemotion_event
api.Window.deviceorientationabsolute_event
api.DeviceOrientationEvent
api.DeviceMotionEvent
api.DeviceMotionEventAcceleration
api.DeviceMotionEventRotationRate
Siehe auch
- Device Orientation & Motion bei web.dev