@capgo/capacitor-compass

Panoramica

Leggi l'orientamento della bussola del dispositivo in gradi con aggiornamenti continui e gestione dei permessi

Inizia con getCurrentHeading() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Funzionalità principali

• getCurrentHeading - Ottiene l'orientamento attuale della bussola in gradi. Su iOS, l'orientamento viene aggiornato in background e viene restituito l'ultimo valore. Su Android, l'orientamento viene calcolato al momento della chiamata utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
• startListening - Inizia ad ascoltare i cambiamenti dell'orientamento della bussola tramite eventi. Questo avvia i sensori della bussola ed emette eventi 'headingChange'.
• stopListening - Smette di ascoltare i cambiamenti dell'orientamento della bussola. Questo arresta i sensori della bussola e smette di emettere eventi.
• checkPermissions - Verifica lo stato attuale del permesso per l'accesso ai dati della bussola. Su iOS, questo verifica lo stato del permesso di localizzazione. Su Android, restituisce sempre 'granted' poiché non sono richiesti permessi.

Pubblico API

Metodo	Descrizione
getCurrentHeading	Ottieni l'orientamento attuale della bussola in gradi. Su iOS, l'orientamento viene aggiornato in background e viene restituito l'ultimo valore. Su Android, l'orientamento viene calcolato al momento della chiamata al metodo usando i sensori accelerometro e magnetometro. Non implementato su Web.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
startListening	Inizia ad ascoltare le variazioni della direzione della bussola tramite eventi. Questo avvia i sensori della bussola ed emette eventi 'headingChange'.
stopListening	Smetti di ascoltare i cambiamenti di orientamento della bussola. Questo ferma i sensori della bussola e interrompe l'emissione di eventi.
addListener	Add a listener for compass heading change events.
addListener	Aggiungi un listener per gli eventi di variazione dell'accuratezza della bussola. Supportato solo su Android. Su iOS e Web non verranno mai emessi eventi.
removeAllListeners	- Rimuove tutti i listener di questo plugin.
checkPermissions	Verifica lo stato attuale dei permessi per l'accesso ai dati della bussola. Su iOS, questo verifica lo stato del permesso di localizzazione. Su Android, restituisce sempre 'granted' poiché non sono richiesti permessi.
requestPermissions	Richiedi il permesso per accedere ai dati della bussola. Su iOS, richiede il permesso di localizzazione (necessario per i dati di orientamento). Su Android, viene risolta subito dato che non servono permessi.
watchAccuracy	Inizia a monitorare la precisione della bussola. Su Android, monitora la precisione del magnetometro ed emette eventi accuracyChange. Gli sviluppatori possono ascoltare questi eventi e implementare la propria UI per i prompt di calibrazione. Su iOS e Web, questo metodo non fa nulla poiché il monitoraggio della precisione della bussola non è disponibile.
unwatchAccuracy	Smetti di monitorare la precisione della bussola. Interrompe il monitoraggio della precisione.
getAccuracy	Ottieni il livello di precisione attuale della bussola. Su Android, restituisce la precisione attuale del sensore magnetometro. Su iOS e Web, restituisce sempre CompassAccuracy.UNKNOWN poiché il monitoraggio della precisione non è disponibile.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-compass.

Continua da @capgo/capacitor-compass

Se stai usando @capgo/capacitor-compass per pianificare il lavoro sui plugin nativi, collegalo a Usare @capgo/capacitor-compass per la funzionalità nativa in Utilizzo di @capgo/capacitor-compass, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.