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:
- 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 nimaddWatchFace
lubupdateWatchFace
, które są wywoływane za pomocąMessageClient
z telefonu na zegarek. - 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.
- Jeśli użytkownik przyzna uprawnienia, zegarek powinien wywołać funkcję