Zum Inhalt springen

@capgo/capacitor-health

Capacitor Plugin zur Interaktion mit Daten aus Apple HealthKit und Health Connect.

@capgo/capacitor-health liest und schreibt Gesundheitsdaten von Nutzern über Apple HealthKit auf iOS und Health Connect auf Android. Nutze es für Schrittzahlen, Workouts, Schlafphasen, Vitalwerte und Nutrition-Samples, ohne zwei separate native SDK-Integrationen in deinem App-Layer zu pflegen.

Fitness-Dashboards, Habit-Apps, klinische Wellness-Produkte und betriebliche Wellness-Programme beginnen meist mit requestAuthorization, dann readSamples oder saveSample für die Metriken, die ihnen wichtig sind.

PlattformSupportNotizen
iOSJaHealthKit-Autorisierung und Samples
AndroidJaHealth Connect, optionale Berechtigung für Daten über ca. 30 Tage hinaus
WebEingeschränktisAvailable meldet nicht unterstützte native SDKs

Nur Android-Helfer: openHealthConnectSettings, showPrivacyPolicy.

  • isAvailable - Gibt an, ob die aktuelle Plattform das native Health SDK unterstützt.
  • requestAuthorization - Fordert Lese-/Schreibzugriff für die angegebenen Datentypen an.
  • checkAuthorization - Prüft den Autorisierungsstatus der Datentypen, ohne den User zu prompten.
  • readSamples - Liest Samples für den Datentyp im angegebenen Zeitraum aus.
MethodeBeschreibung
isAvailableGibt zurück, ob die aktuelle Plattform das native Health-SDK unterstützt.
requestAuthorizationFordert Lese-/Schreibzugriff auf die angegebenen Datentypen an.
checkAuthorizationPrüft den Autorisierungsstatus für die angegebenen Datentypen, ohne den Nutzer zu fragen.
readSamplesLiest Samples für den angegebenen Datentyp innerhalb des festgelegten Zeitraums aus.
saveSampleSchreibt ein einzelnes Sample in den nativen Health Store.
getPluginVersionDie native Capacitor Plugin-Version abrufen.
openHealthConnectSettingsÖffnet die Health Connect-Einstellungen (nur Android). Unter iOS bewirkt diese Methode nichts.
showPrivacyPolicyZeigt die Datenschutzrichtlinie für Health Connect an (nur Android). Auf iOS hat diese Methode keine Auswirkung.
queryWorkoutsFragt Workout-Sessions aus dem nativen Health Store ab. Unterstützt auf iOS (HealthKit) und Android (Health Connect).
queryAggregatedFragt aggregierte Gesundheitsdaten aus dem nativen Health Store ab. Daten werden in Zeitintervallen (Stunde, Tag, Woche, Monat) mit Operationen wie Summe, Durchschnitt, Min oder Max zusammengefasst. Dies ist effizienter als das Abrufen einzelner Samples über große Zeiträume.

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

Wenn du es nutzt @capgo/capacitor-health Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-health verwenden für die native Funktion in „@capgo/capacitor-health verwenden“, 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.