Android 版 Commissioning API 的多管理員

Android 上的 Commissioning API 支援 Matter 的多重管理 (或多重管理),這表示 Commissioning API 可做為主要或次要 Matter 委託者,且您可以新增自己的委託者:

  • Matter 主要委託人:

    • 在這個模式中,系統會先使用 Google UX 新增 Google Fabric。
    • 你可以新增自訂委託人。
      • 將 Google 結構新增至裝置後,系統會呼叫您的委託者,然後重新開啟 Matter 委託視窗。
      • 如果 Google 因任何原因無法先完成自身 Fabric 的委任作業,就不會執行自訂委任服務。
  • Matter 次要委託人:

    • 在這種模式下,您可以實作自己的委託使用者體驗,並將裝置加入自己的 Fabric (或其他 Fabric)。
    • 之後,您可以在開放的委任視窗中呼叫 Google Commissioning API,新增 Google Fabric。在這種模式下,Google 強烈建議,當使用者授予您使用 Home API 的權限時,應用程式應在完成調試流程後,主動提示使用者新增 Google 的 Fabric (使用 Commissioning API)。

如何使用 Commissioning API 做為主要 Matter 委託者

以下步驟說明 Google 偏好的 Matter 完整功能委任流程:

  1. 使用者在應用程式中啟動委任流程。例如,使用者輕觸標示為「Add Device」的按鈕。

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

  3. 在「將這部裝置連結至 Google 帳戶」畫面上,使用者輕觸「我同意」,將裝置新增至 Google 生態系統。如果使用者改為輕觸這個畫面上的「取消」,所有裝置委任作業都會立即結束。

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

  5. 接著,系統會顯示「Device connected」畫面,並開始Matter設定程序。使用者可以在這個畫面選擇房間和裝置名稱。

  6. 裝置加入 Matter 網路時,系統會顯示「正在設定裝置」畫面。

  7. 應用程式會重新取得控制權,如果已註冊自訂委任者,則會立即執行。

如何使用 Commissioning API 做為次要 Matter 委託者

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

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

  2. 執行調試使用者體驗程序,將裝置新增至 Fabric。

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

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

  5. Google 委任程序會將裝置新增至 Google 結構。