Google Home Sample App for Matter 會使用 Google Home Mobile SDK 建立類似 Google Home app (GHA) 的 Android 應用程式。此範例應用程式提供以下功能：
- 將實體和虛擬 Matter 裝置委派給本機 Android 網狀架構
- 為開發框架委託實體和虛擬設備
- 控制開發環境中的設備，例如開啟燈
- 多管理員功能可讓您與其他應用程式共享開發環境中的設備，反之亦然，也可以將從其他應用程式共享的設備新增至開發環境。
- 開發人員公用程式
本指南說明如何安裝 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 將更容易進行調查。
- 建造一個Matter虛擬設備和
rootnode_dimmablelight_bCwGYSDpoe應用程式.當你創建一個Matter一體化在Google Home Developer Console， 使用0xFFF1作為您的供應商 ID 和0x8000作為您的產品 ID。 - 使用
all-clusters-app建構一個 Espressif 設備。在 Developer Console 中建立 Matter 整合時，請使用0xFFF1做為廠商 ID，並使用0x8001做為產品 ID。
使用 Sample App for Matter 時，您不需要集線器（例如 Google Nest Hub (2nd gen)）來偵錯和控制裝置。
安裝
前往 Sample App for Matter GitHub 存放區的「版本」部分。如要查看最新版本，請在「資產」部分中找出名為
GHSAFM-version-default-debug.apk的 APK。請勿選取targetcommissioner。安裝 Android Debug Bridge (ADB)：
使用 USB 連接 Android 裝置並啟用「檔案傳輸」，然後安裝 APK：
$ adb unroot && adb install GHSAFM-version-default-debug.apk
委託設備
首次啟動範例應用程式時，系統會顯示對話方塊，內含 Sample App for Matter 程式碼研究室的連結。如果選取「不要再顯示這則訊息」，隨時可以前往應用程式的「管理」部分更新偏好設定，重新顯示對話方塊。
在後續步驟中，您將在 Local Android 網狀架構中新增Matter裝置，以及僅限於範例應用程式的本機開發網狀架構。
什麼是 Matter 織物？
Matter Fabric 是家用網路中裝置共用的信任網域，可讓裝置彼此通訊。
裝置可能有一或多個對應平台、應用程式或互動裝置群組的網狀架構。網狀架構具有專屬 ID，裝置共用同一組憑證和憑證授權單位 (CA)。這些憑證是在Matter調試期間分配的。
如要委派 Matter 裝置，請完成下列步驟：
輕觸「新增裝置」按鈕，開始委派程序。
接下來，控制權轉移到 Google Play services，它是透過呼叫 Mobile SDK 啟動的。如要驗證擁有權，請掃描 QR code 或輕觸「使用配對碼」。
完成委派後，輸入「裝置名稱」，然後輕觸「完成」。
您的裝置現已連接到本機 Android 架構和開發架構。
調試設備時，所有調試工作和相關螢幕均由 Play services 處理。這可提供一致的使用者體驗，並免除處理 Wi-Fi 和 Thread 憑證等私密權限的需求。
控制裝置
開發框架會建立憑證，以便直接從範例應用程式控制 Matter 裝置。
在主畫面上，你可以將裝置切換為「開啟」或「關閉」。輕觸裝置即可存取裝置詳細資料。
共用裝置
在 Matter 規格中，共用裝置被稱為 多重管理員流。 一旦設備被分配到範例應用程序，就可以輕鬆地與其他生態系統共享。
要與其他生態系統共享您的 Matter 設備，您需要在 Android 設備上安裝另一個平台。這個外部平台會成為目標佣金管理員。我們創建了範例應用程式的另一個實例，您可以將其用作目標委託人。
前往 GitHub 倉庫 Sample App for Matter 中的 Releases 部分。如要查看最新版本，請在「資產」部分中找出名為
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。輕觸這個範例應用程式執行個體，即可分享裝置。
接著，外部應用程式 (目標委派人) 會完成將裝置委派至自家網狀架構的程序。
設定
在主畫面上，按一下「設定」 圖示。您可以在這裡更新使用者偏好設定、取得說明，以及進一步瞭解應用程式。
半頁通知
在「設定」畫面中，你可以選擇停用Matter裝置的主動式可委派探索通知。
如果應用程式提供自己的Matter探索或委派流程，您可能會想停用這些通知，以免中斷流程。詳情請參閱「禁止顯示可賺取佣金的探索通知」。
開發人員公用程式
您也可以從「設定」畫面存取「開發人員公用程式」。
如要在 Logcat 中查看裝置和使用者偏好設定 DataStore 存放區的內容，請完成下列步驟：
按一下「記錄存放區內容」。
按一下對話方塊中的「確定」，然後勾選「Logcat」。
意見回饋和說明
如要提供意見或回饋，協助我們改善 Sample App for Matter 的開發體驗，請填寫意見回饋表單。
如果 Sample App for Matter 有問題，請嘗試完成下列步驟來驗證環境：
如果您在使用範例應用程式時有任何疑問，或發現程式碼錯誤，可以將問題提交至 GitHub 存放區中的 Issue Tracker：
如要取得 Google 官方的技術問題指引，請使用智慧住宅開發人員論壇：
如要向社群尋求技術支援，請在 Stack Overflow 上使用 google-smart-home 標記：