Android 版 Commissioning API 的多管理員

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完整委派流程:

  1. 使用者在應用程式中啟動委派流程。舉例來說,使用者輕觸標示為「新增裝置」的按鈕。

  2. Google UX 會接管控制權並顯示「掃描 QR code」畫面,讓使用者掃描 QR code 開始設定程序。Matter

  3. 在「將這部裝置連結至 Google 帳戶」畫面中,使用者輕觸「我同意」,即可將裝置新增至 Google 生態系統。如果使用者改為輕觸這個畫面上的「取消」,裝置委派程序就會立即終止。

  4. 在「選擇住家」畫面中,使用者選取可控制裝置的住家。如果沒有住家,系統會建立新的住家。 如果系統在住家中找不到適當的中樞裝置,或使用者沒有權限,委派程序就會結束。

  5. 接著會顯示「已連線裝置」畫面,並開始Matter設定Matter程序。使用者可以在這個畫面上選擇會議室和裝置名稱。

  6. 裝置加入 Matter 網狀架構時,畫面上會顯示「正在設定裝置」

  7. 應用程式會恢復控制權,且自訂委派人 (如已註冊) 現在會執行。

如何以次要 Matter 委派者身分使用 Commissioning API

以下步驟說明Matter委任流程,其中委任程序會在 Google 委任程序之前進行:

  1. 使用者在應用程式中啟動委派流程。舉例來說,使用者輕觸「新增裝置」

  2. 執行調試 UX 程序,將裝置新增至你的 Fabric。

  3. 完成後,您可以根據對使用者的瞭解,決定後續行為。舉例來說,如果使用者已選擇加入 Google Home API,這可能表示使用者想委託 Google 進行設定,您就可以觸發設定程序。

  4. 您的程序會呼叫 Commissioning API 並提供酬載,其中包含密碼、鑑別器和其他可用資訊。

  5. Google 調試程序會將裝置新增至 Google Fabric。