Compass

Utilizzo di @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 - Avvia l'ascolto delle variazioni dell'indirizzo del compasso tramite eventi. Ciò avvia i sensori del compasso e emette eventi di tipo 'headingChange'.
• stopListening - Fermati di ascoltare le variazioni 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, ciò restituisce sempre '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-bussola/
• Docs: /docs/plugins/bussola/

Continua da Utilizzo di @capgo/capacitor-bussola

Se stai utilizzando Utilizzo di @capgo/capacitor-bussola per pianificare il dashboard e le operazioni di API, collega il con @capgo/capacitor-bussola 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.