适用于 Android Studio 的 Google Home 插件

Google Home Plugin for Android Studio专为 Google 设计和打造 Home Platform 开发者。借助此插件,您可以访问 Google Assistant Simulator、Cloud Logging 和其他工具, 智能家居开发流程。

适用于 Android Studio 的 Google Home 插件

安全通知

为了防止 Android Studio 存储 Secret 和 请完成以下步骤:

  1. 点击文件,然后点击设置...
  2. 外观和行为,展开系统设置,然后点击 密码
  3. 选择重启后不保存,忘记密码
适用于 Android Studio 的 Google Home 插件

功能

Google 助理模拟器

测试您的智能家居设备能否与 Google Home 正常配合使用 因此你可以随时与Assistant Simulator互动 即将离开Android Studio

与现有的 Google 助理类似 提供的模拟器Actions on Google Console 控制台中,Assistant Simulator 可让您 即可通过输入查询内容轻松控制自己的设备,例如 “开灯。”Android Studio内, Assistant Simulator会根据你的短信回复 例如“好的,开灯”

使用 Google 助理模拟器进行测试

查看 Cloud Logging

Google Cloud Logging 提供了调试信息和关键指标,可帮助您深入了解自己的 操作的使用情况。为了简化开发,Google Home Plugin 会显示 实时Cloud Logging消息,就在代码旁边 问题排查。

您可以显示实时日志或选择日期范围。

Cloud Logging 视图

批量话语

一条话语的 Assistant Simulator 条回复不符合要求 是确定性的。例如,响应可以是以下任一短语:

  • 知道了,正在打开这 2 盏灯。
  • 没问题,正在打开这 2 盏灯。
  • 知道了,正在打开这 2 盏灯。
  • 好的,正在打开这 2 盏灯。

运行自动化测试并验证 Google 集成如何与 您可以将批量话语发送到 Assistant Simulator。将脚本 保存后,您可以收集响应并针对您的查询运行多项测试。

Home Graph 查看器

借助 Home Graph Viewer,您可以 显示设备状态并启动 在浏览器中安装 Google Home 测试套件

Android 调试桥 (adb) 日志查看器

Adb 日志查看器是一种工具,用于查看和分析日志文件,例如: Matter 设备日志文件、Google Home 日志和 Android 日志。

安装

如需在 Android Studio 中安装 Google Home Plugin,请执行以下操作: 请按以下步骤操作:

  1. 下载或更新 Android Studio。 <ph type="x-smartling-placeholder"> 下载 Android Studio
  2. 转到文件 >设置 (Android Studio > Preferences(MacOS 上为偏好设置)。
  3. Plugins 部分中,点击 Marketplace,然后搜索 google home
  4. 安装该工具并重启 Android Studio

您也可以直接从 JetBrains Marketplace

设置

安装插件后,您需要 您必须先完成以下步骤,然后才能使用 Assistant Simulator 和 查看 Cloud Logging:

使用 Google 账号登录

您可以从 Google Home 面板登录您的开发者账号, 授权 Android Studio 与 Google 通信 。

  1. 点击左侧纵向标签页列中的 Google 首页标签页 Android Studio 窗口的一侧。

  2. 使用以下账号登录部分,点击 Google 以启动浏览器。

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

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

  5. 关闭浏览器窗口,然后返回 Android Studio

现在,您应该已经成功登录,您会看到退出选项。

选择 Cloud 项目

登录后,从下拉列表中选择 Project。要过滤您的 项目列表中,输入 Filter 表达式(例如 matter),然后按 Enter

项目下拉列表会根据您的 过滤:当您退出时,系统会保留您的选择 Android Studio

选择项目

如需项目过滤条件方面的帮助,请参阅 查询参数 请参阅 Google Cloud 参考文档。

使用 Google 助理模拟器

如需在 Android Studio 中打开 Assistant Simulator,请执行以下操作: 点击 Google Home Plugin 面板中的话语面板

打开话语面板

您可以通过多种方式向 Assistant Simulator 发送查询。接下来 我们将逐一介绍每个选项

输入查询并收集响应

若要与 Assistant Simulator 交互,请输入您的查询,然后按 Enter 键。

您可以重新发送查询,方法是点击 末尾的“”重新发送图标 。

提交一个或多个查询后,请点击 重放以重新运行您的 并检查您的响应。话语面板会持续跟踪 存储在存储的缓存中的查询和响应。重放仅会向 该内部缓存,并且不会在您每次点击 按钮。

使用 Google 助理模拟器重放话语

点击 保存以保存查询,然后 输入的条数 话语面板。您的互动将按以下格式转换为 JSON 格式: 格式:

  • ask:您的查询。
  • answers:一组可能的 Assistant Simulator 响应。

您可以在 Android Studio 中修改此 JSON 文件。

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

收集批量响应

Google Home Plugin 面板中,点击话语文件以打开 您保存的 JSON 文件。在选择路径部分,您可以选择 文件或文件夹。如果您选择了一个文件夹,那么点击收集测试 处理该文件夹中所有话语 .json 文件。

您可以为同一文件或不同文件打开多个标签页,例如 lightslights(1)plug

状态栏显示上次测试的结果(如果适用)。 以指示文件是否已收集到黄色或绿点,以及 语音内容 .json 文件路径。点击 收集Assistant Simulator 会运行您的查询。 当系统收集到新回复时,您会收到通知,并且状态栏 在系统处理查询时,会显示计数器。

使用 Google 助理模拟器收集话语

收集完成后,状态栏会进行更新并显示绿色签入 .json 路径前面,并且语音文件中将会填充 可能的回答。

<ph type="x-smartling-placeholder">
</ph> 使用 Google 助理模拟器收集话语
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

如果您提前停止收集,则 .json 路径将不会被标记为 。

测试批量语音

收集到回复后,点击 测试以重放查询 并检查您的响应和日志。测试批量话语时, Assistant Simulator 需要保存到您的 JSON 中的响应 文件。如果测试返回的响应尚未收集,您会收到 类似于以下响应的通知:

Expected one of: "Got it, turning on 2 lights."

使用 Google 助理模拟器运行话语

此情形表示测试失败。否则, Assistant Simulator 将运行您的每个查询并返回响应。 状态栏(如果测试成功)。

<ph type="x-smartling-placeholder">
</ph> 使用 Google 助理模拟器运行话语

查看 Cloud Logging

如需在 Cloud 日志工具窗口中打开项目标签页,请点击 Cloud 日志。 选择 Google Home Plugin 面板。您可以打开单独的云日志标签页 分别创建项目和计划

Cloud Logging 标签页

查询字词

对于所选项目,您还可以使用查询字段过滤日志。 例如,如需过滤 light 关键字的日志,请使用以下代码:

Cloud Logging 查询

选择使用 QL 以使用 日志记录查询语言

Cloud Logging 查询语言

下面列举了一些 QL 查询示例,以帮助您上手:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

日期和时间查询

按日期查询日志也是可选操作,点击 之后之前。您可以在 字段(例如 5/11/22, 12:37 PM),也可以使用日期选择器 以选择日期,然后在文本字段中输入时间。

  • 如需选择 5/1/22之后的日期,请选择晚于,然后点击日期图标
  • 要选择 5/1/22之前的日期,请选择早于,然后点击相应日期 图标
  • 要选择 5/1/226/30/22之间的日期,请选择之前之后,并从日期图标中选择日期

选择实时可提取实时项目日志。点击停止以结束 实时更新

严重级别

您还可以从下拉列表中选择最低严重级别

查询结果

点击 抓取提交 您的查询参数。

加载日志后,点击任意记录 可展开完整内容 JSON 载荷。再次点击 以显示完整的消息。

(可选)您可以在过滤条件框中输入某个关键字以缩小日志范围 结果。点击 x 可移除过滤条件并恢复为原图 提取结果。

查看 Cloud Logging

查看 Home Graph 并运行测试

如需列出您的设备,请从 Android Studio 清单中选择 Home Graph Google Home Plugin面板。

点击 刷新以显示 设备的设备名称设备 ID设备类型 与所选项目相关联。您可以设置多个 系统会针对不同的项目打开 Google Home Graph 个面板。

加载设备后,点击任意记录 可展开完整内容 JSON 载荷。

Home Graph JSON 载荷

您还可以使用展开收起来显示或隐藏 JSON 为设备分配有效负载

Home Graph 展开和收起 JSON

如需针对特定设备启动测试套件,请执行以下操作: 点击测试。这会在浏览器中启动测试套件 设备已选定,且已准备好进行测试。点击 Start 并等待测试 结果。

Home Graph 运行测试

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

Home Graph 已完成测试

Android 调试桥 (adb) 日志查看器

要在“Adb 日志”工具窗口中打开项目标签,请点击 Adb Log 命令。 。您可以单独打开 Adb 日志 每个日志文件对应的标签页。要删除标签页,请点击 图标。

使用选择字段选择要查看的特定日志记录组件, 严重性下拉菜单,用于仅显示具有匹配日志严重性的条目。

对于所选的 adb 日志,您可以使用过滤条件来过滤日志条目 字段,其中包含可选的区分大小写Regex 修饰符。

此外,您可以:

  • 使用 Find 字段和 Find Next 图标)和 Find Previous 图标)命令查找特定条目。
  • 使用可选的区分大小写Regex 修饰符。
  • 跳至行 (Jump to line) 可跳转到日志中的指定行(按数字)。

选择编号可查看已添加行号的日志行。选择原始 查看原始日志条目。

adb 日志查看器

资源和反馈

点击资源,查看开发者工具和资源列表。

提交您的想法或反馈,帮助我们改进开发工作 使用 Google Home Plugin 时,请点击反馈

<ph type="x-smartling-placeholder">
</ph> 发送反馈