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。
借助 Assistant Simulator,您可以通过输入查询轻松控制设备,例如输入“开灯”。在 VS Code 中,Assistant Simulator 会根据您的命令回复文本消息,例如 “好的,开灯。”如需了解详情,请参阅使用 Google 助理模拟器。
批量语句
如需像自动化操作一样测试 Google Home 集成,您可以通过运行语音脚本将批量语音发送到 Google 助理模拟器。如需了解详情,请参阅运行批量指令。
Matter 日志记录工具
Matter 日志记录工具可以收集与 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 Viewer
Home Graph Viewer 现在可直接在 Google Home Extension 中使用,这样您就可以在 VS Code 中验证 Home Graph 中的设备状态。如需了解详情,请参阅查看 Home Graph 和运行测试。
安装 Google Home Extension for VS Code
如需安装 Google Home Extension,请在 VS Code 中按以下步骤操作:
- 点击活动栏上的扩展程序图标。
搜索
google home
,然后点击安装。
您也可以直接从 VS Code Marketplace 下载 Google Home Extension。
设置 Google Home Extension for VS Code
安装 Google Home Extension 并重新加载 VS Code 后,您需要登录并选择一个项目,然后才能使用 Assistant Simulator 和查看 Cloud Logging。
使用 Google 账号登录并选择一个云项目
您可以通过 Google Home Extension 登录自己的开发者账号,授权 VS Code 代表您与 Google 服务通信。
点击活动栏上的 Google Home 图标,打开 Google Home Extension。
点击使用 Google 账号登录,在浏览器中启动登录视图。
选择与您的智能家居设备关联的账号。
在使用 Google 账号登录授权页面上,点击允许。
系统会打开一个浏览器标签页,并显示 Open Visual Studio Code 对话框。点击打开 Visual Studio Code 以继续。
系统会将您重定向到 VS Code,您需要在该处授予权限,以允许 Google Home Extension 打开 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 助理模拟器。在消息框中,输入您的查询,然后按 Enter
。
您可以查看 Assistant Simulator 响应,并在查询后点击相应按钮以重新发送。
运行批量语句
将鼠标悬停在 GOOGLE ASSISTANT SIMULATOR 菜单栏上,然后从以下选项中选择用于设置脚本的选项:
点击
以打开现有语音指令脚本。点击
将历史记录保存到*.utterance
脚本中。
如需开始发送批量语音指令,请从以下选项中进行选择:
- 点击 以从下拉窗口中选择一个语音指令脚本。
直接打开
*.utterance
文件,然后点击 。
查看 Cloud Logging
在快捷访问下,点击 Cloud Logging 以打开 Cloud Logging 页面,您可以在其中找到所选项目所属的日志。
用户可以根据严重级别和时间范围过滤日志。
默认情况下,日志最多只能有 50 行。如果用户想查看更多日志,请向下滚动到底部,然后点击更多以查看更多日志。
查看 Home Graph 并运行测试
在快捷访问下,点击住宅图表查看器以打开住宅图表查看器面板,您可以在其中找到属于所选项目的设备。您还可以点击运行测试,为设备运行测试。
这会在浏览器中启动测试套件,并选择您的设备,以便您进行测试。点击开始,然后等待测试结果。
所有测试完成后,您可以查看测试详情并查看日志。
使用 Google Home Extension 进行 Matter 调试
Android 日志记录
在 MATTER LOGGING TOOLS 下,点击 Android Logs 以打开 Android Logs 页面,选择要连接到的 Android 手机,然后开始显示日志。
Android 手机连接后,您将能够逐行查看日志。请注意,系统会过滤日志,这意味着系统只会显示与 GHA 和 Google Play services Matter 模块相关的日志。您还可以设置严重程度来过滤日志,或在日志中搜索关键字。
Matter 设备日志记录
在 MATTER LOGGING TOOLS 下,点击 Device Logs 以打开 Resources 页面,然后先选择 SoC Type:
接下来,选择 Matter 设备:
然后,您可以从设备获取所有设备日志,并使用严重程度和搜索等过滤条件查找您感兴趣的信息。
下载所有案例日志
在快捷访问下,点击下载日志以打开下载日志对话框,选择要下载的日志,然后按 OK。
选择要下载日志的文件夹,然后点击保存:
然后,日志会保存到目标文件夹中:
解压缩已保存的 ZIP 文件,其中会显示设备信息和日志文件。
设备信息文件将包含调试问题所需的所有版本信息。
发送反馈
如需就如何改进 Google Home Extension 的开发体验提交想法或反馈,请从以下选项中进行选择:
- 在帮助和反馈面板中,点击提供反馈以向我们提供建议。
- 在帮助和反馈面板中,点击报告问题,报告您在使用 Google Home Extension 时遇到的任何问题
- 我们还在资源页面上提供了反馈图标。