Google Home Sample App for Matter 使用 Google Home Mobile SDK 建立類似 Google Home app (GHA) 的 Android 應用程式。這個範例應用程式提供下列功能：
- 將實體和虛擬 Matter 裝置配對到本機 Android 生態系
- 將實體和虛擬裝置配對到開發生態系
- 控制開發 Fabric 上的裝置，例如開燈
- 多管理員功能可讓您與其他應用程式共用開發架構上的裝置，反之，也能將其他應用程式共用的裝置納入開發架構
- 開發人員公用程式
本指南說明如何安裝 Sample App for Matter APK，並使用該 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，會更容易調查。
- 使用
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 存放區的版本專區。在「Assets」部分中，找出最新版本名為
GHSAFM-version-default-debug.apk的 APK。請勿選取targetcommissioner。安裝 Android Debug Bridge (adb)：
使用 USB 連接 Android 裝置並啟用「File Transfer」，然後安裝 APK：
$ adb unroot && adb install GHSAFM-version-default-debug.apk
委任裝置
首次啟動範例應用程式時，系統會顯示對話方塊，其中包含 Sample App for Matter 程式碼實驗室的連結。如果選取「Don't show this message again」，您隨時可以在應用程式的「管理」部分更新偏好設定，重新顯示對話方塊。
在後續步驟中，您會將 Matter 裝置新增至本機 Android Fabric，以及僅限範例應用程式本機的開發 Fabric。
什麼是 Matter 網路？
Matter 網路架構是家用網路中裝置之間的共用信任網域，可讓裝置彼此通訊。
裝置可能有一或多個 Fabric，對應至平台、應用程式或一組互動的裝置。Fabric 具有專屬 ID，裝置會共用同一組憑證和憑證授權單位 (CA)。這些憑證會在 Matter 委任期間指派。
如要委任 Matter 裝置，請完成下列步驟：
輕觸「 Add Device」按鈕，開始進行委任程序。
接著，控制權會轉移至 Google Play services，這是透過呼叫 Mobile SDK 啟動。如要建立擁有權證明，請掃描 QR code 或輕觸「使用配對碼」。
完成後，輸入裝置名稱，然後輕觸「完成」。
裝置現已連線至本機 Android 網路和開發網路。
在委託裝置時，所有委託工作和相關畫面都會由 Play services 處理。這可提供一致的使用者體驗，且不必處理私密資訊權限，例如 Wi-Fi 和 Thread 憑證。
控制裝置
開發 Fabric 會建立憑證，直接從範例應用程式控制 Matter 裝置。
在主畫面上，你可以切換裝置的「開啟」或「關閉」狀態。輕觸裝置即可查看詳細資料。
共用裝置
在 Matter 規格中，共用裝置稱為「多管理員流程」。裝置委託給範例應用程式後，即可輕鬆與其他生態系統共用。
如要與其他生態系統共用 Matter 裝置，必須在 Android 裝置上安裝其他平台。這個外部平台會成為「目標委任者」。我們已建立另一個範例應用程式執行個體，可做為目標委任端。
前往 Sample App for Matter GitHub 存放區的版本專區。在「Assets」部分中，找出最新版本名為
GHSAFM-version-targetcommissioner-debug.apk的 APK。請勿選取default。安裝目標委任者。
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk在主畫面輕觸裝置，即可顯示裝置資訊。輕觸「分享」。
範例應用程式會呼叫 Mobile SDK Share API，並再次將控制權轉移至 Play services。
系統會顯示分享工作表，讓您選擇要與裝置配對的應用程式或平台。這個畫面提供兩種分享裝置的方式：
- 手動輸入設定碼，並與目標委任者應用程式共用
- 使用已註冊為 Matter 委任者的本機 Android 應用程式
目標委託者應用程式標示為 GHSAFM-TC。輕觸這個範例應用程式執行個體，即可分享裝置。
接著，外部應用程式 (目標委任者) 會完成裝置委任，將裝置加入自己的 Fabric。
設定
在主畫面中，按一下「設定」圖示 。您可以在這裡更新使用者偏好設定、取得說明，以及進一步瞭解應用程式。
半頁通知
在「設定」畫面中，你可以選擇停用 Matter 裝置的主動式可委任探索通知。
如果應用程式提供自己的 Matter 探索或委任流程，建議您隱藏這些通知，以免造成干擾。詳情請參閱「隱藏可委託探索通知」。
開發人員公用程式
您也可以在「設定」畫面中存取「開發人員公用程式」。
如要在 Logcat 中查看裝置和使用者偏好設定 DataStore 存放區的內容，請完成下列步驟：
按一下「記錄存放區內容」。
在對話方塊中按一下「OK」，然後查看「Logcat」。
意見回饋和說明
如要提交想法或意見，協助我們改善 Sample App for Matter 的開發體驗，請填寫意見回饋表單。
如果 Sample App for Matter 發生問題，請嘗試完成下列步驟，驗證環境：
如果您對使用範例應用程式有任何疑問，或發現程式碼錯誤，可以將問題提交至 GitHub 存放區中的 Issue Tracker：
如要取得 Google 針對技術問題提供的官方指引，請使用智慧住宅開發人員論壇：
如要向社群尋求技術支援，請在 Stack Overflow 上使用 google-smart-home 標記：