시계 화면 푸시를 위해 휴대전화 앱 구성

표준 마켓플레이스의 경우 휴대전화 앱이 사용자가 앱과 상호작용하는 주된 방법입니다.

시계 화면 설정

사용자가 휴대전화 앱에서 시계 화면을 선택하면 시계 화면을 설정하는 후속 흐름에는 두 가지 부분이 있습니다.

  1. 설치: MessageClient를 통해 시작된 시계 화면 푸시를 사용하여 시계 화면을 설치합니다. 이 단계는 간단합니다. addWatchFace 또는 updateWatchFace를 사용하고 휴대전화에서 시계로 MessageClient를 사용하여 트리거합니다.
  2. 활성화: 설치된 워치 페이스를 활성으로 설정합니다. 이 단계에는 권한 상태에 따라 여러 경로가 있습니다.
    • 별도의 조치가 필요하지 않을 수 있습니다. 마켓플레이스에서 이미 활성 시계 화면을 제어하고 있을 수 있습니다.
    • 사용자 개입이 필요하지 않을 수 있습니다. 앱에 활성 시계 화면을 설정하는 데 필요한 권한이 있으며 setWatchFaceAsActive()를 사용하여 직접 설정할 수 있습니다.
    • 권한 요청을 수락하는 방법이나 길게 누르기 동작을 사용하거나 호환 앱을 통해 시계 화면을 수동으로 설정하는 방법에 관한 안내가 필요할 수 있습니다.

설치 응답

활성화 단계를 용이하게 하려면 설치 단계에서 시계에서 휴대전화로 다음 정보를 반환해야 합니다.

  • 설치 시도 결과
  • isWatchFaceActive()의 결과 - 앱에 이미 활성 워치 페이스가 있는지 확인합니다.
  • setWatchFaceAsActive()가 이전에 이미 호출되었는지 여부 - Wear OS 앱은 이 정보를 로컬에서 추적하고 유지해야 합니다. 이 API 호출은 한 번만 사용할 수 있습니다.

활성화

설치 후 응답은 앱에 이미 활성 시계 화면이 있다고 표시할 수 있습니다. 그러나 그렇지 않은 경우 앱은 워치 페이스를 활성으로 설정하는 버튼을 표시할 수 있습니다.

시나리오 1: 활성 워치 페이스를 설정하려는 모든 시도가 실패함

설치 응답에서 setWatchFaceAsActive()가 이전에 이미 호출되었다고 표시되면 이 버튼을 누르면 휴대전화의 안내 화면으로 이동하여 사용자가 시계 화면을 길게 터치하여 원하는 시계 화면으로 수동으로 설정하는 방법을 보여줍니다.

시나리오 2 - 활성 시계 화면을 설정하려고 시도

휴대전화는 시계에 필요한 SET_PUSHED_WATCH_FACE_AS_ACTIVE 권한을 확인하도록 안내해야 합니다.

  • 사용자가 이미 권한을 부여한 경우 setWatchFaceAsActive()를 호출합니다.
  • 사용자가 이전에 권한을 거부한 경우 시계는 이를 휴대전화에 다시 전달해야 합니다. 휴대전화에서는 권한의 필요성과 수동으로 권한을 부여하는 방법을 설명하는 안내 화면을 표시할 수 있습니다.
  • 이전에 권한이 요청되지 않은 경우 시계는 휴대전화에 시계에서 권한을 수락하는 방법을 안내하는 교육 순간을 표시하도록 안내해야 하며 시계는 권한을 요청해야 합니다.

    • 사용자가 권한을 부여하면 시계는 setWatchFaceAsActive()를 호출해야 합니다.
    • 그렇지 않으면 시계는 휴대전화에 권한의 필요성과 수동으로 권한을 부여하는 방법을 설명하는 안내 화면을 표시하도록 안내해야 합니다.