Matter 雲端至雲端 Local Home SDK Device SDK
Google Home Extension for Visual Studio Code 是專為 Google Home 平台開發人員設計並建立。這項擴充功能可讓您存取 Google Assistant Simulator、Google Cloud Logging、Home Graph Viewer 和其他工具，簡化 Matter 和智慧型住宅的開發程序。
Google Home 擴充功能功能
Google 助理模擬器
如要測試智慧住宅裝置是否能與 Google Home 生態系統正常運作，您隨時可以與 Assistant Simulator 互動，不必取得 VS Code。
與 Actions Console 中提供的現有模擬器類似，Assistant Simulator 可讓您輸入查詢內容 (例如「開燈」)，輕鬆控制裝置。在 VS Code 中，Assistant Simulator 會根據您的指令回應簡訊，例如「好的，開啟燈。」詳情請參閱「使用 Google 助理模擬器」一文。
批次通告
如要像 Automaton 一樣測試 Google Home 整合情形，您可以執行語音指令碼，將批次語音內容傳送至 Google 助理模擬器。詳情請參閱執行批次通告。
Matter 記錄工具
Matter 記錄工具可收集所有與 Matter 偵錯相關的記錄，包括 Google Home app (GHA) 記錄和 Google Play 服務 (GMS Core) 記錄。可以透過篩選器和關鍵字搜尋在 VS Code 中查看記錄。下載記錄可包含其他偵錯資訊 (例如 Android 和應用程式版本)，並傳送給 Google 以利回報問題。
Cloud Logging
Cloud Logging 提供偵錯資訊和主要指標，協助您深入瞭解動作的使用情形。在疑難排解期間，Google Home Extension 會在程式碼旁顯示即時 Google Cloud Logging 訊息，以便簡化開發作業。詳情請參閱「查看 Cloud Logging」一節。
Home Graph 檢視者
Home Graph Viewer 現已直接在 Google Home Extension 中直接提供，方便您在 Home Graph 中驗證裝置狀態。詳情請參閱「查看 Home Graph 並執行測試」。
安裝 VS Code 的 Google Home 擴充功能
如要安裝 Google Home Extension，請在 VS Code 中按照下列步驟操作：
- 按一下「活動列」上的「擴充功能」圖示。
搜尋
google home，然後按一下「Install」。
您也可以直接從 VS Code Marketplace 下載 Google Home Extension。
設定 VS Code 的 Google Home 擴充功能
安裝 Google Home Extension 並重新載入 VS Code 後，您必須先登入並選取專案，才能使用 Assistant Simulator 查看 Cloud Logging。
使用 Google 帳戶登入並選取 Cloud 專案
您可以從 Google Home Extension 登入開發人員帳戶，授權 VS Code 代表您與 Google 服務通訊。
按一下「活動列」上的「Google Home」圖示，開啟 Google Home Extension。
按一下「Sign in with Google」，在瀏覽器中啟動登入檢視畫面。
選取與智慧住宅裝置連結的帳戶。
在「使用 Google 帳戶登入」授權頁面上，按一下「允許」。
系統會開啟瀏覽器分頁，並顯示「Open Visual Studio Code」對話方塊。按一下「Open Visual Studio Code」(開啟 Visual Studio 程式碼) 以繼續操作。
系統會將您重新導向至 VS Code。如要讓 Google Home 擴充功能開啟 URI，必須取得您的許可。按一下「Open」完成登入程序。
登入後，「Google Home Extension」會載入你的專案。完成後，按一下「Select a project」(選取專案)。
在顯示的「Search and select a project」(搜尋並選取專案) 下拉式選單中，選取智慧型住宅專案。
安裝 Android Debug Bridge (ADB) 工具
如要在 Android 手機上查看 Matter 記錄，您需要安裝 ADB：
- 在電腦上安裝 ADB。
- 在 Android 手機上開啟開發人員選項和 USB 偵錯功能。
安裝 Matter 裝置 SoC 工具
如何查看 Matter 裝置的偵錯記錄：
- 大多數裝置 SoC 都會匯出序列埠，例如 Linux 的
/dev/ttyUSBx或 MacOS 的/dev/tty.SLAB_USBtoUART或/dev/tty.usbserial。LogViewer 則可直接從裝置讀取記錄。 - 部分 SoC 類型 (例如 NXP 或 Silicon Labs) 可能需要安裝外部工具 (例如 JLink)。詳情請參閱「 支援的裝置」一文。
使用 Google Home 擴充功能 VS Code
查看開發人員資源
在「說明與意見回饋」下方，按一下「開始使用與資源」可開啟「資源」頁面，您可以在其中找到使用 Google Home 生態系統開發的實用資訊。
使用 Google 助理模擬器
如要在 VS Code 中開啟 Assistant Simulator，請按一下側欄上的「GOOGLE ASSISTANTSI」。在「Message」(訊息) 方塊中輸入查詢，然後按下 Enter。
您可以查看 Assistant Simulator 回應，並在查詢後按一下按鈕重新傳送。
執行批次通告
將滑鼠遊標移到「GOOGLE ASSISTANT SIMULATOR」選單列上，然後選擇以下選項來設定指令碼：
按一下 可開啟現有的語音指令碼。
按一下 即可將記錄儲存至
*.utterance指令碼。
如要批次傳送語音內容，請選擇下列任一做法：
- 按一下 ，即可從下拉式選單中選取語音指令碼。
直接開啟
*.utterance檔案，然後按一下 。
查看 Cloud Logging
在「快速存取」下方，按一下「Cloud Logs」開啟「Cloud Logs」頁面，即可找到屬於所選專案的記錄。
使用者可以根據嚴重性和時間範圍篩選記錄。
預設最多只能記錄 50 列資料。如果使用者想查看更多記錄檔，請向下捲動至底部，然後按一下「More」查看更多記錄。
查看 Home Graph 並執行測試
在「快速存取」下方，按一下「Home Graph Viewer」即可開啟「Home Graph Viewer」面板，您可以在此尋找屬於所選專案的裝置。您也可以按一下「Run Test」，對裝置執行測試。
這樣就能在瀏覽器中啟動測試套件，並選擇您的裝置並準備好進行測試。按一下「Start」，然後等待測試結果。
您可以在所有測試完成後查看測試詳細資料，並檢視記錄。
使用 Google Home 擴充功能進行 Matter 偵錯
Android 記錄功能
在「MATTER LOGGING TOOLS」下方，按一下「Android Logs」開啟「Android Logs」頁面，選取要連線的 Android 手機，並開始顯示記錄。
連接 Android 手機後，您可以逐行查看記錄。請注意，記錄檔會經過篩選，因此只會顯示與 GHA 和 Google Play services Matter 模組相關的記錄。您也可以設定「Severity」(嚴重性) 來篩選記錄，或設定「Search」(搜尋) 記錄中的關鍵字。
Matter 裝置記錄功能
在「MATTER LOGGING TOOLS」下方，按一下「Device Logs」以開啟「Resources」頁面，先選取「SoC Type」：
接著，選取 Matter 裝置：
接著，您可以從裝置取得所有裝置記錄，並使用「嚴重性」和「搜尋」等篩選器尋找您感興趣的資訊。
下載所有 Matter 記錄
在「QUICK ACCESS」下方，按一下「Download Logs」開啟「Download Logs」對話方塊，選取要下載的記錄，然後按下「OK」。
選取要下載記錄檔的資料夾，然後按一下「Save」：
接著，系統會將記錄檔儲存至目的地資料夾：
將已儲存的 ZIP 檔案解壓縮，即可顯示裝置資訊和記錄檔。
裝置資訊檔案會包含偵錯問題所需的所有版本資訊。
提供意見
如要提交您對 Google Home Extension 開發體驗的想法或意見回饋，請選擇下列選項：
- 按一下「說明與意見回饋」面板上的「提供意見」，即可向我們提供建議。
- 按一下「說明與意見回饋」面板上的「回報問題」，回報您在 Google Home Extension 中發現的任何問題
- 此外，我們也在「資源」頁面上提供了意見回饋圖示。