Saltare al contenuto

@capgo/capacitor-compass

Capacitor Interfaccia plugin Compass per la lettura della direzione del dispositivo.

Capacitor Interfaccia plugin Compass per la lettura della direzione del dispositivo.

  • getCurrentHeading - Ottieni la direzione attuale 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 viene chiamato il metodo utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
  • startListening - Inizia a ricevere notifiche di cambiamento della direzione del compasso tramite eventi. Ciò attiva i sensori del compasso e emette eventi ‘headingChange’.
  • stopListening - Fermati di ricevere notifiche di cambiamento della direzione 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.
MetodoDescrizione
getCurrentHeadingOttenere l'attuale orientamento magnetico in gradi. Su iOS, l'orientamento viene aggiornato in background e viene restituito il valore più recente. Su Android, l'orientamento viene calcolato quando viene chiamato il metodo utilizzando i sensori accelerometro e magnetometro. Non implementato su Web.
getPluginVersionOttenere la versione nativa del plugin Capacitor.
startListeningAvviare l'ascolto dei cambiamenti dell'orientamento magnetico tramite eventi. Ciò avvia i sensori dell'orientamento e emette gli eventi ‘headingChange’.
stopListeningSospendere l'ascolto dei cambiamenti dell'orientamento magnetico. Ciò sospende i sensori dell'orientamento e sospende l'emissione degli eventi.
addListenerAggiungere un ascoltatore per gli eventi di cambiamento dell'orientamento magnetico.
addListenerAggiungere un ascoltatore per gli eventi di cambiamento dell'accuratezza dell'orientamento. Supportato solo su Android. Su iOS e Web, questo non emette mai eventi.
removeAllListenersRimuovere tutti gli ascoltatori per questo plugin.
checkPermissionsControllare lo stato di autorizzazione corrente per l'accesso ai dati dell'orientamento. Su iOS, ciò controlla lo stato di autorizzazione per la localizzazione. Su Android, questo sempre restituisce ‘granted’ poiché non sono richieste autorizzazioni alcune.
requestPermissionsRichiedi il permesso di accedere ai dati del compasso. Su iOS, ciò richiede la richiesta di autorizzazione per la posizione (richiesta per i dati di orientamento). Su Android, ciò risolve immediatamente poiché non sono richieste autorizzazioni.
watchAccuracyInizia a monitorare l'accuratezza del compasso. Su Android, questo monitora l'accuratezza del magnetometro e emette eventi di accuracyChange. Gli 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 monitorazione dell'accuratezza del compasso non è disponibile.
unwatchAccuracyFerma di monitorare l'accuratezza del compasso. Ciò ferma la monitorazione dell'accuratezza.
getAccuracyOttieni il livello di accuratezza corrente del compasso. Su Android, restituisce l'accuratezza attuale del sensore magnetometro. Su iOS e Web, restituisce sempre CompassAccuracy.UNKNOWN poiché la monitorazione dell'accuratezza non è disponibile.

Questa referenza è sincronizzata da src/definitions.ts in capacitor-compasso.

Se stai utilizzando @capgo/capacitor-compass per pianificare il lavoro del plugin nativo, connettilo con Usando @capgo/capacitor-compass per la capacità nativa in Usando @capgo/capacitor-compass, Directory dei Plugin di Capgo per il flusso di lavoro del prodotto in Directory dei Plugin di Capgo, I Plugin di Capacitor sviluppati da Capgo per i dettagli di implementazione in I Plugin di Capacitor sviluppati da Capgo, Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin, e Alternative ai Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Alternative ai Plugin Enterprise di Ionic.