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。这仅限于LevelControltrait 命令中的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 设备可能不适用于使用
MediaPlaybacktrait 的自动化操作。 - 在仅包含 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 设备可能不适用于使用
MediaPlaybacktrait 的自动化操作。 - 在仅包含 Google 集线器的结构中：
- Matter 设备在 Google Home 应用 (GHA) 中可能显示为离线。
- Google 助理无法控制 Matter 设备。
- 智能显示屏无法控制 Matter 设备或显示任何 Matter 设备的状态。
- 对于某些设备，应用可能并不总是反映准确的状态，并且您的应用报告的状态可能与 Google 应用（例如 Google Home 应用 [GHA]）报告的状态不同。这通常是因为设备未向 Google 报告状态。
- 解决方法：使用 Google 应用检查状态即可解决不一致的问题。
修复的已知问题
- 如果应用在该过程中被最小化，配置可能会失败。
- 解决方法：在应用中使用 Commissioning API 时，使用
suppressHalfSheetNotification()API 抑制半页通知。
- 解决方法：在应用中使用 Commissioning API 时，使用
- 服务器端问题可能会导致 OkGoogle 启动器无法在自动化操作中运行。
- 使用运行 Fuchsia 且结构中没有任何 Matter 设备的集线器时，如果集线器闲置超过 3 小时，则调试第一个 Matter 设备会导致该 Matter 设备离线。
- 为集线器恢复出厂设置后，即使设备报告为在线，发送给新配置的设备的命令也可能会失败。