Android 上的 Commissioning API 支援 Matter 的多重管理 (或多重管理員),也就是說,Commissioning API 可做為主要或次要的 Matter 委託人,且您可以新增自己的委託人:
主要Matter專員:
- 在這個模式中,系統會先使用 Google UX 新增 Google 網域。
- 你可以新增自訂的委員。
- 將 Google 網狀架構新增至裝置後,系統會呼叫你的專員,然後重新開啟 Matter 委派視窗。
- 如果 Google 無法基於任何原因,先完成自己的網狀架構委派程序,自訂委派服務就不會執行。
次要Matter專員:
- 在這個模式中,您可以實作自己的委派 UX,並加入自己的網狀架構 (或其他網狀架構)。
- 之後可使用開啟的委派視窗呼叫 Google Commissioning API,新增 Google 網狀架構。在這個模式下,Google 強烈建議您在使用者授予您使用 Home API 的權限後,應用程式主動提示使用者新增 Google 的網狀架構 (使用 Commissioning API),並在完成委派流程後執行這項操作。
如何使用 Commissioning API 做為主要 Matter 委派員
以下步驟說明 Google 偏好的Matter完整委派流程:
使用者在應用程式中啟動委派流程。舉例來說,使用者輕觸標示為「新增裝置」的按鈕。
Google UX 會接管控制權並顯示「掃描 QR code」畫面,讓使用者掃描 QR code 開始設定程序。Matter
在「將這部裝置連結至 Google 帳戶」畫面中,使用者輕觸「我同意」,即可將裝置新增至 Google 生態系統。如果使用者改為輕觸這個畫面上的「取消」,裝置委派程序就會立即終止。
在「選擇住家」畫面中,使用者選取可控制裝置的住家。如果沒有住家,系統會建立新的住家。 如果系統在住家中找不到適當的中樞裝置,或使用者沒有權限,委派程序就會結束。
接著會顯示「已連線裝置」畫面,並開始Matter設定Matter程序。使用者可以在這個畫面上選擇會議室和裝置名稱。
裝置加入 Matter 網狀架構時,畫面上會顯示「正在設定裝置」。
應用程式會恢復控制權,且自訂委派人 (如已註冊) 現在會執行。
如何以次要 Matter 委派者身分使用 Commissioning API
以下步驟說明Matter委任流程,其中委任程序會在 Google 委任程序之前進行:
使用者在應用程式中啟動委派流程。舉例來說,使用者輕觸「新增裝置」。
執行調試 UX 程序,將裝置新增至你的 Fabric。
完成後,您可以根據對使用者的瞭解,決定後續行為。舉例來說,如果使用者已選擇加入 Google Home API,這可能表示使用者想委託 Google 進行設定,您就可以觸發設定程序。
您的程序會呼叫 Commissioning API 並提供酬載,其中包含密碼、鑑別器和其他可用資訊。
Google 調試程序會將裝置新增至 Google Fabric。