Planowanie i sprawdzanie typów danych Health Connect

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.