Compass

Mit @capgo/capacitor-compass

Capacitor Compass-Plugin-Schnittstelle für das Lesen des Gerätekompasseinschlags.

Installieren

bun add @capgo/capacitor-compass
bunx cap sync

Was dieses Plugin freigibt

• getCurrentHeading - Der aktuelle Kompasseinschlag in Grad abrufen. Bei iOS wird der Einschlag im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Bei Android wird der Einschlag bei Aufruf der Methode mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web.
• startListening - Kompass-Einschlagsänderungen über Ereignisse abrufen. Dies startet die Kompass-Sensoren und emittiert Ereignisse vom Typ 'headingChange'.
• stopListening - Abhören von Kompass-Einschlagsänderungen beenden. Dies stoppt die Kompass-Sensoren und stoppt die Ereignisausgabe.
• checkPermissions - Überprüfen der aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Bei iOS wird die Standortberechtigung überprüft. Bei Android wird immer 'erlaubt' zurückgegeben, da keine Berechtigungen erforderlich sind.

Beispiel-Verwendung

getCurrentHeading

Der aktuelle Kompasseinschlag in Grad abrufen. Bei iOS wird der Einschlag im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Bei Android wird der Einschlag bei Aufruf der Methode mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web.

import { CapgoCompass } from '@capgo/capacitor-compass';

const { value } = await CapgoCompass.getCurrentHeading();
console.log('Compass heading:', value, 'degrees');

startListening

Starten Sie das Abhören von Änderungen der Kompassrichtung über Ereignisse. Dies startet die Kompasssensor und sendet Ereignisse vom Typ 'headingChange'.

import { CapgoCompass } from '@capgo/capacitor-compass';

// With default throttling (100ms interval, 2° minimum change)
await CapgoCompass.startListening();

// With custom throttling for high-frequency updates
await CapgoCompass.startListening({
  minInterval: 50,      // 50ms between events
  minHeadingChange: 1.0 // 1° minimum change
});

CapgoCompass.addListener('headingChange', (event) => {
  console.log('Heading:', event.value);
});

stopListening

Stoppen Sie das Abhören von Änderungen der Kompassrichtung. Dies stoppt die Kompasssensor und stoppt die Ereignisausgabe.

import { CapgoCompass } from '@capgo/capacitor-compass';

await CapgoCompass.stopListening();

checkPermissions

Überprüfen Sie den aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Auf iOS überprüft dies die Standortberechtigung. Auf Android wird immer 'granted' zurückgegeben, da keine Berechtigungen erforderlich sind.

import { CapgoCompass } from '@capgo/capacitor-compass';

const status = await CapgoCompass.checkPermissions();
console.log('Compass permission:', status.compass);

Vollständige Referenz

• GitHub: https://github.com/Cap-go/capacitor-kompass/
• Dokumentation: /docs/plugins/compass/

Fortsetzen Sie von Using @capgo/capacitor-kompass

Wenn Sie "@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-kompass" verwenden Verwenden Sie @capgo/capacitor-kompass um das Dashboard und API-Betrieb zu planen, verbinden Sie es mit @capgo/capacitor-kompass für die Implementierungsdetails in @capgo/capacitor-compass, Einstieg für die Implementierungsdetails in Einstieg, API Übersicht für die Implementierungsdetails in API Übersicht, Einführung für die Implementierungsdetails in Einführung, und API Schlüssel für die Implementierungsdetails in API Schlüssel.