VS Code 適用的 Google Home 擴充功能

適用於 Visual Studio Code 的 Google Home Extension 是專為 Google Home Platform 開發人員設計的。這項擴充功能提供 Google 助理模擬工具、Cloud Logging 和其他工具,可簡化智慧型住宅開發流程。

VS Code 適用的 Google Home 擴充功能

Google Home 擴充功能功能

Google 助理模擬工具

如要測試您的智慧住宅裝置是否能夠與 Google Home 生態系統搭配使用,您隨時可以離開 Google 助理模擬工具,而不必離開 VS Code。

與動作主控台中現有的 Google 助理 Simulator 類似,Google 助理模擬工具可讓您輸入查詢來輕鬆控制自己的裝置,例如「開燈」。在 VS Code 中,Google 助理會根據指令回應文字訊息,例如「“右大,開燈」。詳情請參閱使用 Google 助理模擬工具

批次用詞

如要測試 Google Home 整合 (例如 Automaton),您可以執行語音指令碼,將批次資訊傳送至 Google 助理模擬工具。詳情請參閱執行批次公用程式

Cloud Logging

Cloud Logging 提供偵錯資訊和重要指標,可讓您深入瞭解操作的使用情形。為了簡化開發作業,Google Home 擴充功能會在疑難排解時,直接在程式碼旁顯示即時 Google Cloud Logging 訊息。詳情請參閱查看 Cloud Logging

Home Graph 檢視者

Home Graph 檢視器現在可直接在 Google Home 擴充功能中使用,方便您在 Home Graph 中透過 VS Code 驗證裝置的狀態。詳情請參閱查看首頁圖表和執行測試

安裝 VS Code 的 Google Home 擴充功能

下載並安裝 VS Code:

下載 VS Code

安裝 VS Code 後,請透過下列其中一個選項安裝 Google Home 擴充功能:

透過 VS Code 安裝 Google Home 擴充功能

如果您想要透過 VS Code 安裝 Google Home 擴充功能,請完成下列步驟:

  1. 下載 Google Home 擴充功能的 VSIX 檔案。將下載的檔案解壓縮,以便擷取 VSIX 檔案。

    下載 Google Home 擴充功能的 VSIX 檔案

  2. 啟動 VS Code。

  3. 選擇下列其中一個安裝選項。

    • 活動列中按一下 [擴充功能]。在 [EXTENSIONS] 選單中,按一下 個其他選項,然後按一下 [Install from VSIX...]

      透過擴充功能選單安裝 Google Home 擴充功能
    • 在「歡迎」頁面中按一下 [執行指令...],或是依序按一下 [檢視] 和 [命令調色盤...]。在「Command Palette」(指令集) 中輸入 Install from VSIX

      透過 Command Palette 安裝 Google Home 擴充功能
  4. 當畫面上出現提示時,選取您已下載並解壓縮的 VSIX 檔案。

如需更多資訊,請參閱 Microsoft 的 Extension Marketplace 說明文件

透過指令列安裝 Google Home 擴充功能

如要透過指令列進行安裝,請使用 --install-extension

code --install-extension google-home-extension.vsix

為 VS Code 設定 Google Home 擴充功能

安裝 Google Home 擴充功能並重新載入 VS Code 後,您必須完成下列步驟才能使用 Google 助理模擬器 並查看 Cloud Logging:

使用 Google 帳戶登入

您可以透過 Google Home 擴充功能登入開發人員帳戶,授權 VS Code 代表您與 Google 服務進行通訊。

  1. 按一下活動列上的「Google Home」圖示,即可開啟 Google Home 擴充功能。

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

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

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

  5. 系統隨即會開啟瀏覽器分頁,並顯示「Open Visual Studio Code」(開啟 Visual Studio Code) 對話方塊。按一下 [開啟 Visual Studio Code] 以繼續。

    開啟 VS Code 對話方塊
  6. 系統會將您重新導向至 VS Code,其中需要您授予權限,允許 Google Home Extension 開啟 URI。請按一下 [Open] (開啟) 以完成登入程序。

    允許 Google Home 擴充功能開啟 URI

選取一個 Cloud 專案

  1. 登入後,Google Home 擴充功能會載入您的專案。完成後,請按一下 [Select a project] (選取專案)

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

透過 Google Home 擴充功能使用 VS Code

查看開發人員資源

在「快速存取」下方,按一下 [資源] 即可開啟「資源」頁面,您可以在這裡找到實用的資訊,瞭解如何運用 Google Home 生態系統開發應用程式。

Google Home 生態系統相關資源

使用 Google 助理模擬工具

如要在 VS Code 中開啟 Google 助理模擬器,請按一下側欄中的 [Google 助理模擬工具]。在「Message」(訊息) 方塊中輸入查詢內容,然後按下 Enter

您可以查看 Google 助理模擬工具回應,接著在查詢結束後按一下該按鈕,即可重新傳送

使用 Google 助理模擬工具

執行批次公用程式

將滑鼠遊標移至 [GOOGLE ASSISTANT SIMULATOR] 選單列,然後選擇下列選項來設定指令碼:

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

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

    批次指標選單圖示

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

  • 按一下 [],從下拉式選單中選取包含語音的指令碼。
  • 直接開啟 *.utterance 檔案並按一下

    批次公用程式執行圖示

查看 Cloud Logging

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

使用 Cloud Logging

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

依嚴重性和時間篩選記錄

根據預設,記錄的上限為 50 列。如果使用者想查看更多記錄,請向下捲動到底部,然後按一下 [More] (更多) 查看更多記錄。

查看更多記錄檔

查看首頁圖表並執行測試

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

Home Graph 檢視者

完成後,系統就會在瀏覽器中開啟測試套件,供您選取裝置並進行測試。按一下 [開始],等待測試結果。

智慧型住宅測試套件

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

測試結果

提供意見

歡迎您透過下列方法提出意見或意見,協助我們改善 Google Home 擴充功能的開發體驗:

  • 在「側欄」中,按一下「Google 登入」的意見回饋圖示。

    傳送意見回饋圖示
  • 此外,我們也在「資源」頁面上提供意見回饋圖示。