VS Code 適用的 Google Home 擴充功能

裝置 SDK

Google Home Extension for Visual Studio Code 專為 Google Home Platform 開發人員設計及建立。這項擴充功能可讓您存取 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 會根據您的指令回應簡訊,例如「好的,開啟燈光」。詳情請參閱「使用 Google 助理模擬器」。

批次雜訊

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

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」,然後按一下「Install」(安裝)

    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. 按一下「Activity Bar」中的「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 會載入您的專案。完成後,按一下「Select a project」(選取專案)

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

使用 Google Home 擴充功能進行 VS Code

查看開發人員資源

在「Help & FEEDBACK」(說明和意見回饋) 下方,按一下「Get started & Resources」(開始使用與資源) 以開啟「Resource」(資源) 頁面,在 Google Home 生態系統中,您可以找到關於開發方面的實用資訊。

Google Home 生態系統的資源

使用 Google 助理模擬器

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

您可以查看 Assistant Simulator 回應,然後在查詢下方按一下「Resend」按鈕。

使用 Google 助理模擬器

執行批次雜訊

將滑鼠遊標懸停在 GOOGLE ASSISTANT SIMULATOR 選單列上,然後選擇下列其中一個選項來設定指令碼:

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

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

    批次開啟選單選單的圖示

如要開始傳送批次語音,請選擇下列其中一個選項:

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

    批次 Utterance Run Run 圖示

查看 Cloud Logging

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

使用 Cloud Logging

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

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

根據預設,記錄檔最多只能包含 50 列。如果使用者想查看更多記錄檔,請向下捲動至底部,然後按一下「More」(更多) 即可查看更多記錄檔。

查看更多記錄檔

查看 Home 圖與執行測試

在「QUICK ACCESS」下方,按一下「Home Graph Viewer」面板開啟「Home Graph Viewer」面板,您可以在其中找到屬於所選專案的裝置。您也可以按一下「Run Test」,在裝置上執行測試。

Home Graph 檢視者

系統隨即會在瀏覽器中選取測試套件,並啟動測試。按一下「Start」(開始),然後等待測試結果。

Google Home 測試套件

測試完成後,您可以查看測試詳細資料,並查看記錄檔。

測試結果

提供意見

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

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