Android Studio 專用的 Google Home 外掛程式

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

Android Studio 專用的 Google Home 外掛程式

安全性聲明

防止 Android Studio 儲存密鑰和 ，請完成下列步驟：

  1. 依序點選「檔案」和「設定...」。
  2. 在「外觀與」部分行為，展開系統設定，然後按一下 密碼。
  3. 選取「不要儲存，重新啟動後忘記密碼」。
Android Studio 專用 Google Home 外掛程式

功能

Google 助理模擬器

測試智慧住宅裝置是否可搭配 Google Home 正常運作 生態系統，您隨時可以與 Assistant Simulator 互動，不必 離開 Android Studio。

與現有 Google 助理類似 已提供模擬工具 Actions on Google Console 控制台中的 Assistant Simulator 可讓您 可讓你輕鬆輸入查詢內容，輕鬆控制裝置，例如 「開燈。」在 Android Studio 中，Assistant Simulator 會根據您的指令回傳文字訊息，例如「Alright, turning on the light.」

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

查看 Cloud Logging

Google Cloud Logging敬上 提供偵錯資訊和關鍵指標，深入分析 Action 的用量。為了簡化開發作業，Google Home Plugin 會顯示 即時接收即時 Cloud Logging 訊息，您的代碼將出現在驗證碼旁 來排解問題

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

Cloud Logging 檢視表

批次處理序數

「Assistant Simulator」無法針對單一語音做出回覆 確定性舉例來說，回應可以是下列任一詞組：

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

執行自動化測試，並驗證 Google 整合項目如何與 Google 整合 您就可以傳送批次語音給 Assistant Simulator，即可執行語音指令碼。將指令碼 可以收集回應，並針對查詢執行多次測試。

Home Graph 檢視者

Home Graph Viewer 可讓您執行下列操作： 顯示裝置狀態並啟動 在瀏覽器中使用 Google Home Test Suite。

Android Debug Bridge (ADB) 記錄檢視器

Adb 記錄檢視器這項工具可用來查看和分析記錄檔，例如 Matter 裝置的記錄檔、Google Home 記錄和 Android 。

安裝

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

  1. 下載或更新「Android Studio」。 下載 Android Studio
  2. 前往「File」>設定 (Android Studio > MacOS 上的「Preferences」)。
  3. 在「Plugins」部分，前往「Marketplace」並搜尋 google home。
  4. 安裝工具並重新啟動 Android Studio。

您也可以直接從 JetBrains Marketplace。

設定

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

使用 Google 帳戶登入

您可以透過 Google Home 面板登入開發人員帳戶。 正在授權 Android Studio 與 Google 通訊 管理基礎架構

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

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

    Android Studio Google 登入

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

  4. 在「使用 Google 帳戶登入」授權頁面中，按一下「允許」。

  5. 關閉瀏覽器視窗，然後返回 Android Studio。

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

選取 Cloud 專案

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

「Project」下拉式選單會根據 篩選器：離開後，系統會自動保留您選取的項目 Android Studio。

選取專案

如需專案篩選器的相關說明，請參閱 查詢參數 。

使用 Google 助理模擬器

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

開啟「文獻」面板

您可以透過幾種方式將查詢傳送至 Assistant Simulator。接下來，我們將逐一說明各個選項。

輸入查詢及收集回應

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

只要按一下 結尾重新傳送圖示 。

提交一或多個查詢後，請按一下 重播即可重新執行 以及查看回應「Utterances」面板可用來追蹤 儲存於儲存快取中的查詢和回應重播只會新增對以下內容的回應： 這個內部快取，避免在每次您點選 按鈕。

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

按一下「儲存」圖示 ，即可儲存查詢並 相關回應 「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 檔案。在「選取路徑」部分，您可以選擇 檔案或資料夾如果選擇資料夾，「Collect」和「Test」將在您選取該資料夾時 應用於該資料夾中的所有語音 .json 檔案。

您可以針對同一個檔案或不同檔案開啟多個分頁。舉例來說， lights、lights(1)和plug。

狀態列會顯示上次測試的結果 (如果適用)。 黃色或綠點會指出檔案是否已收集完成， 話語 .json 檔案路徑。點選之後 收集， 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 路徑就不會標示為已收集。

測試批次語音

收集回覆後，按一下 測試以重播查詢 並檢查您的回應與記錄測試批次語音內容時 Assistant Simulator 預期會儲存至 JSON 的回應 檔案。如果測試傳回尚未收集的回應，您會收到 參考類似以下回應的通知：

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

使用 Google 助理模擬器執行語音操作

此情境代表測試失敗。否則， Assistant Simulator 會執行您的各項查詢並傳回回應。 如果測試成功，狀態列會顯示 勾號。

使用 Google 助理模擬器執行語音操作

查看 Cloud Logging

如要在「Cloud Logs」工具視窗中開啟專案分頁，請按一下「Cloud Logs」 ，Google Home Plugin面板開啟不同的 Cloud Log 分頁 方便您管理各個專案

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 之間的日期，請選取「之前」，然後按一下 晚於，然後從日期圖示中選擇日期 。

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

嚴重性等級

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

查詢結果

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

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

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

查看 Cloud Logging

查看首頁圖譜並執行測試

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

按一下 [重新整理] 即可顯示 裝置的裝置名稱、裝置 ID 和裝置類型 與所選專案相關聯您可以建立 Google Home Graph面板會開啟為不同專案。

裝置載入後，點選任一記錄 即可展開完整內容 JSON 酬載

Home Graph JSON 酬載

您也可以使用「Expand」和「Expand」顯示及隱藏 JSON 必須為您的裝置進行酬載

主畫面圖展開及收合 JSON

如要為特定裝置啟動測試套件， 按一下「測試」。即可在瀏覽器中使用 按一下「Start」，然後等待測試 也就是預測結果

Home 圖譜跑步測試

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

Home 圖譜完成考試

Android Debug Bridge (ADB) 記錄檢視器

如要在 Adb Log 工具視窗中開啟專案分頁，請按一下 Google Home 外掛程式工具列 (左側) 中的「Adb Log」指令。您可以開啟另一個 查看各個記錄檔如要刪除分頁，請按一下分頁右側的 「」圖示。

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

對於所選的 ADB 記錄，您可以使用篩選器篩選記錄項目。 這個欄位含有選用的 Case-sensitive 或 Regex 修飾符。

此外，您還可以：

  • 使用「尋找」欄位和「尋找下一個項目」 ( 圖示) 和「尋找上一個」 ( 圖示) 指令，尋找特定項目。
  • 使用選用的「區分大小寫」或「Regex」修飾符。
  • 跳至一行，即可跳至記錄中的指定行 (按數字)。

選取「編號」即可查看已加上行號的記錄行。選取「原始」 查看原始記錄項目。

Adb 記錄檢視器

資源與意見回饋

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

提出意見或意見，協助我們改善開發功能 「Google Home Plugin」使用體驗，請按一下「意見回饋」。

提供意見