@capgo/capacitor-compass

Übersicht

Kompasskurs des Geräts in Grad auslesen, mit kontinuierlichen Updates und Permission-Handling

Starte mit getCurrentHeading() und den anderen unten aufgeführten Core-Methoden.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	Native
Android	Ja	Native
Web	Nein	Absichern mit Capacitor.getPlatform()

Kernfunktionen

• getCurrentHeading - Ruft die aktuelle Kompassrichtung in Grad ab. Auf iOS wird die Richtung im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Auf Android wird die Richtung beim Aufruf der Methode mit Hilfe von Beschleunigungs- und Magnetometersensoren berechnet. Nicht auf Web implementiert.
• startListening - Beginnt, auf Änderungen der Kompassrichtung über Events zu lauschen. Dies startet die Kompasssensoren und löst 'headingChange'-Events aus.
• stopListening - Beendet das Lauschen auf Änderungen der Kompassrichtung. Dies stoppt die Kompasssensoren und das Auslösen von Events.
• checkPermissions - Prüft den aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Auf iOS wird der Standortberechtigungsstatus geprüft. Auf Android wird immer 'granted' zurückgegeben, da keine Berechtigungen erforderlich sind.

Öffentliches API

Methode	Beschreibung
getCurrentHeading	Ruft die aktuelle Kompassrichtung in Grad ab. Auf iOS wird die Richtung im Hintergrund aktualisiert und der neueste Wert zurückgegeben. Auf Android wird die Richtung beim Aufruf der Methode mit Hilfe von Beschleunigungs- und Magnetometersensoren berechnet. Nicht implementiert für Web.
getPluginVersion	Die native Capacitor Plugin-Version abrufen.
startListening	Beginnt, auf Änderungen der Kompassrichtung über Events zu lauschen. Dies startet die Kompasssensoren und löst 'headingChange'-Events aus.
stopListening	Beendet das Lauschen auf Änderungen der Kompassrichtung. Dies stoppt die Kompasssensoren und das Auslösen von Events.
addListener	Fügt einen Listener für Kompass-Richtungsänderungs-Events hinzu.
addListener	Fügt einen Listener für Kompass-Genauigkeitsänderungs-Events hinzu. Nur auf Android unterstützt. Auf iOS und Web werden nie Events ausgelöst.
removeAllListeners	Entfernt alle Listener für dieses Plugin.
checkPermissions	Prüft den aktuellen Berechtigungsstatus für den Zugriff auf Kompassdaten. Auf iOS wird der Standortberechtigungsstatus geprüft. Auf Android wird immer 'granted' zurückgegeben, da keine Berechtigungen erforderlich sind.
requestPermissions	Fordert Berechtigung für den Zugriff auf Kompassdaten an. Auf iOS wird die Standortberechtigung angefordert (erforderlich für Richtungsdaten). Auf Android wird sofort aufgelöst, da keine Berechtigungen erforderlich sind.
watchAccuracy	Startet die Überwachung der Kompassgenauigkeit. Auf Android wird die Magnetometergenauigkeit überwacht und accuracyChange-Events ausgelöst. Entwickler können auf diese Events lauschen und eine eigene UI für Kalibrierungsaufforderungen implementieren. Auf iOS und Web tut diese Methode nichts, da die Überwachung der Kompassgenauigkeit nicht verfügbar ist.
unwatchAccuracy	Überwachung der Kompassgenauigkeit stoppen. Dies beendet das Monitoring der Genauigkeit.
getAccuracy	Aktuelles Genauigkeitsniveau des Kompass abrufen. Auf Android wird die aktuelle Genauigkeit des Magnetometer-Sensors zurückgegeben. Auf iOS und Web wird immer CompassAccuracy.UNKNOWN zurückgegeben, da kein Genauigkeits-Monitoring verfügbar ist.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-compass.

Weiterlesen ab @capgo/capacitor-compass

Wenn du es nutzt @capgo/capacitor-compass Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/capacitor-compass für die native Funktion in Using @capgo/capacitor-compass, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.