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 报告问题。
