Na tej stronie opisujemy główne funkcje interfejsu Health Connect API.
Operacje CRUD dotyczące rekordów i synchronizacji danych
Platforma ta zapewnia standardowe funkcje wstawiania, aktualizowania i usuwania zarejestrowanych danych. Health Connect udostępnia również funkcje, które umożliwiają aplikacjom klienckim synchronizowanie danych z Health Connect. Spowoduje to utworzenie logu zmian w danych, który pokazuje deweloper i użytkownika, czy określone typy danych zostały dodane lub usunięte przez inne aplikacje.
Podstawowe funkcje agregacji
Klienci mogą zastosować w przypadku danych bazowych funkcję agregacji, uzyskując w ten sposób:
- Wartości średnie, minimalne lub maksymalne (np. minimalne i maksymalne tętno podczas sesji aktywności).
- Suma sum (np. łączna liczba kroków w interwałach dziennych).
- Prosta liczba liczby powiązanych z nimi pomiarów (np. liczba sesji aktywności w danym tygodniu).
- Całkowity czas trwania obsługiwanych typów danych (np. czas spędzony w danym tygodniu w fazie snu głębokiego lub łączny czas trwania sesji aktywności dzisiaj).
Kontrole dostępności
Aplikacja Health Connect jest zgodna z pakietem SDK na Androida w wersji 28 (Pie) i nowszych. Pakiet SDK pozwala aplikacjom klienckim określać, czy interfejs Health Connect API znajduje się na urządzeniu z Androidem użytkownika. Jeśli nie, Health Connect uruchamia kontrolę dostępności, aby określić, czy urządzenie użytkownika jest zgodne.
Sprawdzanie uprawnień
Health Connect wymaga poproszenia użytkownika o zgodę na odczytywanie lub zapisywanie danych dotyczących zdrowia i aktywności fizycznej z poszczególnych aplikacji. Pozwala też sprawdzić, które uprawnienia zostały już przyznane lub odrzucone przez użytkownika.
Czytanie z Health Connect
Tylko aplikacje działające na pierwszym planie mogą odczytywać dane z Health Connect. To ograniczenie zostało wprowadzone, aby jeszcze lepiej chronić prywatność użytkowników. Health Connect powiadamia użytkowników i zapewnia, że nie ma dostępu do ich danych w tle. Może tylko odczytywać dane i uzyskiwać do nich dostęp na pierwszym planie.
W sytuacjach, w których aplikacja może powodować przerwy w działaniu, na przykład wyświetlać odczyt w aplikacji, odczytuj ją bezpośrednio z Health Connect do aplikacji klienckiej.
W sytuacjach, w których wolisz, aby aplikacja działała bez zakłóceń, na przykład do odczytywania zakresu danych z Health Connect, a następnie zapisywania ich i przesyłania w innym miejscu, lepiej użyć usługi ForegroundService, a nie Aktywności, w której można ją łatwo zamknąć.