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 搭配使用。
- 使用
rootnode_dimmablelight_bCwGYSDpoe
應用程式建構 Matter 虛擬裝置。在 Google Home Developer Console 中建立 Matter 整合時,請以0xFFF1
做為供應商 ID,並使用0x8000
做為產品 ID。 - 使用
all-clusters-app
建構 Espressif 裝置。在 Developer Console 中建立 Matter 整合時,使用0xFFF1
做為供應商 ID,並將0x8001
設為產品 ID。
- 使用
您不需要中樞 (例如 Google Nest Hub (2nd gen)),即可利用 Sample App for Matter 委託及控制裝置。
安裝
前往 Sample App for Matter GitHub 存放區中的「Releases」區段。找出名為
GHSAFM-1.4.1-default-debug.apk
的 APK。請勿選取targetcommissioner
:安裝 Android Debug Bridge (ADB):
使用 USB 連接 Android 裝置並啟用檔案傳輸功能,然後安裝 APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
佣金裝置
首次啟動範例應用程式時,系統會顯示對話方塊,其中含有 Sample App for Matter 程式碼研究室的連結。如果選取「不要再顯示這則訊息」,您可以隨時更新應用程式「管理」部分中的偏好設定,再次顯示對話方塊。
在後續步驟中,您會將 Matter 裝置新增至本機 Android 布料,以及只納入範例應用程式的開發布料。
什麼是 Matter 布料?
Matter 布料是家用裝置共用的信任網域,可讓裝置互相通訊。
裝置可使用多種布料,以對應某個平台、應用程式或一組裝置彼此互動。Fabrics 具有專屬 ID,且裝置會共用同一組憑證和憑證授權單位 (CA)。這些憑證會在 Matter 修訂期間指派。
如要委託 Matter 裝置,請完成下列步驟:
輕觸
「Add Device」按鈕,開始執行佣金程序。接著,將控制項轉移到 Google Play services,並透過呼叫 Mobile SDK 啟動。如要建立持有證明,請輕觸「掃描 QR 圖碼」或輕觸「使用配對碼」。
建立完成後,輸入裝置名稱,然後輕觸「完成」。
裝置現已連線至本機 Android 布料和開發布料。
計算裝置時,所有佣金工作和相關畫面都由 Play services 處理。如此一來,使用者就能享有一致的使用者體驗,也不必處理機密權限,例如 Wi-Fi 和 Thread 憑證。
控制裝置
開發架構會建立憑證,以便直接從範例應用程式控制 Matter 裝置。
在主畫面上,您可以將裝置切換為「開啟」或「關閉」。輕觸裝置即可存取裝置詳細資料。
共用裝置
在 Matter 規格中,共用裝置稱為「多重管理員流程」。裝置都通過範例應用程式後,您就可以輕鬆與其他生態系統共用裝置。
如要與其他生態系統共用 Matter 裝置,您必須在 Android 裝置上安裝另一個平台。這個外部平台會成為「目標佣金」。我們建立了範例應用程式的另一個執行個體,做為目標佣金程式。
前往 Sample App for Matter GitHub 存放區中的「Releases」區段。找出最近的 APK,名為
GHSAFM-[version]-targetcommissioner
,例如GHSAFM-1.4.1-targetcommissioner-debug.apk
:安裝目標佣金。
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
在主畫面上輕觸裝置,即可顯示裝置資訊。輕觸「分享」。
範例應用程式會呼叫 Mobile SDK Share API,再次將控制項轉移給 Play services。
畫面上會顯示共用工作表,讓您選擇要與裝置配對的應用程式或平台。此螢幕提供兩種共用裝置的方式:
- 透過設定代碼手動與目標佣金應用程式共用
- 使用已註冊為 Matter 佣金的本機 Android 應用程式
目標佣金應用程式會標示為 GHSAFM-TC。輕觸範例應用程式的範例以共用裝置。
接著,外部應用程式 (目標委員會) 會將裝置編譯成自己的布料。
設定
在主畫面上按一下
圖示。您可以選擇更新使用者偏好設定、取得說明以及進一步瞭解應用程式。半頁通知
在「設定」畫面中,您可以選擇停用 Matter 裝置的主動式探索探索通知。
如果您的應用程式提供專屬的 Matter 探索或佣金流程,建議您隱藏這些通知,以免服務中斷。詳情請參閱「略過佣金式探索通知」。
開發人員公用程式
在「設定」畫面中,您也可以存取開發人員公用程式。
如要在 Logcat 中查看裝置與使用者偏好設定 DataStore 存放區的內容,請完成下列步驟:
按一下「Log repositories content」(記錄存放區內容)。
按一下「OK」至對話方塊,然後勾選「Logcat」。
意見回饋和說明
如要提供寶貴意見或意見回饋,協助我們改善「Sample App for Matter」的開發體驗,請填寫意見回饋表單。
如果您在使用 Sample App for Matter 時遇到問題,請嘗試按照下列步驟驗證環境:
如果無法順利使用範例應用程式,或發現程式碼錯誤,您可以透過 GitHub 存放區中的 Issue Tracker 提交問題:
如要向 Google 取得技術相關問題的官方指引,請使用智慧型住宅開發人員論壇:
如需社群的技術支援,請在 Stack Overflow 上使用 google-smart-home
標記: