Android 设备上的账号授权

在继续进行账号授权之前,请确保您已执行以下操作:

  1. 在 Android 移动设备上安装了 Google Home app (GHA)。
  2. 住宅中至少有一种以下受支持的设备类型用于示例应用:
    • 色温灯(开/关、亮度)
    • 接触式传感器(布尔状态)
    • 可调光灯(开/关、亮度)
    • 门锁
    • 扩展色灯(开/关、亮度)
    • 通用开关
    • Google 边界路由器
    • Google 相机
    • Google 门铃
    • 在家/外出传感器(在家/外出感应)
    • 开/关灯(开/关、亮度)
    • 开/关灯开关
    • 开/关插件单元(开/关)
    • 开/关传感器
  3. 用于测试示例自动化操作的两台设备。

通过 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中获批的设备类型授予权限。

点按允许访问所选住宅:

  • 如果您的账号关联了住宅,请选择一个住宅以授予权限。如果在所选住宅中未找到任何设备,您可以执行以下任一操作:
    1. 点按允许访问其他住宅 以选择其他住宅。
    2. 使用 Google Home app (GHA) 在该住宅中设置您选择的设备 。请注意,只有以下设备类型支持在此示例应用中进行控制:
      • 色温灯(开/关、亮度)
      • 接触式传感器(布尔状态)
      • 可调光灯(开/关、亮度)
      • 门锁
      • 扩展色灯(开/关、亮度)
      • 通用开关
      • Google 边界路由器
      • Google 相机
      • Google 门铃
      • 在家/外出传感器(在家/外出感应)
      • 开/关灯(开/关、亮度)
      • 开/关灯开关
      • 开/关插件单元(开/关)
      • 开/关传感器
  • 如果您的账号未关联任何住宅,您将看到一个屏幕,其中显示消息所选账号没有结构 。
    1. 向后滑动即可返回到示例应用主视图。
    2. 如需设置住宅,请使用 GHA。然后再次尝试向示例应用授予权限。

您可以随时重新访问权限授予流程,只需点击任意 示例应用屏幕右上角的个人资料图标 即可。

选择要在其中运行示例应用的结构。
图 1:选择结构
所选结构,显示了可用设备。
图 2:结构和设备
控制设备的设置。
图 3:设备控件
所选住宅,其中显示了可用的自动化操作。
图 4:结构和自动化操作

成功向包含设备的住宅授予权限后,您将进入设备视图。您可以通过示例应用控制设备并观察其状态变化。