Window: devicemotion-Ereignis

Baseline 2023

Newly 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 Intervallen ausgelöst und gibt die Beschleunigungsrate des Geräts mit/ohne Berücksichtigung der Gravitation an diesem Zeitpunkt an. Es liefert auch Informationen über die Rotationsrate, falls verfügbar.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht propagiert.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("devicemotion", (event) => {});

ondevicemotion = (event) => {};

Ereignistyp

Ein DeviceMotionEvent, das von Event erbt.

Event DeviceMotionEvent

Ereigniseigenschaften

DeviceMotionEvent.acceleration Schreibgeschützt

Ein Objekt, das die Beschleunigung des Geräts auf den drei Achsen x, y und z angibt. Die Beschleunigung wird in m/s² ausgedrückt.

DeviceMotionEvent.accelerationIncludingGravity Schreibgeschützt

Ein Objekt, das die Beschleunigung des Geräts auf den drei Achsen x, y und z unter Berücksichtigung der Gravitation angibt. 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 alpha, beta und gamma angibt. Die Rotationsrate wird in Grad pro Sekunde ausgedrückt.

DeviceMotionEvent.interval Schreibgeschützt

Eine Zahl, die das Zeitintervall in Millisekunden darstellt, in dem Daten vom Gerät bezogen werden.

Beispiele

js
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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch