Cloud-to-cloud Local Home SDK 设备 SDK
Google Home Playground 是一个 Web 应用,使用可配置的设备类型和特征来模拟智能家居项目。您可以创建虚拟设备、修改设备属性和状态、在 Google Home Graph 中查看这些设备,以及导入或导出设备配置。
完成账号关联
如需使用 Google Home Playground,建议您先将该工具与您的帐号关联。在手机上打开 Google Home app (GHA),然后完成帐号关联流程:
- 点击左上角的加号 (+) 图标。
- 依次选择设置设备 > 与 Google 服务兼容。
- 搜索名为 Google Home Playground 的 Action。
- 选择相应 Action,GHA 便会将您定向到登录页面。点击使用 Google 帐号登录,然后选择您的帐号并登录。
- 点击授权按钮以授权帐号关联。

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

登录
点击下面的按钮可启动 Google Home Playground:
点击 Sign in with Google(使用 Google 账号登录)。请务必使用您在 GHA 中使用的那个帐号登录以完成帐号关联。

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

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

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

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

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

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

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

修改(或复制并粘贴)您的同步响应,然后点击保存以应用更改,以查看其在 Google Home 生态系统中的运作方式。

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

将虚拟设备导出到文件
- 点击 可将虚拟设备导出到文件中。
- 输入要导出的文件名,然后点击 OK。
- 输入文件名后,浏览器将下载已导出的虚拟设备的文件。
从文件导入虚拟设备
- 点击 即可从文件导入虚拟设备。
- 选择要导入的文件,然后点击 OK。
- 确认要导入的文件后,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 支持的当前设备类型和特征列表。

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