Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph, and import or export device configurations.
完成帐号关联
如需使用 Home Playground,建议您先将该工具关联到您的帐号。打开Google Home app (GHA) on your phone, and go through the account linking process:
- 点击左上角的加号 (+) 图标。
- 依次选择设置设备 > 适用于 Google。
- 搜索名为 Google Home Playground 的操作。
- 选择 Action,GHA 即会将您定向到登录页面。 点击使用 Google 帐号登录,然后选择您的帐号进行登录。
- 点击授权按钮,对帐号关联进行授权。

完成帐号关联后,GHA 上会显示一组默认虚拟设备供您互动。

登录
点击下面的按钮可启动 Home Playground:
点击使用 Google 帐号登录。请务必使用您在 GHA 中使用的帐号登录,以完成帐号关联。

登录后,Home Playground 将显示存储在 Home Graph 中的虚拟设备。

该网页界面包含三个面板:
- 设备列表会显示您的所有虚拟设备。您可以通过此面板选择某个虚拟设备以查看其信息并创建虚拟设备。
- 设备信息显示所选虚拟设备的信息。 您还可以通过面板修改此信息并移除所选的虚拟设备。
- 日志区域会显示 Home Playground 和 Home Graph 之间的互动日志。您可以展开日志以检查请求和响应载荷以进行问题排查。
虚拟设备
查看虚拟设备信息
在设备列表面板中,选择您要查看的虚拟设备。 设备信息面板将其信息分为五个标签页:
- 基本信息:设备的顶级属性,包括设备类型、ID 和名称。
- 特征:设备支持的特征。
- 属性:设备的特征特定属性。
- 状态:所有设备状态。
- SUV:设备的次要用户验证配置。
修改虚拟设备信息
除了查看虚拟设备的信息外,您还可以通过设备信息面板直接修改存储在 Home Graph 中的信息。
修改支持的特征
- 选择特征标签页,然后点击修改按钮。
- 在弹出式窗口中,您可以看到设备当前支持的特征,以及可添加特征。使用箭头
(arrow_forward/arrow_back) 按钮可添加或移除设备支持的特征。 - 更新完受支持的特征后,点击保存,更新后的特征将应用于 Home Graph。
- 您可以在日志区域中查看这些特征更新。

修改设备特性
- 选择 Basic Information/Attributes 标签页,并修改设备支持的特征的属性。
- 完成修改后,按 Enter 键,特性更改将应用于 Home Graph。
- 您可以在日志区域中查看这些更新后的属性。
修改设备状态
- 选择状态标签页,然后直接修改状态。状态变更将应用于 Home Graph。
- 您可以在日志区域中查看这些状态修改。
向虚拟设备添加第二层用户身份验证机制
您可以向虚拟设备添加 SUV,并在每个设备上配置其验证类型和相应行为。
在设备上配置 SUV
- 在设备列表面板中,选择您要配置的虚拟设备。
- 在设备信息面板中,选择 SUV 标签页,然后配置以下内容:

识别支持 SUV 的设备
在设备列表面板中,每个已启用 SUV 的设备旁边都会显示一个钥匙图标 键。

以下特征需要 SUV:
创建新的虚拟设备
- 在设备列表面板中,点击添加设备。
- 在弹出的面板中,选择设备类型,然后输入新设备的设备名称。或者,您也可以选择添加一组预定义的设备。
- 完成所有步骤后,新设备将被添加到 Home Graph 中。

移除虚拟设备
- 在设备列表面板中,选择要移除的设备。
然后,在设备信息面板中,选择基本信息标签页,并点击底部的
移除设备。
- 在弹出式提醒中确认设备已移除。
- 您确认移除后,设备将从 Home Graph 中移除。

导入和导出虚拟设备
如需排查问题或重现问题,您可以将虚拟设备及其状态导出到一个文件,并与他人共享该文件以导入和复制虚拟设备。

将虚拟设备导出到文件中
- 点击 即可将虚拟设备导出到一个文件中。
- 输入要导出的文件名,然后点击确定。
- 输入文件名后,浏览器将下载导出的虚拟设备的文件。
通过文件导入虚拟设备
- 点击 以从文件导入虚拟设备。
- 选择要导入的文件,然后点击 OK。
- 确认要导入的文件后,Home Playground 将从该文件导入具有状态的虚拟设备,并在 Home Graph 中更新导入设备的信息和状态。
检查互动日志
当您与虚拟设备互动时,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 调用的响应正文。如需了解每种方法的格式,请参阅参考文档。 |
查看受支持的设备类型和特征
右上角的问号 帮助图标将显示 Home Playground 支持的当前设备类型和特征列表。

反馈和报告问题
希望您可以向我们提供反馈意见!点击右上角的笑脸图标 motion_sf 向我们提供反馈,或使用感叹号图标 feedback 报告问题。
