Magnetometer

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das Magnetometer-Interface der Sensor-APIs liefert Informationen über das Magnetfeld, das vom primären Magnetometersensor des Geräts erfasst wird.

Um diesen Sensor zu verwenden, muss der Benutzer die Berechtigung zum Zugriff auf den 'magnetometer'-Gerätesensor über die Permissions API erteilen. Darüber hinaus kann dieses Feature durch eine auf Ihrem Server festgelegte Permissions Policy blockiert werden.

EventTarget Sensor Magnetometer

Konstruktor

Magnetometer() Experimentell

Erstellt ein neues Magnetometer-Objekt.

Instanzeigenschaften

Magnetometer.x Schreibgeschützt Experimentell

Gibt ein double zurück, das das Magnetfeld um die x-Achse des Geräts enthält.

Magnetometer.y Schreibgeschützt Experimentell

Gibt ein double zurück, das das Magnetfeld um die y-Achse des Geräts enthält.

Magnetometer.z Schreibgeschützt Experimentell

Gibt ein double zurück, das das Magnetfeld um die z-Achse des Geräts enthält.

Instanzmethoden

Das Magnetometer hat keine eigenen Methoden. Es erbt jedoch Methoden von seinen übergeordneten Schnittstellen, Sensor und EventTarget.

Ereignisse

Das Magnetometer hat keine eigenen Ereignisse. Es erbt jedoch Ereignisse von seiner übergeordneten Schnittstelle, Sensor.

Beispiel

Das Magnetometer wird typischerweise im reading-Ereignis-Callback gelesen. Im untenstehenden Beispiel geschieht dies sechzig Mal pro Sekunde.

js
let magSensor = new Magnetometer({ frequency: 60 });

magSensor.addEventListener("reading", (e) => {
  console.log(`Magnetic field along the X-axis ${magSensor.x}`);
  console.log(`Magnetic field along the Y-axis ${magSensor.y}`);
  console.log(`Magnetic field along the Z-axis ${magSensor.z}`);
});
magSensor.start();

Spezifikationen

Specification
Magnetometer
# magnetometer-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Magnetometer
Experimental
Magnetometer() constructor
Experimental
x
Experimental
y
Experimental
z
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
User must explicitly enable this feature.