在继续进行账号授权之前,请确保您已执行以下操作:
- 在 Android 移动设备上安装了 Google Home app (GHA)。
- 住宅中至少有一种以下受支持的设备类型用于示例应用:
- 色温灯(开/关、亮度)
- 接触式传感器(布尔状态)
- 可调光灯(开/关、亮度)
- 门锁
- 扩展色灯(开/关、亮度)
- 通用开关
- Google 边界路由器
- Google 相机
- Google 门铃
- 在家/外出传感器(在家/外出感应)
- 开/关灯(开/关、亮度)
- 开/关灯开关
- 开/关插件单元(开/关)
- 开/关传感器
- 用于测试示例自动化操作的两台设备。
通过 Home API 使用设备之前,必须能够通过 GHA控制这些设备。
运行 Android 示例应用
在授权账号之前,请验证示例应用是否已针对您的项目配置适当的 OAuth 范围。默认情况下,示例应用源代码使用 https://www.googleapis.com/auth/home.platform.v2 范围。示例应用中的许多功能都受 home.platform.v2 范围的限制,并且需要合作伙伴批准才能访问。如需使用标准
https://www.googleapis.com/auth/home.platform.selected.devices范围授权和使用示例应用,请按照构建应用中的说明,在HomeModule.kt
中手动将homePlatformScope切换为HOME_PLATFORM_SCOPE_VERSION_1。
运行 Android 示例应用。首次运行该应用时,系统会要求您允许访问 Google 账号中的住宅。这会授予示例应用访问和控制该住宅中的结构和设备的权限。
如果您没有结构,用户可以在权限授予流程中创建一个结构,而无需使用 GHA。
应用的默认权限行为会有所不同,具体取决于 该应用是否已在 Google Home Developer Console 中注册。
如果应用未在Developer Console中注册,则该应用将处于 未验证状态。建议您使用此状态来测试 Home API 的使用情况:
只有在 OAuth 控制台中注册为测试用户的用户才能授予 应用权限。未验证的 应用最多只能有 100 个测试用户。
未验证的应用将有权访问 Home API 的 OAuth 支持的任何设备类型的设备( Developer Console开发者控制台中的设备类型列表)。系统将授予对结构中所有设备的访问权限。
如果 开发者控制台中注册Developer Console ,并且已获准访问一种或多种设备类型,并且已完成 OAuth 的品牌 验证,则该应用将处于已验证状态。如需将应用发布到正式版,必须处于此状态:
- 不再适用测试用户限制。任何用户都可以向应用授予权限。
- 用户只能向在 Developer Console中获批的设备类型授予权限。
点按允许访问所选住宅:
- 如果您的账号关联了住宅,请选择一个住宅以授予权限。如果在所选住宅中未找到任何设备,您可以执行以下任一操作:
- 点按允许访问其他住宅 以选择其他住宅。
- 使用 Google Home app (GHA) 在该住宅中设置您选择的设备
。请注意,只有以下设备类型支持在此示例应用中进行控制:
- 色温灯(开/关、亮度)
- 接触式传感器(布尔状态)
- 可调光灯(开/关、亮度)
- 门锁
- 扩展色灯(开/关、亮度)
- 通用开关
- Google 边界路由器
- Google 相机
- Google 门铃
- 在家/外出传感器(在家/外出感应)
- 开/关灯(开/关、亮度)
- 开/关灯开关
- 开/关插件单元(开/关)
- 开/关传感器
- 如果您的账号未关联任何住宅,您将看到一个屏幕,其中显示消息所选账号没有结构 。
- 向后滑动即可返回到示例应用主视图。
- 如需设置住宅,请使用 GHA。然后再次尝试向示例应用授予权限。
您可以随时重新访问权限授予流程,只需点击任意 示例应用屏幕右上角的个人资料图标 即可。
成功向包含设备的住宅授予权限后,您将进入设备视图。您可以通过示例应用控制设备并观察其状态变化。