Konfigurowanie aplikacji na telefonie pod kątem powiadomień o tarczy zegarka
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 nim addWatchFace lub updateWatchFace, które są wywoływane za pomocą MessageClient z telefonu na zegarek.
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ę.
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.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[],[],null,["# Configure your phone app for Watch Face Push\n\nFor the canonical marketplace, the phone app is the predominant way in which\nthe user interacts with the app.\n\nSet a watch face\n----------------\n\nWhen the user selects a watch face in the phone app, there are two parts to the\nsubsequent flow to set the watch face:\n\n1. **Installation:** Install the watch face using Watch Face Push, initiated through `MessageClient`. This step is straightforward, using either `addWatchFace` or `updateWatchFace`, triggered using `MessageClient` from the phone to the watch.\n2. **Activation:** [Set the installed watch face as active](/training/wearables/watch-face-push/wear-os-app#set-watch-face-as-active). This step has several possible paths, depending on the permission state:\n - There may be **no action needed**. The marketplace may already have control of the active watch face.\n - There may be **no user intervention needed** . The app has the necessary permissions to set the active watch face, and can do so directly using `setWatchFaceAsActive()`.\n - There may be **guidance needed**, either as to how to accept permission requests, or how to manually set the watch face using a long-press gesture or through a companion app.\n\nInstallation response\n---------------------\n\nTo facilitate the **Activation** phase, the **Installation** phase should return\nthe following information from the watch to the phone:\n\n- The outcome of the installation attempt\n- The result of `isWatchFaceActive()` - to determine whether the app already has the active watch face.\n- Whether `setWatchFaceAsActive()` has already been called in the past - the Wear OS app should track and persist this information locally. *This API\n call can only be used once.*\n\nActivation\n----------\n\nFollowing the installation, the response may indicate that the app already has\nthe active watch face. However if it does not, then the app may choose to show a\nbutton to **set watch face as active**.\n\n### Scenario 1: All attempts to set the active watch face are exhausted\n\nIf the response from installation indicated that `setWatchFaceAsActive()` had\nalready been called in the past, then the button should lead to an education\nscreen on the phone, showing the user how to touch \\& hold on the watch face to\nmanually set it to the one they want.\n\n### Scenario 2 - Try to set the active watch face\n\nThe phone should instruct the watch to check for the necessary\n`SET_PUSHED_WATCH_FACE_AS_ACTIVE` permission:\n\n- If the user has **already granted it**, proceed to calling setWatchFaceAsActive().\n- If the user has **previously denied the permission**, the watch should communicate this back to the phone, where an education screen can be shown explaining the need for the permission and how to manually grant it.\n- If the **permission has not been requested before**, the watch should\n instruct the phone to show an educational moment guiding the user on how to\n accept permissions on the watch, and the watch should proceed to request the\n permission.\n\n - If the user grants the permission, the watch should then call `setWatchFaceAsActive()`.\n - Otherwise the watch should instruct the phone to show an education screen explaining the need for the permission and how to manually grant it."]]
