Übersicht
Abschnitt mit dem Titel „Übersicht“Capacitor Kompass-Plugin-Schnittstelle zur Lesung der Gerätekompasseinstellung.
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“getCurrentHeading- Holen Sie sich den aktuellen Kompasswinkel in Grad. Auf iOS wird der Winkel im Hintergrund aktualisiert und der neueste Wert wird zurückgegeben. Auf Android wird der Winkel bei Aufruf der Methode mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web.startListening- Beginnen Sie mit dem Abhören von Kompasswinkeländerungen über Ereignisse. Dies startet die Kompass-Sensoren und emittiert Ereignisse vom Typ ‘headingChange’.stopListening- Beenden Sie das Abhören von Kompasswinkeländerungen. Dies stoppt die Kompass-Sensoren und stoppt die Ereignisemission.checkPermissions- Überprüfen Sie den aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Auf iOS wird die Standortberechtigung überprüft. Auf Android wird immer ‘erlaubt’ zurückgegeben, da keine Berechtigungen erforderlich sind.
Öffentlich API
Abschnitt mit dem Titel „Öffentlich API“| Methode | Beschreibung |
|---|---|
getCurrentHeading | Holten Sie sich den aktuellen Kompasswinkel in Grad. Auf iOS wird der Winkel im Hintergrund aktualisiert und der neueste Wert wird zurückgegeben. Auf Android wird der Winkel bei Aufruf der Methode mithilfe von Beschleunigungssensor und Magnetometer-Sensor berechnet. Nicht implementiert auf Web. |
getPluginVersion | Erhalten Sie die native Capacitor-Pluginversion. |
startListening | Fangen Sie mit dem Abhören von Änderungen des Kompasswinkels über Ereignisse an. Dies startet die Kompasssensoren und sendet 'headingChange'-Ereignisse. |
stopListening | Beenden Sie das Abhören von Änderungen des Kompasswinkels. Dies stoppt die Kompasssensoren und stoppt die Ereignisausgabe. |
addListener | Fügen Sie einen Listener für Änderungen des Kompasswinkels hinzu. |
addListener | Fügen Sie einen Listener für Änderungen der Kompassgenauigkeit hinzu. Nur auf Android unterstützt. Auf iOS und Web wird nie ein Ereignis ausgelöst. |
removeAllListeners | Entfernen Sie alle Listener für dieses Plugin. |
checkPermissions | Überprüfen Sie den aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Auf iOS überprüft dies die Standortberechtigungsstatus. Auf Android wird immer 'granted' zurückgegeben, da keine Berechtigungen erforderlich sind. |
requestPermissions | Bitten Sie um die Berechtigung zum Zugriff auf Kompassdaten. Auf iOS wird die Standortberechtigung angefordert (erforderlich für die Kopfdaten). Auf Android wird sofort gelöst, da keine Berechtigungen erforderlich sind. |
watchAccuracy | Fangen Sie mit dem Überwachen der Kompassgenauigkeit an. Auf Android überwacht dies die Magnetometergenauigkeit und sendet accuracyChange-Ereignisse. Entwickler können diese Ereignisse abhören und ihre eigenen UI für Kalibrierungshinweise implementieren. Auf iOS und Web tut dies nichts, da die Überwachung der Kompassgenauigkeit nicht verfügbar ist. |
unwatchAccuracy | Beenden Sie das Überwachen der Kompassgenauigkeit. Dies stoppt die Genauigkeitsüberwachung. |
getAccuracy | Erhalten Sie den aktuellen Kompassgenauigkeitslevel. Auf Android wird der aktuelle Magnetometersensorgenauigkeit zurückgegeben. Auf iOS und Web wird immer CompassAccuracy.UNKNOWN zurückgegeben, da die Genauigkeitsüberwachung nicht verfügbar ist. |
Quelle der Wahrheit
Abschnitt mit dem Titel “Quelle der Wahrheit”Diese Referenz wird von src/definitions.ts in capacitor-Kompas.