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

W przypadku kanonicznej platformy handlowej aplikacja na telefon jest głównym sposobem interakcji użytkownika z aplikacją.

Ustawianie tarczy zegarka

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

  1. Instalacja: zainstaluj tarczę zegarka za pomocą funkcji Watch Face Push, którą uruchomisz na stronie MessageClient. Ten krok jest prosty. Użyj addWatchFace lub updateWatchFace, aby wywołać MessageClient z telefonu na zegarek.
  2. Aktywowanie: ustaw zainstalowaną tarczę zegarka jako aktywną. Ten krok ma kilka możliwych ścieżek, zależnie od stanu uprawnień:
    • Nie musisz nic robić. Platforma handlowa może już mieć kontrolę nad aktywną tarczą zegarka.
    • Użytkownik nie musi podejmować żadnych działań. Aplikacja ma niezbędne uprawnienia do ustawienia aktywnej tarczy zegarka i może to zrobić bezpośrednio za pomocą setWatchFaceAsActive().
    • Może być potrzebna pomoc dotycząca akceptowania próśb o przyznanie uprawnień lub ręcznego ustawiania tarczy zegarka za pomocą gestów długo naciśnięcia lub w aplikacji towarzyszącej.

Odpowiedź na prośbę o instalację

Aby ułatwić fazę aktywacji, faza instalacji powinna zwracać z zegarka do telefonu te informacje:

  • Wynik próby instalacji
  • Wynik funkcji isWatchFaceActive() – służy do określenia, czy aplikacja ma już aktywną tarczę zegarka.
  • Czy funkcja setWatchFaceAsActive() została już wywołana 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 zainstalowaniu aplikacji odpowiedź może wskazywać, że aplikacja ma już aktywną tarczę zegarka. Jeśli jednak nie ma takiej opcji, aplikacja może wyświetlić przycisk ustawienia tarczy zegarka jako aktywnej.

Scenariusz 1. Wszystkie próby ustawienia aktywnej tarczy zegarka zostały wyczerpane

Jeśli odpowiedź z instalacji wskazuje, że setWatchFaceAsActive() została już wywołana w przeszłości, przycisk powinien prowadzić do ekranu z instrukcjami na telefonie, na którym użytkownik może dowiedzieć się, jak dotknąć i przytrzymać tarczę zegarka, aby ręcznie ustawić ją na wybraną.

Scenariusz 2. Próba ustawienia aktywnej tarczy zegarka

Telefon powinien zlecić zegarkowi sprawdzenie, czy ma on niezbędne uprawnienia SET_PUSHED_WATCH_FACE_AS_ACTIVE:

  • Jeśli użytkownik już je przyznał, przejdź do wywołania metody setWatchFaceAsActive().
  • Jeśli użytkownik wcześniej odmówił przyznania uprawnień, zegarek powinien przekazać tę informację do telefonu, na którym można wyświetlić ekran z informacjami o potrzebie przyznania uprawnień i o sposobie ich ręcznego przyznania.

  • Jeśli uprawnienia nie żądano wcześniej, zegarek powinien poprosić telefon o wyświetlenie informacji, jak zaakceptować uprawnienia na zegarku. Następnie zegarek powinien poprosić o uprawnienia.

    • Jeśli użytkownik udzieli uprawnień, zegarek powinien wywołać funkcję setWatchFaceAsActive().
    • W przeciwnym razie zegarek powinien poprosić telefon o wyświetlenie ekranu z informacjami o potrzebie przyznania uprawnienia i o tym, jak to zrobić ręcznie.