此页面由 Cloud Translation API 翻译。

适用于 Android Studio 的 Google Home 插件

Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.

安全通知

为防止 Android Studio 存储 Secret 和密码，请完成以下步骤：

点击文件，然后点击设置...。
在外观和行为中，展开系统设置，然后点击密码。
选择不保存，重启后请忘记密码。

功能

Google 助理模拟器

如需测试你的智能家居设备能否与 Google Home 生态系统搭配使用，你可以随时与 Assistant Simulator 互动，无需退出 Android Studio。

与 Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light." 中提供的现有 Google 助理模拟器类似

查看 Cloud Logging

Google Cloud Logging 可提供调试信息和关键指标，让您深入了解 Action 的使用情况。为了简化开发，在问题排查期间，Google Home Plugin 会在您的代码旁边显示实时 Cloud Logging 消息。

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

批量话语

对一条话语的 Assistant Simulator 响应不是确定的。例如，响应可以是以下任何一个短语：

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

如需运行自动化测试并验证 Google 集成如何处理这些不同的响应，您可以通过运行话语脚本向 Assistant Simulator 发送语音样本。保存脚本后，您可以收集响应并针对查询运行多个测试。

Home Graph 查看者

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

安装

如需在 Android Studio 中安装 Google Home Plugin，请按以下步骤操作：

下载或更新 Android Studio。
重要提示：您必须拥有 Android Studio - Chipmunk (2021.2.1)+ to use the plugin. To learn more, refer to the Compatibility Range
下载 Android Studio
依次转到 File > Settings（在 MacOS 中，依次转到 Android Studio > Preferences）。
在 Plugins 部分中，转到 Marketplace，然后搜索 google home。
安装该工具，然后重启 Android Studio。

您也可以直接从 JetBrains Marketplace 下载该插件。

设置

安装此插件后，您需要先完成以下步骤，然后才能使用 Assistant Simulator 并查看 Cloud Logging：

使用 Google 帐号登录
选择云项目

使用 Google 帐号登录

您可以从 Google Home 面板登录您的开发者帐号，并授权 Android Studio 代表您与 Google 服务通信。

点击 Android Studio 窗口左侧垂直标签页列中的 Google Home 标签页。
在登录方式部分，点击 Google 以启动浏览器。
选择与你的智能家居设备关联的帐号。
在使用 Google 帐号登录授权页面上，点击允许。
关闭浏览器窗口，然后返回到 Android Studio。

您现在应该已经登录，可以选择退出。

选择一个 Cloud 项目

登录后，从下拉菜单中选择项目。如需过滤项目列表，请输入过滤条件表达式（例如 matter），然后按 Enter。

Project 下拉列表根据您的 Filter 加载前 100 个项目。系统会在您退出时保留您的选择 Android Studio。

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

使用 Google 助理模拟器

如需在 Android Studio 中打开 Assistant Simulator，请点击 Google Home Plugin 面板中的 话语面板。

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

输入查询内容并收集回复

如需与 Assistant Simulator 交互，请输入您的查询，然后按 Enter 键。

如需重新发送查询，请点击查询末尾的重新发送图标。

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

点击保存以保存您在话语面板中输入的查询和响应。您的互动会按以下格式转换为 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 面板中，点击 Utterances 文件，以在新的标签页中打开已保存的 JSON 文件。对于选择路径，您可以选择文件或文件夹。如果您选择一个文件夹，Collect 和 Test 将处理该文件夹中的所有话语 .json 文件。

您可以针对同一文件或不同文件打开多个标签页，例如 lights、lights(1) 和 plug。

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

收集完成后，状态栏会使用 .json 路径前面的绿色对勾标记进行更新，并且语音提示文件会填充可能的响应。

{
  "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."

这种情况表明测试失败。否则，Assistant Simulator 将运行您的每个查询并返回响应。如果测试成功，则状态栏中会显示检查。

查看 Cloud Logging

如需在 Cloud Logs 工具窗口中打开项目标签页，请点击 Google Home Plugin 面板中的 Cloud Logs。您可以为每个项目打开单独的 Cloud Log 标签页。

查询字词

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

选择使用 QL 以使用 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/22 到 6/30/22 之间的日期，请选择之前和之后，然后从日期图标中选择日期。

选择实时可获取实时项目日志。点击停止即可结束实时 Feed。

严重级别

您也可以从下拉菜单中选择最低严重级别。

查询结果

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

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

（可选）您可以在过滤条件框中输入关键字以缩小日志结果的范围。点击 x 可移除过滤条件并返回原始提取结果。

查看 Home Graph 并运行测试

如需列出您的设备，请从 Google Home Plugin 面板中选择 Home Graph。

点击 Refresh 以显示与所选项目关联的设备的 Device name、Device ID 和 Device type。您可以添加多个 Google Home Graph panels open for separate projects.

设备加载后，点击任意记录以展开完整的 JSON 载荷。

您还可以使用展开和收起来显示和隐藏设备的 JSON 载荷。

如需为特定设备启动测试套件，请点击测试。这样即可在浏览器中启动测试套件，并且您的设备已选定并可供测试。点击开始，然后等待测试结果。

您可以查看测试详情，并在测试完成后查看日志。

资源和反馈

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

如需提交您对如何使用 Google Home Plugin 改善开发体验的想法或反馈，请点击反馈。