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

在標準市集中，使用者與應用程式互動的主要方式是透過電話應用程式。

設定錶面

使用者在手機應用程式中選取錶面後，後續設定錶面的流程分為兩個部分：

1. 安裝：使用錶面推送功能安裝錶面，透過 MessageClient 啟動。這個步驟很簡單，只要使用 addWatchFace 或 updateWatchFace，並透過手機上的 MessageClient 觸發手錶即可。
2. 啟用： 將已安裝的錶面設為使用中。這個步驟有幾種可能的路徑，視權限狀態而定：
   • 無須採取任何行動。市集可能已控制使用中的錶面。
   • 可能不需要使用者介入。應用程式具備設定使用中錶面的必要權限，因此可以直接使用 setWatchFaceAsActive() 執行這項操作。
   • 可能需要相關指引，說明如何接受權限要求，或如何使用長按手勢或透過隨附應用程式手動設定錶面。

安裝回應

為利於「啟用」階段，請確保「安裝」階段會將下列資訊從手錶傳回手機：

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

啟用

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

情境 1：所有設定使用中錶面的嘗試都已用盡

如果安裝的回應指出 setWatchFaceAsActive() 先前已呼叫過，按鈕應會連往手機上的教學畫面，向使用者說明如何觸控並按住錶面，手動將錶面設為所需樣式。

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

手機應指示手錶檢查必要的SET_PUSHED_WATCH_FACE_AS_ACTIVE權限：

• 如果使用者已授予權限，請繼續呼叫 setWatchFaceAsActive()。
• 如果使用者先前拒絕授予權限，手錶應將此情況回報給手機，手機可以顯示說明畫面，解釋為何需要這項權限，以及如何手動授予權限。

• 如果先前未要求權限，手錶應指示手機顯示教育時刻，引導使用者接受手錶上的權限，然後手錶應繼續要求權限。

  • 如果使用者授予權限，手錶應呼叫 setWatchFaceAsActive()。
  • 否則，手錶應指示手機顯示教育資訊畫面，說明需要這項權限的原因，以及如何手動授予權限。