Kompass

Verwendung von @capgo/capacitor-compass

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

Installieren

bun add @capgo/capacitor-compass
bunx cap sync

Was dieser Plugin bereitstellt

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

Beispielanwendung

getCurrentHeading

Ermitteln Sie den aktuellen Kompasswinkel in Grad. Bei iOS wird der Winkel im Hintergrund aktualisiert und der neueste Wert wird zurückgegeben. Bei Android wird der Winkel mithilfe von Beschleunigungssensor und Magnetometer berechnet, wenn die Methode aufgerufen wird. 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 des Kompasswinkels über Ereignisse. Dies startet die Kompass-Sensoren und emittiert 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

Beenden Sie das Abhören von Änderungen des Kompasswinkels. Dies stoppt die Kompass-Sensoren und stoppt die Ereignis-Emission.

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

await CapgoCompass.stopListening();

checkPermissions

Überprüfen Sie den aktuellen Berechtigungsstatus für den Zugriff auf Kompass-Daten. Bei iOS wird die Standortberechtigung überprüft. Bei Android wird immer 'erlaubt' 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/

Weitermachen 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 die API-Operationen zu planen und zu verbinden @capgo/capacitor-Kompass zur Implementierungsdetail in @capgo/capacitor-Kompass Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten API-Übersicht zur Implementierungsdetail in API-Übersicht Einführung zur Implementierungsdetail in Einführung und API-Schlüssel zur Implementierungsdetail in API-Schlüssel.