Home API Android SDK 版本说明

2026-10-22

  Home API 正式版 1.11.1  

此版本修复了多个 bug，并提升了 Home API Android SDK 的正式版质量。

最低版本

新功能

其他值得注意的变更

已知问题

  • 摄像头重启后，其连接状态可能会报告为 PARTIAL_ONLINE，而不是 ONLINE。除了 Matter 停用功能外，所有云摄像头功能都会继续正常运行。

2026-09-23

  Home API 正式版 1.11  

此版本修复了多个 bug，并提升了 Home API Android SDK 的正式版质量。

最低版本

重要更新

新功能

其他值得注意的变更

2026-09-16

我们推出了两个新的 MCP 服务器。Home MCP 可让个人智能体安全地与智能家居互动，而 Home Developer MCP 则可让 Home 开发者中心和其他智能家居资源中的文档可供您喜爱的智能体搜索和查询。

新功能

2026-09-16

Home API Android 示例应用已更新，以支持 Home API 1.10.1 版本。

示例应用

2026-08-28

  Home API 正式版 1.10.1  

此版本修复了多个 bug，并提升了 Home API Android SDK 的正式版质量。

最低版本

重要更新

新功能

其他值得注意的变更

2026-08-07

Home API Android 示例应用已更新，以支持 Home API 1.10 版本。

示例应用

2026-08-03

  Home API 正式版 1.10  

此版本修复了一些问题，并将 Home API Android SDK 升级到了正式版。

最低版本

2026-07-09

forceLaunch 标志已弃用。应用应迁移到 ForcePermissionFlow 枚举，以指定意见征求界面行为。

即将发生的更改

2026-07-08

Android 边界路由器设备指南现已发布。

新内容

2026-07-07

Home API Android 示例应用已更新，以支持 Home API 1.9.1 版本。

示例应用

2026-06-26

  Home API 公开 Beta 版 1.9.1  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

新功能

修复的已知问题

  • Google Nest Cam（室外用，有线版，第 2 代）、Google Nest Cam（室内用，有线版 - 第 3 代）和 Doorbell（有线版 - 第 3 代）设备型号不支持快速配对调试。

2026-06-09

Home API Android 示例应用已更新，以支持 Home API 1.9.0 版本。

示例应用

2026-05-29

  Home API 公开 Beta 版 1.9  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

新功能

已知问题

  • Google Nest Cam（室外用，有线版，第 2 代）、Google Nest Cam（室内用，有线版 - 第 3 代）和 Doorbell（有线版 - 第 3 代）设备型号不支持快速配对调试。

2026-05-26

Home API Android 示例应用已更新，以支持 Home API 1.8.1 版本。

示例应用

2026-05-01

  Home API 公开 Beta 版 1.8.1  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

新功能

  • 温控器特性现在支持读取/更新、开启/关闭和定时器功能

修复的已知问题

  • Matter 设备调试可能会失败。
  • 飞利浦 BLE 灯未显示正确状态。
  • 延迟导致网络不稳定和响应时间缓慢。

已知问题

  • 无法使用 Google TV Streamer (4K) 调试某些设备。
  • 如果 hub 是 Nest Wifi Pro、Google Nest Hub 或 Google Nest Hub Max，Google Home 应用会将多部分设备显示为多个图块。

2026-04-10

Home API Android 示例应用已更新，以支持 Home API 1.8 版本。

示例应用

2026-04-09

  Home API 公开 Beta 版 1.8  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：26.12.32
  • Google Hub 固件、Cast、Nest WiFi Pro：3.78.518349
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.78.526062
  • Google Hub 固件、Fuchsia：29.20251023.103.2101601
  • Google hub 固件、Google TV Streamer、4K：UTTK.250729.004
  • Android SDK：home.android.sdk_GHP_1_8_0
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

修复的已知问题

  • 无法更改 Google Nest Learning Thermostat（第 4 代）的温度单位（摄氏度/华氏度）。
  • 在移动版网页版 Google Home 中，顶部图标和返回按钮被标题遮挡。用户可能无法返回或看到关键界面元素。
  • Android TV Hub 可能会错误地将 Matter 设备报告为“离线”。

已知问题

  • Matter 设备调试可能会失败。

2026-03-13

  Home API 公开 Beta 版 1.7.1  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：
  • Google Hub 固件、Cast、Nest WiFi Pro：3.78.518349
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.78.516526
  • Google Hub 固件，Fuchsia：29.20251023.103.2201
  • Google hub 固件、Google TV Streamer、4K：UTTK.250729.004
  • Android SDK：home.android.sdk_GHP_1_7_1
  • Google Home 应用：1.7.1
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

其他值得注意的变更

  • 无中心模式已被移除。

示例应用

修复的已知问题

  • 对于 Nest Cam 室内/室外（电池版或有线版）和 Nest Doorbell（电池版，第 2 代），电池设置中没有“电池剩余时间”选项。
  • 系统会忽略提示音时长设置。
  • 即使设备实际上处于离线状态，飞利浦 BLE 灯也会错误地显示为“在线”。

已知问题

  • 无法更改 Google Nest Learning Thermostat（第 4 代）的温度单位（摄氏度/华氏度）。
  • 网络稳定性和设备响应能力可能会出现延迟。
  • 在移动版网页版 Google Home 中，顶部图标和返回按钮被标题遮挡。用户可能无法返回或看到关键界面元素。
  • 在联合模式 OOBE 之后，Hub 可能会卡在“正在连接…”状态。
  • Matter 设备调试可能会失败。
  • Android TV 集线器可能会错误地将 Matter 设备报告为离线。
  • “当前摄像头设备软件版本”可能不会显示正确的软件版本。
  • 温控器界面滑块显示超出范围的温度。
  • 设置提示音时长后，设备在指定时长内不会发出提示音。

2026-02-13

Home API Android 示例应用已更新，以支持 Home API 1.7 版本。

示例应用

2026-02-09

  Home API 公开 Beta 版 1.7  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：26.02.34
  • Google Hub 固件、Cast、Nest WiFi Pro：3.76.508025
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.77.510748
  • Google hub 固件，Fuchsia：29.20251023.103.2100
  • Google hub 固件、Google TV Streamer、4K：UTTK.250729.004
  • Android SDK：home.android.sdk_GHP_1_7
  • Google Home 应用：1.7
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

其他值得注意的变更

修复的已知问题

  • History API 始终会返回 nextPageToken，从而导致无限循环。
  • 尝试登录新账号时，系统显示“用户取消了权限流程”错误。

已知问题

  • 对于 Nest Cam 室内/室外（电池版或有线版）和 Nest Doorbell（电池版，第 2 代），电池设置中没有“电池剩余时间”选项。
  • 系统会忽略提示音时长设置。
  • 即使设备实际上处于离线状态，飞利浦 BLE 灯也会错误地显示为“在线”。解决方法：不要仅依赖智能家居设备类型 (SHDT) 在线状态。而是针对具有 LOCAL_SYNC 来源的设备使用目标设备状态服务 (TDSS) 映射。

2025-12-22

  Home API 公开 Beta 版 1.6  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.47.30
  • Google Hub 固件、Cast、Nest WiFi Pro：3.75.479819
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.77.505721
  • Google hub 固件、Fuchsia：28.20250723.103.2100300
  • Google hub 固件、Google TV Streamer、4K：UTTK.250729.004
  • Android SDK：home.android.sdk_GHP_1_6
  • Google Home 应用：1.6
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • Android 示例应用添加了摄像头设置、预定义自动化操作、风扇和音箱支持。

已知问题

  • 设备控件在长时间使用后停止运行。解决方法：重启 hub。
  • Matter 设备调试可能会失败。
  • 在 Android 版示例应用中尝试添加新账号时，系统显示“用户取消了权限流程”错误。解决方法：通过 Android 设备设置添加 Google 账号。
  • 使用 Android Home APIs SDK 调试的 Walmart onn 有线监控摄像头无法通过 Google Home 应用直播。
  • 在 Home APIs 应用中调试的摄像头无法从 Google Home 应用启动直播会话。

2025-10-23

  Home API 公开 Beta 版 1.5.1  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.41.30
  • Google Hub 固件、Cast：3.76.495998
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5_1
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • Android 示例应用添加了对门铃设备类型的支持（开关、直播、双向对讲）和 Hub Activation API 实现。

修复的已知问题

  • 示例应用未在设备视图中正确显示设备状态。

2025-09-26

  Home API 公开 Beta 版 1.5.0  

此版本引入了对摄像头设备的支持，修复了一些 bug，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.37.31
  • Google Hub 固件、Cast：3.76.492738
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • Android 示例应用添加了对相机、多管理员调试、预定义 OnOff 自动化操作的支持。

修复的已知问题

  • 强制移除当前活跃的 Hub 后，会有 5 分钟的时间无法控制某些设备。5 分钟后，设备控制功能会恢复。
  • 用户从预设或色温选择器中选择颜色后，扩展颜色灯无法更新颜色。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 提供支持的风扇设备类型。

2025-08-29

  Home API 公开 Beta 版 1.4.1  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.33.32
  • Google Hub 固件、Cast：3.76.495998
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_4_1
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

修复的已知问题

  • 当用户尝试将温控器设置为不支持的模式时，Android 示例应用会崩溃。

已知问题

  • 强制移除当前活跃的 Hub 后，会有 5 分钟的时间无法控制某些设备。5 分钟后，设备控制功能会恢复。

2025-07-31

  Home API 公开 Beta 版 1.4.0  

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.28.34
  • Google Hub 固件，Cast：3.76.486931
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_4_0
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

其他值得注意的变更

  • Android 示例应用会删除仅支持 Matter 的设备、重命名设备，并替换已废弃的 API 调用。

修复的已知问题

  • 已停靠的吸尘器设备不会注册“已停靠”状态。

已知问题

  • 在手机上退出登录并重新登录后，Home API 应用无法控制设备。解决方法：关闭应用并等待至少 10 秒。

2025-06-26

  Home API 公开 Beta 版 1.3.2  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.23.31
  • Google Hub 固件、Cast、Google Home、Google Home Mini 和 Google Nest Mini：3.75.468362
  • Google Hub 固件、Cast、Google Nest Audio：3.75.476451
  • Google Hub 固件、Fuchsia：26.20250116.103.2900
  • Android SDK：home.android.sdk_1_3_2
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

  • SDK 工件已分为两个单独的工件：Home API SDK 框架 (play-services-home-17.0.0.aar) 以及 SDK 特征和设备类型 (play-services-home-types-17.0.0.aar)。从该版本开始，开发者需要在项目的编译时和运行时库路径中包含这两个工件。

其他值得注意的变更

  • Android 示例应用添加了以下功能：用户可以断开连接并撤消应用的权限。
  • Android 示例应用新增：更新了 SDK 工件，以包含 play-services-home-17.0.0 和 play-services-home-types-17.0.0。

已知问题

  • 已停靠的吸尘器设备不会注册“已停靠”状态。

2025-06-05

  Home API 公开 Beta 版 1.3.1  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.19.32
  • Google Hub 固件，Cast：3.75.468222
  • Google hub 固件、Fuchsia：26.20250116.103.2201
  • Android SDK：home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

其他值得注意的变更

  • Android 示例应用添加了用于记录结构体、设备、类型、trait 和自动化操作状态的功能，以便更轻松地进行调试。

修复的已知问题

已知问题

  • 在 Android 示例应用中，“创建自动化操作”按钮有时需要点按多次才能触发。

2025-05-12

  Home API 公开 Beta 版 1.3  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.16.33
  • Google Hub 固件，Cast：3.75.468222
  • Google hub 固件、Fuchsia：26.20250116.103.2201
  • Android SDK：home.android.sdk_202504_EAP_1_3_RC00
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

修复的已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 集线器恢复出厂设置后，设备可能会显示为离线。

已知问题

2025-04-09

  Home API 公开 Beta 版 1.2.1  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

  • Google Play 服务：25.09.33
  • Google Hub 固件最低版本：
    • Cast：3.75.468222
    • Fuchsia：24.20241009.103.19006011
  • Android SDK：home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home 应用：适用于任何版本
  • androidx.core 库：1.10.0
  • Matter 版本：1.4.0.0
1. 此 build 目前正在向正式版渠道发布，并将于 2025 年 4 月 22 日之前面向所有设备提供。

新功能

  • 提升了从 Home Graph 加载对象时的性能。
  • Automation API
    • 添加了对 实体过滤器的支持，使自动化操作能够根据自动化操作中指定的条件动态选择设备。
  • Device API

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在集线器恢复出厂设置后，设备可能会显示为离线。

修复的已知问题

  • 如果在初始化之前或初始化完成之前调用 Discovery API，系统会抛出 HomeException，其中包含 code 14: UNKNOWN 和消息“No route found.”。
  • 在包含多个结构和多用户的环境中，在结构和用户之间切换可能会导致不返回任何设备。

2025-03-14

  Home API 公开 Beta 版 1.2.0  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

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

新功能

已知问题

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

修复的已知问题

  • Home API 应用在启动后首次调用 HomeManager.structures() 时，即使存在一个或多个结构，它也会收到零个结构。这会让人误以为没有与该 Google 账号关联的结构。
  • 在加载、创建和修改自动化操作时，用户可能会遇到较长的等待时间。
  • 从“相机”应用启动设置流程的用户必须扫描二维码两次，才能完成 Matter 调试。
  • 在包含超过 200 台设备的结构中，Discovery API 可能不会返回任何候选设备。

2025-01-29

  Home API 公开 Beta 版 1.1.0  

此版本包含问题修复，并提升了 Home APIs Android SDK 的 Beta 版质量。

最低版本

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

新功能

  • Streaming API：
    • 提供事件流，用于通知已添加、更改和移除的结构体、房间和设备。
    • 请参阅订阅实体关系事件。
  • Batching API（实验性）：

已知问题

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

修复的已知问题

  • 切换已登录的 Google 账号可能会失败并导致错误。
  • Google TV 设备可能不适用于使用 MediaPlayback 特性的自动化操作。
  • 在仅包含 Google Hub 的结构中：
    • 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 版期间，所有开发者都可以开始构建和测试其应用。

此版本包含问题修复，并提升了 Home API Android SDK 的 Beta 版质量，包括改进了对 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 特性的自动化操作。
  • 在仅包含 Google Hub 的结构中：
    • Matter 设备可能会在 Google Home 应用 (GHA) 中显示为离线状态。
    • Google 助理无法控制 Matter 设备。
    • 智能显示屏无法控制 Matter 设备，也无法显示任何 Matter 设备的状态。
  • 对于某些设备，应用可能并不总是反映准确的状态，并且您的应用报告的状态可能与 Google 应用（例如 Google Home 应用 [GHA]）报告的状态不同。这通常是因为设备未向 Google 报告状态。
    • 解决方法：使用 Google 应用检查状态可解决不匹配问题。

修复的已知问题

  • 如果在配置过程中将应用最小化，配置可能会失败。
  • 服务器端问题可能会导致“Ok Google”启动方式无法在自动化操作中正常运行。
  • 如果使用运行 Fuchsia 的 hub，且结构中没有任何 Matter 设备，那么当 hub 闲置超过 3 小时后，调试第一个 Matter 设备会导致该 Matter 设备处于离线状态。
  • 对集线器执行恢复出厂设置后，向新调试的设备发出的命令可能会失败，即使设备报告为在线也是如此。