Health Platform-API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die Health Platform API ist eine Android-API, die Entwicklern eine einzige Oberfläche 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 persönlichen Gesundheits-, Fitness- und Wellnessdaten zugreifen und diese anzeigen können. So können App-Entwickler Nutzern einen umfassenderen Überblick über ihren Gesundheitszustand bieten und Nutzer können ihre Daten effektiver im Blick behalten.

Das Health Platform API Software Development Kit bietet Android-App-Entwicklern alles, was sie benötigen, um auf ausgewählten Samsung-Geräten Zugriff auf die Gesundheits- und Fitnessdaten eines Nutzers zu gewähren. 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 Lese- oder Schreibzugriff erhalten.
• Der Nutzer kann Berechtigungen jederzeit verweigern oder widerrufen.
• Die Health Platform API wird nur von ausgewählten Samsung-Geräten unterstützt.
• HealthDataClient ist der Client für die Health Platform und ein Einstiegspunkt für die Health Platform.

Die folgende Abbildung zeigt die erforderlichen Integrationsschritte, die Entwickler ausführen müssen:

Release-Dateien

Die Version 1 der Health Platform enthält Folgendes:

• Client SDK: Dieses SDK muss in Ihrer Anwendung enthalten sein, um die Health Platform API zu verwenden. Das SDK ist ein Maven-Repository, das Sie direkt in die Gradle-Builddateien Ihrer Anwendung einbinden können.

Gesundheitsplattform installieren

So installieren Sie die Health Platform:

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

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

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

Daten

Die Health Platform speichert und strukturiert Gesundheits- und Fitnessdaten. Außerdem werden die grundlegenden Unterschiede bei der Messung von Daten verschiedener Typen berücksichtigt. Beispielsweise wird die Herzfrequenz sofort gemessen, die Schrittzahl jedoch über einen bestimmten Zeitraum.

Hier sind die zentralen Objekte in der Health Platform und ihre Unterschiede:

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

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

Jedem RawData-Objekt wird beim Einfügen eine eindeutige Kennung (UID) von der Health Platform zugewiesen. Mit dieser UID kannst du in Lese-, Aktualisierungs- oder Löschanfragen auf ein bestimmtes RawData-Objekt verweisen.

Datentypen

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

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

• Felder:Bestimmte oder allgemeine Felder, die mit dem Datentyp verknüpft sind. Der Datentyp „Sauerstoffsättigung im Blut (SpO2)“ enthält beispielsweise Felder wie „Titel“, „Hinweise“ und „Prozentsatz“.
• Typ:long, double, string oder enum.
• Attribut: „Lesezugriff“, „Erforderlich“, „Optional“ oder „Gültigkeitsbereich“.

Liste der Datentypen

Wenn Sie die verfügbaren Datentypen kennen, können Sie die Health Platform optimal nutzen. Die Health Platform unterstützt die Datentypen in der folgenden Tabelle. 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 standardmäßige Funktionen zum Einfügen, Aktualisieren und Löschen von Rohdaten.

AggregatedData lesen

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

• StatisticalData:der Mittelwert, der Minimal- oder der Maximalwert in einer Gruppe von SampleData oder SeriesData, z. B. die minimale und maximale Herzfrequenz während einer Aktivitätseinheit.
• CumulativeData:Die Summe der IntervalData-Werte, z. B. die Gesamtzahl der Schritte innerhalb eines Tages.
• CountData:Eine einfache Zählung der zugrunde liegenden RawData Objekte, z. B. die Anzahl der Aktivitätssitzungen in einer bestimmten Woche. Zähldaten können für Stichproben-, Intervall- und Reihendatentypen berechnet werden.

Verbindung zur Health Platform API herstellen

HealthDataClient ist der Einstiegspunkt in die Health Platform API.

In den folgenden Schritten wird beschrieben, wie Sie eine Verbindung zur Health Platform herstellen:

1. Mit HealthDataService.getClient können Sie neue HealthDataClient-Instanzen 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 Speicherschicht und übernimmt die gesamte Inter-Process Communication (IPC) und Serialization von ausgehenden Anfragen und eingehenden Antworten.