Home API Android SDK 版本说明

bookmark_border 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

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 设备类型和集群。

新功能

• Automation API：
  • 支持在自动化操作条件中使用日期范围和部分日期。 请参阅使用包含“between”的日期。
  • 在之前的版本中，Discovery API 会针对某些位图字段返回 NumberSetConstraint，而实际上应返回 BitmapConstraint。这些字段现在会按预期返回 BitmapConstraint。这仅限于 LevelControl trait 命令中的 optionsMask 和 optionsOverride 位图。

已知问题

• 从 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 应用检查状态即可解决不一致的问题。

修复的已知问题

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