Ta strona opisuje 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 synchronizację danych z Health Connect. Tworzy on dziennik zmian danych, który pokazuje deweloperowi i użytkownikowi, czy określone typy danych zostały wstawione lub usunięte przez inne aplikacje.
Podstawowe funkcje agregujące
Klienci mogą stosować funkcję agregacji do danych źródłowych, podając:
- wartości średnie, minimalne lub maksymalne (np. minimalne i maksymalne tętno podczas sesji aktywności);
- Suma całkowita (np. łączna liczba kroków w interwale dobowym).
- Prosta liczba wartości pomiarów podstawowych (np. liczba sesji aktywności w danym tygodniu).
- Całkowity czas w obsługiwanych typach danych (np. czas spędzony w tym tygodniu na głębokim śnie lub łączny czas trwania sesji aktywności w danym dniu).
Sprawdzanie dostępności
Health Connect jest zgodna z pakietem Android SDK w wersji 28 (Pie) lub nowszej. Ten pakiet SDK pozwala aplikacjom klienckim określić, czy interfejs Health Connect API jest dostępny na urządzeniu z Androidem użytkownika. Jeśli nie, Health Connect uruchamia sprawdzanie dostępności, aby określić, czy urządzenie użytkownika jest zgodne.
Sprawdzanie uprawnień
Health Connect wymaga, abyś poprosił(a) użytkownika o pozwolenie na odczytywanie i zapisywanie jego danych o stanie zdrowia i kondycji fizycznej w każdej aplikacji. Możesz też sprawdzić, jakie uprawnienia zostały już przyznane lub odrzucone przez użytkownika.
Czytanie z Health Connect
Odczytywanie na pierwszym planie
Gdy aplikacja jest na pierwszym planie, możesz normalnie odczytywać dane z Health Connect. W takich przypadkach możesz rozważyć użycie usługi na pierwszym planie, aby wykonać tę operację, jeśli użytkownik lub system przeniesie Twoją aplikację do tle podczas operacji odczytu.
W sytuacjach, w których aplikacja może spodziewać się przerwy, np. wyświetlania odczytu w aplikacji, odczyt bezpośrednio z Health Connect do aplikacji klienta.
W sytuacjach, w których wolisz, aby aplikacja działała bez zakłóceń, użyj usługi na pierwszym planie:
FOREGROUND_SERVICE_TYPE_HEALTH: aplikacja pozostaje na pierwszym planie, aby zbierać dane z czujników. Przykładem może być aplikacja do ćwiczeń, która nadal zbiera dane, nawet gdy użytkownik przełączy ją na tło.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: usługa ogólnego typu, która umożliwia aplikacji dalsze zbieranie kluczowych danych w przypadku zadań trwających krócej niż 3 minuty, nawet jeśli użytkownik przeniesie aplikację do tle przed ich zakończeniem.
Odczytywanie w tle
Możesz poprosić, aby aplikacja działała w tle i czytała dane z Health Connect. Jeśli żądasz uprawnienia Czytaj w tle, użytkownik może zezwolić aplikacji na odczytywanie danych w tle.