Konfigurowanie aplikacji na telefonie pod kątem powiadomień o tarczy zegarka

W przypadku kanonicznego sklepu aplikacja na telefon jest głównym sposobem interakcji użytkownika z aplikacją.

Ustawianie tarczy zegarka

Gdy użytkownik wybierze tarczę zegarka w aplikacji na telefon, proces ustawiania tarczy zegarka składa się z 2 części:

  1. Instalacja: zainstaluj tarczę zegarka za pomocą funkcji Watch Face Push, którą uruchamia się za pomocą ikony MessageClient. Ten krok jest prosty. Użyjemy w nim addWatchFace lub updateWatchFace, które są wywoływane za pomocą MessageClient z telefonu na zegarek.
  2. Aktywacja: ustaw zainstalowaną tarczę zegarka jako aktywną. Ten krok ma kilka możliwych ścieżek w zależności od stanu uprawnień:
    • Nie musisz nic robić. Platforma handlowa może już mieć kontrolę nad aktywną tarczą zegarka.
    • Nie musisz podejmować żadnych działań. Aplikacja ma niezbędne uprawnienia do ustawiania aktywnej tarczy zegarka i może to robić bezpośrednio za pomocą setWatchFaceAsActive().
    • Może być potrzebna pomoc w zakresie akceptowania próśb o uprawnienia lub ręcznego ustawiania tarczy zegarka za pomocą gestu długiego naciśnięcia lub aplikacji towarzyszącej.

Odpowiedź instalacji

Aby ułatwić aktywację, w fazie instalacji zegarek powinien przekazywać do telefonu te informacje:

  • Wynik próby instalacji
  • Wynik isWatchFaceActive() – określa, czy aplikacja ma już aktywną tarczę zegarka.
  • Czy funkcja setWatchFaceAsActive() była już wywoływana w przeszłości – aplikacja Wear OS powinna śledzić i przechowywać te informacje lokalnie. Tego wywołania interfejsu API można użyć tylko raz.

Aktywacja

Po instalacji odpowiedź może wskazywać, że aplikacja ma już aktywną tarczę zegarka. Jeśli tak się nie stanie, aplikacja może wyświetlić przycisk ustawiania tarczy zegarka jako aktywnej.

Scenariusz 1. Wykorzystano wszystkie próby ustawienia aktywnej tarczy zegarka

Jeśli odpowiedź z instalacji wskazuje, że funkcja setWatchFaceAsActive() została już wcześniej wywołana, przycisk powinien prowadzić do ekranu edukacyjnego na telefonie, na którym użytkownik zobaczy, jak dotknąć i przytrzymać tarczę zegarka, aby ręcznie ustawić wybraną tarczę.

Scenariusz 2. Próba ustawienia aktywnej tarczy zegarka

Telefon powinien poinstruować zegarek, aby sprawdził, czy ma wymagane uprawnienie SET_PUSHED_WATCH_FACE_AS_ACTIVE:

  • Jeśli użytkownik przyznał już uprawnienia, wywołaj funkcję setWatchFaceAsActive().
  • Jeśli użytkownik wcześniej odmówił przyznania uprawnień, zegarek powinien przekazać tę informację do telefonu, na którym może się wyświetlić ekran z wyjaśnieniem, dlaczego te uprawnienia są potrzebne i jak można je przyznać ręcznie.

  • Jeśli użytkownik nie poprosił wcześniej o uprawnienia, zegarek powinien wyświetlić na telefonie instrukcję, jak zaakceptować uprawnienia na zegarku, a następnie sam poprosić o uprawnienia.

    • Jeśli użytkownik przyzna uprawnienia, zegarek powinien wywołać funkcję setWatchFaceAsActive().
    • W przeciwnym razie zegarek powinien wyświetlić na telefonie ekran z informacjami o tym, dlaczego to uprawnienie jest potrzebne i jak można je przyznać ręcznie.