Zu Hauptinhalt springen
Capgo-Logo
Zurück zu Plugins
@capgo/capacitor-compass
Tutorial
@capgo/capacitor-compass

Plugin-Symbol für Compass

Lese den Kompasswinkel des Geräts in Grad mit kontinuierlichen Aktualisierungen und Berechtigungsverwaltung

Downloads/Monat

6,7k

GitHub Sterne

6

Richtlinie

Tutorial zum Kompass

Mit @capgo/capacitor-kompass

Capacitor-Kompass-Plugin-Schnittstelle zur Lesung des Gerätkompasswinkels.

Installieren

bun add @capgo/capacitor-compass
bunx cap sync

Was diese Erweiterung offenlegt

  • getCurrentHeading - Ermitteln Sie den aktuellen Kompasswinkel in Grad. Auf iOS wird der Winkel im Hintergrund aktualisiert und der neueste Wert wird zurückgegeben. Auf Android wird der Winkel, wenn die Methode aufgerufen wird, mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web.
  • startListening - Beginnen Sie mit dem Abhören von Kompasswinkeländerungen über Ereignisse. Dies startet die Kompass-Sensoren und emittiert Ereignisse vom Typ 'headingChange'.
  • stopListening - Beenden Sie das Abhören von Kompasswinkeländerungen. Dies stoppt die Kompass-Sensoren und stoppt die Ereignisemission.
  • checkPermissions - Überprüfen Sie den 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.

Beispielverwendung

getCurrentHeading

Ermitteln Sie den aktuellen Kompasswinkel in Grad. Auf iOS wird der Winkel im Hintergrund aktualisiert und der neueste Wert wird zurückgegeben. Auf Android wird der Winkel, wenn die Methode aufgerufen wird, 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

Beginnen Sie mit dem Abhören von Kompasswinkeländerungen ü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 Kompasswinkeländerungen. Dies stoppt die Kompass-Sensoren und stoppt die Ereignisemission.

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

await CapgoCompass.stopListening();

checkPermissions

Überprüfen Sie den 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.

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

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

Vollständige Referenz

Weitermachen Sie mit der Verwendung von @capgo/capacitor-compass

Wenn Sie die Verwendung von Die Verwendung von @capgo/capacitor-compass um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit @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.