對於標準市集而言,電話應用程式是使用者與應用程式互動的主要方式。
設定錶面
當使用者在手機應用程式中選取錶面時,後續流程會分成兩個部分來設定錶面:
- 安裝:使用 Watch Face Push 安裝錶面,並透過
MessageClient
啟動。這個步驟很簡單,只要使用addWatchFace
或updateWatchFace
,並透過MessageClient
從手機觸發手錶即可。 - 啟用: 將已安裝的錶面設為使用中錶面。這個步驟有幾個可能的路徑,取決於權限狀態:
- 您可能不必採取任何行動。市集可能已控制使用中的錶面。
- 也許不需要使用者介入。應用程式具有設定使用中錶面的必要權限,並可直接使用
setWatchFaceAsActive()
執行此操作。 - 您可能需要指示,例如如何接受權限要求,或是如何使用長按手勢或隨附應用程式手動設定錶面。
安裝回應
為方便進行啟用階段,安裝階段應從手錶傳回下列資訊至手機:
- 安裝嘗試的結果
isWatchFaceActive()
的結果 - 用於判斷應用程式是否已擁有使用中的錶面。setWatchFaceAsActive()
是否已在先前呼叫 - Wear OS 應用程式應在本機追蹤及儲存這項資訊。這個 API 呼叫只能使用一次。
實行
安裝完成後,回應可能會指出應用程式已具有有效的錶面。但如果沒有,應用程式可能會選擇顯示按鈕,以便將錶面設為使用中。
情境 1:嘗試設定使用中的錶面時,所有嘗試都失敗
如果安裝作業的回應指出 setWatchFaceAsActive()
先前已呼叫過,則按鈕應會導向手機上的說明畫面,向使用者顯示如何輕觸並按住錶面,以手動將錶面設為所需錶面。
情境 2:嘗試設定使用中的錶面
手機應指示手錶檢查是否具備必要的 SET_PUSHED_WATCH_FACE_AS_ACTIVE
權限:
- 如果使用者已授予權限,請繼續呼叫 setWatchFaceAsActive()。
- 如果使用者先前拒絕授予權限,手錶應將此資訊傳回手機,以便手機顯示說明畫面,說明需要授予權限的原因,以及如何手動授予權限。
如果權限先前未曾要求,手錶應指示手機顯示教育性內容,引導使用者瞭解如何在手錶上接受權限,然後手錶應繼續要求權限。
- 如果使用者授予權限,手錶就會呼叫
setWatchFaceAsActive()
。 - 否則,手錶應指示手機顯示說明畫面,說明需要權限的原因,以及如何手動授予權限。
- 如果使用者授予權限,手錶就會呼叫