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

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

Google Home Sample App for Matter 會使用 Google Home Mobile SDK 建立與 Google Home app (GHA) 類似的 Android 應用程式。此範例應用程式提供下列功能：

  • 將實體和虛擬 Matter 裝置委託至本機 Android 架構
  • 將實體和虛擬裝置調成開發織布
  • 在開發架構上控制裝置，例如開燈
  • 多管理員功能可讓您在開發架構上與其他應用程式共用裝置，反之亦然，也能加入與其他應用程式共用的開發布料裝置
  • 開發人員公用程式

本指南說明如何安裝 Sample App for Matter APK，並用於佣金、控管及分享 Matter 裝置。

如要下載原始碼，瞭解如何在 Android Studio 中整合 Mobile SDK 並自訂畫面，請嘗試使用 Sample App for Matter 程式碼研究室。

前往 Sample App for Matter 程式碼研究室

必要條件

您不需要中樞 (例如 Google Nest Hub (2nd gen))，即可透過 Sample App for Matter 委託及控制裝置。

安裝

  1. 前往 Sample App for Matter GitHub 存放區中的版本部分。在最新版本中，找出名為 GHSAFM-version-default-debug.apk 的 APK，並在「Assets」區段中找到。請勿選取 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 布料？

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

Matter 架構是家用網路中裝置之間共用的信任網域，可讓使用者彼此通訊。

裝置可具有一或多個對應平台、應用程式或裝置群組相互互動的布料。Fabrics 具備專屬 ID，且裝置會共用同一組憑證和憑證授權單位 (CA)。這些憑證會在 Matter 啟動期間指派。

如要調試 Matter 裝置，請完成下列步驟：

  1. 輕觸「新增裝置」按鈕 ，即可開始調試程序。

    新增裝置

  2. 接著，控制項會轉移至 Google Play services，這是透過呼叫 Mobile SDK 來啟動。如要建立持有證明，請掃描 QR code 或輕觸「使用配對碼」。

    掃描 QR 圖碼

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

您的裝置現已連線至本機 Android 織品和開發架構。

調試裝置時，所有調試工作和相關畫面都是由 Play services 處理。這樣可提供一致的使用者體驗，並省去處理 Wi-Fi 和 Thread 憑證等機密權限的需求。

控制裝置

開發架構會建立憑證，以便直接透過範例應用程式控制 Matter 裝置。

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

已新增裝置

共用裝置

在 Matter 規格中，共用裝置稱為「多管理流程」。將裝置委託到範例應用程式後，您就可以輕鬆與其他生態系統共用裝置。

如要與其他生態系統共用 Matter 裝置，必須在 Android 裝置上安裝其他平台。這個外部平台會變成「目標佣金工具」。我們建立了另一個範例應用程式的執行個體，可做為目標佣金工具使用。

  1. 前往 Sample App for Matter GitHub 存放區中的版本部分。在最新版本中，找出名為 GHSAFM-version-targetcommissioner-debug.apk 的 APK，並在「Assets」區段中找到。請勿選取 default。

  2. 安裝目標佣金工具。

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

  3. 在主畫面中，輕觸要顯示裝置資訊的裝置。輕觸「共用」。

    共用裝置

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

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

  1. 手動透過設定代碼，與目標佣金工具應用程式分享
  2. 使用註冊為 Matter 委託方的本機 Android 應用程式

目標佣金應用程式會標示為 GHSAFM-TC。輕觸範例應用程式的執行個體以共用裝置。

接著，外部應用程式 (目標佣金工具) 會將裝置調派到自身的架構。

設定

在主畫面中，按一下設定 圖示。在這裡，您可以更新使用者偏好設定、取得說明，並進一步瞭解應用程式。

設定

半頁式通知

您可以在「設定」畫面中選擇為 Matter 裝置停用主動式佣金探索通知。

如果您的應用程式提供自己的 Matter 探索或提交流程，建議您隱藏這些通知，以免發生中斷情形。詳情請參閱「隱藏可委託的探索通知」。

開發人員公用程式

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

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

  1. 按一下「Log positories content」。

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

意見回饋和說明

如要提供意見或提供意見，協助我們改善 Sample App for Matter 的開發體驗，請填寫意見回饋表單。

歡迎提供寶貴意見

如果您在使用 Sample App for Matter 時遇到問題，請嘗試完成環境驗證步驟：

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

如需 Google 針對技術問題提供的官方指引，請使用智慧型住宅開發人員論壇：

如要取得社群的技術支援，請使用 Stack Overflow 上的 google-smart-home 標記：