Ta strona opisuje główne funkcje interfejsu Health Connect API.
Operacje CRUD na rekordach i synchronizacji 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 dziennym).
- 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ś prosił(a) użytkownika o pozwolenie na odczytywanie i zapisywanie danych o stanie zdrowia i kondycji w konkretnej aplikacji. Możesz też sprawdzić, jakie uprawnienia zostały już przyznane lub odrzucone przez użytkownika.
Czytanie z Health Connect
Odczytywanie na pierwszym planie
Tylko aplikacje działające na pierwszym planie mogą odczytywać dane z Health Connect. To ograniczenie ma na celu zwiększenie prywatności użytkowników.
W sytuacjach, w których aplikacja może spodziewać się przerwy, np. wyświetlania odczytu w aplikacji, odczytaj dane bezpośrednio z Health Connect do aplikacji klienta.
W sytuacjach, w których wolisz, aby aplikacja działała bez zakłóceń (np. odczytuje ona zakres danych z Health Connect, a potem zapisuje i przesyła je gdzie indziej), użyj usługi na pierwszym planie, a nie aktywności, którą można łatwo zamknąć.
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.