Android Studio 專用的 Google Home 外掛程式

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator, Cloud Logging, and other tools to simplify your smart home development process.

Android Studio 專用的 Google Home 外掛程式

安全性通知

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

  1. 依序點選 [File] (檔案) > [Settings...] (設定...)。
  2. 在「Appearance & Behavior」(外觀與行為) 中，展開「System Settings」(系統設定)，然後按一下 [Passwords] (密碼)。
  3. 選取 [不要儲存，在重新啟動後清除密碼]。
Android Studio 專用的 Google Home 外掛程式

功能與特色

Google 助理模擬工具

如要測試您的智慧住宅裝置是否能夠與 Google Home 生態系統搭配運作，您無須離開 Android Studio 即可隨時與 Assistant Simulator 互動。

與 Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light." 中提供的現有 Google 助理模擬工具類似

使用 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 測試套件。

安裝

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

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

設定

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

使用 Google 帳戶登入

您可以透過 Google Home 面板登入開發人員帳戶，授權 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 助理模擬工具重播《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 便會執行查詢。您收到新的回應時，系統會通知您；處理列會在查詢處理期間顯示計數器。

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

如果提早停止集合，您的 .json 路徑就不會標示為已收集。

測試批次話語

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

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

使用 Google 助理模擬器執行 Utterances

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

使用 Google 助理模擬器執行 Utterances

查看 Cloud Logging

如要在 Cloud 記錄檔工具視窗中開啟專案分頁，請按一下 Google Home Plugin 面板中的 [Cloud Logs]。您可以為每個專案開啟獨立的 Cloud Logging 分頁。

Cloud Logging 分頁

查詢字詞

針對所選專案，您也可以使用「Query」欄位篩選記錄。舉例來說，如要篩選 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之前的日期，請選取「早於」，然後按一下日期圖示 。
  • 如要選取介於 5/1/22 和 6/30/22 之間的日期，請選取 [早於] 和 [之後]，然後從日期圖示 中選擇日期。

選取 [即時] 可擷取即時專案記錄。按一下「Stop」(停止) ，結束即時資訊提供。

嚴重性等級

您也可以從下拉式選單中選取 [最小值]。

查詢結果

按一下 [擷取] 來提交查詢參數。

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

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

查看 Cloud Logging

查看主螢幕圖表並執行測試

如要列出您的裝置，請在 Google Home Plugin 面板中選取「Home Graph」(首頁圖)。

按一下 「Refresh」(重新整理) 以顯示與所選專案相關聯的裝置的「Device name」(裝置名稱)、「Device id」(裝置 ID) 和「Device type」(裝置類型)。您可以使用多個 Google Home Graph panels open for separate projects.

裝置載入後，點選任何記錄 即可展開完整的 JSON 酬載。

Home Graph JSON 酬載

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

首頁圖展開與收合 JSON

如要針對特定裝置啟動測試套件，請按一下 [測試]。系統會在瀏覽器中開啟測試套件，選取您的裝置後，即可進行測試。按一下 [開始]，然後等待測試結果。

家庭圖跑步測驗

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

首頁圖已完成測試

資源與意見回饋

按一下 [資源] 即可查看開發人員工具與資源清單。

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

提供意見