Vai direttamente al contenuto principale
Capgo logo
Torna ai plugin
@capgo/capacitor-compass
Tutorial
di github.com/Cap-go

Compass

Leggi l'orientamento del compasso del dispositivo in gradi con aggiornamenti continui e gestione delle autorizzazioni

Download settimanali

6.7k

GitHub Stelle

5

Guida

Tutorial su Compass

Utilizzo di @capgo/capacitor-compass

Capacitor Plugin di Compass per la lettura della direzione del compasso del dispositivo.

Installa

bun add @capgo/capacitor-compass
bunx cap sync

What This Plugin Espone

  • getCurrentHeading - Ottieni l'attuale direzione del compasso in gradi. Su iOS, la direzione viene aggiornata in background e il valore più recente viene restituito. Su Android, la direzione viene calcolata quando il metodo viene chiamato utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
  • startListening - Inizia a ricevere cambiamenti della direzione del compasso tramite eventi. Ciò avvia i sensori del compasso e emette eventi 'headingChange'.
  • stopListening - Fermati di ricevere cambiamenti della direzione del compasso. Ciò ferma i sensori del compasso e ferma l'emissione di eventi.
  • checkPermissions - Controlla lo stato di autorizzazione corrente per accedere ai dati del compasso. Su iOS, ciò controlla lo stato di autorizzazione per la posizione. Su Android, questo sempre restituisce 'granted' poiché non sono richieste autorizzazioni.

Esempio di Utilizzo

getCurrentHeading

Ottieni l'attuale direzione del compasso in gradi. Su iOS, la direzione viene aggiornata in background e il valore più recente viene restituito. Su Android, la direzione viene calcolata quando il metodo viene chiamato utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.

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

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

startListening

Inizia a ricevere cambiamenti della direzione del compasso tramite eventi. Ciò avvia i sensori del compasso e emette eventi '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

Fermati di ricevere cambiamenti della direzione del compasso. Ciò ferma i sensori del compasso e ferma l'emissione di eventi.

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

await CapgoCompass.stopListening();

checkPermissions

Controlla lo stato di autorizzazione corrente per accedere ai dati del compasso. Su iOS, ciò controlla lo stato di autorizzazione per la posizione. Su Android, questo sempre restituisce 'granted' poiché non sono richieste autorizzazioni.

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

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

Riferimento Completo

Continua da Utilizzare @capgo/capacitor-compass

Se stai utilizzando Utilizzare @capgo/capacitor-compass per pianificare il dashboard e le operazioni di API, collega il con @capgo/capacitor-compass per i dettagli di implementazione in @capgo/capacitor-compass, Avvio rapido per i dettagli di implementazione in Avvio rapido, Panoramica di API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, e API Chiavi per i dettagli di implementazione in API Chiavi.