Sesje umożliwiają użytkownikom szybkie i łatwe wyświetlanie listy jakie czynności wykonali. Pojawią się one na stronie dziennika w aplikacji Google Fit. Dla: np. sesja oddechowa, spacer, bieg czy sen przykładową sesję.
Sesje grupują zbiory danych z określonego przedziału czasu, które zostały zebrane aktywność. Jeśli na przykład użytkownik śledził, kiedy zaczynał i kończył 3 km można utworzyć sesję i wszystkie dane dotyczące aktywności w tym czasie. okres (np. kroki, prędkość, dystans) będzie powiązany z tą sesją.
Sesje nie zawierają szczegółów aktywności. To jest w w gromadzeniu danych. Sesje mają następujące właściwości:
- opisowa, przyjazna nazwa (np. „poranny bieg”).
- tekst reklamy,
- Unikalny identyfikator
- typ rejestrowanej aktywności (np. bieg);
Zalety korzystania z sesji
- Przydatne dla użytkowników: sesje pomagają uporządkować dane o aktywności i treningi w użyteczny sposób. Mogą zobaczyć całą swoją aktywność w tym dniu w Strona dziennika w aplikacji Google Fit.
- Spójne wrażenia użytkownika: jeśli aplikacja lub urządzenie towarzyszące zezwalają na śledzenia (gdzie użytkownicy mogą rozpoczynać i zatrzymywać aktywność) oraz mieć sesje dla pozwala użytkownikom sprawdzić swoją aktywność w obu aplikacjach.
- Bardziej kompleksowe dane: Google Fit scala też dane z wielu różnych źródeł, które uzupełniają i wzbogacają informacje dotyczące sesji. Dzięki temu użytkownicy mogą pełniejszy obraz ich aktywności.
- Korzystaj z platformy Google Fit: jeśli użytkownicy nie śledzą swojej aktywności lub Twoja aplikacja nie obsługuje śledzenia, sesje nadal możesz odczytywać w Google Fit. Możesz wysyłać zapytania o szczegółowe lub zbiorcze dane ze sklepu fitness i znaleźć bez konieczności implementacji własnego schematu pamięci masowej.
- Większe zaangażowanie użytkowników: możesz wyświetlać użytkownikom dostępne sesje oraz aplikacji, które je utworzyły. Korzystanie w ten sposób z innymi aplikacjami do fitnessu może zwiększyć zaangażowanie użytkowników.
Uzyskiwanie autoryzacji użytkowników na potrzeby sesji
Jeśli chcesz odczytywać lub zapisywać sesje, aplikacja musi pobrać uprawnienia. Dostęp do sesji używa tych samych zakresów autoryzacji jako typy danych, o które należy prosić:
Android
Za pomocą odpowiednich pól wyboru określ, do jakiego typu sesji aplikacja ma mieć dostęp
metod z FitnessOptions
.
Aby na przykład odczytać sesje powiązane z bieganiem, możesz wybrać:
val fitnessOptions = FitnessOptions.builder()
.accessActivitySessions(FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
.build()
Ten przykład określa, że aplikacja chce uzyskać dostęp do metadanych sesji aktywności, a także typy danych, które chce odczytywać w ramach tych sesji; W tym przykładzie wykorzystane zostały typy danych o tętnie, prędkości i lokalizacji.
REST
Zakresy żądań są następujące:
- Sesje z typami aktywności związanej ze snem:
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
- Wszystkie inne sesje:
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
Korzystanie z sesji
Android
Interfejs Sessions API umożliwia:
- Tworzenie sesji w czasie rzeczywistym
- Wstaw sesje w sklepie fitness
- Wstawiaj segmenty aktywności, aby wspomóc przerwy podczas treningu
- Odczytywanie sesji i powiązanych z nimi zbiorów danych
- Uruchom inną aplikację, by wyświetlić informacje o utworzonej przez siebie sesji.
- Odbieranie intencji, gdy inna aplikacja rozpoczyna sesję
REST
Interfejs Sessions API umożliwia:
- Tworzenie sesji w czasie rzeczywistym
- Wstaw sesje w sklepie fitness
- Wstawiaj segmenty aktywności, aby wspomóc przerwy podczas treningu
- Odczytywanie sesji i powiązanych z nimi zbiorów danych
Jak zbiory danych i segmenty współdziałają z sesjami
W Google Fit:
- Zbiór danych reprezentuje zbiór punktów danych dotyczących określonego źródłem danych w określonym przedziale czasu. Zbiory danych można wstawiać do swoich własnych. Jeśli jednak tworzysz sesję, łatwiej będzie przygotować i jej zbiory danych.
- Segment grupuje zbiory danych w sesji według dokładnego działania użytkownika co podczas sesji. Jeśli na przykład użytkownik śledzi 30-minutowy bieg ( ), ale przez chwilę chodziliśmy w tym czasie, można to podzielić na segmentów niestandardowych. Fragment to bieg, przerwa na spacer, uruchomić ponownie.
![](https://developers.google.cn/static/fit/images/timeline.png?authuser=0000&hl=pl)
Rysunek 1 przedstawia przedział czasu w sklepie fitness, w którym aplikacje A, B i C włożyły wybrane zbiory danych i sesje:
- Aplikacja A wstawiła zbiory danych A1 i A2 razem z sesjami 1 i A3 niezależnie od sesji.
- Aplikacja B wstawiła zbiory danych B1 i B2 razem z sesją 2.
- Aplikacja C wstawiła zbiór danych C1 niezależnie od sesji.
Przy odczytywaniu danych sesji ze sklepu fitness wszystkie należące do w przedziale czasu trwania sesji jest z nim automatycznie powiązany. , nawet jeśli wstawisz dane po jej utworzeniu, lub utworzysz sesja po pasywnym śledzeniu danych. Na przykład zapytanie o fitness dane z sesji 1 zostaną zwrócone:
- Zbiór danych A1
- Zbiór danych A2
- Część zbioru danych A3 między t1 a t2
- Część zbioru danych C1 między t1 a t2
Możesz sprawdzić, która aplikacja wstawiono do danej sesji i zbioru danych.
Tworzenie sesji
Sesje można tworzyć na kilka różnych sposobów:
- Aplikacja może tworzyć sesję w obu tych lokalizacjach:
- w czasie rzeczywistym, gdy użytkownik aktywnie śledzi aktywność na urządzeniu (tylko z Androidem) lub
- przez ręczne wstawienie go.
- Gdy użytkownik ręcznie doda trening lub aktywność w aplikacji Google Fit.
Kiedy utworzyć sesję
Czy dodajesz dane dotyczące snu?
- Tak – utwórz sesję i ręcznie umieść ją w sklepie fitness. Możesz na przykład wstawić sesję snu. Ten jest to, że użytkownicy korzystający z aplikacji lub urządzeń do monitorowania snu nie będą wchodzić w interakcję z urządzeniami. rozpoczęcia i zakończenia aktywności snu (śledzona pasywnie).
- Nie – czy aplikacja pozwala użytkownikom rozpoczynać i zatrzymywać aktywności?
- Nie – nie twórz sesji. Dodaj zbiory danych tylko ze swojej aplikacji.
- Tak – za pomocą interfejsu Android API utwórz sesję w czasie rzeczywistym, jeśli użytkownicy śledzą swoją aktywność lub ręcznie. Utwórz sesję i ręcznie umieść ją w sklepie fitness za pomocą interfejsu API REST.
- Czy aplikacja może wykrywać, kiedy użytkownik wykonuje różne czynności na
szczegółowe dane (np. marsz lub bieg)?
- Tak – dodaj segmenty.
- Nie – możesz tylko dodawać zbiory danych. Zignoruj i pozwól Google Fit pasywnie je utworzyć.
Sesje czytania
Aplikacja może odczytywać sesje na kilka sposobów:
- Wyszukaj konkretną sesję utworzoną lub wpisaną przez aplikację.
- Imię i nazwisko lub
- Identyfikator
- Wyszukaj wszystkie utworzone lub wstawione sesje według przedziału czasu
- Wyszukaj wszystkie dostępne sesje utworzone przez wszystkie aplikacje (w tym Google Fit) według przedziału czasu
Dowiedz się, które źródła utworzyły sesję
Możesz pokazać użytkownikom, które aplikacje lub urządzenia utworzyły poszczególne sesje. Każdy sesja ma powiązane źródło danych, które zawiera informacje o aplikacji lub z których urządzeń zebrało się lub przekształciło dane.
Android
Obecnie można uzyskać nazwę pakietu tylko dla sesji napisanej przez Androida.
klienta. Aby uzyskać nazwę pakietu aplikacji, która utworzyła sesję, użyj funkcji
getAppPackageName
. Dzięki tym informacjom w aplikacji możesz wyświetlać
użytkowników, którzy do innych aplikacji dodawali sesje fitness. Możesz wyświetlać ikonę
każdy z tych elementów
aplikacji, aby pomóc użytkownikom je zidentyfikować.
Możesz też uruchomić intent do uruchomić inne aplikacje, by wyświetlić szczegóły utworzonych sesji. Inne aplikacje też mogą wywołaj intencję uruchomienia aplikacji.
Dowiedz się więcej o znajdowaniu źródła, które utworzyło .
REST
Aby uzyskać nazwę pakietu aplikacji na Androida, która utworzyła sesje, użyj funkcji
session.application
. W przypadku sesji utworzonych za pomocą
API typu REST, zamiast tego użyj właściwości session.name
. Możesz użyć tej
informacje w aplikacji, aby pokazać użytkownikom, które inne aplikacje dodały informacje o aktywności fizycznej
sesji. Możesz pokazać ikony każdej z tych aplikacji, aby ułatwić użytkownikom
.
Dowiedz się więcej o znajdowaniu źródła, które utworzyło .