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.

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.

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

BCD tables only load in the browser