Saltare al contenuto

@capgo/capacitor-compass

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

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

  • getCurrentHeading - Ottieni l'attuale direzione del compasso in gradi. Su iOS, la direzione viene aggiornata in background e il valore più recente viene restituito. Su Android, la direzione viene calcolata quando il metodo viene chiamato utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
  • startListening - Inizia ad ascoltare per i cambiamenti della direzione del compasso tramite eventi. Questo avvia i sensori del compasso e emette eventi ‘headingChange’.
  • stopListening - Fermati di ascoltare per i cambiamenti della direzione del compasso. Questo 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, questo controlla lo stato di autorizzazione per la posizione. Su Android, questo restituisce sempre ‘granted’ poiché non sono richieste autorizzazioni.
MetodoDescrizione
getCurrentHeadingOttieni l'attuale direzione del compasso in gradi. Su iOS, la direzione viene aggiornata in background e il valore più recente viene restituito. Su Android, la direzione viene calcolata quando il metodo viene chiamato utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
getPluginVersionOttieni la versione nativa del plugin Capacitor.
startListeningInizia ad ascoltare per i cambiamenti della direzione del compasso tramite eventi. Questo avvia i sensori del compasso e emette eventi ‘headingChange’.
stopListeningFermati di ascoltare per i cambiamenti della direzione del compasso. Questo ferma i sensori del compasso e ferma l'emissione di eventi.
addListenerAggiungi un ascoltatore per eventi di modifica della direzione del compasso.
addListenerAggiungi un ascoltatore per eventi di modifica dell'accuratezza del compasso. Supportato solo su Android. Su iOS e Web, questo non emette mai eventi.
removeAllListenersRimuovi tutti gli ascoltatori per questo plugin.
checkPermissionsControlla lo stato di permesso corrente per l'accesso ai dati del compasso. Su iOS, questo controlla lo stato di permesso per la posizione. Su Android, questo restituisce sempre 'concesso' poiché non sono richieste alcune autorizzazioni.
requestPermissionsRichiedi il permesso per accedere ai dati del compasso. Su iOS, questo richiede il permesso di posizione (richiesto per i dati di direzione). Su Android, questo risolve immediatamente poiché non sono richieste alcune autorizzazioni.
watchAccuracyInizia a monitorare l'accuratezza del compasso. Su Android, questo monitora la precisione del sensore magnetico e emette eventi di modifica dell'accuratezza. I sviluppatori possono ascoltare questi eventi e implementare la propria UI per le richieste di calibrazione. Su iOS e Web, questo metodo non fa nulla poiché la monitorizzazione dell'accuratezza del compasso non è disponibile.
unwatchAccuracyFermati di monitorare l'accuratezza del compasso. Questo ferma la monitorizzazione dell'accuratezza.
getAccuracyOttieni il livello di accuratezza corrente del compasso. Su Android, restituisce la precisione corrente del sensore magnetico. Su iOS e Web, restituisce sempre CompassAccuracy.UNKNOWN poiché la monitorizzazione dell'accuratezza del compasso non è disponibile.

Questa documentazione è sincronizzata da src/definitions.ts in capacitor-compass.

Se stai utilizzando @capgo/capacitor-compass per pianificare il lavoro del plugin nativo, connettilo con Utilizzando @capgo/capacitor-compass per la capacità nativa in Utilizzando @capgo/capacitor-compass, Capgo Directory dei plugin per il flusso di lavoro del prodotto in Capgo Directory dei plugin, Capacitor Plugin da Capgo per il dettaglio di implementazione in Capacitor Plugin da Capgo, Aggiunta o Aggiornamento Plugin per la dettagliata implementazione in Aggiunta o Aggiornamento Plugin, e Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic.