設定手機應用程式以便推送錶面

對於標準市集而言,電話應用程式是使用者與應用程式互動的主要方式。

設定錶面

當使用者在手機應用程式中選取錶面時,後續流程會分成兩個部分來設定錶面:

  1. 安裝:使用 Watch Face Push 安裝錶面,並透過 MessageClient 啟動。這個步驟很簡單,只要使用 addWatchFaceupdateWatchFace,並透過 MessageClient 從手機觸發手錶即可。
  2. 啟用: 將已安裝的錶面設為使用中錶面。這個步驟有幾個可能的路徑,取決於權限狀態:
    • 您可能不必採取任何行動。市集可能已控制使用中的錶面。
    • 也許不需要使用者介入。應用程式具有設定使用中錶面的必要權限,並可直接使用 setWatchFaceAsActive() 執行此操作。
    • 您可能需要指示,例如如何接受權限要求,或是如何使用長按手勢或隨附應用程式手動設定錶面。

安裝回應

為方便進行啟用階段,安裝階段應從手錶傳回下列資訊至手機:

  • 安裝嘗試的結果
  • isWatchFaceActive() 的結果 - 用於判斷應用程式是否已擁有使用中的錶面。
  • setWatchFaceAsActive() 是否已在先前呼叫 - Wear OS 應用程式應在本機追蹤及儲存這項資訊。這個 API 呼叫只能使用一次。

實行

安裝完成後,回應可能會指出應用程式已具有有效的錶面。但如果沒有,應用程式可能會選擇顯示按鈕,以便將錶面設為使用中

情境 1:嘗試設定使用中的錶面時,所有嘗試都失敗

如果安裝作業的回應指出 setWatchFaceAsActive() 先前已呼叫過,則按鈕應會導向手機上的說明畫面,向使用者顯示如何輕觸並按住錶面,以手動將錶面設為所需錶面。

情境 2:嘗試設定使用中的錶面

手機應指示手錶檢查是否具備必要的 SET_PUSHED_WATCH_FACE_AS_ACTIVE 權限:

  • 如果使用者已授予權限,請繼續呼叫 setWatchFaceAsActive()。
  • 如果使用者先前拒絕授予權限,手錶應將此資訊傳回手機,以便手機顯示說明畫面,說明需要授予權限的原因,以及如何手動授予權限。
  • 如果權限先前未曾要求,手錶應指示手機顯示教育性內容,引導使用者瞭解如何在手錶上接受權限,然後手錶應繼續要求權限。

    • 如果使用者授予權限,手錶就會呼叫 setWatchFaceAsActive()
    • 否則,手錶應指示手機顯示說明畫面,說明需要權限的原因,以及如何手動授予權限。