Matter 云到云 Local Home SDK 设备 SDK
Google Home Extension for Visual Studio Code 是专为 Google Home Platform 开发者设计的。此扩展程序让您能够使用 Google Assistant Simulator、Google Cloud Logging、Home Graph Viewer 以及其他工具,以简化您的 Matter 和智能家居开发流程。

Google Home 扩展程序功能
Google 助理模拟器
如需测试你的智能家居设备能否与 Google Home 生态系统正常运行,你可以随时与 Assistant Simulator 互动,无需离开 VS Code。
与 Actions 控制台中提供的现有模拟器类似,Assistant Simulator 还可让您通过输入查询轻松控制设备,例如“开灯”。 在 VS Code 内,Assistant Simulator 会根据您的命令返回短信,例如“Alright, turn on the light”(好的,正在开灯。)如需了解详情,请参阅使用 Google 助理模拟器。
批量说话
如需测试 Google Home 集成(如自动模式),你可以通过运行语音提示脚本向 Google 助理模拟器发送批量语音提示。如需了解详情,请参阅运行批量话语。
Matter 日志记录工具
Matter Logging 工具可以收集与 Matter 调试相关的所有日志,包括 Google Home app (GHA) 日志和 Google Play 服务 (GMS Core) 日志。您可以在包含 VS Code 的过滤条件和关键字搜索中查看日志。您可以下载包含其他调试信息(如 Android 和应用版本)的日志,并将日志发送给 Google 以报告问题。

Cloud Logging
Cloud Logging 提供了调试信息和关键指标,可让您深入了解 Action 的使用情况。为了简化开发,在问题排查期间,Google Home Extension 会在代码旁边显示实时 Google Cloud Logging 消息。如需了解详情,请参阅查看 Cloud Logging。
Home Graph 查看器
Home Graph Viewer 现在可直接在 Google Home Extension 中使用,因此您可以在 Home Graph 中的 VS Code 内验证设备的状态。如需了解详情,请参阅查看 Home Graph 和运行测试。
安装 Google Home Extension for VS Code
如需安装 Google Home Extension,请在 VS Code 中执行以下步骤:
- 点击活动栏上的扩展程序图标。
搜索
google home
,然后点击安装。
您也可以直接从 VS Code Marketplace 下载 Google Home Extension。
为 VS Code 设置 Google Home 扩展程序
安装 Google Home Extension 并重新加载 VS Code 后,您需要先登录并选择项目,然后才能使用 Assistant Simulator 和查看 Cloud Logging。
使用 Google 帐号登录,并选择一个云项目
您可以从 Google Home Extension 登录开发者帐号,并授权 VS Code 代表您与 Google 服务通信。
点击 Activity Bar 中的 Google Home 图标以打开 Google Home Extension。
点击使用 Google 帐号登录以在浏览器中打开登录视图。
选择与你的智能家居设备关联的帐号。
在使用 Google 帐号登录授权页面上,点击允许。
系统随即会打开一个浏览器标签页,并显示一个 Open Visual Studio Code 对话框。点击 Open Visual Studio Code 以继续。
系统会将您重定向到 VS Code,您需要授权它允许 Google Home 扩展程序打开 URI。点击打开以完成登录过程。
登录后,Google Home Extension 将会加载您的项目。完成后,点击选择项目。
在搜索并选择项目下拉窗口中,选择您的智能家居项目。
安装 Android 调试桥 (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 Extension for VS Code
查看开发者资源
在帮助和反馈下,点击开始使用和资源以打开资源页面,在该页面上,您可以找到有关 Google Home 生态系统开发工作的实用信息。

使用 Google 助理模拟器
如需在 VS Code 中打开 Assistant Simulator,请点击边栏上的 GOOGLE ASSISTANT SIMULATOR。在消息框中,输入您的查询并按 Enter
。
您可以查看 Assistant Simulator 响应,然后在查询后点击该按钮以重新发送。

《批量出话》
将鼠标悬停在 GOOGLE ASSISTANT SIMULATOR 菜单栏上,然后从以下选项中进行选择,设置脚本:
点击
以打开现有的语音提示脚本。点击
可将历史记录保存到*.utterance
脚本中。
要开始发送批量语音提示,请从以下选项中进行选择:
- 点击 即可从下拉窗口中选择语音描述脚本。
直接打开
*.utterance
文件,然后点击 。
查看 Cloud Logging
在快速访问下,点击 Cloud 日志以打开 Cloud 日志页面,您可以在其中找到属于所选项目的日志。

用户可以根据严重程度和时间范围过滤日志。

默认情况下,日志的行数上限为 50。如果用户想要查看更多日志,请向下滚动到底部,然后点击更多以查看更多日志。

查看 Home Graph 并运行测试
在 QUICK ACCESS 下,点击 Home Graph Viewer,打开 Home Graph Viewer 面板,您可以在其中找到属于所选项目的设备。您也可以点击 Run Test,对设备运行测试。

这样系统就会在浏览器中启动测试套件,并已选择您的设备并准备好进行测试。点击开始,然后等待测试结果。
您可以在所有测试完成后查看测试详情和查看日志。

使用 Google Home 扩展程序进行 Matter 调试
Android 日志记录
在诉讼或调查日志工具下,点击 Android 日志以打开 Android 日志页面,然后选择要连接的 Android 手机并开始显示日志。

连接 Android 手机后,您将能够逐行查看日志。请注意,日志会被过滤,这意味着系统只会显示与 GHA 和 Google Play services Matter 模块相关的日志。您还可以设置严重程度来过滤日志或搜索日志中的关键字。

Matter 设备日志记录
在诉讼或调查工具下,点击设备日志以打开资源页面,先选择 SoC 类型:

接下来,选择 Matter Device:

然后,您可以从设备获取所有设备日志,并使用 Severity(严重程度)和 Search(搜索)等过滤条件查找您感兴趣的信息。

下载所有 Matter 日志
在快速访问下,点击下载日志,打开下载日志对话框,选择要下载的日志,然后按确定。

选择文件夹以下载日志,然后点击 Save(保存):

然后,日志将保存到目标文件夹中:

解压已保存的 zip 文件,该文件将显示设备信息和日志文件。

设备信息文件将包含调试问题所需的所有版本信息。

发送反馈
如需就我们如何借助 Google Home Extension 改善开发体验提交您的想法或反馈,请从以下选项中进行选择:
- 在帮助和反馈面板上,点击提供反馈以向我们提供建议。
- 在帮助和反馈面板上,点击报告问题,报告您使用 Google Home Extension 发现的任何问题

- 我们还在资源页面上提供了反馈图标。