Anleitung
Health in Capacitor nutzen
@capgo/capacitor-health verwenden
Capacitor-Plugin für die Interaktion mit Daten aus Apple HealthKit und Health Connect.
Installieren
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync kopiert das native code des Plugins in deine nativen Projekte. Führe es nach jedem Plugin-Upgrade erneut aus.
Importieren
import { Health } from '@capgo/capacitor-health';
API im Überblick
| Methode | Beschreibung |
|---|---|
isAvailable |
Gibt an, ob die aktuelle Plattform den nativen SDK unterstützt. |
requestAuthorization |
Fordert Lese-/Schreibzugriff auf die angegebenen Datentypen an. |
checkAuthorization |
Prüft den Autorisierungsstatus der Datentypen, ohne den User zu fragen. |
readSamples |
Liest Samples für den angegebenen Datentyp im definierten Zeitraum aus. |
saveSample |
Schreibt ein einzelnes Sample in den nativen Health Store. |
openHealthConnectSettings |
Öffnet die Health Connect Einstellungen (nur Android). Auf iOS hat dies keine Auswirkung. |
showPrivacyPolicy |
Zeigt die Datenschutzrichtlinie für Health Connect an (nur Android). Auf iOS hat dies keine Auswirkung. |
queryWorkouts |
Ruft Workouts aus dem nativen Health Store ab. Unterstützt iOS (HealthKit) und Android (Health Connect). |
queryAggregated |
Fragt 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. Das ist effizienter, als Einzelwerte für große Zeiträume abzurufen. |
Beispiele
isAvailable()
Gibt an, ob die aktuelle Plattform den nativen Health SDK unterstützt.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Fordert Lese-/Schreibzugriff für die angegebenen Datentypen an.
import { Health } from '@capgo/capacitor-health';
const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);
checkAuthorization()
Prüft den Autorisierungsstatus für die angegebenen Datentypen, ohne den User zu fragen.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Liest Samples für den angegebenen Datentyp innerhalb des definierten Zeitraums aus.
import { Health } from '@capgo/capacitor-health';
const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);
saveSample()
Schreibt ein einzelnes Sample in den nativen Health Store.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Öffnet die Health Connect Einstellungen (nur Android). Auf iOS bewirkt diese Methode nichts.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Die obige Tabelle listet die 9 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub-Repository.
Vollständige Referenz
Weiterlesen unter Verwendung von @capgo/capacitor-health
Wenn Sie ... verwenden @capgo/capacitor-health verwenden um die Arbeit an Native Plugins zu planen, verbinde es mit @capgo/capacitor-health für die Implementierungsdetails in @capgo/capacitor-health, Erste Schritte für Details zur Implementierung in „Erste Schritte“, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in den Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in „Plugins hinzufügen oder aktualisieren“.