在 Android 上啟用使用者體驗

使用 Commissioning API 在您的應用程式中啟動偵錯流程有兩種方式:直接在您的應用程式中啟動,或透過快速配對流程中的應用程式選擇器啟動。本節將說明各項功能的 UX。

由應用程式發起

在這種情況下,使用者開始在您的應用程式中進行委託,通常是透過「新增裝置」的號召性用語 (CTA)。我們建議以以下方式顯示新增裝置按鈕:

  • 使用者可以看到他們所有的設備,例如 控制項 頁面
  • 使用者可管理住家的位置,例如「設定」頁面
  • 應用程式的「首頁」

完成委派後,建議將使用者帶往應用程式的首頁,或應用程式中顯示使用者剛設定的裝置控制器,或顯示所有裝置完整清單 (包括剛設定的裝置) 的位置。

如圖 2 所示:

  • 應用程式啟動的委派程序 (步驟 1)

    應用程式使用者點選 新增裝置

  • 應用程式啟動的委派程序 (步驟 2)

    使用者掃描 QR code 或輸入配對碼。

  • 應用程式發起的調試(步驟 3)

    系統會提示使用者同意將裝置新增至 Google 網狀架構 (這對應於圖 1 中的「同意聲明 + 中繼資料」),並選取要使用的 Google 帳戶。

  • 應用程式啟動的委派程序 (步驟 4)

    如果使用者有多個住家,系統會提示選取住家。如果他們沒有設定家庭,則會自動建立一個名為「家庭」的家庭。

  • 應用程式發起的調試(步驟 5)

    調試 API 連接到設備。

  • 應用程式發起的調試(步驟 6)

    使用者需要選擇設備所在的房間。

  • 應用程式啟動的委派程序 (步驟 8)

    系統會提示使用者重新命名裝置。

  • 應用程式發起的調試(步驟 10)

    調試 API 產生 Matter 憑證,檢查網路連接,然後執行調試過程,將設備連接到選定的網路結構。

  • 應用程式發起的調試(步驟 11)

    如果已授予使用者住家和裝置的權限,裝置應該會與該住家的其他裝置一起顯示在 Google Home 中,並可透過應用程式控制。

    如果尚未授予使用者住家和裝置的存取權,裝置應該還不會顯示在應用程式中,也無法透過應用程式控制。 必須授予權限,才能在應用程式中存取及控制裝置。

圖 2:應用程式發起的偵錯

由快速配對功能發起

你也可以在 Android 裝置上使用快速配對功能啟動委派程序。掃描裝置的 Matter QR code 後,系統會提示使用者選取應用程式,繼續完成委派程序。選擇您的應用程式會利用應用程式中的偵錯 API,如圖 3 所示。

如果使用者未在行動裝置上安裝應用程式,系統會提示他們先安裝應用程式,再繼續操作。從同意畫面開始的使用者體驗與圖 2 中的相同。

  • 快速配對委派 (步驟 1)

    用戶將被提示掃描二維碼。

  • 快速配對委派 (步驟 2)

    使用者掃描裝置的 Matter QR code。

  • 快速配對委派 (步驟 3)

    用戶需要選擇一個應用程式來繼續調試過程。

  • 快速配對調試(步驟 4)

    如果尚未安裝應用程式,系統會提示使用者安裝。

  • 快速配對委派 (步驟 5)

    該應用程式可從 Google Play 商店下載。

  • 快速配對調試(步驟 6)

    應用程式已安裝。

  • 快速配對委派 (步驟 7)

    應用程式安裝完成後,系統會提示使用者繼續操作。

  • 快速配對調試(步驟 8)

    系統會提示使用者同意將裝置新增至 Google Fabric(這對應於圖 1 中的「同意 + 元資料」),並選擇要使用的 Google 帳戶。

  • 快速配對委派 (步驟 9)

    如果使用者有多個住家,系統會提示選取住家。如果對方尚未設定住家,系統會自動建立名為「住家」的住家。

  • 快速配對委派 (步驟 10)

    調試 API 連接到設備。

  • 快速配對調試(步驟 11)

    使用者需要選擇設備所在的房間。

  • 快速配對調試(步驟 13)

    系統會提示使用者重新命名裝置。

  • 快速配對調試(步驟 15)

    調試 API 產生 Matter 憑證,檢查網路連接,然後執行調試過程,將設備連接到選定的網路結構。

  • 快速配對調試(步驟 16)

    如果已授予使用者住家和裝置的權限,裝置應該會與該住家的其他裝置一起顯示在 Google Home 應用程式中,並可透過應用程式控制。

    如果尚未授予對使用者結構和設備的權限,則該設備在應用程式中也不應可見或可控制。 需要權限 才能在應用程式中存取和控制裝置。

圖 3:快速配對偵錯

應用選擇器

應用選擇器視圖,顯示兩個可供選擇的應用程式。

在委派程序中,應用程式挑選器會顯示應用程式的方式有兩種:

  1. 選擇一個應用螢幕.
  2. 如果使用者選擇 選擇其他應用程式,則會在 其他已安裝應用程式 畫面上顯示。

推薦應用

應用程式挑選器會顯示兩個建議的應用程式。

  • 第一個始終是Google Home app (GHA)
  • 第二個是設備製造商首選的應用程序,如果它在與設備的 VID 或 PID 關聯的 Google Home Developer Console 項目中定義。(此選項不適用於不建置Matter裝置的應用程式開發者。) 設備製造商首選委託人應用程式

當應用程式處於 選擇應用 螢幕時,有兩種情況。

  1. 已安裝 - Google Play services 檢查應用程式是否支援 ACTION_COMMISSION_DEVICE intent 過濾器。如果缺少意圖過濾器,則會將使用者引導至 Play 商店更新應用程式。
  2. 未安裝 - 使用者將被引導至 Play 商店安裝應用程式後再繼續。