Health Connect przechowuje i organizuje dane o zdrowiu i aktywności fizycznej. Uwzględnia też do pomiaru różnych typów danych. Te typy danych obejmują tętno natychmiastowe pomiary, liczba zrobionych kroków i dane dotyczące snu w sesjach.
Trzeba wiedzieć, jakie typy danych i uprawnienia związane z Health Połącz oferty, aby zaplanować wymagania aplikacji. Dzięki temu musisz sprawdzić typy danych, zanim będziesz mieć możliwość spełnienia wymagań.
Kategorie typów danych
Health Connect obsługuje typy danych, które są używane w przypadku większości danych o zdrowiu i aktywności fizycznej aby oferować jak największą różnorodność. Health Connect oferuje kompleksowe przeglądanie i przechowywanie danych dotyczących zdrowia i aktywności fizycznej. Te typy danych należą do kategorii można podzielić na następujące kategorie:
- Aktywność:rejestruje aktywność użytkownika. Mogą one obejmować ćwiczeń zdrowotnych i fitnessowych, takich jak bieganie, pływanie czy sen.
- Pomiary ciała: rejestruje podstawowe dane związane z ciałem, takie jak: waga użytkownika i jego podstawowa przemiana materii.
- Śledzenie cyklu: rejestruje cykle miesiączkowe i powiązane z nimi punkty danych, np. binarny wynik testu owulacyjnego.
- Żywienie: obejmuje typy danych na temat nawodnienia i żywienia. Poprzedni informuje, ile wody wypija jeden napój. To ostatnie zawiera opcjonalne pola, takie jak kalorie, cukier i magnez.
- Sen: rejestruje dane interwałów związane z długością i typem użytkownika snu.
- Vitals: te dane zbierają ważne informacje o ogólnych wynikach wyszukiwania, stan zdrowia. Zawiera dane takie jak temperatura ciała, poziom glukozy we krwi i krwi ciśnienie i nasycenie krwi tlenem.
Format typu danych
Typy danych w Health Connect są przechowywane w obiektach, które są podklasami
Record
Z każdym typem danych powiązane są pola ogólne, takie jak
time i zoneOffset lub konkretne, takie jak title, count i percentage.
W niektórych polach są używane proste typy, takie jak „long”, „podwójne” lub „ciąg znaków”, inne używają
typy złożone, takie jak wyliczenia i klasy, np. Instant czy
ZoneOffset Atrybuty tych pól mogą być wymagane lub
opcjonalnie. Niektóre atrybuty są tylko do odczytu, a inne są ograniczone do
określonego zakresu wartości.
Pełną listę dostępnych typów danych i ich pól znajdziesz w zajęciach w Jetpack.
Dodatkowe atrybuty danych
Dane w interfejsie Health Connect API obejmują też atrybuty metadanych. opisane na tej liście:
- Identyfikator Health Connect: każdy punkt danych jest przypisywany z unikalnym identyfikatorem (UID) po utworzeniu. Jest to przydatne w przypadku standardowych operacji odczytu i zapisu. Więcej informacji znajdziesz na stronie Identyfikator Health Connect.
- Ostatnia modyfikacja: wskazuje sygnaturę czasową ostatniego wystąpienia rekordu. jest aktualizacja. Jest on generowany automatycznie podczas tworzenia ani przy każdej aktualizacji.
- Pochodzenie danych: Health Connect przechowuje informacje o aplikacji, w której Źródła danych: Zawiera nazwę pakietu tego punktu początkowego, która jest automatycznie dodane po utworzeniu.
- Urządzenie: Health Connect przechowuje informacje o urządzeniu, na którym znajdują się dane skąd pochodzi użytkownik. Zawiera informacje o producencie i modelu urządzenia, które możesz ręcznie wpisać wartość.
- Identyfikator klienta: Health Connect udostępnia identyfikatory klienta, dzięki którym aplikacje klienckie mogą odnoszą się do danych za pomocą własnych identyfikatorów, co pomaga w rozwiązywaniu konfliktów ułatwia synchronizację. Wartość ta jest dodawana do rekordu ręcznie.
- Wersja rekordu klienta: oprócz identyfikatora klienta Health Connect udostępnia obsługi wersji, aby ułatwić śledzenie zmian podczas synchronizacji danych. Jest ona dostarczana do ręcznie.
- Metoda nagrywania: Health Connect pozwala Ci zrozumieć, jak są rejestrowane dane. Metody te obejmują aplikacje rejestrujące dane pasywnie (automatycznie) oraz użytkowników rejestrując dane aktywnie lub ręcznie.
Identyfikator Health Connect
Health Connect przypisuje unikalne identyfikatory (UID) do nowo wstawionych obiektów danych. które identyfikują obiekty danych i odróżniają je od innych. Identyfikatory Health Connect są przydatne w żądaniach odczytu lub zapisu. Identyfikatory Health Connect nie są identyczne z Client ID (Identyfikator klienta). Aplikacja kliencka przypisuje identyfikatory klienta, a jedynie Health Connect przypisuje identyfikatory Health Connect.
Podczas pracy z identyfikatorami Health Connect pamiętaj o tych kwestiach:
- Sesje mają jeden identyfikator Health Connect, ale dane w ramach sesji mają swój własne identyfikatory Health Connect.
- Identyfikatory Health Connect nie są powiązane z sygnaturami czasowymi.
- W niektórych przypadkach może być konieczne przechowywanie określonego identyfikatora Health Connect w czasie, gdy i przepływu pracy. Na przykład do pobrania i wyświetlenia użytkownikowi wymagany jest konkretny identyfikator użytkownik właśnie zalogowany wpis danych.
Czas w Health Connect
Wszystkie dane zapisywane w Health Connect muszą zawierać informacje o przesunięciach strefy. Określenie przesunięcia strefy umożliwia aplikacjom odczytywanie danych, w których są one reprezentowane. w czasie cywilnym. Czas cywilny to czas lokalny, który ma znaczenie dla użytkownika. ale niekoniecznie w uniwersalnym czasie koordynowanym (UTC).
W rzadkich przypadkach przesunięcie strefy może być niedostępne. W takim przypadku w Androidzie 14 (poziom interfejsu API 34) Health Connect ustawia przesunięcie strefy na podstawie domyślnej strefy czasowej systemu urządzenia. Android 13 i starsze wersje (poziom API 33 lub niższy) można zapisywać w Health Connect bez określania jakichkolwiek informacji o przesunięciu strefy, których należy unikać.
Ustawienia godziny i strefy
Określenie informacji o przesunięciu strefy podczas zapisu danych zapewnia strefę czasową podczas odczytywania danych w Health Connect. Może się jednak to nie udać w pewnych sytuacjach, na przykład wtedy, gdy przesunięcie strefy nie jest podane. Twoja aplikacja przygotować się do radzenia sobie z oboma rodzajami danych w sensowny sposób w konkretnych okolicznościach.
Uprawnienia
Zanim poprosisz o jakiekolwiek uprawnienia, aplikacja musi je zadeklarować w pliku manifestu . W tabelach poniżej znajdziesz pełne mapowanie typów danych i ich uprawnień.
Wersja 1.0.0-alfa10 lub nowsza
| Typ klasy rekordu | Deklaracja uprawnień do odczytu i zapisu |
|---|---|
| Aktywne kalorie |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| Podstawowa temperatura ciała |
android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| Podstawowa przemiana materii |
android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| Glukoza we krwi |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
| Ciśnienie krwi |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
| Tkanka tłuszczowa |
android.permission.health.READ_BODY_FAT,
android.permission.health.WRITE_BODY_FAT |
| Temperatura ciała |
android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE |
| BodyWaterMass, |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
| BoneMass, |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
| śluz szyjkowy |
android.permission.health.READ_CERVIVE_MUCUS
android.permission.health.WRITE_CERVIVE_MUCUS |
| CyclingPedalingCadence |
android.permission.health.READ_ĆWIczenie
android.permission.health.ZAPIS_ĆWICZENIA |
| Dystans |
android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE |
| Przebyte przewyższenie |
android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED |
| Sesja ćwiczeń |
android.permission.health.READ_ĆWIczenie
android.permission.health.ZAPIS_ĆWICZENIA |
| Pokonane piętra |
android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED |
| Tętno |
android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE |
| Zmienność rytmu serca |
android.permission.health.READ_HEART_RATE_VARIABILITY (dostępność)
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| Wysokość |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
| Nawodnienie |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
| Krwawienie międzynarodowe |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING.
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| LeanBodyMass, |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
| MenstruationFlow |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| Okres menstruacyjny |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| Żywienie |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
| Test owulacyjny |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
| Nasycenie tlenem |
android.permission.health.READ_OXYGEN_SATURATION (Nasycenie)
android.permission.health.WRITE_OXYGEN_SATURATION |
| Władza |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
| Częstość oddychania |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
| Tętno spoczynkowe |
android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE |
| Aktywność o charakterze seksualnym |
android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Sesja snu |
android.permission.health.READ_SLEEP,
android.permission.health.WRITE_SLEEP, |
| Szybkość |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
| Ścieżka kroków |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| Kroki |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| Łączna liczba spalonych kalorii |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Vo2Max, |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
| Waga |
android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT |
| Pchnięcia wózka inwalidzkiego |
android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES |
Wersje 1.0.0-alfa09 i starsze
| Typ klasy rekordu | Deklaracja uprawnień do odczytu i zapisu |
|---|---|
| Aktywne kalorie |
androidx.health.permission.AktywneKalorieBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE |
| Podstawowa temperatura ciała |
androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.ZAPIS |
| Podstawowa przemiana materii |
androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.ZAPIS |
| Glukoza we krwi |
androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.ZAPIS |
| Ciśnienie krwi |
androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE |
| Tkanka tłuszczowa |
androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE |
| Temperatura ciała |
androidx.health.permission.Temperatura ciała.READ
androidx.health.permission.Temperatura ciała.ZAPIS |
| BodyWaterMass, |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.ZAPIS |
| BoneMass, |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.ZAPIS |
| śluz szyjkowy |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.ZAPIS |
| CyclingPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CyclingPedalingCadence.WRITE |
| Dystans |
androidx.health.permission.Odległość.ODCZYT
androidx.health.permission.Odległość.WRITE |
| Przebyte przewyższenie |
androidx.health.permission.wzrost.ODCZYT
androidx.health.permission.Wzmocnienie.ZAPIS |
| Sesja ćwiczeń |
androidx.health.permission.SessionSession.READ
androidx.health.permission.SessionSession.WRITE |
| Pokonane piętra |
androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.PiętraClimbed.ZAPIS |
| Tętno |
androidx.health.permission.Tętno.ODCZYT
androidx.health.permission.Tętno.ZAPIS |
| Zmienność rytmu serca |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.ZAPIS |
| Wysokość |
androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE |
| Nawodnienie |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE |
| Krwawienie międzynarodowe |
androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.ZAPIS |
| LeanBodyMass, |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.ZAPIS |
| MenstruationFlow |
androidx.health.permission.MenstruationFlow.READ
androidx.health.permission.MenstruationFlow.ZAPIS |
| Żywienie |
androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE |
| Test owulacyjny |
androidx.health.permission.OvulationTest.READ
androidx.health.permission.Test owulacji.ZAPIS |
| Nasycenie tlenem |
androidx.health.permission.Nasycenie tlenem.READ
androidx.health.permission.Nasycenie tlenem.ZAPIS |
| Władza |
androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE |
| Częstość oddychania |
androidx.health.permission.Częstotliwośćoddychania.READ
androidx.health.permission.Częstotliwość oddychania.ZAPIS |
| Tętno spoczynkowe |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeart.ZAPIS |
| Aktywność o charakterze seksualnym |
androidx.health.permission.GenderActivity.READ
androidx.health.permission.GenderActivity.ZAPIS |
| Sesja snu |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.ZAPIS |
| Szybkość |
androidx.health.permission.Szybkość.READ
androidx.health.permission.Szybkość.WRITE |
| Ścieżka kroków |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.ZAPIS |
| Kroki |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.ZAPIS |
| Łączna liczba spalonych kalorii |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
| Vo2Max, |
androidx.health.permission.Vo2Max.READ
androidx.health.permission.Vo2Max.WRITE |
| Waga |
androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE |
| Pchnięcia wózka inwalidzkiego |
androidx.health.permission.Pchnięcia kół wózka inwalidzkiego.READ
androidx.health.permission.Pchnięcia wózka inwalidzkiego.WRITE |
Przejrzyj typy danych i uprawnienia
Po zaplanowaniu typów danych i uprawnień możesz wdrożyć w trakcie tworzenia aplikacji.
Sprawdzając aplikację przed przesłaniem jej do Sklepu Play, upewnij się, listę typów danych i uprawnień wymaganych przez aplikację. Dzięki temu możesz: dokładnie zadeklarować użycie danych przez aplikację.
Gdy przygotowujesz się do opublikowania aplikacji w Sklepie Play, zadeklarować dostęp do typów danych Health Connect, że Twoja aplikacja zastosowań. W przeciwnym razie użytkownicy mogą zobaczyć komunikat o błędzie z informacją, że Twoja aplikacja nie ma dostępu do typów danych Health Connect, ponieważ wymagają one specjalnych i poparcia.