Window: devicemotion Ereignis
Baseline 2023Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das devicemotion
Ereignis wird in regelmäßigen Abständen ausgelöst und zeigt die Beschleunigungsrate des Geräts an, mit oder ohne Berücksichtigung der Gravitationskraft zu diesem Zeitpunkt. Es liefert auch Informationen über die Rotationsrate, falls verfügbar.
Dieses Ereignis kann nicht abgebrochen werden und löst keine Bubbling-Effekte aus.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("devicemotion", (event) => { })
ondevicemotion = (event) => { }
Ereignistyp
Ein DeviceMotionEvent
. Erbt von Event
.
Ereigniseigenschaften
DeviceMotionEvent.acceleration
Schreibgeschützt-
Ein Objekt, das die Beschleunigung des Geräts in den drei Achsen angibt: x, y und z. Die Beschleunigung wird in m/s² ausgedrückt.
DeviceMotionEvent.accelerationIncludingGravity
Schreibgeschützt-
Ein Objekt, das die Beschleunigung des Geräts in den drei Achsen angibt: x, y und z, unter Berücksichtigung der Schwerkraft. Die Beschleunigung wird in m/s² ausgedrückt.
DeviceMotionEvent.rotationRate
Schreibgeschützt-
Ein Objekt, das die Änderungsrate der Orientierung des Geräts auf den drei Orientierungsachsen angibt: alpha, beta und gamma. Die Rotationsrate wird in Grad pro Sekunde ausgedrückt.
DeviceMotionEvent.interval
Schreibgeschützt-
Eine Zahl, die das Zeitintervall in Millisekunden angibt, in dem Daten vom Gerät abgerufen werden.
Beispiele
function handleMotionEvent(event) {
const x = event.accelerationIncludingGravity.x;
const y = event.accelerationIncludingGravity.y;
const z = event.accelerationIncludingGravity.z;
// Do something awesome.
}
window.addEventListener("devicemotion", handleMotionEvent, true);
Spezifikationen
Specification |
---|
Device Orientation and Motion # devicemotion |
Device Orientation and Motion # ref-for-dom-window-ondevicemotion |