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

本頁面由 Cloud Translation API 翻譯而成。

Android Studio 專用的 Google Home 外掛程式

Google Home Plugin for Android Studio 是專為 Google Home Platform 開發人員設計和建立。這個外掛程式可讓您使用 Google Assistant Simulator、Cloud Logging 和其他工具，簡化智慧型住宅開發流程。

安全性通知

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

依序按一下「File」和「Settings...」。
在「Appearance & Behavior」中，展開「System Settings」，然後按一下「Passwords」。
選取「不要儲存，在重新啟動後忘記密碼」。

功能與特色

Google 助理模擬器

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

與 Actions on Google Console 控制台提供的現有 Google 助理模擬工具類似，Assistant Simulator 可讓您透過輸入查詢內容輕鬆控制裝置，例如「開燈」。在 Android Studio 中，Assistant Simulator 會根據指令回覆簡訊，例如「好，正在開燈」。

查看 Cloud Logging

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

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

批次通訊

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

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

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

Home Graph 檢視者

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

Android Debug Bridge (ADB) 記錄檢視器

Adb 記錄檢視器是一項工具，用於查看及分析記錄檔，例如 Matter 裝置記錄檔、Google Home 記錄和 Android 記錄檔。

安裝

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

下載或更新 Android Studio。
重要事項：您必須具備 Android Studio - Chipmunk (2021.2.1) 以上版本，才能使用這個外掛程式。詳情請參閱相容性範圍
下載 Android Studio
前往「File」 >「Settings」 (MacOS 中為 Android Studio >「Preferences」)。
在「Plugins」(外掛程式) 區段中，前往「Marketplace」並搜尋 google home。
安裝工具，然後重新啟動 Android Studio。

您也可以直接從 JetBrains Marketplace 下載此外掛程式。

設定

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

使用 Google 帳戶登入
選取 Cloud 專案

使用 Google 帳戶登入

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

在 Android Studio 視窗左側的垂直分頁欄中，按一下「Google Home」分頁標籤。
在「登入身分」部分，按一下「Google」，啟動瀏覽器。
選擇與智慧住宅裝置連結的帳戶。
在「使用 Google 帳戶登入」授權頁面，按一下「允許」。
關閉瀏覽器視窗，然後返回 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」面板會追蹤儲存在儲存快取中的查詢和回應。「重播」只會新增回應到這個內部快取，且不會在每次點選按鈕時重複查詢。

按一下「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 面板中，按一下「Utterances File」，在新分頁中開啟已儲存的 JSON 檔案。在「Select Path」中，您可以選擇檔案或資料夾。如果選擇資料夾，「Collect」和「Test」將執行該資料夾中的所有語音 .json 檔案。

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

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

「Collect」(收集) 完成後，「狀態列」會在 .json 路徑前方顯示綠色勾號，而語音檔案會填入可能的回應。

{
  "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."
      ]
    }
  ]
}

如果您提早「停止」收集作業，您的 .json 路徑將不會標示為已收集。

測試批次語音

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

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

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

查看 Cloud Logging

如要在 Cloud Log 工具視窗中開啟專案分頁，請按一下 Google Home Plugin 面板中的「Cloud Logs」。您可以開啟不同專案的 Cloud Log 分頁

查詢字詞

針對所選專案，您也可以使用「Query」欄位篩選記錄。例如，篩選 light 關鍵字的記錄：

選取「Use QL」，以使用 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"

日期和時間查詢

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

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

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

嚴重性等級

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

查詢結果

按一下「擷取」，提交查詢參數。

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

或者，您也可以在「Filter」方塊中輸入關鍵字，以縮小記錄結果。按一下 x 即可移除篩選器，並返回原始擷取結果。

查看主頁圖並執行測試

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

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

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

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

如要啟動特定裝置的「Test Suite」，請按一下「Test」。這樣做之後，系統會在瀏覽器中啟動測試套件，接著即可進行測試。按一下「Start」，然後等待測試結果。

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

Android Debug Bridge (ADB) 記錄檢視器

如要在 ADB 記錄工具視窗中開啟專案分頁，請按一下 Google Home 外掛程式工具列中的 Adb Log 指令。您可以為每個記錄檔開啟個別的 ADB 記錄檔分頁。如要刪除分頁，請按一下圖示。

使用「Select」欄位選取要查看的記錄元件，並使用「Severity」下拉式選單，只顯示相符記錄嚴重性的項目。

針對所選的 ADB 記錄，您可以使用「Filter」欄位篩選記錄項目，並可選擇「Case-Sensitive」或「Regex」修飾符。

此外，你還可以：

使用「Find」欄位和「Find Next」 ( 圖示) 和「Find Previous」 ( 圖示) 指令尋找特定項目。
使用選用的 Case-Sensitive 或 Regex 修飾符。
跳到行：跳到記錄中的特定行 (按數字排列)。

選取「Numbered」即可查看含行號的記錄行。選取「Raw」即可查看原始記錄項目。

資源與意見回饋

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

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