Matter 專用的 Google Home 範例應用程式

Google Home Matter 範例應用程式

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 程式碼研究室

必要條件

您不需要提供中樞 (例如 Google Nest Hub (2nd gen)) 即可收取佣金 使用 Sample App for Matter 控制裝置及控制裝置

安裝

  1. 前往 Sample App for Matter GitHub 存放區的「Releases」部分。如要查看最新版本，請前往「資產」部分 名為 GHSAFM-version-default-debug.apk。不要選取 targetcommissioner。

  2. 安裝 Android Debug Bridge (ADB)：

    安裝 ADB

  3. 使用 USB 連接 Android 裝置並啟用「檔案傳輸」，然後安裝 APK：

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

委任裝置

首次啟動範例應用程式時，系統會顯示對話方塊，其中含有 Sample App for Matter 程式碼研究室的連結。 如果您選取「不要再顯示這則訊息」，可以再次顯示對話方塊 只要前往應用程式的「管理」部分更新偏好設定即可。

在後續步驟中，您會新增Matter裝置 本地 Android 織布以及適用於樣品的開發布料 僅限應用程式使用。

什麼是 Matter 織布？

Google Home Matter 範例應用程式

Matter 架構是各裝置間的信任網域 能夠與彼此通訊

裝置可能會有一或多個結構體，對應至平台、應用程式或一組互動裝置。布料與 ID 和裝置共用同一組憑證和憑證授權單位 (CA)。這些憑證是在 Matter期間指派 例如模型訓練

如要佣金 Matter 裝置，請完成下列步驟：

  1. 輕觸 新增 用於啟動調試程序的裝置按鈕。

    新增裝置

  2. 接著，控制項會轉移至已啟動的 Google Play services 呼叫 Mobile SDK。為了證明 手上，輕觸「掃描 QR code」或輕觸「使用配對碼」。

    掃描 QR code

  3. 委派完成後，請輸入「裝置名稱」，然後輕觸「完成」。

您的裝置現在已連上本機 Android 織布和 開發架構

所有調試作業和相關畫面都在 調試裝置時：Play services。這個 讓使用者享有一致的體驗，不需自行處理 例如 Wi-Fi 和 Thread 憑證

控制裝置

開發架構會建立憑證來控管 透過範例應用程式即可下載 Matter 部裝置。

在主畫面上，您可以將裝置切換為「開啟」或「關閉」。輕觸 存取裝置詳細資料。

已新增裝置

共用裝置

共用裝置在 Google Workspace 環境稱為「多管理員流程」 Matter 規格。 當裝置要求使用範例應用程式後，您就可以輕鬆共用裝置 與其他生態系統交流

如要與其他生態系統共用「Matter」裝置，請按照下列步驟操作： 則您必須在 Android 裝置上安裝其他平台。這個 外部平台就會成為目標佣金器。我們另外建立了 範例應用程式的執行個體，可做為目標委託工具使用。

  1. 前往「版本」部分 Sample App for Matter GitHub Cloud Storage 也提供目錄同步處理功能如要查看最新版本，請前往「資產」部分 名為 GHSAFM-version-targetcommissioner-debug.apk。不要選取 default。

  2. 安裝目標委託工具。

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. 在主畫面上輕觸裝置，即可顯示裝置資訊。輕觸 分享。

    共用裝置

範例應用程式會呼叫 Mobile SDK Share API，然後再次將控制權轉移至 Play services。

分享工作表會隨即顯示，讓你選擇要編輯的應用程式或平台 要將裝置配對這個畫面提供兩種方式讓您 裝置：

  1. 手動透過設定代碼，與目標佣金應用程式共用
  2. 使用已註冊為 Matter 委派者的本機 Android 應用程式

目標佣金應用程式已加上「GHSAFM-TC」GHSAFM-TC標籤。只要輕觸這裡的 共用裝置範例。

接著，外部應用程式 (目標系統) 會完成 成型的布料。

設定

在主畫面上，按一下「設定」圖示 。這個區塊可讓您 更新使用者偏好設定、取得說明及進一步瞭解應用程式。

設定

資訊表通知

您可以在「設定」畫面中，選擇停用 Matter 裝置的主動可佣金發現通知。

如果應用程式提供自己的 Matter 探索或委派流程，您可能會想抑制這些通知，以免造成中斷。請參閱略過可佣金探索的探索 通知 瞭解詳情

開發人員公用程式

此外，您也可以在「設定」畫面中存取「開發人員公用程式」。

查看裝置和使用者偏好設定 DataStore 存放區內容 在 Logcat 中，完成下列步驟：

  1. 按一下「Log repositories content」。

  2. 按一下對話方塊中的「OK」，然後勾選「Logcat」。

意見回饋和說明

如要針對 Sample App for Matter 的開發體驗提出意見或意見回饋，請填寫意見回饋表單。

提供意見回饋

如果無法順利使用「Sample App for Matter」，請嘗試完成後續操作 驗證環境的步驟：

如果對使用範例應用程式有疑問，或發現程式碼錯誤， 可以將問題提交至 GitHub 存放區的 Issue Tracker：

如要取得 Google 技術問題的官方指南，請使用智慧住宅開發人員論壇：

如要向社群尋求技術支援，請在 Stack Overflow 上使用 google-smart-home 標記：