Health Connect przechowuje i strukturyzuje dane o zdrowiu i aktywności fizycznej oraz dane z dokumentacji medycznej. Najpierw musisz poznać typy danych i uprawnienia oferowane przez Health Connect, aby móc zaplanować wymagania aplikacji.
Po zakończeniu prac nad aplikacją i przygotowaniu jej do opublikowania w Google Play musisz zadeklarować sposób wykorzystywania danych przez aplikację oraz dostęp do typów danych Health Connect, z których korzysta aplikacja. W przeciwnym razie użytkownicy mogą zobaczyć komunikat o błędzie, że aplikacja nie ma dostępu do typów danych Health Connect, ponieważ wymagają one specjalnej zgody.
Więcej informacji znajdziesz w artykule Wypełnianie deklaracji dotyczącej aplikacji związanych ze zdrowiem w Konsoli Play.
Kategorie typów danych
Health Connect obsługuje typy danych używane w większości aplikacji związanych ze zdrowiem i aktywnością fizyczną, aby zapewnić jak największą różnorodność. Health Connect ma na celu zapewnienie kompleksowego widoku danych o zdrowiu i aktywności fizycznej oraz ich przechowywanie. Te typy danych należą do tych kategorii:
| Kategoria | Opis | |
|---|---|---|
| directions_run | Aktywność | Rejestruje to każdą aktywność użytkownika. Może ona obejmować aktywności związane ze zdrowiem i kondycją fizyczną, takie jak bieganie i pływanie. |
| straighten | Pomiary ciała | Obejmuje to typowe dane dotyczące ciała, takie jak waga użytkownika i wskaźnik podstawowej przemiany materii. |
| fertile | Śledzenie cyklu | Obejmuje to cykle menstruacyjne i powiązane punkty danych, np. wynik binarny testu owulacyjnego. |
| grocery | Odżywianie | Obejmuje to typy danych dotyczące nawodnienia i odżywiania. Pierwsza wartość określa, ile wody użytkownik wypija za jednym razem. Obejmuje to pola opcjonalne, takie jak kalorie, cukier i magnez. |
| sleep_auto | Sen | Rejestruje dane interwałowe związane z długością i rodzajem snu użytkownika. |
| vital_signs | Parametry życiowe | Zawiera ona podstawowe informacje o ogólnym stanie zdrowia użytkownika. Obejmuje to dane takie jak temperatura ciała, poziom glukozy we krwi, ciśnienie krwi i nasycenie krwi tlenem. |
| mindfulness | Wellness | Obejmuje to dane związane ze zdrowiem psychicznym i samopoczuciem użytkownika. |
Przewodniki dotyczące wrażeń programisty
Health Connect udostępnia przewodniki dla programistów, które koncentrują się na konkretnych przypadkach użycia związanych ze zdrowiem i aktywnością fizyczną. Z tych przewodników dowiesz się, jak używać odpowiednich typów danych do tworzenia funkcji w tych obszarach:
W tabeli typów danych znajdziesz też informacje o tym, które przewodniki po platformie są powiązane z poszczególnymi typami danych.
Pola typu danych
Tabela typów danych Health Connect zawiera kilka kolumn pól, które pomagają zrozumieć strukturę i wymagania każdego typu danych. Te kolumny to:
| Pole | Opis | |
|---|---|---|
| schedule | Typ rekordu | Wskazuje, czy dane są rejestrowane w danym momencie, czy w określonym przedziale czasu. Możliwe wartości to: Interval, Instantaneous, Series. |
| straighten | Jednostka | Jednostka miary dla typu danych (np. kalorie, metry, liczba). |
| star | Pola obowiązkowe | Są to niezbędne pola, które muszą być uwzględnione podczas zapisywania danych tego typu, aby zachować integralność danych i użyteczność. |
Typy danych o zdrowiu i aktywności fizycznej
Zanim poprosisz o jakiekolwiek uprawnienia, musisz zadeklarować je w pliku manifestu. Więcej informacji znajdziesz w sekcji Deklarowanie uprawnień w przewodniku dla początkujących.
Poniższa tabela zawiera pełną listę typów danych wraz z kategoriami, flagami funkcji i przewodnikami oraz deklaracjami uprawnień.
Ta tabela dotyczy pakietu Health Connect SDK w wersji 1.0.0-alpha09 i starszych. Jeśli używasz nowszej wersji pakietu SDK, zapoznaj się z typami danych Health Connect w przypadku pakietu SDK w wersji 1.0.0-alpha10 lub nowszej.
| Typ danych Przewodniki |
Kategoria | Typ rekordu Deklaracje uprawnień Flaga funkcji |
|---|---|---|
| Spalone kalorie Przewodnik po treningach
|
Aktywność | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE Typy danych zbiorczychACTIVE_CALORIES_TOTAL |
| Intensywność aktywności Przewodnik po treningach
|
Aktywność | ActivityIntensityRecord
FEATURE_ACTIVITY_INTENSITYTypy danych zbiorczychDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Podstawowa temperatura ciała
|
Śledzenie cyklu | BasalBodyTemperatureRecord
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
Wskaźnik podstawowej przemiany materii
|
Pomiary ciała | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE Typy danych zbiorczychBASAL_CALORIES_TOTAL |
| Poziom glukozy we krwi Przewodnik po aplikacji Vitals
|
Vitals | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| Ciśnienie krwi Przewodnik po danych o stanie zdrowia
|
Vitals | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE Typy danych zbiorczychDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Tkanka tłuszczowa
|
Pomiary ciała | BodyFatRecord
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| Temperatura ciała Przewodnik po parametrach życiowych
|
Vitals | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
Masa wody w ciele
|
Pomiary ciała | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
Masa kości
|
Pomiary ciała | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
Śluz szyjkowy
|
Śledzenie cyklu | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| Kadencja pedałowania na rowerze Przewodnik po treningach
|
Aktywność | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE Typy danych zbiorczychRPM_AVGRPM_MAXRPM_MIN |
| Dystans Przewodnik po treningach
|
Aktywność | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE Typy danych zbiorczychDISTANCE_TOTAL |
| Wzniesienie Przewodnik po treningach
|
Aktywność | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE Typy danych zbiorczychELEVATION_GAINED_TOTAL |
| Ćwiczenia Przewodnik po treningach Przewodnik po dodawaniu tras ćwiczeń
|
Aktywność | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE Rodzaje ćwiczeńWyświetl wszystkie typy ćwiczeńEXERCISE_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_YOGATypy danych zbiorczychEXERCISE_DURATION_TOTAL |
| Liczba pokonanych pięter Przewodnik po treningach
|
Aktywność | FloorsClimbedRecord
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE Typy danych zbiorczychFLOORS_CLIMBED_TOTAL |
| Tętno Przewodnik po wskaźnikach
|
Vitals | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE Typy danych zbiorczychBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Zmienność rytmu serca Przewodnik po parametrach życiowych
|
Vitals | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
Wysokość
|
Pomiary ciała | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE Typy danych zbiorczychHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Nawodnienie
|
Odżywianie | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE Typy danych zbiorczychVOLUME_TOTAL |
Krwawienie międzymiesiączkowe
|
Śledzenie cyklu | IntermenstrualBleedingRecord
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
Beztłuszczowa masa ciała
|
Pomiary ciała | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| Menstruation W przypadku MenstruationFlowRecord:
W przypadku MenstruationPeriodRecord:
|
Śledzenie cyklu | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| Uważność Przewodnik po śledzeniu uważności
|
Samopoczucie | MindfulnessSessionRecord
FEATURE_MINDFULNESS_SESSIONRodzaje sesji uważnościWyświetl wszystkie rodzaje sesji uważnościMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDED
Typy danych zbiorczychMINDFULNESS_DURATION_TOTAL |
Odżywianie
|
Odżywianie | NutritionRecord
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE Typy danych zbiorczychBIOTIN_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 |
Test owulacyjny
|
Śledzenie cyklu | OvulationTestRecord
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| Nasycenie tlenem Przewodnik po parametrach życiowych
|
Vitals | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| Zaplanowane ćwiczenia Przewodnik po treningach Przewodnik po planach treningowych
|
Aktywność | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| Moc Przewodnik po treningach
|
Aktywność | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE Typy danych zbiorczychPOWER_AVGPOWER_MAXPOWER_MIN |
| Częstość oddychania Przewodnik po parametrach życiowych
|
Vitals | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| Tętno spoczynkowe Przewodnik po Vitals
|
Vitals | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE Typy danych zbiorczychBPM_AVGBPM_MAXBPM_MIN |
Czynność o charakterze seksualnym
|
Śledzenie cyklu | SexualActivityRecord
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| Temperatura skóry Przewodnik po parametrach życiowych Przewodnik po pomiarze temperatury skóry
|
Vitals | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATURETypy danych zbiorczychTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Sesja snu Przewodnik po śnie Przewodnik po śledzeniu sesji snu
|
Sen | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE Typy danych zbiorczychSLEEP_DURATION_TOTAL |
| Szybkość Przewodnik po treningach
|
Aktywność | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE Typy danych zbiorczychSPEED_AVGSPEED_MAXSPEED_MIN |
| Kroki Przewodnik po treningach W przypadku StepsRecord:
W przypadku StepsCadenceRecord:
|
Aktywność | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE Typy danych zbiorczych dla StepsRecordCOUNT_TOTALAgregowanie typów danych dla StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Suma spalonych kalorii Przewodnik po treningach
|
Aktywność | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE Typy danych zbiorczychENERGY_TOTAL |
| Pułap tlenowy Przewodnik po treningach
|
Aktywność | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
Waga
|
Pomiary ciała | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE Typy danych zbiorczychWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Pchnięcia wózka inwalidzkiego Przewodnik po treningach
|
Aktywność | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE Typy danych zbiorczychCOUNT_TOTAL |