Verwendung von @capgo/capacitor-compass

Capacitor Compass-Plugin-Schnittstelle für die Lesung der Gerätekompasseinstellung.

Installieren

bun add @capgo/capacitor-compass
bunx cap sync

Was dieses Plugin bereitstellt

getCurrentHeading - Aktuelle Kompasseinstellung in Grad abrufen. Auf iOS wird die Einstellung im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Auf Android wird die Einstellung, wenn der Methodenaufruf erfolgt, mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web.
startListening - Hört auf Kompass-Einstellungsänderungen via Ereignisse zu. Dies startet die Kompass-Sensoren und emittiert Ereignisse vom Typ 'headingChange'.
stopListening - Hört auf Kompass-Einstellungsänderungen auf. Dies stoppt die Kompass-Sensoren und stoppt die Ereignisemission.
checkPermissions - Überprüfe den aktuellen Berechtigungsstatus für den Zugriff auf Kompass-Daten. Auf iOS wird die Standortberechtigung überprüft. Auf Android wird immer 'erlaubt' zurückgegeben, da keine Berechtigungen erforderlich sind.

Beispiel für die Verwendung

`getCurrentHeading`

- Aktuelle Kompasseinstellung in Grad abrufen. Auf iOS wird die Einstellung im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Auf Android wird die Einstellung, wenn der Methodenaufruf erfolgt, 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 Kompasssensoren 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 Kompasssensoren 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-compass/
Dokumentation: /docs/plugins/compass/

Fortsetzen Sie von Using @capgo/capacitor-compass

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-compass verwenden Verwenden Sie @capgo/capacitor-compass Um das Dashboard und API-Betrieb zu planen, verbinden Sie es mit Verbinden Sie @capgo/capacitor-compass 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.

Kompass

Anleitung