VS Code 適用的 Google Home 擴充功能

Device SDK

Google Home Extension for Visual Studio Code 是專為 Google Home 平台開發人員設計和建立的工具。這個擴充功能可讓您存取 Google Assistant SimulatorGoogle Cloud Logging、Home Graph Viewer 和其他工具,簡化 Matter 和智慧型家居開發程序。

VS Code 適用的 Google Home 擴充功能

Google Home 擴充功能

Google 助理模擬器

如要測試智慧型住宅裝置是否可與 Google Home 生態系統正常運作,您可以隨時與 Assistant Simulator 互動,無須離開 VS Code。

Assistant Simulator 可讓你輸入查詢,輕鬆控制裝置,例如「打開燈」在 VS Code 中,Assistant Simulator 會根據您的指令回應文字訊息,例如「Alright, turning on the light.」詳情請參閱「使用 Google 助理模擬器」。

批次語句

如要以自動化方式測試 Google Home 整合功能,您可以執行語音指令指令碼,將批次語音指令傳送至 Google 助理模擬器。詳情請參閱「執行批次語句」。

Cloud Logging

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

Home Graph 檢視器

Home Graph Viewer 現已可直接在 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 首頁」圖示,即可開啟 Google Home Extension

    Google Home 擴充功能圖示
  2. 按一下「使用 Google 帳戶登入」,在瀏覽器中啟動登入畫面。

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

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

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

    開啟 VS Code 對話方塊
  6. 系統會將您重新導向至 VS Code,您必須授予權限,才能允許 Google Home 擴充功能開啟 URI。點選「開啟」即可完成登入程序。

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

    選取專案
  8. 在隨即顯示的「Search and select a project」下拉式視窗中,選取智慧型家居專案。

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

查看開發人員資源

在「說明與意見回饋」下方,點選「開始使用與資源」,開啟「資源」頁面,查看有關使用 Google Home 生態系統進行開發的實用資訊。

Google Home 生態系統資源

使用 Google 助理模擬工具

如要在 VS Code 中開啟 Assistant Simulator,請按一下「Side Bar」上的「Google Assistant Simulator」。在「訊息」方塊中輸入查詢,然後按下 Enter

您可以查看 Assistant Simulator 回應,並在查詢後點選按鈕,重傳

使用 Google 助理模擬工具

執行批次指令

將滑鼠游標移至「Google 助理模擬器」選單列,然後從下列選項中選擇設定指令碼:

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

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

    「批次語句」選單圖示

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

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

    批次指令執行圖示

查看 Cloud Logging

在「快速存取」下方,按一下「Cloud Logs」,開啟「Cloud Logs」頁面,即可找到所選專案的記錄。

使用 Cloud Logging

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

依嚴重性和時間篩選記錄檔

根據預設,記錄的數量上限為 50 列。如果使用者想查看更多記錄,請向下捲動至底部,然後點選「更多」即可查看更多記錄。

查看更多記錄

查看首頁圖表和執行測試

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

Home Graph 檢視器

系統會在瀏覽器中啟動測試套件,並選取您的裝置,以便您進行測試。按一下「開始」,等待測試結果。

Google Home 測試套件

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

測試結果

提供意見

如要針對如何改善 Google Home Extension 的開發人員體驗,提供想法或意見回饋,請選擇下列選項:

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