Compass

Utilizza @capgo/capacitor-compass

Capacitor Interfaccia del plugin Compass per la lettura dell'indirizzo del dispositivo del compasso.

Installa

bun add @capgo/capacitor-compass
bunx cap sync

Cos'è che questo plugin espone

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

Esempio di utilizzo

getCurrentHeading

Ottieni l'indirizzo attuale del compasso in gradi. Su iOS, l'indirizzo viene aggiornato in background e il valore più recente viene restituito. Su Android, l'indirizzo viene calcolato quando viene chiamato il metodo 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

Avvia l'ascolto delle modifiche di direzione del compasso tramite eventi. Questo 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

Smetti di ascoltare le modifiche di direzione del compasso. Questo 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 l'accesso ai dati del compasso. Su iOS, questo controlla lo stato di autorizzazione per la posizione. Su Android, questo restituisce sempre '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 il dashboard e le operazioni di API, connettilo con @capgo/capacitor-compass per i dettagli di implementazione in @capgo/capacitor-compass, Avvio per i dettagli di implementazione in Avvio, Panoramica di API per i dettagli di implementazione in Panoramica di API Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in Chiavi di API