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 Abständen ausgelöst und zeigt die Beschleunigungsrate des Geräts mit/ohne den Beitrag der Schwerkraft zu diesem Zeitpunkt an. Es liefert auch Informationen über die Rotationsrate, falls verfügbar.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

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 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 mit dem Einfluss der Schwerkraft angibt. Die Beschleunigung wird in m/s² ausgedrückt.
DeviceMotionEvent.rotationRate Schreibgeschützt: Ein Objekt, das die Änderungsrate der Ausrichtung 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 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