Vai direttamente al contenuto principale
Capgo logo
Indietro ai plugin

Guida

Tutoriale su Compass

Testare sul dispositivo

Scarica l'app Capgo, poi scansione il codice QR code.

App Store Google Play
Anteprima del plugin Compass QR code

Utilizzo di @capgo/capacitor-compass

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

Installa

bun add @capgo/capacitor-compass
bunx cap sync

Cosa 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 dei cambiamenti dell'indirizzo del compasso tramite eventi. Ciò avvia i sensori del compasso e emette eventi di tipo 'headingChange'.
  • stopListening - Fermati l'ascolto dei 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.

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 variazioni del capo via eventi. Questo avvia i sensori del capo 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 variazioni del capo. Questo ferma i sensori del capo 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 capo. 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

Continua da Utilizza @capgo/capacitor-compass

Se stai utilizzando Utilizza @capgo/capacitor-compass per pianificare dashboard e API operazioni, connettilo con @capgo/capacitor-compass per i dettagli di implementazione in @capgo/capacitor-compass Iniziare per i dettagli di implementazione in Iniziare 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