使用 Commissioning API 在您的應用程式中啟動偵錯流程有兩種方式:直接在您的應用程式中啟動,或透過快速配對流程中的應用程式選擇器啟動。本節將說明各項功能的 UX。
由應用程式發起
在這種情況下,使用者開始在您的應用程式中進行委託,通常是透過「新增裝置」的號召性用語 (CTA)。我們建議以以下方式顯示新增裝置按鈕:
- 使用者可以看到他們所有的設備,例如 控制項 頁面
- 使用者可管理住家的位置,例如「設定」頁面
- 應用程式的「首頁」
完成委派後,建議將使用者帶往應用程式的首頁,或應用程式中顯示使用者剛設定的裝置控制器,或顯示所有裝置完整清單 (包括剛設定的裝置) 的位置。
如圖 2 所示:
應用程式使用者點選 新增裝置。
使用者掃描 QR code 或輸入配對碼。
系統會提示使用者同意將裝置新增至 Google 網狀架構 (這對應於圖 1 中的「同意聲明 + 中繼資料」),並選取要使用的 Google 帳戶。
如果使用者有多個住家,系統會提示選取住家。如果他們沒有設定家庭,則會自動建立一個名為「家庭」的家庭。
調試 API 連接到設備。
使用者需要選擇設備所在的房間。
系統會提示使用者重新命名裝置。
調試 API 產生 Matter 憑證,檢查網路連接,然後執行調試過程,將設備連接到選定的網路結構。
如果已授予使用者住家和裝置的權限,裝置應該會與該住家的其他裝置一起顯示在 Google Home 中,並可透過應用程式控制。
如果尚未授予使用者住家和裝置的存取權,裝置應該還不會顯示在應用程式中,也無法透過應用程式控制。 必須授予權限,才能在應用程式中存取及控制裝置。
由快速配對功能發起
你也可以在 Android 裝置上使用快速配對功能啟動委派程序。掃描裝置的 Matter QR code 後,系統會提示使用者選取應用程式,繼續完成委派程序。選擇您的應用程式會利用應用程式中的偵錯 API,如圖 3 所示。
如果使用者未在行動裝置上安裝應用程式,系統會提示他們先安裝應用程式,再繼續操作。從同意畫面開始的使用者體驗與圖 2 中的相同。
用戶將被提示掃描二維碼。
使用者掃描裝置的 Matter QR code。
用戶需要選擇一個應用程式來繼續調試過程。
如果尚未安裝應用程式,系統會提示使用者安裝。
該應用程式可從 Google Play 商店下載。
應用程式已安裝。
應用程式安裝完成後,系統會提示使用者繼續操作。
系統會提示使用者同意將裝置新增至 Google Fabric(這對應於圖 1 中的「同意 + 元資料」),並選擇要使用的 Google 帳戶。
如果使用者有多個住家,系統會提示選取住家。如果對方尚未設定住家,系統會自動建立名為「住家」的住家。
調試 API 連接到設備。
使用者需要選擇設備所在的房間。
系統會提示使用者重新命名裝置。
調試 API 產生 Matter 憑證,檢查網路連接,然後執行調試過程,將設備連接到選定的網路結構。
如果已授予使用者住家和裝置的權限,裝置應該會與該住家的其他裝置一起顯示在 Google Home 應用程式中,並可透過應用程式控制。
如果尚未授予對使用者結構和設備的權限,則該設備在應用程式中也不應可見或可控制。 需要權限 才能在應用程式中存取和控制裝置。
應用選擇器
在委派程序中,應用程式挑選器會顯示應用程式的方式有兩種:
- 在選擇一個應用螢幕.
- 如果使用者選擇 選擇其他應用程式,則會在 其他已安裝應用程式 畫面上顯示。
推薦應用
應用程式挑選器會顯示兩個建議的應用程式。
- 第一個始終是Google Home app (GHA)。
- 第二個是設備製造商首選的應用程序,如果它在與設備的 VID 或 PID 關聯的 Google Home Developer Console 項目中定義。(此選項不適用於不建置Matter裝置的應用程式開發者。)
當應用程式處於 選擇應用 螢幕時,有兩種情況。
- 已安裝 - Google Play services 檢查應用程式是否支援
ACTION_COMMISSION_DEVICEintent 過濾器。如果缺少意圖過濾器,則會將使用者引導至 Play 商店更新應用程式。 - 未安裝 - 使用者將被引導至 Play 商店安裝應用程式後再繼續。