啟用 API 可支援 Matter 的多管理 (或稱為多管理員),這表示啟用 API 可做為主要或次要 Matter 啟用者,您也可以新增自己的啟用者:
身為主要 Matter 委任者:
- 在這個模式中,Google 架構會先使用 Google UX 進行新增。
- 您可以新增自訂委託人。
- 在 Google 結構體新增至裝置後,系統會呼叫委派者,然後重新開啟 Matter 委派作業視窗。
- 如果 Google 因任何原因無法先完成自家結構體的調試作業,自訂調試服務就不會執行。
作為次要 Matter 委派人員:
- 在這個模式中,您可以實作自己的啟用使用者體驗,並將其納入自己的結構體 (或其他結構體)。
- 日後可透過開放的啟用作業視窗呼叫 Google Commissioning API,以便新增 Google 架構。在這個模式中,Google 強烈建議在使用者授予您使用 Home API 的權限後,應用程式應主動提示使用者在啟用流程完成後新增 Google 的結構 (使用啟用 API)。
如何使用啟用 API 做為主要 Matter 啟用者
以下步驟說明 Google 偏好的 Matter 全功能啟用流程:
使用者在應用程式中啟動委派流程,例如輕觸標示為「Add Device」的按鈕。
Google UX 會接管並顯示「Scan Matter QR Code」畫面,讓使用者掃描 QR code 開始設定程序。
在「將這部裝置連結至 Google 帳戶」畫面上,使用者輕觸「我同意」,將裝置新增至 Google 生態系統。如果使用者改為輕觸畫面上的「取消」,所有裝置委派作業都會立即結束。
在「選擇住家」畫面上,使用者可選取要用來控制裝置的住家。如果沒有可用的住家,系統會建立新的住家。如果家中沒有適合的中樞,或是使用者缺少權限,就會結束委派程序。
接著會顯示「Device connected」畫面,並開始設定 Matter。使用者可以在這個畫面上選擇會議室和裝置名稱。
裝置加入 Matter 結構體時,畫面會顯示「準備裝置」畫面。
應用程式會恢復控制權,而自訂委派者 (如果已註冊) 也會立即執行。
如何以次要 Matter 委派者身分使用啟用 API
這些步驟會顯示 Matter 啟用流程,其中啟用程序會在 Google 啟用程序之前執行:
使用者在應用程式中啟動委派流程,例如輕觸「Add Device」。
執行調試使用者體驗程序,將裝置新增至 Fabric。
完成後,您可以根據對使用者的瞭解,決定後續行為。舉例來說,如果使用者已選擇採用 Google Home API,這可能表示使用者想向 Google 收取佣金,因此您可以觸發委託程序。
您的程序會呼叫啟用 API,並提供酬載,其中包含密碼、辨別符和其他可用資訊。
Google 調試程序會將裝置新增至 Google 結構體。