Google Home Sample App for Matter 會使用 Google Home Mobile SDK 建立類似 Google Home app (GHA) 的 Android 應用程式。這個範例應用程式提供下列功能:
- 將實體和虛擬 Matter 裝置委派至本機 Android 結構體
- 將實體和虛擬裝置委託開發架構
- 透過開發架構控制裝置,例如開啟 輕微
- 多管理員功能可讓您與其他應用程式共用開發結構上的裝置,反之亦然,您也可以將其他應用程式共用的開發結構裝置納入其中
- 開發人員公用程式
本指南說明如何安裝 Sample App for Matter APK 及使用 控制及共用 Matter 部裝置
如要下載原始碼,請瞭解如何整合 Mobile SDK,以及自訂 Android Studio 中的畫面,請試用我們的 Sample App for Matter 程式碼研究室。
前往 Sample App for Matter 程式碼研究室
必要條件
- 搭載 Android O (8.1,API 級別 27) 以上版本的裝置,可供測試。如要確認裝置支援最新的 Matter,請參閱「驗證 Matter 模組和服務」指南。
- 建構具備開/關功能的 Matter 裝置。這個範例應用程式可搭配虛擬裝置和 ESP32 使用。
- Matter 虛擬裝置 (MVD)。 為盡量減少環境問題,我們強烈建議您一開始使用 MVD。如果您遭遇問題,大幅簡化 調查範例應用程式是否用於 MVD。
- 建構 Matter 虛擬裝置
rootnode_dimmablelight_bCwGYSDpoe
應用程式。當您 建立 Matter 整合 Google Home Developer Console, 使用0xFFF1
做為供應商 ID,產品 ID 則是0x8000
。 - 建構 Espressif 裝置
使用
all-clusters-app
。在 Developer Console 中建立 Matter 整合時,請使用0xFFF1
做為廠商 ID,並使用0x8001
做為產品 ID。
您不需要中樞裝置 (例如 Google Nest Hub (2nd gen)),即可透過 Sample App for Matter 啟用及控制裝置。
安裝
前往「版本」部分 Sample App for Matter GitHub Cloud Storage 也提供目錄同步處理功能如要查看最新版本,請前往「資產」部分 名為
GHSAFM-version-default-debug.apk
。不要選取targetcommissioner
。安裝 Android Debug Bridge (ADB):
使用 USB 連接 Android 裝置並啟用「檔案傳輸」,然後安裝 APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
佣金裝置
首次啟動範例應用程式時,系統會顯示對話方塊,其中含有 Sample App for Matter 程式碼研究室的連結。 如果您選取「不要再顯示這則訊息」,可以再次顯示對話方塊 只要前往應用程式的「管理」部分更新偏好設定即可。
在後續步驟中,您會新增Matter裝置 本地 Android 織布以及適用於樣品的開發布料 僅限應用程式。
什麼是 Matter 架構?
Matter 架構是各裝置間的信任網域 能夠與彼此通訊
裝置可能會有一或多個結構體,對應至平台、應用程式或一組互動裝置。布料與 ID 和裝置共用同一組憑證和憑證授權單位 (CA)。這些憑證會在 Matter 調試期間指派。
如要啟用 Matter 裝置,請完成下列步驟:
輕觸「新增裝置」按鈕
,即可開始調試程序。接著,控制項會轉移至已啟動的 Google Play services 呼叫 Mobile SDK。為了證明 手上,輕觸「掃描 QR code」或輕觸「使用配對碼」。
執行完畢後,請輸入裝置名稱,然後輕觸「完成」。
您的裝置現在已連線至本機 Android 結構體和開發結構體。
Play services 會在裝置啟用時處理所有啟用工作和相關畫面。這個 讓使用者享有一致的體驗,不需自行處理 例如 Wi-Fi 和 Thread 憑證
控制裝置
開發架構會建立憑證來控管 透過範例應用程式即可下載 Matter 部裝置。
你可以在主畫面上將裝置切換為「開啟」或「關閉」。輕觸裝置即可查看裝置詳細資料。
共用裝置
共用裝置在 Google Workspace 環境稱為「多管理員流程」 Matter 規格。 裝置委託範例應用程式後,您可以輕鬆將其分享給其他生態系統。
如要與其他生態系統共用「Matter」裝置,請按照下列步驟操作: 則您必須在 Android 裝置上安裝其他平台。這個外部平台會成為目標委託人。我們另外建立了 範例應用程式的執行個體,可做為目標委託工具使用。
前往「版本」部分 Sample App for Matter GitHub Cloud Storage 也提供目錄同步處理功能如需最新版本,請在「Assets」部分找出名為
GHSAFM-version-targetcommissioner-debug.apk
的 APK。不要選取default
。安裝目標委託工具。
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
在主畫面上,輕觸裝置即可顯示裝置資訊。輕觸 分享。
範例應用程式會呼叫 Mobile SDK Share API,然後再次將控制權轉移至 Play services。
分享工作表會隨即顯示,讓你選擇要編輯的應用程式或平台 要將裝置配對這個畫面提供兩種分享裝置的方式:
- 手動透過設定代碼,與目標佣金應用程式共用
- 使用已註冊為 Matter 委員
目標佣金應用程式已加上「GHSAFM-TC」GHSAFM-TC標籤。只要輕觸這裡的 共用裝置範例。
接著,外部應用程式 (目標系統) 會完成 成型的布料。
設定
在主畫面上,按一下「設定」圖示
。這個區塊可讓您 更新使用者偏好設定、取得說明及進一步瞭解應用程式。資訊表通知
您可以在「設定」畫面中選擇停用主動式佣金功能 探索通知 (Matter 部裝置)。
如果您的應用程式有自己的 Matter 探索或 為了讓流量順利進行,建議您隱藏這些通知 幹擾。請參閱略過可佣金探索的探索 通知 瞭解詳情
開發人員公用程式
您也可以透過「設定」畫面存取開發人員公用程式。
如要在 Logcat 中查看裝置和使用者偏好設定 DataStore 存放區的內容,請完成下列步驟:
按一下「Log repositories content」。
按一下對話方塊中的「OK」,然後勾選「Logcat」。
意見回饋和說明
歡迎提出意見或意見,協助我們改善開發功能 請填寫意見回饋表單。Sample App for Matter
如果無法順利使用「Sample App for Matter」,請嘗試完成後續操作 驗證環境的步驟:
如果對使用範例應用程式有疑問,或發現程式碼錯誤, 可以將問題提交至 GitHub 存放區的 Issue Tracker:
如要取得 Google 技術問題的官方指南,請使用智慧住宅開發人員論壇:
如要取得社群的技術支援,請使用 google-smart-home
標記,
Stack Overflow: