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 Sklepie Play musisz zadeklarować sposób wykorzystania danych przez aplikację, a także 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 specjalnego zatwierdzenia.
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 wglądu w dane 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 to obejmować aktywności związane ze zdrowiem i kondycją fizyczną, takie jak bieganie i pływanie. |
| wyprostować | Pomiary ciała | Obejmuje to typowe dane związane z ciałem, takie jak waga użytkownika i jego wskaźnik podstawowej przemiany materii. |
| fertile | Śledzenie cyklu | Obejmuje to cykle menstruacyjne i powiązane punkty danych, np. wynik testu owulacyjnego (0 lub 1). |
| artykuły spożywcze | Odżywianie | Obejmuje to dane dotyczące nawodnienia i odżywiania. Pierwsza wartość określa, ile wody wypija użytkownik 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 | Vitals | 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 saturacja krwi. |
| uważność | 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 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 | |
|---|---|---|
| harmonogram | Typ rekordu | Wskazuje, czy dane są rejestrowane w danym momencie, czy w określonym przedziale czasu. Możliwe wartości to: Interval, Instantaneous, Series. |
| wyprostować | Jednostka | Jednostka miary dla typu danych (np. kalorie, metry, liczba). |
| gwiazdka | 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 Szybki start.
Aby odczytywać dane, gdy aplikacja działa w tle, lub odczytywać dane historyczne, musisz zadeklarować dodatkowy zestaw uprawnień do odczytu oddzielnie od uprawnień do typów danych:
| Dodatkowe uprawnienia do odczytu | Deklaracja uprawnień |
|---|---|
|
Odczytywanie danych w tle
Przewodnik przykładu odczytywania w tle |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
Odczytywanie danych historycznych
Przewodnik Odczytywanie danych starszych niż 30 dni |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Wybór wersji Jetpacka
Deklaracje uprawnień różnią się w zależności od wersji Jetpacka, więc wybierz zakres wersji Jetpacka, z którego korzysta Twoja aplikacja.
2. Filtrowanie tabeli typów danych
Poniższa tabela zawiera pełną listę typów danych wraz z kategoriami, flagami funkcji i przewodnikami oraz deklaracjami uprawnień.
| Typ danych Przewodniki |
Kategoria | Typ rekordu Deklaracje uprawnień Flaga funkcji |
|---|---|---|
| Kalorie spalone podczas aktywności Przewodnik po treningach
|
Aktywność | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Typy danych zbiorczychACTIVE_CALORIES_TOTAL |
| Intensywność aktywności Przewodnik po treningach
|
Aktywność | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYTypy danych zbiorczychDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Podstawowa temperatura ciała
|
Śledzenie cyklu | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Wskaźnik podstawowej przemiany materii
|
Pomiary ciała | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Typy danych zbiorczychBASAL_CALORIES_TOTAL |
| Glukoza we krwi Przewodnik po parametrach życiowych
|
Vitals | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Ciśnienie krwi Przewodnik po parametrach życiowych
|
Vitals | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Typy danych zbiorczychDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Tkanka tłuszczowa
|
Pomiary ciała | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Temperatura ciała Przewodnik po wskaźnikach
|
Vitals | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Masa wody w ciele
|
Pomiary ciała | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Masa kości
|
Pomiary ciała | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Śluz szyjkowy
|
Śledzenie cyklu | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Kadencja pedałowania na rowerze Przewodnik po treningach
|
Aktywność | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Typy danych zbiorczychRPM_AVGRPM_MAXRPM_MIN |
| Dystans Przewodnik po treningach
|
Aktywność | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Typy danych zbiorczychDISTANCE_TOTAL |
| Wzniesienie Przewodnik po treningach
|
Aktywność | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Typy danych zbiorczychELEVATION_GAINED_TOTAL |
| Ćwiczenia Przewodnik po treningach Przewodnik po dodawaniu tras ćwiczeń
|
Aktywność | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE 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
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Typy danych zbiorczychFLOORS_CLIMBED_TOTAL |
| Tętno Przewodnik po parametrach życiowych
|
Vitals | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Typy danych zbiorczychBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Zmienność rytmu serca Przewodnik po parametrach życiowych
|
Vitals | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Wysokość
|
Pomiary ciała | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Typy danych zbiorczychHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Nawodnienie
|
Wartości odżywcze | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Typy danych zbiorczychVOLUME_TOTAL |
Krwawienie międzymiesiączkowe
|
Śledzenie cyklu | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Beztłuszczowa masa ciała
|
Pomiary ciała | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation W przypadku MenstruationFlowRecord:
W przypadku MenstruationPeriodRecord:
|
Śledzenie cyklu | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Uważność Przewodnik po śledzeniu uważności
|
Samopoczucie | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONTypy danych zbiorczychMINDFULNESS_DURATION_TOTAL |
Odżywianie
|
Wartości odżywcze | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION 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
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Nasycenie tlenem Przewodnik po parametrach życiowych
|
Vitals | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Zaplanowane ćwiczenia Przewodnik po treningach Przewodnik po planach treningowych
|
Aktywność | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Moc Przewodnik po treningach
|
Aktywność | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Typy danych zbiorczychPOWER_AVGPOWER_MAXPOWER_MIN |
| Częstość oddychania Przewodnik po parametrach życiowych
|
Vitals | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Tętno spoczynkowe Przewodnik po parametrach życiowych
|
Vitals | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Typy danych zbiorczychBPM_AVGBPM_MAXBPM_MIN |
Czynność o charakterze seksualnym
|
Śledzenie cyklu | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Temperatura skóry Przewodnik po parametrach życiowych Przewodnik po pomiarze temperatury skóry
|
Vitals | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURETypy danych zbiorczychTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Sesja snu Przewodnik po śnie Przewodnik po śledzeniu sesji snu
|
Sen | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Typy danych zbiorczychSLEEP_DURATION_TOTAL |
| Szybkość Przewodnik po treningach
|
Aktywność | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Typy danych zbiorczychSPEED_AVGSPEED_MAXSPEED_MIN |
| Kroki Przewodnik po treningach W przypadku StepsRecord:
W przypadku StepsCadenceRecord:
|
Aktywność | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Typy danych zbiorczych dla StepsRecordCOUNT_TOTALTypy danych zbiorczych dla StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Suma spalonych kalorii Przewodnik po treningach
|
Aktywność | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Typy danych zbiorczychENERGY_TOTAL |
| Maksymalny pułap tlenowy Przewodnik po treningach
|
Aktywność | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Waga
|
Pomiary ciała | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Typy danych zbiorczychWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Pchnięcia wózka inwalidzkiego Przewodnik po treningach
|
Aktywność | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Typy danych zbiorczychCOUNT_TOTAL |