Home API Android SDK 版本说明

2025-03-14

  Home API 公开 Beta 版 1.2.0  

此版本修复了一些 bug,并提升了 Home API Android SDK 的正式版 (GA) 质量。

最低版本

  • Google Play 服务的最低版本:25.06.32
  • Google Hub 固件最低版本:
    • Cast 版本:3.75.456944
    • Fuchsia 最低版本:24.20241009.103.1900601
  • Android SDK:home.android.sdk_202412_EAP_1_2_RC01
  • Google Home 应用最低版本:适用于任何版本
  • androidx.core 库的最低版本:1.10.0
  • Matter 版本: 1.3.0.0
    • 注意:不支持临时 Matter 设备类型和集群。

新功能

已知问题

  • 从 Wi-Fi 切换到移动网络时,设备控制延迟可能会增加。
  • 将集线器恢复出厂设置后,设备可能会显示为离线。
  • 如果在初始化之前或初始化完成之前调用 Discovery API,系统会抛出包含 code 14: UNKNOWN 和“No route found”(未找到路线)消息的 HomeException
    • 解决方法:仅在您实际需要自动化候选项时调用 Discovery API。请勿预提取和缓存候选实体。在对实体调用 Discovery API 方法之前,请检查实体是否处于在线状态。
  • 在包含多个结构和多个用户的环境中,在结构和用户之间切换可能会导致系统不返回任何设备。

修复的已知问题

  • Home API 应用在启动后首次调用 HomeManager.structures() 时,会收到零个结构,即使存在一个或多个结构也是如此。这会给人错误的印象,即没有与 Google 账号相关联的结构。
  • 在加载、创建和修改自动化操作时,用户可能会遇到长时间的等待时间。
  • 从相机应用启动设置流程的用户需要扫描二维码两次才能完成 Matter 调试。
  • 在包含 200 多部设备的结构中,Discovery API 可能根本不会返回任何候选设备。

2025-01-29

  Home API 公开 Beta 版 1.1.0  

此版本修复了一些 bug,并提升了 Home API Android SDK 的正式版 (GA) 质量。

最低版本

  • Google Play 服务的最低版本:25.02.32
  • Google Hub 固件最低版本:
    • Cast 版本:3.75.456944
    • 最低 Fuchsia 版本:24.20241009.103.1900500
  • Android SDK:home.android.sdk_202412_EAP_1_1_RC04
  • Google Home 应用最低版本:适用于任何版本
  • androidx.core 库的最低版本:1.10.0
  • Matter 版本: 1.3.0.0
    • 注意:不支持临时 Matter 设备类型和集群。

新功能

  • 流式传输 API:
    • 提供事件流,用于通知已添加、更改和移除的结构、房间和设备。
    • 请参阅订阅实体关系事件
  • 批处理 API(实验性):

已知问题

  • 在加载、创建和修改自动化操作时,用户可能会遇到较长的等待时间。
  • 从相机应用启动设置流程的用户需要扫描二维码两次才能完成 Matter 调试。
  • 在包含 200 多部设备的结构中,Discovery API 可能根本不会返回任何候选设备。

修复的已知问题

  • 切换已登录的 Google 账号可能会失败并导致错误。
  • Google TV 设备可能不适用于使用 MediaPlayback trait 的自动化操作。
  • 在仅包含 Google 集线器的结构中:
    • Matter 设备在 Google Home 应用中可能显示为离线状态。
    • Google 助理无法控制 Matter 设备。
    • 智能显示屏无法控制 Matter 设备或显示任何 Matter 设备的状态。
  • 对于某些设备,应用可能并不总能反映准确的状态,并且您的应用报告的状态可能与 Google 应用(例如 Google Home 应用)报告的状态不同。这通常是因为设备未向 Google 报告状态。
    • 解决方法:使用 Google 应用检查状态即可解决不一致的问题。

2025-01-14

更新了 Home API 初始化的指南。

我们更明确地说明了Home 的实例应初始化为上下文单例。这样可以确保在您的应用中提供更流畅的用户体验,并避免出现无效会话错误。

2025-01-07

  Home API 公开 Beta 版  

在公开开发者 Beta 版期间,所有开发者都可以开始构建和测试其应用。

此版本修复了一些 bug,并提升了 Home API Android SDK 的通用版本 (GA) 质量,包括改进了对 Google Nest Audio 和 Google TV 设备的支持。

最低版本

  • Google Play 服务的最低版本:24.45.34
  • Google Hub 固件最低版本:
    • Cast 版本:3.74.444798
    • Fuchsia 最低版本:22.20240805.103.161
  • Android SDK:home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home 应用 (GHA) 最低版本:适用于任何版本
  • androidx.core 库的最低版本:1.10.0
  • Matter 版本: 1.3.0.0
    • 注意:不支持临时 Matter 设备类型和集群。

已知问题

  • 切换已登录的 Google 账号可能会失败并导致错误。
    • 解决方法:重新运行权限流程或重启应用。
  • Google TV 设备可能不适用于使用 MediaPlayback trait 的自动化操作。
  • 在仅包含 Google 集线器的结构中:
    • Matter 设备在 Google Home 应用 (GHA) 中可能显示为离线。
    • Google 助理无法控制 Matter 设备。
    • 智能显示屏无法控制 Matter 设备或显示任何 Matter 设备的状态。
  • 对于某些设备,应用可能并不总是反映准确的状态,并且您的应用报告的状态可能与 Google 应用(例如 Google Home 应用 [GHA])报告的状态不同。这通常是因为设备未向 Google 报告状态。
    • 解决方法:使用 Google 应用检查状态即可解决不一致的问题。

修复的已知问题

  • 如果应用在该过程中被最小化,配置可能会失败。
  • 服务器端问题可能会导致 OkGoogle 启动器无法在自动化操作中运行。
  • 使用运行 Fuchsia 且结构中没有任何 Matter 设备的集线器时,如果集线器闲置超过 3 小时,则调试第一个 Matter 设备会导致该 Matter 设备离线。
  • 为集线器恢复出厂设置后,即使设备报告为在线,发送给新配置的设备的命令也可能会失败。