Auf dieser Seite werden die wichtigsten Funktionen der Health Connect API beschrieben.
CRUD-Vorgänge für Datensätze und Datensynchronisierung
Die Plattform bietet Standardfunktionen 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, aus dem der Entwickler und der Nutzer sehen können, ob bestimmte Datentypen von anderen Apps eingefügt oder gelöscht wurden.
Einfache Aggregationsfunktionen
Clients können eine Aggregationsfunktion auf zugrunde liegende Daten anwenden. Das bietet folgende Vorteile:
- Die Durchschnitts-, Mindest- oder Höchstwerte, z. B. die minimale und maximale Herzfrequenz während einer Aktivität.
- Die Gesamtsumme, z. B. die Gesamtzahl der Schritte in einem Tagesintervall.
- Eine einfache Zählung der Anzahl 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 diese Woche im Tiefschlaf verbracht wurde, oder die Gesamtdauer der Aktivitätssitzungen heute.
Verfügbarkeitsprüfungen
Health Connect ist mit 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 verfügbar ist. Wenn nicht, löst Health Connect eine Verfügbarkeitsprüfung aus, um festzustellen, ob das Gerät des Nutzers kompatibel ist.
Berechtigungsprüfungen
Für Health Connect müssen Sie die Einwilligung des Nutzers zum Lesen und Schreiben seiner Gesundheits- und Fitnessdaten pro App anfordern. Außerdem können Sie sehen, welche Berechtigungen der Nutzer bereits erteilt oder abgelehnt hat.
Daten mit Health Connect lesen
Lesen im Vordergrund
Normalerweise können Sie Daten aus Health Connect lesen, wenn sich Ihre App im Vordergrund befindet. In diesen Fällen sollten 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.
In Situationen, in denen Ihre App mit einer Unterbrechung rechnen muss, z. B. beim Anzeigen eines Messwerts in Ihrer Anwendung, sollten Sie Daten direkt aus Health Connect in Ihre Clientanwendung lesen.
Wenn Sie möchten, dass Ihre App ohne Unterbrechungen ausgeführt wird, verwenden Sie einen Dienst im Vordergrund:
FOREGROUND_SERVICE_TYPE_HEALTH: Ermöglicht der App, im Vordergrund zu bleiben, um Sensordaten zu erheben, z. B. bei einer Trainings-App, die weiterhin Daten erhebt, auch wenn der Nutzer die App in den Hintergrund verschiebt.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Ein Dienst vom generischen Typ, 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 verschiebt, bevor die Aufgabe 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 Im Hintergrund lesen anfordern, kann der Nutzer Ihrer App Zugriff zum Lesen von Daten im Hintergrund gewähren.