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

设备 SDK

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

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

Google Home 扩展程序功能

Google 助理模拟器

如需测试您的智能家居设备能否在 Google Home 生态系统中正常运行,您可以在不退出 VS Code 的情况下随时与 Assistant Simulator 交互。

与 Actions 控制台中提供的现有模拟器类似,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 查看器

Home Graph Viewer 现在可直接在 Google Home Extension 中使用,因此您可以在 VS Code 内在 Home Graph 中验证设备的状态。如需了解详情,请参阅查看 Home Graph 并运行测试

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

如需安装 Google Home Extension,请在 VS Code 中执行以下步骤:

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

    Google Home 扩展程序市场

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

下载Google Home Extension

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

安装 Google Home Extension 并重新加载 VS Code 后,您需要先登录并选择一个项目,然后才能使用 Assistant Simulator 并查看 Cloud Logging。

使用 Google 账号登录并选择一个云项目

您可以从 Google Home Extension 登录您的开发者帐号,授权 VS Code 代表您与 Google 服务进行通信。

  1. 点击 Activity Bar 上的 Google Home 图标,即可打开 Google Home Extension

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

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

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

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

    打开 VS Code 对话框
  6. 系统会将您重定向到 VS Code,您需要授权 Google Home 扩展程序打开 URI。点击打开以完成登录过程。

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

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

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

查看开发者资源

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

Google Home 生态系统相关资源

使用 Google 助理模拟器

如需在 VS Code 中打开 Assistant Simulator,请点击侧边栏上的 GOOGLE ASSISTANT SIMULATOR。在消息框中,输入您的查询,然后按 Enter

您可以查看 Assistant Simulator 响应,然后点击查询后面的按钮重新发送该查询。

使用 Google 助理模拟器

运行批量话语

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

  • 点击 即可打开现有的语音脚本。

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

    批量话语菜单图标

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

  • 点击 即可从下拉列表中选择语音脚本。
  • 直接打开 *.utterance 文件,然后点击

    “批量语音运行”图标

查看 Cloud Logging

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

使用 Cloud Logging

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

按严重性和时间过滤日志

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

查看更多日志

查看 Home Graph 并运行测试

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

Home Graph 查看器

此操作将在浏览器中启动测试套件,选择您的设备并准备好测试。点击 Start,然后等待测试结果。

Google Home 测试套件

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

测试结果

发送反馈

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

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