Utilizza @capgo/capacitor-compass

L'interfaccia del plugin del Compasso di Capacitor per la lettura dell'orientamento del compasso del dispositivo.

Installa

bun add @capgo/capacitor-compass
bunx cap sync

Cosa questo 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 di tipo '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 localizzazione. 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 di tipo '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 localizzazione. 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

GitHub: https://github.com/Cap-go/capacitor-compass/
Documentazione: /docs/plugins/compass/

Continua da Utilizza @capgo/capacitor-compass

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

Compass

Tutorial sull'uso del Compasso