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.

Die Magnetometer-Schnittstelle der Sensor-APIs liefert Informationen über das Magnetfeld, wie es vom primären Magnetometersensor des Geräts erkannt wird.

Um diesen Sensor zu verwenden, muss der Benutzer über die Permissions API die Erlaubnis für den 'magnetometer'-Gerätesensor erteilen. Darüber hinaus kann diese Funktion durch eine auf Ihrem Server festgelegte Berechtigungsrichtlinie 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

Magnetometer besitzt keine eigenen Methoden. Allerdings erbt es Methoden von seinen übergeordneten Schnittstellen, Sensor und EventTarget.

Ereignisse

Magnetometer besitzt keine eigenen Ereignisse. Allerdings erbt es Ereignisse von seiner übergeordneten Schnittstelle, Sensor.

Beispiel

Das Magnetometer wird typischerweise im reading-Ereignis-Callback ausgelesen. Im folgenden Beispiel geschieht dies sechzigmal 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