Auf dieser Seite werden die Hauptfunktionen der Health Connect API beschrieben.
CRUD-Vorgänge mit aufgezeichneter Daten und Datensynchronisierung
Die Plattform bietet Standardfunktionen zum Einfügen, Aktualisieren und Löschen für aufgezeichnete Daten. Health Connect umfasst auch Funktionen, mit denen Clientanwendungen Daten aus Health Connect synchronisieren können. Dadurch wird ein Protokoll der Datenänderungen erstellt, das dem Entwickler und dem Nutzer zeigt, ob bestimmte Datentypen von anderen Apps eingefügt oder gelöscht wurden.
Grundlegende Aggregatfunktionen
Clients können eine Aggregationsfunktion auf zugrunde liegende Daten anwenden und Folgendes bereitstellen:
- Die Durchschnitts-, Mindest- oder Höchstwerte (z. B. die minimale und maximale Herzfrequenz während einer Aktivitätssitzung).
- Die Gesamtsumme, z. B. die Gesamtschrittzahl in einem täglichen Intervall.
- 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. Zeit, die diese Woche im Tiefschlaf verbracht wurde oder Gesamtdauer der Aktivitätssitzungen heute).
Verfügbarkeitsprüfungen
Health Connect ist mit dem Android SDK Version 28 (Pie) und höher kompatibel. Mit dem SDK können Client-Apps feststellen, ob sich die Health Connect API auf dem Android-Gerät des Nutzers befindet. Ist das nicht der Fall, löst Health Connect eine Verfügbarkeitsprüfung aus, um festzustellen, ob das Gerät des Nutzers kompatibel ist.
Berechtigungsprüfungen
Bei Health Connect musst du die Berechtigung des Nutzers zum Lesen und/oder Schreiben seiner Gesundheits- und Fitnessdaten für einzelne Apps anfordern. Außerdem sehen Sie, welche Berechtigungen der Nutzer bereits gewährt oder verweigert hat.
Lesen mit Health Connect
Nur Apps, die im Vordergrund ausgeführt werden, können Daten mit Health Connect lesen. Diese Einschränkung soll den Datenschutz für Nutzer weiter verbessern. Health Connect benachrichtigt Nutzer und versichert, dass die App keinen Lesezugriff im Hintergrund auf ihre Daten hat und nur im Vordergrund auf Daten zugreifen kann.
In Situationen, in denen Ihre Anwendung möglicherweise eine Unterbrechung erwartet, z. B. wenn ein Messwert in Ihrer Anwendung angezeigt wird, können Sie direkt von Health Connect zu Ihrer Clientanwendung lesen.
In Situationen, in denen Ihre App unterbrechungsfrei ausgeführt werden soll, z. B. wenn Sie einen Bereich von Daten aus Health Connect lesen und dann an anderer Stelle schreiben und hochladen, sollten Sie einen ForegroundService anstelle einer Activity verwenden, bei der sie einfach geschlossen werden können.