Auf dieser Seite werden die Hauptfunktionen der Health Connect API beschrieben.
CRUD-Vorgänge für Einträge und Datensynchronisierung
Die Plattform bietet standardmäßige Funktionen zum Einfügen, Aktualisieren und Löschen von aufgezeichneten Daten. Health Connect bietet auch Funktionen, mit denen Client-Apps Daten aus Health Connect synchronisieren können. Dadurch wird ein Protokoll der Datenänderungen erstellt, das Entwicklern und Nutzern zeigt, ob bestimmte Datentypen von anderen Apps eingefügt oder gelöscht wurden.
Grundlegende Aggregationsfunktionen
Kunden können eine Aggregationsfunktion auf die zugrunde liegenden Daten anwenden und dabei Folgendes festlegen:
- Durchschnitt, Minimum oder Maximum (z. B. die minimale und maximale Herzfrequenz während einer Aktivitätseinheit)
- Die Summe (z. B. die Gesamtzahl der Schritte in einem Tagesintervall).
- Eine einfache Zählung der zugrunde liegenden Messungen (z. B. die Anzahl der Aktivitätssitzungen in einer bestimmten Woche).
- Die Gesamtdauer für unterstützte Datentypen (z. B. die Zeit, die Sie diese Woche im Tiefschlaf verbracht haben, oder die Gesamtdauer der Aktivitätssitzungen heute).
Verfügbarkeitsprüfungen
Health Connect ist mit der Android SDK-Version 28 (Pie) und höher kompatibel. Mit dem SDK können Client-Apps ermitteln, ob die Health Connect API auf dem Android-Gerät des Nutzers installiert ist. Andernfalls löst Health Connect eine Verfügbarkeitsprüfung aus, um festzustellen, ob das Gerät des Nutzers kompatibel ist.
Berechtigungsprüfungen
Bei Health Connect müssen Sie die Berechtigung des Nutzers zum Lesen und Schreiben seiner Gesundheits- und Fitnessdaten pro App anfordern. Außerdem sehen Sie, welche Berechtigungen dem Nutzer bereits gewährt oder verweigert wurden.
Lesen mit Health Connect
Daten im Vordergrund abrufen
Normalerweise können Sie Daten aus Health Connect lesen, wenn sich Ihre App im Vordergrund befindet. In diesen Fällen können Sie einen Dienst im Vordergrund verwenden, um diesen Vorgang auszuführen, falls der Nutzer oder das System Ihre App während eines Lesevorgangs in den Hintergrund verschiebt.
Wenn in Ihrer App eine Unterbrechung erwartet wird, z. B. beim Anzeigen einer Messung in Ihrer App, lesen Sie direkt von Health Connect in Ihre Clientanwendung.
Verwenden Sie einen Dienst im Vordergrund, wenn Ihre App ohne Unterbrechungen ausgeführt werden soll:
FOREGROUND_SERVICE_TYPE_HEALTH: Ermöglicht es der App, im Vordergrund zu bleiben, um Sensordaten zu erheben. Dies ist beispielsweise bei einer Trainings-App der Fall, die auch dann Daten erhebt, wenn der Nutzer die App im Hintergrund schaltet.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Ein generischer Dienst, mit dem eine App weiterhin wichtige Daten für Aufgaben erfassen kann, die weniger als drei Minuten dauern, auch wenn der Nutzer die App in den Hintergrund stellt, bevor sie abgeschlossen ist.
Daten im Hintergrund abrufen
Sie können anfordern, dass Ihre Anwendung im Hintergrund ausgeführt wird und Daten aus Health Connect liest. Wenn Sie die Berechtigung Lesen im Hintergrund anfordern, kann der Nutzer Ihrer App Zugriff gewähren, um Daten im Hintergrund zu lesen.