Sesje

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ć:

    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()

Korzystanie z sesji

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.

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.