适用于 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。

与 Actions 控制台中提供的现有模拟器类似,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 以报告问题。

Google Home Extension Matter 日志记录

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,然后点击 Install

    Google Home 扩展程序市场

您也可以直接从 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. 点击 Activity Bar 上的 Google Home 图标以打开 Google Home Extension

    Google Home 扩展程序图标
  2. 点击 Sign in with Google(使用 Google 帐号登录),以在浏览器中启动登录视图。

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

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

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

    打开 VS Code 对话框
  6. 系统会将您重定向到 VS Code,您需要获得相应权限才能允许 Google Home 扩展程序打开 URI。点击打开以完成登录过程。

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

    选择项目
  8. 在随即显示的 Search and select a project 下拉窗口中,选择您的智能家居项目。

安装 Android 调试桥 (ADB) 工具

如需在 Android 手机上查看 Matter 日志,您需要安装 ADB:

  1. 在计算机上安装 ADB
  2. 在 Android 手机上开启“开发者选项”和 USB 调试功能

安装 Matter 设备 SoC 工具

如需查看 Matter 设备的调试日志,请执行以下操作:

  1. 大多数设备 SoC 都会导出串行端口,例如 Linux 上的 /dev/ttyUSBx 或 MacOS 上的 /dev/tty.SLAB_USBtoUART/dev/tty.usbserial。LogViewer 可以直接从设备读取日志。
  2. 某些 SoC 类型(如 NXPSilicon Labs)可能需要安装外部工具(例如 JLink)。如需了解详情,请参阅 支持的设备

使用 Google Home Extension for VS Code

查看开发者资源

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

Google Home 生态系统相关资源

使用 Google 助理模拟器

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

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

使用 Google 助理模拟器

运行批量话语

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

  • 点击 打开现有的话语脚本。

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

    批量话语菜单图标

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

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

    “批量话语运行”图标

查看 Cloud Logging

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

使用 Cloud Logging

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

按严重性和时间过滤日志

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

查看更多日志

查看 Home Graph 并运行测试

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

Home Graph Viewer

这将在浏览器中启动测试套件,并选择您的设备,可以进行测试。点击 Start,然后等待测试结果。

Google Home 测试套件

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

测试结果

使用 Google Home 扩展程序进行 Matter 调试

Android 日志记录

重要日志记录工具下,点击 Android 日志以打开 Android 日志页面,选择您要连接的 Android 手机并开始显示日志。

Android 日志记录

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

已过滤 Android 日志记录

Matter 设备日志记录

重要日志记录工具下,点击设备日志以打开资源页面,先选择 SoC 类型

Matter 设备日志记录

接下来,选择 Matter Device

Matter 设备日志记录(选择设备)

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

Matter 设备过滤日志记录

下载所有 Matter 日志

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

下载 Matter 日志

选择要下载日志的文件夹,然后点击 Save

保存 Matter 日志

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

Matter 日志目标文件夹

解压保存的 ZIP 文件,系统会显示设备信息和日志文件。

Matter 日志 ZIP 文件

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

Matter 日志调试

发送反馈

如果您有关于我们如何改进 Google Home Extension 开发体验的想法或反馈,请从以下选项中进行选择:

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