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

Android Studio 專用的 Google Home 外掛程式

Google Home Plugin for Android Studio 專為 Google Home Platform 開發人員設計及建立。這個外掛程式可讓您存取 Google Assistant Simulator、Cloud Logging 和其他工具，以簡化智慧型居家開發程序。

Android Studio 專用 Google Home 外掛程式

安全性通知

為避免 Android Studio 儲存密鑰和密碼，請完成下列步驟：

  1. 依序點選「檔案」和「設定...」。
  2. 在「Appearance & Behavior」中，展開「System Settings」，然後按一下「Passwords」。
  3. 選取「不儲存，於重新啟動後忘記密碼」。
Android Studio 專用 Google Home 外掛程式

功能與特色

Google 助理模擬器

如要測試智慧住宅裝置是否與 Google Home 生態系統正確運作，你可以隨時與 Assistant Simulator 互動，無須離開 Android Studio。

與 Actions on Google Console Console 中提供的現有 Google 助理模擬工具類似，Assistant Simulator 可讓您透過輸入查詢來控制裝置，例如「開燈」。在 Android Studio 中，Assistant Simulator 會根據您的指令回應簡訊，例如 "Alright, Turn on the light。

使用 Google 助理模擬器進行測試

查看 Cloud Logging

Google Cloud Logging 提供偵錯資訊和重要指標，協助您深入瞭解動作的使用情形。為了簡化開發流程，Google Home Plugin 在疑難排解期間，於程式碼旁邊顯示即時 Cloud Logging 訊息。

您可以顯示即時記錄或選取日期範圍。

Cloud Logging 檢視表

批次雜訊

對單一語音回應的 Assistant Simulator 回應並不具有確定性。舉例來說，回應可以是下列任一詞組：

  • 知道了，正在開啟 2 盞燈
  • 沒問題，正在開啟 2 盞燈
  • 知道了，正在開啟 2 盞燈
  • 好的，正在開啟 2 盞燈

如要執行自動化測試並驗證 Google 整合如何與這些回應搭配運作，您可以透過執行語音指令碼，將批次語音傳送至 Assistant Simulator。儲存指令碼後，即可收集回應，並針對查詢執行多項測試。

Home Graph 檢視者

Home Graph 檢視者可讓您顯示裝置狀態，並在瀏覽器中啟動 Google Home Test Suite。

安裝

如要在 Android Studio 中安裝 Google Home Plugin，請按照下列步驟操作：

  1. 下載或更新 Android Studio。 下載 Android Studio
  2. 前往「File」(檔案) >「Settings」(設定) (MacOS 中為「Android Studio」 >「Preferences」(偏好設定))。
  3. 在「Plugins」(外掛程式) 區段中，前往「Marketplace」並搜尋 google home。
  4. 安裝工具然後重新啟動 Android Studio。
您也可以直接從 JetBrains Marketplace 下載外掛程式。

設定

安裝外掛程式後，您必須先完成下列步驟，才能使用 Assistant Simulator 及查看 Cloud Logging：

使用 Google 帳戶登入

你可以透過 Google 首頁面板登入開發人員帳戶，並授權 Android Studio 代表您與 Google 服務通訊。

  1. 在 Android Studio 視窗左側的垂直分頁中，按一下「Google Home」分頁標籤。

  2. 在「Sign in」(登入) 部分按一下「Google」，啟動瀏覽器。

    Android Studio Google 登入

  3. 選擇與智慧住宅裝置連結的帳戶。

  4. 在「使用 Google 帳戶登入」授權頁面上點選 [允許]。

  5. 關閉瀏覽器視窗並返回 Android Studio。

您現在應該已經登入，可選擇 [登出] 選項。

選取 Cloud 專案

登入之後，從下拉式選單中選取「Project」。如要篩選專案清單，請輸入「Filter」運算式 (例如 matter)，然後按下 Enter。

「Project」(專案) 下拉式選單會根據您的篩選器載入前 100 項專案。系統會在你離開 Android Studio 時保留你的選項。

選取專案

如需專案篩選條件的相關說明，請參閱 Google Cloud 參考資料中的查詢參數。

使用 Google 助理模擬器

如要在 Android Studio 中開啟 Assistant Simulator，請按一下 Google Home Plugin 面板中的「Utterances Panel」。

開啟「篩選器」面板

您可以透過多種方式將查詢傳送至 Assistant Simulator。接下來，我們將介紹每個選項。

輸入查詢並收集回應

如要與 Assistant Simulator 互動，請輸入查詢並按下 Enter 鍵。

如要重新傳送查詢，請按一下查詢結尾的 重新傳送圖示。

提交一或多項查詢後，請按一下「Replay」(重播) 重新執行查詢並檢查回應。「Utterances」面板會在已儲存的快取中追蹤查詢和回應。「重播」只會新增內部回應給這個內部快取，也不會在每次按下按鈕時複製查詢。

透過 Google 助理模擬器重播語音

按一下 「Save」(儲存)，即可儲存您在「Utterances」面板中輸入的查詢和回應。您的互動會以下列格式轉換為 JSON：

  • ask：您的查詢。
  • answers：可能的 Assistant Simulator 回應陣列。

您可以在 Android Studio 中編輯這個 JSON 檔案。

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

收集批次回應

在 Google Home Plugin 面板中，按一下「Utterance File」，在新分頁中開啟新分頁。在「Select Path」(選取路徑) 中，您可以選擇檔案或資料夾。如果選擇資料夾，「Collect」(收集) 和「Test」(測試) 均可在該資料夾中執行的所有語音 .json 檔案。

您可以為同一個檔案或多個檔案開啟多個分頁，例如 lights、lights(1) 和 plug。

狀態列會顯示您上次測試的結果 (如適用)、以黃色或綠色圓點來表示檔案是否已收集，以及語音 .json 檔案路徑。按一下「Collect」(收集) 後，Assistant Simulator 會執行查詢。每次收集新回應時，您會收到通知，狀態列會在查詢處理期間顯示計數器。

使用 Google 助理模擬器收集語音

收集後，「狀態列」會在 .json 路徑前面加上綠色勾號，並更新話語檔案，並填入可能的回應。

使用 Google 助理模擬器收集語音 
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

如果您提前「Stop」停止收集，.json 路徑不會標示為已收集。

測試批次語音

收集回應後，按一下 「Test」(測試) 即可重新查詢查詢，並查看回應和記錄。測試批次語音時，Assistant Simulator 會預期儲存在 JSON 檔案中的回應。如果測試傳回尚未收集的回應，您會收到類似以下的通知：

Expected one of: "Got it, turning on 2 lights."

透過 Google 助理模擬器執行語音

這種情況表示測試失敗。否則，Assistant Simulator 會執行每項查詢並傳回回應。如果測試成功，狀態列會顯示 檢查。

透過 Google 助理模擬器執行語音

查看 Cloud Logging

如要在 Cloud 記錄工具視窗中開啟專案分頁，請按一下 Google Home Plugin 面板中的「Cloud 記錄檔」。您可以為每個專案開啟個別的 Cloud Log 分頁。

Cloud Logging 分頁

查詢字詞

您也可以使用所選查詢的查詢欄位篩選記錄檔。例如，以下資料可以篩選 light 關鍵字的記錄：

Cloud Logging 查詢

選取「Use QL」來使用 Logging 查詢語言。

Cloud Logging 查詢語言

以下列舉幾個 QL 查詢，協助您快速上手：

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

日期和時間查詢

您也可以選擇依日期查詢記錄，按一下「After」(之後) 和「Before」(之前) 即可啟用。您可以在我們提供的文字欄位中輸入日期和時間格式，例如 5/11/22, 12:37 PM，或使用日期挑選器 () 選取日期，然後在文字欄位中輸入時間。

  • 如要選取 5/1/22 之後的日期，請選取「晚於」，然後按一下日期圖示 。
  • 如要選取 5/1/22 之前的日期，請選取「Before」(之前)，然後按一下日期圖示 。
  • 如要選取 5/1/22 到 6/30/22 之間的日期，請選取「Before」(之前) 和「After」(之後)，然後選擇日期圖示 中的日期。

選取「即時」，擷取即時專案記錄檔。按一下「Stop」即可結束即時動態饋給。

嚴重性等級

您也可以在下拉式選單中選取「最小嚴重性」。

查詢結果

按一下 「Extract」(擷取) 即可提交查詢參數。

載入記錄檔後，按一下任一記錄 即可展開完整的 JSON 酬載。再按一下 即可顯示完整訊息。

您可以視需要在「Filter」(篩選器) 方塊中輸入關鍵字，以縮小記錄結果。按一下 x 移除篩選器，然後返回原始擷取結果。

查看 Cloud Logging

查看 Home 圖與執行測試

如要列出裝置，請在 Google Home Plugin 面板中選取「Home Graph」。

按一下 「Refresh」(重新整理)，針對與所選專案相關聯的裝置顯示裝置名稱、裝置 ID 和裝置類型。你可以為不同專案開啟多個 Google Home Graph 面板。

裝置載入完畢後，按一下任一記錄 即可展開完整的 JSON 酬載。

Home Graph JSON 酬載

您也可以使用「Expand」(展開) 和「收合」來收合及隱藏裝置的 JSON 酬載。

Home 圖 展開式和收合 JSON

如要為特定裝置啟動測試套件，請按一下「Test」。系統會在瀏覽器中選取測試套件，並啟動測試。按一下「Start」，然後等待測試結果。

Home 圖執行測試

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

住家圖已完成的測試

資源與意見回饋

按一下「資源」，查看開發人員工具和資源清單。

如要提供想法或意見回饋，協助我們改善 Google Home Plugin 的開發體驗，請按一下「意見回饋」。

提供意見