在继续进行账号授权之前,请确保您已完成以下操作:
- 安装在移动设备上的 Google Home app (GHA),并在您的 Google 账号中设置了至少一个住宅(结构)。
- 住宅中至少有一台支持的示例应用设备类型:
- 色温灯(开启和关闭、亮度)
- 接触传感器(布尔值状态)
- 可调光灯(开启和关闭、亮度)
- 扩展色彩灯(开启和关闭、亮度)
- 通用开关
- 在家/外出传感器(在家/外出感知)
- 开/关灯(开启和关闭、亮度)
- 开/关灯开关
- 开/关插入式装置(开启和关闭)
- 开/关传感器
- 两部用于测试示例自动化操作的设备。
在通过 Home API 使用设备之前,必须先通过 GHA 控制这些设备。
运行示例应用
运行示例应用。首次运行该应用时,系统会要求您允许应用访问您 Google 账号中的住宅。这会向示例应用授予访问和控制该住宅中的结构和设备的权限。
应用的默认权限行为因应用是否在 Google Home Developer Console 上注册而异。
如果应用未在 Developer Console 中注册,则处于未验证状态。建议您使用以下方法测试 Home API 的使用情况:
只有在 OAuth 控制台中注册为测试用户的用户才能为应用授予权限。未经验证的应用的测试用户数量上限为 100 人。
未经验证的应用将有权访问 Home API 的 OAuth 支持的任何类型的设备(Developer Console 中的设备类型列表)。系统会授予结构中的所有设备访问权限。
如果应用已在 Developer Console 中注册 ,并且已获准访问一种或多种设备类型,并且已完成 OAuth 品牌验证,则该应用将处于已验证状态。必须处于此状态才能将应用发布到生产环境:
- 测试用户数上限已不再适用。任何用户都可以向应用授予权限。
- 用户只能向 Developer Console 中已获批准的设备类型授予权限。
点按允许访问所选住宅:
- 如果有任何住宅与您的账号相关联,请选择要授予权限的住宅。如果在所选住宅中找不到任何设备,您可以执行以下操作:
- 点按允许访问其他住宅以选择其他住宅。
- 使用 Google Home app (GHA) 在该住宅中设置您选择的设备。请注意,此示例应用中仅支持控制以下类型的设备:
- 色温灯(开启和关闭、亮度)
- 接触传感器(布尔值状态)
- 可调光灯(开启和关闭、亮度)
- 扩展色彩灯(开启和关闭、亮度)
- 通用开关
- 在家/外出传感器(在家/外出感知)
- 开/关灯(开启和关闭、亮度)
- 开/关灯开关
- 开/关插入式装置(开启和关闭)
- 开/关传感器
- 如果您的账号没有关联的住宅,您会看到一个屏幕,其中显示消息“所选账号没有结构体”。
- 向后滑动以返回示例应用的主视图。
- 如需设置住宅,请使用 GHA。然后,再次尝试向示例应用授予权限。
如需随时重新访问权限流程,请选择任何示例应用屏幕右上角的个人资料图标
。成功向包含设备的住宅授予权限后,您会进入设备视图。您可以通过示例应用控制设备并观察其状态变化。