Google Home Playground

Google Home Playground 是一款 Web 应用，可模拟智能 家居项目，并为其配置设备类型和特征。您可以在其中创建虚拟 设备、修改设备属性和状态、在 Google Home Graph中查看这些设备，以及导入或导出设备配置。

完成账号关联

为了能够使用 Google Home Playground，建议您先将 工具与您的账号关联。在手机上打开 Google Home app (GHA)，然后按照在 Google Home 应用中关联第三方智能家居设备中所述的账号关联过程进行操作。

  1. 搜索名为 Google Home Playground 的集成。
  2. 选择该集成，GHA 会将您定向到 登录页面。 点击 Sign in with Google （使用 Google 账号登录），然后选择您的账号进行登录。
  3. 点击 Authorize （授权）按钮，以授权账号关联。
此图显示了 Google Home 应用的账号关联流程，用于连接 Google Home Playground。

完成账号关联后， 上会显示一组默认的虚拟设备，供您与之互动。GHA

此图显示了当用户成功将 Google Home Playground 与其账号相关联时填充的默认设备列表。

登录

点击以下按钮启动 Google Home Playground：

启动 Playground

点击 Sign in with Google （使用 Google 账号登录）。请务必使用与 GHA 中使用的账号相同的账号登录，以完成账号关联。

此图显示了 Google Home Playground 的初始状态，并突出显示了右上角的登录按钮。

登录后，Google Home Playground 会显示存储在 Home Graph 中的虚拟设备 。

此图显示了 Google Home Playground 默认视图的设备列表、设备信息和日志区域。

Web 界面由三个面板组成：

  • 设备列表 会显示您的所有虚拟设备。您可以选择某个虚拟设备，以查看其信息，并在此面板中创建虚拟设备。
  • 设备信息 会显示所选虚拟设备的信息。 您还可以通过此面板修改此信息并移除所选虚拟设备。
  • 日志区域 会显示 Google Home Playground 与 Home Graph 之间的互动日志。您可以展开日志，以检查请求和响应负载，从而进行问题排查。

虚拟设备

查看虚拟设备信息

在设备列表 面板中，选择您要查看的虚拟设备。 在设备列表 面板中，选择您要查看的虚拟设备。 设备信息 面板会显示其信息，这些信息分为五个标签页：

  • 基本信息 ：设备的顶级属性，包括设备类型、ID 和名称。
  • 特征 ：设备支持的特征。
  • 属性 ：设备特定于特征的属性。
  • 状态 ：所有设备状态。
  • SUV：设备的第二层用户身份验证配置。

修改虚拟设备信息

除了查看虚拟设备的信息之外，您还可以通过设备信息 面板直接修改存储在 Home Graph 中的信息。

修改支持的特征

  1. 选择 Traits （特征）标签页；点击 Edit （修改）按钮。
  2. 在弹出式面板中，您可以看到设备当前支持的特征，以及可添加的特征。使用箭头 (arrow_forward/arrow_back) 按钮为设备 添加或移除支持的特征。
  3. 更新完支持的特征后，点击 Save， 更新后的特征将应用于 Home Graph。
  4. 您可以在日志区域 中查看这些特征更新。
此图显示了 Google Home Playground 中用于在所选设备上添加或删除受支持特征的用户体验工具。

修改设备属性

  1. 选择 Attributes （属性）标签页，然后修改设备支持的特征的属性。
  2. 修改完成后，按 Enter 键，您的属性更改将 应用于 Home Graph。
  3. 您可以在日志区域 中查看这些更新后的属性。

修改设备状态

  1. 选择 States （状态）标签页，然后直接修改状态。状态更改将 应用于 Home Graph。
  2. 您可以在日志区域 中查看这些状态修改。

为虚拟设备添加第二层用户身份验证

您可以为虚拟设备添加 SUV，并配置其在每个设备上的质询类型和相应行为。您可以为虚拟设备添加 SUV，并配置其在每个设备上的质询类型和 相应行为。

在设备上配置 SUV

  1. 在设备列表 面板中，选择您要配置的虚拟设备。
  2. 在设备信息 面板中，选择 SUV 标签页，然后配置以下内容：
    • 已启用：设备上是否启用或停用 SUV（无质询）。
    • Challenge type（质询类型）：SUV 是否需要显式确认 (ackNeeded) 或 个人识别码 (pinNeeded)。
    • PIN ：有效的 PIN 码。
    • Handling of incorrect PIN （错误 PIN 码的处理方式）：PIN 码错误时，是否再次询问用户，如果不是，则响应的错误是什么。
此图显示了用于在 Google Home Playground 中为所选设备启用第二层用户身份验证特征的界面工具。

识别启用 SUV 的设备

在设备列表 面板中，每个启用 SUV 的设备旁边都会显示一个钥匙图标 key。

此图显示了建议启用第二层用户身份验证的设备。

以下特征需要 SUV：

创建新的虚拟设备

  1. 在设备列表 面板中，点击 Add a device （添加设备）。
  2. 在弹出式面板中，选择设备类型，然后为新设备输入设备名称。或者，您也可以选择一组预定义的设备进行添加。
  3. 完成所有步骤后，新设备将添加到 Home Graph。
此图显示了在 Google Home Playground 中添加新设备类型的用户体验工具。

移除虚拟设备

  1. 在设备列表 面板中，选择您要移除的设备。 然后，在设备信息 面板中，选择基本信息 标签页，然后 然后，在设备信息 面板中，选择基本信息 标签页，然后 点击底部的 垃圾箱图标Remove device （移除设备）。
  2. 在弹出式提醒中确认设备移除。
  3. 确认移除设备后，该设备将从 Home Graph中移除。
此图显示了用于在 Google Home Playground 中移除虚拟设备类型的用户体验工具。

SYNC 响应编辑器

您可以在 Google Home Playground 中验证或更新 SYNC 响应。 点击 Sync Response Editor （SYNC 响应编辑器）以打开嵌入式 IDE。

此图显示了用于打开同步响应编辑器的按钮。

修改或复制并粘贴 SYNC 响应，然后点击 Save （保存）以应用更改，查看其在 Google Home 生态系统中的运作方式。

此图显示了用于修改同步响应的窗口。

导入和导出虚拟设备

为了排查问题或重现问题，您可以将虚拟设备及其状态导出到文件，并与他人分享该文件，以便导入和复制您的虚拟设备。

此图显示了 Google Home Playground 中用于导入和导出虚拟设备的界面工具。

将虚拟设备导出到文件

  1. 点击 将 虚拟设备导出到文件。
  2. 输入要导出的文件名，然后点击 OK （确定）。
  3. 输入文件名后，浏览器会下载导出的虚拟设备文件。

从文件导入虚拟设备

  1. 点击 从文件导入虚拟 设备。
  2. 选择要导入的文件，然后点击 OK （确定）。
  3. 确认要导入的文件后，Google Home Playground会 从该文件导入虚拟设备及其状态，并更新导入的 设备的信息和状态（位于Home Graph中）。

检查互动日志

当您与虚拟设备互动时，Google Home Playground 会自动将您的更改应用于 Home Graph。与 Home Graph 的 互动会记录到 日志区域 面板中，您可以在其中展开每个条目，以检查 Home Graph API 请求和响应负载。

每个日志条目都是一个 JSON 数组，包含以下结构的元素：

{
  "uri": string,
  "request": object,
  "response": object
}
字段 类型 说明
uri string Home Graph API 调用的网址。
request object Home Graph API 调用的请求正文。如需了解每种方法的格式，请参阅 参考文档 参考文档 。
response object Home Graph API 调用的响应正文。如需了解每种方法的格式，请参阅 参考文档 参考文档 。

查看支持的设备类型和特征

右上角的问号 帮助 图标会显示当前支持的设备类型和 trait 列表，由Google Home Playground提供支持。

此图显示了在 Google Home Playground 中添加新设备类型的用户体验工具。

报告问题

希望您可以向我们提供反馈意见！如需报告遇到的问题，请使用右上角的 感叹号图标 反馈。

此图显示了 Google Home Playground 中用于提供反馈和报告问题的图标。