Health Platform-API

Die Health Platform API ist eine Android-API, die Entwicklern eine einzige zum Lesen, Schreiben und Teilen von Gesundheits-, Wellness-, und Fitnessdaten. Mit Health Platform haben Nutzer die Kontrolle über ihre Daten. Nutzer*innen steuern, welche Apps Lese- oder Schreibzugriff auf verschiedene Datentypen haben. Gesundheit Zu den Platform-API-Datentypen gehören Größe, Herzfrequenz und mehr.

Die Health Platform API bietet Nutzern einen Speicher- und Freigabemechanismus, der auswählen, welche Apps auf ihre persönlichen Gesundheits-, Fitness- und Fitnessdaten und Wellness-Daten. So können App-Entwickler ihren Nutzern Ansicht der und die Benutzer können ihre Daten besser im Blick behalten.

Das Health Platform API bietet Entwicklern von Android-Apps, alles, was sie brauchen, um Nutzern Zugriff auf die Gesundheits- und Fitnessdaten auf ausgewählten Samsung-Geräten. Damit können Apps Bulk-Vorgänge ausführen. wie das Einfügen, Löschen und Lesen von Daten.

Erste Schritte

Beachten Sie bei der Verwendung der Health Platform Folgendes:

  • Client-Apps müssen detaillierte Berechtigungen für den Lese- oder Schreibzugriff vom Nutzer einholen.
  • Der Nutzer kann die Berechtigungen später jederzeit verweigern oder widerrufen.
  • Die Health Platform API unterstützt nur ausgewählte Samsung-Geräte.
  • 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:

Integrationsschritte

Release-Dateien

Die Health Platform V1-Version enthält Folgendes:

  • Client SDK: Fügen Sie dieses SDK in Ihre Anwendung ein, um die Health Platform API Das SDK ist ein Maven-Repository, das Sie direkt in die Gradle-Build-Dateien Ihrer Anwendung.

Health Platform installieren

So installieren Sie Health Platform:

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

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

Füge in der build.gradle deines Moduls eine Abhängigkeit vom Health Platform SDK hinzu wie im folgenden Beispiel gezeigt:

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

Daten

Die Health Platform speichert und strukturiert Gesundheits- und Fitnessdaten. Außerdem wird berücksichtigt, Kernunterschiede bei der Messung von Daten verschiedener Typen. Beispiel: Die Herzfrequenzmessung wird sofort übernommen, für einen bestimmten Zeitraum.

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

  • RawData: ein Mess- und Datensatz.
  • DataType:Ein Spezifizierer für gängige Arten von Gesundheits- und Fitnessdaten, z. B. Herzfrequenz, Körperfett oder Körpertemperatur und deren Formate, wie schreibgeschützt oder optional sind.
  • SampleData: Ein RawData-Objekt, das eine sofortige Messung darstellt, z. B. wie Herzfrequenz, Blutdruck oder Laufgeschwindigkeit.
  • IntervalData: Ein RawData-Objekt, das eine kumulative Messung ist über einen bestimmten Zeitraum, etwa die Anzahl der gegangenen Schritte, die zurückgelegte Strecke oder verbrannte Kalorien.
  • SeriesData: Ein RawData-Objekt, das eine Folge von Messungen über einen bestimmten Zeitraum hinweg durchgeführt. SeriesData eignet sich besonders für Hochfrequenz-Sensordaten wie kontinuierliche Herzfrequenzmessung während Aktivitätssitzung.

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

Jedem RawData-Objekt wird vom Health-System eine eindeutige Kennung (UID) zugewiesen Plattform, wenn eingefügt. Mit dieser UID können Sie auf eine bestimmte RawData verweisen. in Lese-, Aktualisierungs- oder Löschanfragen enthalten.

Datentypen

Die Health-Plattform umfasst eine breite Palette von Datentypen, die häufig in Gesundheits- und Fitness-Apps. Daten, die mit den verfügbaren Datentypen gespeichert sind, bieten Nutzern mit einem umfassenden Überblick über bisherige Gesundheit, Fitness und Wellness Daten und geben Einblicke in ihre täglichen Aktivitäten.

Jeder Datentyp wird durch sein Datenformat definiert. Dazu gehören:

  • Felder:spezifische oder allgemeine Felder, die mit dem Datentyp verknüpft sind. Für Der Datentyp „SpO2“ hat beispielsweise Felder wie Titel, Notizen und Prozentsatz.
  • Typ:long, double, string oder enum.
  • Attribut:schreibgeschützter, erforderlicher, optionaler oder Validierungsbereich.

Liste der Datentypen

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

SampleData Typen:

DataType.BasalMetabolicRateDataType BASAL_METABOLIC_RATE Erforderlich
DataType.BloodGlucoseDataType BLOOD_GLUCOSE Erforderlich und optional
DataType.BloodPressureDataType BLOOD_PRESSURE Erforderlich und optional
DataType.BodyFatDataType BODY_FAT Erforderlich
DataType.BodyTemperatureDataType BODY_TEMPERATURE Erforderlich und optional
DataType.BoneMassDataType BONE_MASS Erforderlich
DataType.CervicalMucusDataType CERVICAL_MUCUS Optional
DataType.CervicalPositionDataType CERVICAL_POSITION Optional
DataType.CyclingPedalingCadenceDataType CYCLING_PEDALING_CADENCE Erforderlich
DataType.DateOfBirthDataType DATE_OF_BIRTH Schreibgeschützt
DataType.GenderDataType GENDER Schreibgeschützt
DataType.HeartRateDataType HEART_RATE Erforderlich
DataType.HeightDataType HEIGHT Erforderlich
DataType.HipCircumferenceDataType HIP_CIRCUMFERENCE Erforderlich
DataType.HrvDifferentialIndexDataType HRV_DIFFERENTIAL_INDEX Erforderlich
DataType.HrvRmssdDataType HRV_RMSSD Erforderlich
DataType.HrvSDataType HRV_S Erforderlich
DataType.HrvSd2DataType HRV_SD2 Erforderlich
DataType.HrvSdannDataType HRV_SDANN Erforderlich
DataType.HrvSdnnDataType HRV_SDNN Erforderlich
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX Erforderlich
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX Erforderlich
DataType.HrvSdsdDataType HRV_SDSD Erforderlich
DataType.HrvTinnDataType HRV_TINN Erforderlich
DataType.LeanBodyMassDataType LEAN_BODY_MASS Erforderlich
DataType.LocationDataType LOCATION Erforderlich
DataType.MenstruationDataType MENSTRUATION Optional
DataType.OvulationTestDataType OVULATION_TEST Erforderlich
DataType.OxygenSaturationDataType OXYGEN_SATURATION Erforderlich
DataType.PaceDataType PACE Erforderlich
DataType.PowerDataType POWER Erforderlich
DataType.RespiratoryRateDataType RESPIRATORY_RATE Erforderlich
DataType.RestingHeartRateDataType RESTING_HEART_RATE Erforderlich
DataType.SexualActivityDataType SEXUAL_ACTIVITY Erforderlich
DataType.SpeedDataType SPEED Erforderlich
DataType.StepsCadenceDataType STEPS_CADENCE Erforderlich
DataType.Vo2MaxDataType VO2_MAX Erforderlich und optional
DataType.WaistCircumferenceDataType WAIST_CIRCUMFERENCE Erforderlich
DataType.WeightDataType WEIGHT Erforderlich

IntervalData Typen:

DataType.ActiveEnergyDataType ACTIVE_ENERGY_BURNED Erforderlich
DataType.ActiveTimeDataType ACTIVE_TIME Schreibgeschützt
DataType.ActivityEventDataType ACTIVITY_EVENT Erforderlich
DataType.ActivityLapDataType ACTIVITY_LAP Optional
DataType.ActivitySessionDataType ACTIVITY_SESSION Erforderlich
DataType.BasalEnergyDataType BASAL_ENERGY_BURNED Schreibgeschützt
DataType.DistanceDataType DISTANCE Erforderlich
DataType.ElevationGainedDataType ELEVATION_GAINED Erforderlich
DataType.FloorsClimbedDataType FLOORS_CLIMBED Erforderlich
DataType.HydrationDataType HYDRATION Erforderlich
DataType.NutritionDataType NUTRITION Optional
DataType.RepetitionsDataType REPETITIONS Erforderlich
DataType.SleepSessionDataType SLEEP_SESSION Optional
DataType.SleepStageDataType SLEEP_STAGE Erforderlich
DataType.StepsDataType STEPS Erforderlich
DataType.SwimmingStrokesDataType SWIMMING_STROKES Erforderlich und optional
DataType.TotalEnergyDataType TOTAL_ENERGY_BURNED Schreibgeschützt

SeriesData Typen:

DataType.CyclingPedalingCadenceSeriesDataType CYCLING_PEDALING_CADENCE Erforderlich
DataType.HeartRateSeriesDataType HEART_RATE Erforderlich
DataType.LocationSeriesDataType LOCATION Erforderlich
DataType.PaceSeriesDataType PACE Erforderlich
DataType.PowerSeriesDataType POWER Erforderlich
DataType.SpeedSeriesDataType SPEED Erforderlich
DataType.StepsCadenceSeriesDataType STEPS_CADENCE Erforderlich

Entwicklerfunktionen

Im Folgenden werden die Standarddatenfunktionen beschrieben, die in Health-Plattform. Die Plattform bietet Standardfunktionen zum Einfügen, Aktualisieren und Löschen. für Rohdaten.

Aggregierte Daten lesen

Mit der Plattform können Clients eine Aggregationsfunktion auf die folgenden Arten von AggregatedData:

  • StatisticalData: die Durchschnitts-, Mindest- oder Höchstwerte in einer Satz von SampleData oder SeriesData, z. B. minimale und maximale Herzfrequenz durchschnittliche Conversion-Rate.
  • CumulativeData:die Summe der IntervalData-Werte, z. B. die Gesamtschrittzahl in einem täglichen Intervall.
  • CountData: Eine einfache Zählung der Anzahl der zugrunde liegenden RawData -Objekten erstellen, z. B. die Anzahl der Aktivitätssitzungen in einer bestimmten Woche. Anzahl der Daten können für Stichproben-, Intervall- und Reihendatentypen berechnet werden.

Mit der Health Platform API verbinden

HealthDataClient ist der Einstiegspunkt zur Health Platform API.

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

  1. Verwenden Sie HealthDataService.getClient, um neue HealthDataClient-Instanzen zu erstellen.
  2. Die Client-App muss dann über die Methode requestPermissions (Set)-Methode.

HealthDataClient verwaltet automatisch die Verbindung mit dem zugrunde liegenden und übernimmt die gesamte Inter-Process-Kommunikation (IPC) sowie die Serialisierung ausgehender Anfragen und eingehende Antworten.