Health Connect speichert und strukturiert sowohl Gesundheits- und Fitnessdaten als auch medizinische Daten. Es ist wichtig, zuerst zu verstehen, welche Datentypen und Berechtigungen Health Connect bietet, damit du die Anforderungen deiner App planen kannst.
Nach der Entwicklung und wenn du deine App für die Veröffentlichung im Play Store vorbereitest, musst du die Datennutzung deiner App deklarieren und den Zugriff auf die Health Connect-Datentypen, die deine App verwendet, angeben. Andernfalls wird Nutzern möglicherweise eine Fehlermeldung angezeigt, dass deine App nicht auf die Health Connect-Datentypen zugreifen kann, weil dafür eine spezielle Genehmigung erforderlich ist.
Kategorien von Datentypen
Health Connect unterstützt Datentypen, die in den meisten Gesundheits- und Fitness-Apps verwendet werden, um möglichst große Vielfalt zu bieten. Health Connect soll einen umfassenden Überblick über Gesundheits- und Fitnessdaten bieten und diese speichern. Diese Datentypen lassen sich in die folgenden Kategorien unterteilen:
| Kategorie | Beschreibung | |
|---|---|---|
| directions_run | Aktivität | Hier werden alle Aktivitäten eines Nutzers erfasst. Dazu können auch Aktivitäten wie Laufen und Schwimmen gehören. |
| Gerade | Körpermaße | Hier werden gängige körperbezogene Daten erfasst, z. B. das Gewicht und der Grundumsatz eines Nutzers. |
| fruchtbar | Zyklus-Tracking | Hier werden Menstruationszyklen und zugehörige Daten erfasst, z. B. das binäre Ergebnis eines Ovulationstests. |
| Lebensmittel | Nutrition | Hier werden die Datentypen „Flüssigkeitszufuhr“ und „Ernährung“ erfasst. Ersterer gibt an, wie viel Wasser ein Nutzer mit einer einzelnen Portion zu sich nimmt. Letzterer enthält optionale Felder wie Kalorien, Zucker und Magnesium. |
| sleep_auto | Schlaf | Hier werden Intervalldaten zur Dauer und Art des Schlafs eines Nutzers erfasst. |
| vital_signs | Vitals | Hier werden wichtige Informationen zur allgemeinen Gesundheit des Nutzers erfasst. Dazu gehören Daten wie Körpertemperatur, Blutzucker, Blutdruck und Sauerstoffsättigung. |
| Achtsamkeit | Wellness | Hier werden Daten zur psychischen Gesundheit und zum Wohlbefinden eines Nutzers erfasst. |
Leitfäden für Entwickler
Health Connect bietet Leitfäden für Entwickler, die sich auf bestimmte Anwendungsfälle im Bereich Gesundheit und Fitness konzentrieren. In diesen Anleitungen erfahren Sie, wie Sie relevante Datentypen zusammen verwenden, um Funktionen für Folgendes zu erstellen:
In der folgenden Tabelle mit Datentypen ist auch angegeben, welche Leitfäden für die Nutzererfahrung mit den einzelnen Datentypen verknüpft sind.
Felder für Datentypen
Die Tabelle mit den Health Connect-Datentypen enthält mehrere Spalten mit Feldern, die Ihnen helfen, die Struktur und die Anforderungen der einzelnen Datentypen zu verstehen. Folgende Spalten sind verfügbar:
| Feld | Beschreibung | |
|---|---|---|
| Zeitplan | Datensatztyp | Gibt an, ob die Daten zu einem bestimmten Zeitpunkt oder über ein Intervall hinweg erfasst werden. Mögliche Werte sind: Interval, Instantaneous und Series. |
| Gerade | Einheit | Die Maßeinheit für den Datentyp (z. B. „Kalorien“, „Meter“, „Anzahl“). |
| Stern | Pflichtfelder | Dies sind die erforderlichen Felder, die beim Schreiben von Daten für diesen Datentyp enthalten sein müssen, um die Datenintegrität und Nützlichkeit zu wahren. |
Datentypen für Gesundheit und Fitness
Bevor Berechtigungen angefordert werden, müssen sie in deinem Manifest deklariert werden. Weitere Informationen finden Sie im Abschnitt Berechtigungen deklarieren der Kurzanleitung.
Wenn Sie Daten lesen möchten, während Ihre App im Hintergrund ausgeführt wird, oder wenn Sie Verlaufsdaten lesen möchten, muss ein zusätzlicher Satz von Leseberechtigungen separat von den Berechtigungen für Datentypen deklariert werden:
| Zusätzliche Leseberechtigung | Erklärung zu Berechtigungen |
|---|---|
|
Daten im Hintergrund lesen
Beispiel für das Lesen im Hintergrund |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
Verlaufsdaten lesen
Daten lesen, die älter als 30 Tage sind |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Jetpack-Version auswählen
Berechtigungsdeklarationen unterscheiden sich zwischen Jetpack-Versionen. Wählen Sie daher den Jetpack-Versionsbereich aus, den Ihre App verwendet.
2. Tabelle „Datentypen“ filtern
Die folgende Tabelle enthält die vollständige Liste der Datentypen mit Kategorie, Feature-Flags und Anleitungen sowie Berechtigungserklärungen.
| Datentyp Guides |
Kategorie | Datensatztyp Erklärungen zu Berechtigungen Funktions-Flag |
|---|---|---|
| Verbrannte aktive Kalorien Anleitung für Trainingseinheiten
|
Aktivität | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Aggregierte DatentypenACTIVE_CALORIES_TOTAL |
| Intensität der Aktivität Anleitung für Trainingseinheiten
|
Aktivität | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYAggregierte DatentypenDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Basaltemperatur
|
Zyklus-Tracking | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Grundumsatz
|
Körperwerte | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Aggregierte DatentypenBASAL_CALORIES_TOTAL |
| Blutzucker Leitfaden zu Vitalzeichen
|
Vitalparameter | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Blutdruck Leitfaden zu Vitalzeichen
|
Vitalparameter | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Aggregierte DatentypenDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Körperfett
|
Körperwerte | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Körpertemperatur Leitfaden zu Vitalparametern
|
Vitalparameter | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Gesamtkörperwasser
|
Körperwerte | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Knochenmasse
|
Körperwerte | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Zervixschleim
|
Zyklus-Tracking | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Trittfrequenz beim Radfahren Anleitung für Training
|
Aktivität | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Aggregierte DatentypenRPM_AVGRPM_MAXRPM_MIN |
| Strecke Anleitung für Trainingseinheiten
|
Aktivität | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Aggregierte DatentypenDISTANCE_TOTAL |
| Höhenmeter Anleitung für Trainingseinheiten
|
Aktivität | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Aggregierte DatentypenELEVATION_GAINED_TOTAL |
| Training Leitfaden zu Work-outs Leitfaden zum Hinzufügen von Trainingsrouten
|
Aktivität | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE TrainingstypenAlle Trainingstypen ansehenEXERCISE_TYPE_UNKNOWNEXERCISE_TYPE_BADMINTONEXERCISE_TYPE_BASEBALLEXERCISE_TYPE_BASKETBALLEXERCISE_TYPE_BIKINGEXERCISE_TYPE_BIKING_STATIONARYEXERCISE_TYPE_BOOT_CAMPEXERCISE_TYPE_BOXINGEXERCISE_TYPE_CALISTHENICSEXERCISE_TYPE_CRICKETEXERCISE_TYPE_DANCINGEXERCISE_TYPE_ELLIPTICALEXERCISE_TYPE_EXERCISE_CLASSEXERCISE_TYPE_FENCINGEXERCISE_TYPE_FOOTBALL_AMERICANEXERCISE_TYPE_FOOTBALL_AUSTRALIANEXERCISE_TYPE_FRISBEE_DISCEXERCISE_TYPE_GOLFEXERCISE_TYPE_GUIDED_BREATHINGEXERCISE_TYPE_GYMNASTICSEXERCISE_TYPE_HANDBALLEXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAININGEXERCISE_TYPE_HIKINGEXERCISE_TYPE_ICE_HOCKEYEXERCISE_TYPE_ICE_SKATINGEXERCISE_TYPE_MARTIAL_ARTSEXERCISE_TYPE_PADDLINGEXERCISE_TYPE_PARAGLIDINGEXERCISE_TYPE_PILATESEXERCISE_TYPE_RACQUETBALLEXERCISE_TYPE_ROCK_CLIMBINGEXERCISE_TYPE_ROLLER_HOCKEYEXERCISE_TYPE_ROWINGEXERCISE_TYPE_ROWING_MACHINEEXERCISE_TYPE_RUGBYEXERCISE_TYPE_RUNNINGEXERCISE_TYPE_RUNNING_TREADMILLEXERCISE_TYPE_SAILINGEXERCISE_TYPE_SCUBA_DIVINGEXERCISE_TYPE_SKATINGEXERCISE_TYPE_SKIINGEXERCISE_TYPE_SNOWBOARDINGEXERCISE_TYPE_SNOWSHOEINGEXERCISE_TYPE_SOCCEREXERCISE_TYPE_SOFTBALLEXERCISE_TYPE_SQUASHEXERCISE_TYPE_STAIR_CLIMBINGEXERCISE_TYPE_STAIR_CLIMBING_MACHINEEXERCISE_TYPE_STRENGTH_TRAININGEXERCISE_TYPE_STRETCHINGEXERCISE_TYPE_SURFINGEXERCISE_TYPE_SWIMMING_OPEN_WATEREXERCISE_TYPE_SWIMMING_POOLEXERCISE_TYPE_TABLE_TENNISEXERCISE_TYPE_TENNISEXERCISE_TYPE_VOLLEYBALLEXERCISE_TYPE_WALKINGEXERCISE_TYPE_WATER_POLOEXERCISE_TYPE_WEIGHTLIFTINGEXERCISE_TYPE_WHEELCHAIREXERCISE_TYPE_OTHER_WORKOUTEXERCISE_TYPE_YOGAAggregierte DatentypenEXERCISE_DURATION_TOTAL |
| Aufgestiegene Stockwerke Anleitung für Trainingseinheiten
|
Aktivität | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Aggregierte DatentypenFLOORS_CLIMBED_TOTAL |
| Herzfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Herzfrequenzvariabilität Leitfaden zu Vitals
|
Vitalparameter | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Höhe
|
Körperwerte | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Aggregierte DatentypenHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Hydration
|
Ernährung | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Aggregierte DatentypenVOLUME_TOTAL |
Zwischenblutungen
|
Zyklus-Tracking | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Magere Körpermasse
|
Körperwerte | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation For MenstruationFlowRecord:
Für MenstruationPeriodRecord:
|
Zyklus-Tracking | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Achtsamkeit Anleitung zum Erfassen von Achtsamkeit
|
Wohlbefinden | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONArten von AchtsamkeitsübungenAlle Arten von Achtsamkeitsübungen ansehenMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDAggregierte DatentypenMINDFULNESS_DURATION_TOTAL |
Ernährung
|
Ernährung | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION Aggregierte DatentypenBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
Ovulationstest
|
Zyklus-Tracking | OvulationTestRecord
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Sauerstoffsättigung Leitfaden zu Vitalparametern
|
Vitalparameter | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Geplantes Training Anleitung für Workouts Anleitung für Trainingspläne
|
Aktivität | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Stromversorgung Anleitung für Trainingseinheiten
|
Aktivität | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Aggregierte DatentypenPOWER_AVGPOWER_MAXPOWER_MIN |
| Atemfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Ruheherzfrequenz Leitfaden zu Vitalparametern
|
Vitalparameter | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Aggregierte DatentypenBPM_AVGBPM_MAXBPM_MIN |
Sexuelle Aktivität
|
Zyklus-Tracking | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Hauttemperatur Leitfaden zu Vitalparametern Leitfaden zum Messen der Hauttemperatur
|
Vitalparameter | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATUREAggregierte DatentypenTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Schlafeinheit Schlafanleitung Schlafeinheiten aufzeichnen
|
Schlaf | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Aggregierte DatentypenSLEEP_DURATION_TOTAL |
| Geschwindigkeit Leitfaden für Trainingseinheiten
|
Aktivität | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Aggregierte DatentypenSPEED_AVGSPEED_MAXSPEED_MIN |
| Schritte Anleitung für Trainingseinheiten Für StepsRecord:
Für StepsCadenceRecord:
|
Aktivität | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Aggregierte Datentypen für StepsRecordCOUNT_TOTALZusammengefasste Datentypen für StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Insgesamt verbrannte Kalorien Anleitung für Training
|
Aktivität | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Aggregierte DatentypenENERGY_TOTAL |
| Maximale Sauerstoffaufnahme Trainings-Leitfaden
|
Aktivität | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Gewicht
|
Körperwerte | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Aggregierte DatentypenWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Rollstuhl-Schübe Leitfaden für Workouts
|
Aktivität | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Aggregierte DatentypenCOUNT_TOTAL |