별도로 취해야 할 조치가 없을 수도 있습니다. 마켓에서 이미 활성 워치 배경화면을 제어하고 있을 수 있습니다.
사용자 개입이 필요하지 않을 수 있습니다. 앱에 활성 시계 화면을 설정하는 데 필요한 권한이 있으며 setWatchFaceAsActive()을 사용하여 직접 설정할 수 있습니다.
권한 요청을 수락하는 방법이나 길게 누르기 동작 또는 호환 앱을 사용하여 시계 화면을 수동으로 설정하는 방법에 관한 안내가 필요할 수 있습니다.
설치 응답
활성화 단계를 용이하게 하기 위해 설치 단계에서는 시계에서 휴대전화로 다음 정보를 반환해야 합니다.
설치 시도의 결과
isWatchFaceActive()의 결과 - 앱에 이미 활성 워치 배경화면이 있는지 확인합니다.
setWatchFaceAsActive()가 이전에 호출되었는지 여부 - Wear OS 앱은 이 정보를 로컬로 추적하고 유지해야 합니다. 이 API 호출은 한 번만 사용할 수 있습니다.
활성화
설치 후 응답은 앱에 이미 활성 시계 화면이 있음을 나타낼 수 있습니다. 하지만 그렇지 않은 경우 앱은 워치 배경화면을 활성으로 설정하는 버튼을 표시할 수 있습니다.
시나리오 1: 활성 워치 배경화면을 설정하려는 모든 시도가 소진됨
설치 응답에서 setWatchFaceAsActive()가 이전에 이미 호출된 것으로 표시된 경우 버튼은 휴대전화의 교육 화면으로 연결되어 사용자가 시계 화면을 길게 터치하여 원하는 시계 화면으로 수동 설정하는 방법을 보여줘야 합니다.
시나리오 2 - 활성 워치 배경화면 설정 시도
휴대전화는 시계에 필요한 SET_PUSHED_WATCH_FACE_AS_ACTIVE 권한을 확인하도록 지시해야 합니다.
사용자가 이미 부여한 경우 setWatchFaceAsActive() 호출로 진행합니다.
사용자가 이전에 권한을 거부한 경우 시계는 이를 휴대전화에 다시 전달해야 합니다. 그러면 권한의 필요성과 권한을 수동으로 부여하는 방법을 설명하는 교육 화면이 표시될 수 있습니다.
이전에 권한을 요청하지 않은 경우 시계는 휴대전화에 시계에서 권한을 수락하는 방법을 안내하는 교육용 순간을 표시하도록 지시해야 하며 시계는 권한을 요청해야 합니다.
사용자가 권한을 부여하면 시계는 setWatchFaceAsActive()를 호출해야 합니다.
그렇지 않으면 시계는 권한의 필요성과 권한을 수동으로 부여하는 방법을 설명하는 교육 화면을 표시하도록 휴대전화에 안내해야 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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."]]
