Compass

Utilizzo di @capgo/capacitor-compass

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

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 ad ascoltare per i cambiamenti dell'indirizzo del compasso tramite eventi. Ciò avvia i sensori del compasso e emette eventi 'headingChange'.
• stopListening - Ferma di ascoltare per i cambiamenti 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 'granted' poiché non sono richieste autorizzazioni.

Utilizzo di esempio

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 dei cambiamenti della direzione magnetica tramite eventi. Questo avvia i sensori della bussola 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

Sospendi l'ascolto dei cambiamenti della direzione magnetica. Questo ferma i sensori della bussola 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 della bussola. 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/
• Docs: /docs/plugins/compass/

Continua da Utilizzo di @capgo/capacitor-compass

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