Google Home Playground

Cloud-to-cloud    Local Home SDK    设备 SDK

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

完成账号关联

如需使用 Google Home Playground，建议您先将该工具与您的帐号关联。在手机上打开 Google Home app (GHA)，然后完成帐号关联流程：

  1. 点击左上角的加号 (+) 图标。
  2. 依次选择设置设备 > 与 Google 服务兼容。
  3. 搜索名为 Google Home Playground 的 Action。
  4. 选择相应 Action，GHA 便会将您定向到登录页面。点击使用 Google 帐号登录，然后选择您的帐号并登录。
  5. 点击授权按钮以授权帐号关联。
此图显示了用于关联 Google Home Playground 的 Google Home 应用帐号关联流程。

完成帐号关联后，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 的默认视图的设备列表、设备信息和日志区域。

网页界面由三个面板组成：

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

虚拟设备

查看虚拟设备信息

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

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

修改虚拟设备信息

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

修改支持的特征

  1. 选择特征标签页，然后点击修改按钮。
  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 标签页并配置以下内容：
    • Enabled：设备上是启用还是停用 SUV（无质询）。
    • 挑战类型：SUV 是需要明确确认 (ackNeeded) 还是需要个人识别码 (pinNeeded)。
    • PIN 码：有效的 PIN 码。
    • 处理错误 PIN 码：当 PIN 码错误时、是否再次询问用户以及如果不是，则对错误进行响应。
此图显示了用于在 Google Home Playground 中的所选设备上启用第二层用户身份验证特征的用户体验工具。

识别支持 SUV 的设备

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

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

以下特征需要 SUV：

创建新的虚拟设备

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

移除虚拟设备

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

同步响应编辑器

您可以在 Google Home Playground 中验证或更新同步响应。点击 Sync Response Editor 以打开嵌入式 IDE。

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

修改（或复制并粘贴）您的同步响应，然后点击保存以应用更改，以查看其在 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 调用的响应正文。如需了解每种方法的格式，请参阅参考文档 参考文档。

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

右上角的问号 帮助图标将显示 Google Home Playground 支持的当前设备类型和特征列表。

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

报告问题

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

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