在 Android 上啟用使用者體驗

在應用程式中使用 Commissioning API 啟動委任流程的方式有兩種:直接在應用程式中啟動,或在快速配對程序中透過應用程式挑選器啟動。本節將說明各項功能的使用者體驗。

由應用程式啟動

在這種情況下,使用者會在應用程式中開始授權,通常是透過「新增裝置」的行動號召 (CTA)。建議您按照下列方式顯示「新增裝置」按鈕:

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

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

使用者體驗如圖 2 所示:

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

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

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

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

  • 應用程式啟動的委任程序 (步驟 3)

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

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

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

  • 應用程式啟動的委任程序 (步驟 5)

    Commissioning API 會連線至裝置。

  • 應用程式啟動的委任程序 (步驟 6)

    系統會提示使用者選取裝置所在的房間。

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

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

  • 應用程式啟動的調試程序 (步驟 10)

    Commissioning API 會產生 Matter 憑證、檢查網路連線,然後執行調試程序,將裝置連線至所選 Fabric。

  • 應用程式啟動的委任程序 (步驟 11)

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

    如果尚未取得使用者住家結構體和裝置的權限,應用程式就不應顯示或控制裝置。 必須取得權限,才能在應用程式中存取及控制裝置。

圖 2:應用程式啟動的委任程序

由快速配對功能啟動

你也可以在 Android 裝置上使用快速配對功能啟動。掃描裝置的 Matter QR code 後,系統會提示使用者選取應用程式,繼續進行委任程序。選取應用程式後,系統會使用應用程式的 Commissioning API,如圖 3 所示。

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

  • 快速配對偵測 (步驟 1)

    系統會提示使用者掃描 QR code。

  • 快速配對偵測 (步驟 2)

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

  • 快速配對設定 (步驟 3)

    系統會提示使用者選取應用程式,繼續進行委任程序。

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

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

  • 快速配對偵測 (步驟 5)

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

  • 快速配對偵測 (步驟 6)

    應用程式已安裝。

  • 快速配對偵測 (步驟 7)

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

  • 快速配對偵測 (步驟 8)

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

  • 快速配對偵測 (步驟 9)

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

  • 快速配對偵測 (步驟 10)

    Commissioning API 會連線至裝置。

  • 快速配對偵測 (步驟 11)

    系統會提示使用者選取裝置所在的房間。

  • 快速配對偵測 (步驟 13)

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

  • 快速配對偵測 (步驟 15)

    Commissioning API 會產生 Matter 憑證、檢查網路連線,然後執行委任程序,將裝置連線至所選 Fabric。

  • 快速配對偵測 (步驟 16)

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

    如果尚未取得使用者住家結構體和裝置的權限,應用程式就不應顯示或控制裝置。 必須取得權限,才能在應用程式中存取及控制裝置。

圖 3:快速配對調試

應用程式挑選器

應用程式挑選器畫面,顯示兩個可供選擇的應用程式

在委任程序中,應用程式會以兩種方式顯示在應用程式挑選器中:

  1. 在「選擇應用程式」畫面中。
  2. 如果使用者選取「Choose other app」,系統會顯示「Other Installed Apps」畫面。

建議使用的應用程式

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

  • 第一個一律為 Google Home app (GHA)。
  • 第二個是裝置製造商偏好的應用程式,前提是該應用程式已在與裝置 VID 或 PID 相關聯的 Google Home Developer Console 專案中定義。(這個選項不適用於未建構 Matter 裝置的應用程式開發人員)。裝置製造商偏好的委任者應用程式

「選擇應用程式」畫面會顯示兩種情況。

  1. 已安裝 - Google Play services 檢查應用程式是否支援 ACTION_COMMISSION_DEVICE 意圖篩選器。如果缺少意圖篩選器,系統會將使用者導向 Play 商店更新應用程式。
  2. 未安裝:系統會將使用者導向 Play 商店,要求安裝應用程式後再繼續。