Google Home 範例應用程式範例

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

必要條件

不必使用集線器,例如:Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.

安裝

  1. 前往 Sample App for Matter GitHub 存放區中的「Releases」(版本) 區段。找出名為 GHSAFM-1.2.2-default-debug.apk 的 APK。請勿選取 targetcommissioner

    下載 APK

  2. 安裝 Android Debug Bridge (ADB):

    安裝 ADB

  3. 透過 USB 連接 Android 裝置並啟用檔案傳輸,然後安裝 APK:

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

佣金裝置

初次啟動範例應用程式時,您會收到含有 Sample App for Matter 程式碼研究室連結的對話方塊。如果您選取 [不要再顯示這則訊息],您隨時可以在應用程式的「管理」部分中更新偏好設定,以重新顯示對話方塊。

在後續步驟中,您需要在本機 Android 織布上新增 Matter 裝置,以及僅提供給範例應用程式的開發架構。

什麼是 Matter 織布?

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

Fabric 是家用網路裝置之間的共用信任網域,可讓這些裝置互相通訊。

裝置可能具有一或多個對應於設計平台、應用程式或一組裝置的互動布料。布料學有專屬的 ID,且裝置共用同一組憑證和憑證授權單位 (CA)。系統會在這些憑證的指派期間指派這些憑證。 Matter

如要委任 Matter 裝置,請完成下列步驟:

  1. 輕觸「 新增裝置」按鈕,即可啟動佣金程序。

    新增裝置

  2. 接著,控制項會轉移至 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.

    掃描 QR 圖碼

  3. 委任完成後,請輸入裝置名稱,然後輕觸 [完成]

您的裝置現已連線至本機 Android 織布和開發布料。

委任裝置時,Play services 會處理所有修訂版本工作及相關畫面。這能夠提供一致的使用者體驗,且不需處理機密權限,例如 Wi-Fi 和 Thread 憑證。

控制裝置

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

在主畫面上,您可以開啟關閉裝置,輕觸裝置即可存取裝置詳細資訊。

已新增裝置

共用裝置

Matter 規格中,共用裝置的稱為多重管理員流程。將裝置加入範例應用程式後,您就可以輕鬆與其他生態系統分享裝置。

如要與其他生態系統共用 Matter 裝置,您必須在 Android 裝置上安裝其他平台。這個外部平台會成為目標佣金。我們建立了另一個範例應用程式,讓您用來當做目標委員會。

  1. 前往 Sample App for Matter GitHub 存放區中的「Releases」(版本) 區段。找出名為 GHSAFM-[version]-targetcommissioner 的最新 APK,例如 GHSAFM-1.2.2-targetcommissioner-debug.apk

    下載目標專員

  2. 安裝目標委員會。

    $ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
    
  3. 在主畫面上輕觸裝置,即可查看裝置資訊。輕觸 [分享]

    共用裝置

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

分享分享工作表,以便選擇裝置要配對的應用程式或平台。此畫面提供兩種共用裝置的方式:

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

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

接著,外部應用程式 (目標佣金) 將裝置的委任設定完成,將裝置傳送至自己的布料中。

設定

在主螢幕中按一下「設定」圖示 。您可以在這裡選擇更新使用者偏好設定、取得說明,以及深入瞭解應用程式。

設定

半工作表通知

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

如果您的應用程式提供自己的 Matter 探索或委託流程,建議您隱藏這些通知,以免服務中斷。詳情請參閱隱藏佣金探索通知

開發人員公用程式

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

如要查看 Logcat 中裝置與使用者偏好設定 DataStore 存放區的內容,請完成下列步驟:

  1. 按一下 [Log repositories content] (記錄存放區內容)

  2. 按一下對話方塊的 [確定],然後勾選 [Logcat]

意見回饋和說明

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

提供意見回饋

如果您在使用 Sample App for Matter 時遇到問題,請嘗試完成相關步驟來驗證環境:

如果您對使用範例應用程式或發現程式碼錯誤有任何疑問,可以在 GitHub 存放區中向 Issue Tracker 提交問題:

如要向 Google 尋求技術性問題的官方指南,請使用智慧型住宅開發人員論壇:

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