Home API Android SDK 版本说明

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 固件最低版本：
    • 投屏版本：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 账号可能会失败并导致错误。
    • 解决方法：重新运行权限流程或重启应用。
  • 使用 MediaPlayback trait 的自动化操作可能无法在 Google TV 设备上运行。
  • 在仅包含 Google 集线器的结构中：
    • Matter 设备在 Google Home 应用 (GHA) 中可能显示为离线状态。
    • Google 助理无法控制 Matter 设备。
    • 智能显示屏无法控制 Matter 设备或显示任何 Matter 设备的状态。
  • 对于某些设备，应用可能并不总是反映准确的状态，并且您的应用报告的状态可能与 Google 应用（例如 Google Home 应用 [GHA]）报告的状态不同。这通常是因为设备未向 Google 报告状态。
    • 解决方法：使用 Google 应用查看状态即可解决不一致的问题。

修复的已知问题

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