Google Home Playground

<ph type="x-smartling-placeholder"></ph> 设备 SDK

Google Home Playground 是一个 Web 应用，用于模拟智能 Home 项目。您可以创建 设备、修改设备属性和状态、在以下位置查看这些设备 Google Home Graph，以及导入或导出设备配置。

完成账号关联

如需使用 Google Home Playground，建议您先将 工具。在手机上打开Google Home app (GHA)，然后前往 完成账号关联：

1. 点击左上角的加号 (+) 图标。
2. 选择设置设备 >与 Google 服务兼容。
3. 搜索名为 Google Home Playground 的 Action。
4. 选择相应操作，GHA 会将您定向到 登录页面。 点击使用 Google 账号登录，然后选择您的账号进行登录。
5. 点击授权按钮以授权账号关联。

</ph>

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

登录

点击下面的按钮，启动 Google Home Playground：

启动 Playground

点击 Sign in with Google（使用 Google 账号登录）。请务必使用 用于在GHA中完成账号关联。

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

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

• 设备列表会显示您的所有虚拟设备。您可以选择特定的 以便查看其信息并通过 。
• 设备信息：显示所选虚拟设备的信息。 您还可以修改这些信息，并通过以下方式移除所选虚拟设备： 面板
• 日志区域显示了 Google Home Playground和Home Graph。您可以 展开日志以检查 问题排查。

虚拟设备

查看虚拟设备信息

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

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

修改虚拟设备信息

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

修改支持的 trait

1. 选择特征标签页；点击修改按钮。
2. 在弹出式面板中，你可以查看设备当前支持的特征，以及 可添加哪些特征。使用箭头 (arrow_forward/arrow_back) 按钮 添加或移除设备支持的特征。
3. 更新完受支持的特征后，点击 Save，然后 更新后的特征将应用于Home Graph。
4. 您可以在日志区域中查看这些特征更新。

修改设备属性

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

修改设备状态

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

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

您可以将 SUV 添加到虚拟设备并配置其验证类型， 每个设备上的对应行为。 您可以将 SUV 添加到虚拟设备并配置其验证类型， 每个设备上的对应行为。

在设备上配置 SUV

1. 在设备列表面板中，选择您要对 配置。
2. 在设备信息面板中，选择 SUV 标签页并配置 以下： <ph type="x-smartling-placeholder">
   </ph>
   • Enabled：在 SUV 模式下是启用还是停用（无质询） 。
   • 验证类型：SUV 是否需要明确确认 (ackNeeded) 或 个人识别码 (pinNeeded)
   • PIN 码：有效的 PIN 码。
   • 处理不正确的 PIN 码：当 PIN 码错误时，是否询问 用户，如果不是，则响应错误。

识别支持 SUV 的设备

设备列表面板中会显示一个钥匙图标 键显示在 每台支持 SUV 的设备。

SUV 的特征如下：

• ArmDisarm
• LockUnlock
• OpenClose
• 重新启动
• SoftwareUpdate

创建新的虚拟设备

1. 在设备列表面板中，点击添加设备。
2. 在弹出式面板中，选择设备类型，并输入 您的新设备。您也可选择一组预定义的设备 添加。
3. 完成所有步骤后，系统会将新设备添加到 Home Graph。

移除虚拟设备

1. 在设备列表面板中，选择您要移除的设备。 然后，在设备信息面板中，选择基本信息标签页并 然后，在设备信息面板中，选择基本信息标签页并 点击底部的 移除设备。
2. 在弹出式提醒中确认设备移除。
3. 您确认移除设备后，就会将此设备从以下来源中移除： Home Graph。

</ph>

同步响应编辑器

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

修改或复制和粘贴您的同步响应，然后点击保存以应用更改 了解它在 Google Home 生态系统中的运作方式。

导入和导出虚拟设备

如需排查问题或重现问题，您可以导出虚拟设备 以及与其他人共享要导入的文件 复制虚拟设备

将虚拟设备导出到文件

1. 点击 file_download 即可导出 虚拟文件
2. 输入要导出的文件名，然后点击确定。
3. 输入文件名后，浏览器会下载 导出的虚拟设备

从文件导入虚拟设备

1. 点击 upload_file 以导入虚拟设备 从文件中移除设备
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
}

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

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

报告问题

希望您可以向我们提供反馈意见！使用 感叹号图标 反馈 右上角。