Anleitung
So nutzt du Health in Capacitor
@capgo/capacitor-health verwenden
Capacitor-Plugin zum Zugriff auf Daten aus Apple HealthKit und Health Connect.
Installieren
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { Health } from '@capgo/capacitor-health';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
isAvailable |
Gibt zurück, ob die aktuelle Plattform das native Health-SDK unterstützt. |
requestAuthorization |
Fordert Lese-/Schreibzugriff auf die angegebenen Datentypen an. |
checkAuthorization |
Prüft den Autorisierungsstatus für die angegebenen Datentypen, ohne den Nutzer zu fragen. |
readSamples |
Liest Samples für den angegebenen Datentyp innerhalb des festgelegten Zeitraums aus. |
saveSample |
Schreibt ein einzelnes Sample in den nativen Health Store. |
openHealthConnectSettings |
Öffnet die Health Connect-Einstellungen (nur Android). Unter iOS bewirkt diese Methode nichts. |
showPrivacyPolicy |
Zeigt die Datenschutzerklärung der App für Health Connect (nur Android). Unter iOS bewirkt diese Methode nichts. |
queryWorkouts |
Ruft Trainingssitzungen aus dem nativen Health-Store ab. Unterstützt auf iOS (HealthKit) und Android (Health Connect). |
queryAggregated |
Ruft aggregierte Gesundheitsdaten aus dem nativen Health-Store ab. Aggregiert Daten in Zeitintervallen (Stunde, Tag, Woche, Monat) mit Operationen wie Summe, Durchschnitt, Minimum oder Maximum. Dies ist effizienter als das Abrufen einzelner Samples für große Datumsbereiche. |
Beispiele
isAvailable()
Gibt zurück, ob die aktuelle Plattform das native Health-SDK unterstützt.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Fordert Lese-/Schreibzugriff auf 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 Nutzer 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 festgelegten 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). Unter iOS bewirkt diese Methode nichts.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Die obige Tabelle listet die 9 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.
Vollständige Referenz
Weiter mit der Verwendung von @capgo/capacitor-health
Wenn du es nutzt @capgo/capacitor-health verwenden Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-health für die Implementierungsdetails in @capgo/capacitor-health, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.