啟用 Commissioning API 的多管理員

啟用 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 全功能啟用流程:

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

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

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

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

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

  6. 裝置加入 Matter 結構體時,畫面會顯示「準備裝置」畫面。

  7. 應用程式會恢復控制權,而自訂委派者 (如果已註冊) 也會立即執行。

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

這些步驟會顯示 Matter 啟用流程,其中啟用程序會在 Google 啟用程序之前執行:

  1. 使用者在應用程式中啟動委派流程,例如輕觸「Add Device」

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

  3. 完成後,您可以根據對使用者的瞭解,決定後續行為。舉例來說,如果使用者已選擇採用 Google Home API,這可能表示使用者想向 Google 收取佣金,因此您可以觸發委託程序。

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

  5. Google 調試程序會將裝置新增至 Google 結構體。