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
Nur Apps, die im Vordergrund ausgeführt werden, können Daten mit Health Connect lesen. Diese Einschränkung dient dem Schutz der Daten unserer Nutzer.
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.
Wenn Sie möchten, dass Ihre App ohne Unterbrechungen ausgeführt wird, z. B. wenn Sie eine Reihe von Daten aus Health Connect lesen und dann an anderer Stelle schreiben und hochladen, verwenden Sie einen Dienst im Vordergrund anstelle einer Aktivität, die leicht geschlossen werden kann.
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.