Na tej stronie opisujemy główne funkcje interfejsu Health Connect API.
Operacje CRUD na rekordach i synchronizacja danych
Platforma udostępnia standardowe funkcje wstawiania, aktualizowania i usuwania zarejestrowanych danych. Health Connect zawiera też funkcję, która umożliwia aplikacjom klienckim synchronizowanie danych z Health Connect. W ten sposób powstaje dziennik zmian danych, który pokazuje deweloperowi i użytkownikowi, czy inne aplikacje wstawiały lub usuwały określone typy danych.
Podstawowe funkcje agregujące
Klienci mogą stosować funkcję agregacji do danych bazowych, co zapewnia:
- Wartości średnie, minimalne lub maksymalne (np. minimalne i maksymalne tętno podczas sesji aktywności).
- Suma (np. łączna liczba kroków w interwale dziennym).
- Proste zliczenie liczby pomiarów bazowych (np. liczby sesji aktywności w danym tygodniu).
- Łączny czas trwania w przypadku obsługiwanych typów danych (np. czas spędzony w fazie snu głębokiego w tym tygodniu lub łączny czas trwania sesji aktywności w danym dniu).
Sprawdzanie dostępności
Health Connect jest zgodna z Androidem SDK w wersji 28 (Pie) lub nowszej. Pakiet SDK umożliwia aplikacjom klienckim określenie, czy interfejs Health Connect API jest dostępny na urządzeniu z Androidem użytkownika. Jeśli nie, Health Connect uruchomi sprawdzenie dostępności, aby określić, czy urządzenie użytkownika jest zgodne.
Sprawdzanie uprawnień
Health Connect wymaga, aby aplikacja prosiła użytkownika o zezwolenie na odczytywanie i zapisywanie danych o zdrowiu i aktywności fizycznej. Możesz też sprawdzić, które uprawnienia zostały już przyznane lub odrzucone przez użytkownika.
Odczytywanie danych z Health Connect
Odczytywanie na pierwszym planie
Zwykle możesz odczytywać dane z Health Connect, gdy aplikacja jest na pierwszym planie. W takich przypadkach możesz użyć usługi na pierwszym planie, aby wykonać tę operację, jeśli użytkownik lub system umieści aplikację w tle podczas operacji odczytu.
W sytuacjach, w których aplikacja może oczekiwać przerwy, np. podczas wyświetlania odczytu w aplikacji, odczytuj dane bezpośrednio z Health Connect do aplikacji klienta.
W sytuacjach, w których chcesz, aby aplikacja działała bez przerw, użyj usługi na pierwszym planie:
FOREGROUND_SERVICE_TYPE_HEALTH: umożliwia aplikacji pozostanie na pierwszym planie w celu zbierania danych z czujników, np. aplikacji do ćwiczeń, która nadal zbiera dane, nawet gdy użytkownik przełączy ją na drugi plan.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: usługa ogólnego typu, która umożliwia aplikacji dalsze zbieranie kluczowych danych do zadań trwających krócej niż 3 minuty, nawet jeśli użytkownik umieści aplikację w tle przed zakończeniem zadania.
Odczytywanie w tle
Możesz poprosić o uruchomienie aplikacji w tle i odczytywanie danych z Health Connect. Jeśli poprosisz o uprawnienie Odczyt w tle, użytkownik może przyznać Twojej aplikacji dostęp do odczytywania danych w tle.