Health Platform-API

Die Health Platform API ist eine Android-API, die Entwicklern eine einzige Schnittstelle zum Lesen, Schreiben und Teilen der bisherigen Gesundheits‑, Wellness- und Fitnessdaten eines Nutzers bietet. Mit der Health Platform haben Nutzer die Kontrolle über ihre Daten. Nutzer können festlegen, welche Apps Lese- oder Schreibzugriff auf verschiedene Datentypen haben. Zu den Datentypen der Health Platform API gehören unter anderem Größe und Herzfrequenz.

Die Health Platform API bietet Nutzern einen Speicher- und Freigabemechanismus, mit dem sie auswählen können, welche Apps auf ihre personenbezogenen Gesundheits-, Fitness- und Wellnessdaten zugreifen und diese anzeigen dürfen. So können App-Entwickler Nutzern einen umfassenderen Überblick über ihre Gesundheit geben und Nutzer können ihre Daten effektiver im Blick behalten.

Das Health Platform API SDK bietet Android-App-Entwicklern alles, was sie benötigen, um auf ausgewählten Samsung-Geräten Zugriff auf die Gesundheits- und Wellnessdaten eines Nutzers zu ermöglichen. Außerdem können Apps damit Bulk-Vorgänge wie das Einfügen, Löschen und Lesen von Daten ausführen.

Erste Schritte

Beachten Sie bei der Verwendung der Health Platform Folgendes:

• Client-Apps müssen vom Nutzer detaillierte Berechtigungen für den Lese- oder Schreibzugriff einholen.
• Der Nutzer kann Berechtigungen jederzeit verweigern oder widerrufen.
• Die Health Platform API wird nur auf ausgewählten Samsung-Geräten unterstützt.
• HealthDataClient ist der Client für die Health Platform und ein Einstiegspunkt zur Health Platform.

Das folgende Bild zeigt die erforderlichen Integrationsschritte für Entwickler:

Release-Dateien

Die Version 1 der Health Platform enthält Folgendes:

• Client SDK: Dieses SDK muss in Ihre Anwendung eingebunden werden, damit Sie die Health Platform API verwenden können. Das SDK ist ein Maven-Repository, das Sie direkt in die Gradle-Build-Dateien Ihrer Anwendung einfügen können.

Health Platform installieren

Installieren Sie die Health Platform so:

Fügen Sie das Repository in der build.gradle-Datei des App-Stammverzeichnisses hinzu, wie im folgenden Beispiel gezeigt:

allprojects {
    . . .
    repositories {
        . . .
        google()
    }
}

Fügen Sie der Datei build.gradle Ihres Moduls eine Abhängigkeit vom Health Platform SDK hinzu, wie im folgenden Beispiel gezeigt:

Daten

In der Health Platform werden Gesundheits- und Fitnessdaten gespeichert und strukturiert. Außerdem werden die grundlegenden Unterschiede bei der Messung verschiedener Datentypen berücksichtigt. Beispiel: Eine Herzfrequenzmessung erfolgt sofort, eine Schrittzählung über einen bestimmten Zeitraum.

Hier sehen Sie die zentralen Objekte in der Health Platform und wie sie sich unterscheiden:

• RawData:eine Messung und ein Datensatz.
• DataType:Ein Spezifizierer für gängige Arten von Gesundheits- und Fitnessdaten wie Herzfrequenz, Körperfett oder Körpertemperatur und deren Formate wie Felder, schreibgeschützt oder optional.
• SampleData:Ein RawData-Objekt, das eine Momentaufnahme ist, z. B. Herzfrequenz, Blutdruck oder Laufgeschwindigkeit.
• IntervalData:Ein RawData-Objekt, das eine kumulative Messung über einen Zeitraum hinweg darstellt, z. B. die Anzahl der Schritte, die zurückgelegte Distanz oder die verbrannten Kalorien.
• SeriesData:Ein RawData-Objekt, das eine Folge von Messungen über einen Zeitraum hinweg kapselt. SeriesData eignet sich besonders für hochfrequente Sensordaten wie kontinuierliche Herzfrequenzmessungen während einer Aktivität.

Jede der drei RawData-Klassen entspricht einer bestimmten Unterklasse von DataType: SampleData, IntervalData und SeriesData entsprechen SampleDataType, IntervalDataType bzw. SeriesDataType.

Jedem RawData-Objekt wird beim Einfügen von der Health Platform eine eindeutige Kennung (UID) zugewiesen. Mit dieser UID können Sie in Lese-, Aktualisierungs- oder Löschvorgängen auf ein bestimmtes RawData-Objekt verweisen.

Datentypen

Die Health Platform umfasst eine Vielzahl von Datentypen, die häufig in Gesundheits- und Fitness-Apps verwendet werden. Die mit den verfügbaren Datentypen gespeicherten Daten bieten Nutzern einen umfassenden Überblick über ihre bisherigen Gesundheits-, Fitness- und Wellnessdaten und geben Aufschluss über ihre täglichen Aktivitäten.

Jeder Datentyp wird durch sein Datenformat definiert, das Folgendes umfasst:

• Felder:Spezifische oder generische Felder, die mit dem Datentyp verknüpft sind. Der Datentyp „Sauerstoffsättigung (SpO2)“ hat beispielsweise die Felder „Titel“, „Notizen“ und „Prozentsatz“.
• Typ: „long“, „double“, „string“ oder „enum“.
• Attribut:schreibgeschützt, erforderlich, optional oder Validierungsbereich.

Liste der Datentypen

Die Health Platform optimal nutzen, indem Sie sich mit den verfügbaren Datentypen vertraut machen Die Health Platform unterstützt die in der folgenden Tabelle aufgeführten Datentypen. Die Datentypen sind nach ihrem Format organisiert: Stichprobe, Intervall oder Reihe.

SampleData-Typen:

IntervalData-Typen:

SeriesData-Typen:

Entwicklerfunktionen

Im Folgenden werden die Standarddatenfunktionen beschrieben, die in der Health Platform verfügbar sind. Die Plattform bietet Standardfunktionen zum Einfügen, Aktualisieren und Löschen von Rohdaten.

AggregatedData lesen

Auf der Plattform können Kunden eine Aggregationsfunktion auf die folgenden Typen von AggregatedData anwenden:

• StatisticalData:Die durchschnittlichen, minimalen oder maximalen Werte in einer Gruppe von SampleData oder SeriesData, z. B. die minimale und maximale Herzfrequenz während einer Aktivität.
• CumulativeData:Die Summe der IntervalData-Werte, z. B. die Gesamtzahl der Schritte innerhalb eines Tagesintervalls.
• CountData:eine einfache Zählung der Anzahl der zugrunde liegenden RawData-Objekte, z. B. die Anzahl der Aktivitätssitzungen in einer bestimmten Woche. Zähldaten können für die Datentypen „Sample“, „Intervall“ und „Serie“ berechnet werden.

Mit der Health Platform API verbinden

HealthDataClient ist der Einstiegspunkt für die Health Platform API.

So stellen Sie eine Verbindung zur Health Platform her:

1. Verwenden Sie HealthDataService.getClient, um neue HealthDataClient-Instanzen zu erstellen.
2. Die Client-App muss dann mit der Methode requestPermissions (Set) die Berechtigung vom Nutzer anfordern.

HealthDataClient verwaltet automatisch die Verbindung zur zugrunde liegenden Speicherebene und übernimmt die gesamte Interprozesskommunikation (IPC) und Serialisierung ausgehender Anfragen und eingehender Antworten.