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