VS Code 適用的 Google Home 擴充功能

Device SDK

Google Home Extension for Visual Studio Code 是專為 Google Home 平台開發人員所設計。這項擴充功能可讓您使用 Google Assistant SimulatorGoogle Cloud Logging、Home Graph 檢視器和其他工具,簡化 Matter 和智慧型住宅開發程序。

VS Code 適用的 Google Home 擴充功能

Google Home 擴充功能功能

Google 助理模擬器

如要測試智慧住宅裝置與 Google Home 生態系統是否相容,您隨時可以在不離開 VS Code 的情況下與 Assistant Simulator 互動。

與動作主控台提供的現有模擬工具類似,Assistant Simulator 可讓您輸入查詢內容 (例如「開燈」) 輕鬆控制裝置。在 VS Code 中,Assistant Simulator 會根據您的指令 (例如「Alright,Turn on the light」) 以文字回應。詳情請參閱「使用 Google 助理模擬器」一文。

批次通訊

如要測試 Automaton 等 Google Home 整合情形,您可以執行語音指令碼,將批次語音傳送至 Google 助理模擬器。詳情請參閱「執行批次通訊」。

Matter 記錄工具

Matter Logging 工具可收集與 Matter 偵錯相關的所有記錄,包括 Google Home app (GHA) 記錄檔和 Google Play 服務 (GMS Core) 記錄。這些記錄可透過篩選器和關鍵字搜尋在 VS Code 上查看。記錄可透過 Android 和應用程式版本等其他偵錯資訊下載,並傳送給 Google 回報問題。

Google Home 擴充功能 Matter 記錄

Cloud Logging

Cloud Logging 提供偵錯資訊和重點指標,可讓您深入瞭解動作的使用情形。為簡化開發流程,Google Home Extension 會在疑難排解期間,於您的程式碼旁邊顯示即時 Google Cloud Logging 訊息。詳情請參閱「查看 Cloud Logging」。

Home Graph 檢視者

Home Graph 檢視器現在直接在 Google Home Extension 中使用,因此您可以在 VS Code 內在 Home Graph 中驗證裝置的狀態。詳情請參閱「查看首頁圖譜及執行測試」。

安裝 VS Code 適用的 Google Home 擴充功能

如要安裝 Google Home Extension,請在 VS Code 內按照下列步驟操作:

  1. 按一下「活動列」上的「擴充功能」圖示。
  2. 搜尋「google home」,然後按一下「安裝」

    Google Home 擴充功能市集

您也可以直接從 VS Code Marketplace 下載 Google Home Extension

下載 Google Home Extension

設定 VS Code 的 Google Home 擴充功能

安裝 Google Home Extension 並重新載入 VS Code 後,您必須先登入並選取專案,才能使用 Assistant Simulator 和 Cloud Logging。

使用 Google 帳戶登入並選取雲端專案

您可以從 Google Home Extension 登入開發人員帳戶,授權 VS Code 代表您與 Google 服務通訊。

  1. 按一下「活動列」上的「Google Home」圖示,開啟 Google Home Extension

    Google Home 擴充功能圖示
  2. 按一下「Sign in with Google」,在瀏覽器中啟動登入檢視畫面。

    VS Code Google 登入
  3. 選取與智慧住宅裝置連結的帳戶。

  4. 在「使用 Google 帳戶登入」授權頁面,按一下「允許」

  5. 接著會開啟瀏覽器分頁,並顯示「Open Visual Studio Code」對話方塊。按一下「Open Visual Studio Code」繼續操作。

    開啟 VS Code 對話方塊
  6. 系統會將您重新導向至 VS Code,您必須取得您的許可,Google Home 擴充功能才能開啟 URI。按一下「Open」完成登入程序。

    允許 Google Home 擴充功能開啟 URI
  7. 登入後,Google Home Extension 會載入您的專案。完成後,按一下「選取專案」

    選取專案
  8. 在顯示的「Search and select a project」(搜尋並選取專案) 下拉式選單中,選取智慧型住宅專案。

安裝 Android Debug Bridge (ADB) 工具

如要在 Android 手機上查看 Matter 記錄,您必須安裝 ADB:

  1. 在電腦上安裝 ADB。
  2. 在 Android 手機上開啟開發人員選項和 USB 偵錯

安裝 Matter 裝置 SoC 工具

如何查看 Matter 裝置的偵錯記錄:

  1. 大多數裝置的 SoC 會匯出序列埠,例如 Linux 上的 /dev/ttyUSBx/dev/tty.SLAB_USBtoUART,或在 MacOS 上匯出 /dev/tty.usbserial。LogViewer 可以直接讀取裝置上的記錄。
  2. 部分 SoC 類型 (例如 NXPSilicon Labs) 可能需要安裝外部工具 (例如 JLink)。詳情請參閱「 支援的裝置」一節。

使用適用於 VS Code 的 Google Home 擴充功能

查看開發人員資源

在「說明與意見回饋」下方,按一下「開始使用和資源」即可開啟「資源」頁面,您可以在此找到使用 Google Home 生態系統進行開發的實用資訊。

適用於 Google Home 生態系統的資源

使用 Google 助理模擬器

如要在 VS Code 中開啟 Assistant Simulator,請按一下側欄上的「GOOGLE ASSISTANT SIMULATOR」。在「Message」(訊息) 方塊中輸入查詢,然後按下 Enter

您可以查看 Assistant Simulator 回應,並在查詢後按一下按鈕以「重新傳送」

使用 Google 助理模擬器

執行批次回應

將滑鼠遊標懸停在「GOOGLE ASSISTANT SIMULATOR」選單列上,然後選取下列選項來設定指令碼:

  • 按一下 即可開啟現有的語音指令碼。

  • 按一下 ,將記錄儲存至 *.utterance 指令碼。

    「批次處理選單」圖示

如要開始傳送批次語音訊息,請選擇下列任一選項:

  • 按一下 即可從下拉式選單選取語音指令碼。
  • 直接開啟 *.utterance 檔案,然後按一下

    「批次訊號執行」圖示

查看 Cloud Logging

在「QUICK ACCESS」下,按一下「Cloud Logs」即可開啟「Cloud Logs」頁面,即可找到所選專案的記錄檔。

使用 Cloud Logging

使用者可以依據嚴重性和時間範圍篩選記錄。

依嚴重性和時間篩選記錄

根據預設,記錄檔限制為 50 列。如果使用者想查看更多記錄,請向下捲動至底部,然後按一下「More」,即可查看更多記錄。

查看更多記錄檔

查看主頁圖並執行測試

在「快速存取」下方,按一下「Home Graph 檢視器」開啟「Home Graph 檢視器」面板,您可在此找到屬於所選專案的裝置。您也可以按一下「Run Test」,為裝置執行測試。

Home Graph 檢視者

這項操作會在瀏覽器中啟動測試套件,並選取您的裝置以供測試。按一下「Start」,然後等待測試結果。

Google Home 測試套件

完成所有測試後,您可以查看測試詳細資料及查看記錄。

測試結果

使用 Google Home 擴充功能對 Matter 偵錯

Android 記錄

在「MATTER LOGGING TOOLS」下方,按一下「Android Logs」開啟「Android Logs」頁面,選取要連線的 Android 電話,並開始顯示記錄。

Android 記錄

連上 Android 手機後,您將可逐行查看記錄。請注意,記錄檔經過篩選,這表示只會顯示與 GHA Google Play services Matter 模組相關的記錄。您也可以設定「Severity」,來篩選記錄或搜尋記錄中的關鍵字。

Android Logging 篩選

Matter 裝置記錄

在「MATTER LOGGING TOOLS」下方,按一下「Device Logs」開啟「Resources」頁面,請先選取「SoC Type」

Matter 裝置記錄功能

接著選取「Matter 裝置」

Matter 裝置記錄選取裝置

接著,您可以取得裝置中的所有裝置記錄,並使用「Severity」和「Search」等篩選條件尋找感興趣的資訊。

Matter 裝置篩選記錄

下載所有案件記錄

在「QUICK ACCESS」下,按一下「Download Logs」開啟「Download Logs」對話方塊,選取要下載的記錄檔,然後按一下「OK」

下載案件記錄

選取要下載記錄的資料夾,然後按一下「Save」

儲存 Matter 記錄

接著,記錄檔會儲存在目的地資料夾中:

Matter 記錄目的地資料夾

解壓縮儲存的 ZIP 檔案,內含裝置資訊與記錄檔。

Matter 記錄檔 ZIP 檔案

裝置資訊檔案會包含偵錯問題所需的所有版本資訊。

Matter 記錄偵錯

提供意見

如要提供意見或意見回饋,協助我們改善 Google Home Extension 的開發體驗,請選擇下列選項:

  • 點選「說明與意見回饋」面板上的「提供意見」,即可提供建議。
  • 在「說明與意見回饋」面板中,按一下「回報問題」,回報您在使用 Google Home Extension 發現的問題
提供意見圖示
  • 我們也在「資源」頁面上提供了意見回饋圖示。