請注意!我們即將推出新的開發人員預覽版計畫。歡迎在此申請,率先體驗新工具並提供意見回饋。

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 裝置。

如要下載原始碼,瞭解如何整合 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-1.4.1-default-debug.apk 的 APK。請勿選取 targetcommissioner

    下載 APK

  2. 安裝 Android Debug Bridge (ADB):

    安裝 ADB

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

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

佣金裝置

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

在後續步驟中,您會將 Matter 裝置新增至本機 Android 布料,以及只納入範例應用程式的開發布料。

什麼是 Matter 布料?

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

Fabric 是家用網路中的信任網域,可讓他們使用家用網路中的裝置互相通訊。

裝置可使用多種布料,以對應某個平台、應用程式或一組裝置彼此互動。Fabrics 具有專屬 ID,且裝置會共用同一組憑證和憑證授權單位 (CA)。這些憑證會在 Matter 修訂期間指派。

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

  1. 輕觸 「Add Device」按鈕,開始執行佣金程序。

    新增裝置

  2. 接著,將控制項轉移到 Google Play services,並透過呼叫 Mobile SDK 啟動。如要建立持有證明,請輕觸「掃描 QR 圖碼」或輕觸「使用配對碼」

    掃描 QR 圖碼

  3. 建立完成後,輸入裝置名稱,然後輕觸「完成」

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

計算裝置時,所有佣金工作和相關畫面都由 Play services 處理。如此一來,使用者就能享有一致的使用者體驗,也不必處理機密權限,例如 Wi-Fi 和 Thread 憑證。

控制裝置

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

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

已新增裝置

共用裝置

Matter 規格中,共用裝置稱為多管理員流程。裝置都通過範例應用程式後,您就可以輕鬆與其他生態系統共用裝置。

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

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

    下載目標委員會

  2. 安裝目標佣金。

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. 在主畫面上輕觸裝置,即可顯示裝置資訊。輕觸「分享」

    共用裝置

範例應用程式會呼叫 Mobile SDK Share API,再次將控制項轉移給 Play services

畫面上會顯示共用工作表,讓您選擇要與裝置配對的應用程式或平台。此螢幕提供兩種共用裝置的方式:

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

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

接著,外部應用程式 (目標委員會) 會將裝置編譯成自己的布料。

設定

在主畫面上按一下 圖示。您可以選擇更新使用者偏好設定、取得說明以及進一步瞭解應用程式。

設定

半頁通知

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

如果您的應用程式提供專屬的 Matter 探索或佣金流程,建議您隱藏這些通知,以免服務中斷。詳情請參閱「略過佣金式探索通知」。

開發人員公用程式

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

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

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

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

意見回饋和說明

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

歡迎提供意見

如果您在使用 Sample App for Matter 時遇到問題,請嘗試按照下列步驟驗證環境:

如果無法順利使用範例應用程式,或發現程式碼錯誤,您可以透過 GitHub 存放區中的 Issue Tracker 提交問題:

如要向 Google 取得技術相關問題的官方指引,請使用智慧型住宅開發人員論壇:

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