适用于 VS Code 的 Google Home 扩展程序

设备 SDK

Google Home Extension for Visual Studio Code 专为 Google Home 平台开发者设计和创建。借助此扩展程序,您可以使用 Google Assistant SimulatorGoogle Cloud Logging、Home Graph Viewer 和其他工具来简化 Matter 和智能家居开发流程。

Google Home Extension for VS Code

Google Home 扩展程序功能

Google 助理模拟器

如需测试您的智能家居设备是否能与 Google Home 生态系统正常运行,您可以随时与 Assistant Simulator 互动,而无需离开 VS Code。

借助 Assistant Simulator,您可以通过输入查询轻松控制设备,例如输入“开灯”。在 VS Code 中,Assistant Simulator 会根据您的命令回复文本消息,例如 “好的,开灯。”如需了解详情,请参阅使用 Google 助理模拟器

批量语句

如需像自动化操作一样测试 Google Home 集成,您可以通过运行语音脚本将批量语音发送到 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 中按以下步骤操作:

  1. 点击活动栏上的扩展程序图标。
  2. 搜索 google home,然后点击安装

    Google Home 扩展程序 Marketplace

您也可以直接从 VS Code Marketplace 下载 Google Home Extension

下载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 服务通信。

  1. 点击活动栏上的 Google Home 图标,打开 Google Home Extension

    Google Home 扩展程序图标
  2. 点击使用 Google 账号登录,在浏览器中启动登录视图。

    VS Code Google 登录
  3. 选择与您的智能家居设备关联的账号。

  4. 使用 Google 账号登录授权页面上,点击允许

  5. 系统会打开一个浏览器标签页,并显示 Open Visual Studio Code 对话框。点击打开 Visual Studio Code 以继续。

    打开 VS Code 对话框
  6. 系统会将您重定向到 VS Code,您需要在该处授予权限,以允许 Google Home Extension 打开 URI。点击打开以完成登录流程。

    允许 Google Home 扩展程序打开 URI
  7. 登录后,Google Home Extension 会加载您的项目。完成后,点击选择项目

    选择项目
  8. 在随即显示的搜索并选择项目下拉窗口中,选择您的智能家居项目。

使用 Google Home Extension for VS Code

查看开发者资源

帮助和反馈下,点击使用入门和资源以打开资源页面,您可以在其中找到有关使用 Google Home 生态系统进行开发的实用信息。

Google Home 生态系统的资源

使用 Google 助理模拟器

如需在 VS Code 中打开 Assistant Simulator,请点击侧边栏中的 Google 助理模拟器。在消息框中,输入您的查询,然后按 Enter

您可以查看 Assistant Simulator 响应,并在查询后点击相应按钮以重新发送

使用 Google 助理模拟器

运行批量指令

将鼠标悬停在 GOOGLE ASSISTANT SIMULATOR 菜单栏上,然后从以下选项中选择用于设置脚本的选项:

  • 点击 以打开现有语音指令脚本。

  • 点击 将历史记录保存到 *.utterance 脚本中。

    批量语句菜单图标

如需开始发送批量语音指令,请从以下选项中进行选择:

  • 点击 以从下拉窗口中选择一个语音指令脚本。
  • 直接打开 *.utterance 文件,然后点击

    批量指令运行图标

查看 Cloud Logging

快捷访问下,点击 Cloud Logging 以打开 Cloud Logging 页面,您可以在其中找到所选项目所属的日志。

使用 Cloud Logging

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

按严重级别和时间过滤日志

默认情况下,日志最多只能有 50 行。如果用户想查看更多日志,请向下滚动到底部,然后点击更多以查看更多日志。

查看更多日志

查看 Home Graph 并运行测试

快捷访问下,点击住宅图表查看器以打开住宅图表查看器面板,您可以在其中找到属于所选项目的设备。您还可以点击运行测试,为设备运行测试。

Home Graph Viewer

这会在浏览器中启动测试套件,并选择您的设备,以便您开始测试。点击开始,然后等待测试结果。

Google Home 测试套件

所有测试完成后,您可以查看测试详情并查看日志。

测试结果

发送反馈

如需就如何改进 Google Home Extension 的开发体验提交想法或反馈,请从以下选项中进行选择:

  • 帮助和反馈面板中,点击提供反馈以向我们提供建议。
  • 帮助和反馈面板中,点击报告问题,报告您在使用 Google Home Extension 时遇到的任何问题
“发送反馈”图标
  • 我们还在资源页面上提供了反馈图标。