Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- 委託實體和虛擬機構 Matter devices to the Local Android fabric
- 將實體和虛擬裝置分發成開發布料
- 控制開發布料上的裝置,例如開燈
- 多重管理員功能可讓您與其他應用程式共用開發布局中的裝置,並允許將其他應用程式納入開發應用程式
- 開發人員公用事業
本指南說明如何安裝 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) , to commission and control devices with the Sample App for Matter.
安裝
前往 Sample App for Matter GitHub 存放區中的「Releases」(版本) 區段。找出名為
GHSAFM-1.2.2-default-debug.apk
的 APK。請勿選取targetcommissioner
:安裝 Android Debug Bridge (ADB):
透過 USB 連接 Android 裝置並啟用檔案傳輸,然後安裝 APK:
$ adb unroot && adb install GHSAFM-1.2.2-default-debug.apk
佣金裝置
初次啟動範例應用程式時,您會收到含有 Sample App for Matter 程式碼研究室連結的對話方塊。如果您選取 [不要再顯示這則訊息],您隨時可以在應用程式的「管理」部分中更新偏好設定,以重新顯示對話方塊。
在後續步驟中,您需要在本機 Android 織布上新增 Matter 裝置,以及僅提供給範例應用程式的開發架構。
什麼是 Matter 織布?
Fabric 是家用網路裝置之間的共用信任網域,可讓這些裝置互相通訊。
裝置可能具有一或多個對應於設計平台、應用程式或一組裝置的互動布料。布料學有專屬的 ID,且裝置共用同一組憑證和憑證授權單位 (CA)。系統會在這些憑證的指派期間指派這些憑證。 Matter
如要委任 Matter 裝置,請完成下列步驟:
輕觸「
新增裝置」按鈕,即可啟動佣金程序。接著,控制項會轉移至 Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
委任完成後,請輸入裝置名稱,然後輕觸 [完成]。
您的裝置現已連線至本機 Android 織布和開發布料。
委任裝置時,Play services 會處理所有修訂版本工作及相關畫面。這能夠提供一致的使用者體驗,且不需處理機密權限,例如 Wi-Fi 和 Thread 憑證。
控制裝置
開發架構會建立憑證,以便直接從範例應用程式控制 Matter 裝置。
在主畫面上,您可以開啟或關閉裝置,輕觸裝置即可存取裝置詳細資訊。
共用裝置
在 Matter 規格中,共用裝置的稱為多重管理員流程。將裝置加入範例應用程式後,您就可以輕鬆與其他生態系統分享裝置。
如要與其他生態系統共用 Matter 裝置,您必須在 Android 裝置上安裝其他平台。這個外部平台會成為目標佣金。我們建立了另一個範例應用程式,讓您用來當做目標委員會。
前往 Sample App for Matter GitHub 存放區中的「Releases」(版本) 區段。找出名為
GHSAFM-[version]-targetcommissioner
的最新 APK,例如GHSAFM-1.2.2-targetcommissioner-debug.apk
:安裝目標委員會。
$ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
在主畫面上輕觸裝置,即可查看裝置資訊。輕觸 [分享]。
範例應用程式會呼叫 Mobile SDK 共用 API,然後再次將控制項轉移至 Play services。
分享分享工作表,以便選擇裝置要配對的應用程式或平台。此畫面提供兩種共用裝置的方式:
- 透過設定代碼手動與目標佣金應用程式分享
- 使用已註冊為 Matter 委員會的本機 Android 應用程式
目標佣金應用程式會標示為 GHSAFM-TC。輕觸範例應用程式的例項以共用裝置。
接著,外部應用程式 (目標佣金) 將裝置的委任設定完成,將裝置傳送至自己的布料中。
設定
在主螢幕中按一下「設定」圖示
。您可以在這裡選擇更新使用者偏好設定、取得說明,以及深入瞭解應用程式。半工作表通知
在「設定」畫面中,您可以選擇停用 Matter 裝置的主動式探索通知。
如果您的應用程式提供自己的 Matter 探索或委託流程,建議您隱藏這些通知,以免服務中斷。詳情請參閱隱藏佣金探索通知。
開發人員公用程式
您也可以在「設定」畫面中存取「開發人員公用程式」。
如要查看 Logcat 中裝置與使用者偏好設定 DataStore 存放區的內容,請完成下列步驟:
按一下 [Log repositories content] (記錄存放區內容)。
按一下對話方塊的 [確定],然後勾選 [Logcat]。
意見回饋和說明
如要提交意見或意見回饋,協助我們改善 Sample App for Matter 的開發體驗,請填寫意見回饋表單。
如果您在使用 Sample App for Matter 時遇到問題,請嘗試完成相關步驟來驗證環境:
如果您對使用範例應用程式或發現程式碼錯誤有任何疑問,可以在 GitHub 存放區中向 Issue Tracker 提交問題:
如要向 Google 尋求技術性問題的官方指南,請使用智慧型住宅開發人員論壇:
如要取得社群的技術支援,請在 Stack Overflow 上使用 google-smart-home
標記: