2026-05-01
Home API 公开 Beta 版 1.8.1此版本修复了多个 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:26.16.31
- Google Hub 固件、Cast、Nest WiFi Pro:3.78.518349
- Google 集线器固件、Cast、所有其他基于 Cast 的集线器:3.78.526062
- Google Hub 固件,Fuchsia:30.20260121.103.1602802
- Google 集线器固件,Google TV Streamer,4K:UTTK.250729.004
- Android SDK:home.android.sdk_GHP_1_8_1
- Google Home 应用:4.8 或更高版本
-
androidx.core库:适用于任何版本 - Matter 版本:1.4.1.0
- Matter 版本:实验性支持 1.5.0
新功能
- 温控器特征现在支持读取/更新、开启/关闭和计时器功能
修复的已知问题
- Matter 设备调试可能会失败。
- Philips 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此版本修复了多个 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:26.12.32
- Google Hub 固件、Cast、Nest WiFi Pro:3.78.518349
- Google 集线器固件、Cast、所有其他基于 Cast 的集线器:3.78.526062
- Google Hub 固件,Fuchsia:29.20251023.103.2101601
- Google 集线器固件,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
新功能
- Automations API 中的建议自动化操作。
- 支持 Device API 中的多部分设备。
- 在 Device API 中设置摄像头和门铃活动区域。
- 在 Device API 中设置摄像头和门铃的声音检测功能。
- 设备 API 中的摄像头和门铃录制模式(CVR/EVR/无历史记录)。
修复的已知问题
- 无法更改 Google Nest Learning Thermostat(第 4 代)的温度单位(摄氏度/华氏度)。
- 在网页版 Google Home 的移动版中,顶部图标和返回按钮会被标题遮挡。用户可能无法返回或看到关键界面元素。
- Android TV 中枢可能会错误地将 Matter 设备报告为“离线”。
已知问题
- Matter 设备调试可能会失败。
2026-03-13
Home API 公开 Beta 版版本 1.7.1此版本修复了多个 bug,并提升了 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 集线器固件,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
新功能
其他值得注意的变更
- 移除了无 Hub 模式。
示例应用
修复的已知问题
- 对于 Nest Cam(室内用/室外用,电池版或有线版)和 Nest Doorbell(电池版,第 2 代),电池设置中没有“剩余电池续航时间”选项。
- 系统会忽略铃声时长设置。
- 即使 Philips 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此版本修复了多个 bug,并提升了 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 集线器固件,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
新功能
- 本地自动化操作:现在,在 Automations API 中,某些自动化操作可能会在本地执行,具体取决于连接情况、设备类型和特征等条件。
- 在设备 API 中启用应用中的摄像头开箱体验 (OOBE)。
- 设备 API 中的摄像头和门铃铃声主题。
- 设备 API 中的摄像头和门铃自动省电模式。
- 设备 API 中的摄像头和门铃电池用量偏好设置。
- 设备 API 中的摄像头和门铃电池充电状态。
- 设备 API 中的摄像头和门铃电池电量。
- 设备 API 中的摄像头和门铃序列号。
- 设备 API 中的摄像头和门铃型号。
- 设备 API 中的摄像头和门铃软件版本。
- 设备 API 中的自定义键值 API。
- 借助权限查询,应用可以确定用户在 Permissions API 中授予了哪些设备类型的访问权限。
其他值得注意的变更
-
HomeException.unsupported已替换为HomeException.unimplemented,以与标准错误代码保持一致。 - 自定义特征的打包代码生成工具已针对版本 1.7 进行了更改。如果开发者有自定义特征,则在集成 1.7 SDK 后需要重新编译其特征。
修复的已知问题
-
History API 始终返回
nextPageToken,从而导致无限循环。 - 尝试登录新账号时出现“用户取消了权限流程”错误。
已知问题
- 对于 Nest Cam(室内用/室外用,电池版或有线版)和 Nest Doorbell(电池版,第 2 代),电池设置中没有“剩余电池续航时间”选项。
- 系统会忽略铃声时长设置。
-
即使 Philips BLE 灯实际上处于离线状态,也会错误地显示为“在线”。解决方法:不要仅依赖智能家居设备类型 (SHDT) 在线状态。对于具有
LOCAL_SYNC源的设备,请改用目标设备状态服务 (TDSS) 映射。
2025-12-22
Home API 公开 Beta 版版本 1.6此版本修复了多个 bug,并提升了 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 集线器固件,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
新功能
- 支持自动化 API 天气特征。在自动化操作启动方式和条件中添加了对天气特征的支持。
- 支持更多摄像头和门铃设备功能:新增了设置(夜视、状态 LED、取景器、方向、灵敏度、事件时长、响铃)。
- 应用发起的 Google 登录,可简化用户体验流程并消除主动用户检查。
- 无 Hub 模式可让用户在没有独立 Hub 的情况下完成某些 Matter 设备的初始配置并对其进行控制。
- 用于发现和激活 Hub 的 Hub 激活 API。
其他值得注意的变更
- Android 示例应用添加了相机设置、预定义自动化操作、风扇和扬声器支持。
已知问题
- 设备控件在长时间使用后停止工作。解决方法:重启 hub。
- Matter 设备调试可能会失败。
- 尝试在 Android 版示例应用中添加新账号时,系统显示“用户取消了权限流程”错误。解决方法:通过 Android 设备设置添加 Google 账号。
- 使用 Android Home API SDK 调试的 Walmart onn 有线安全摄像头无法通过 Google Home 应用进行实时直播。
- 在 Home API 应用中委托的摄像头无法通过 Google Home 应用启动直播会话。
2025-10-23
Home API 公开 Beta 版 1.5.1此版本修复了多个 bug,并提升了 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 启动 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
新功能
- 启动方式、条件和操作现在接受 Matter 结构作为 Automation API 中的参数。
- 向设备 API 添加了相机设备类型(直播、双向对讲、开始/停止录制)。
其他值得注意的变更
-
Android 示例应用添加了对相机、多管理员调试和预定义
OnOff自动化的支持。
修复的已知问题
- 当当前处于活跃状态的 Hub 被强制移除时,在 5 分钟的时间内,无法控制某些设备。5 分钟后,设备控制功能会恢复。
- 用户从预设或色温选择器中选择颜色后,扩展颜色灯无法更新颜色。
已知问题
- 从 Wi-Fi 切换到移动网络时,设备控制延迟可能会增加。
- 由云到云支持的风扇设备类型的控制可能无法在示例应用中正常运行。
2025-08-29
Home API 公开 Beta 版 1.4.1此版本修复了多个 bug,并提升了 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此版本修复了多个 bug,并提升了 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
新功能
- 在 Automation API 中,自动化可以限制为最多执行有限次数。
- 能够在设备 API 中以编程方式移除 Matter 设备。
-
移除了已弃用的
HomeDevice成员(trait()、isInRoom、isInStructure)。 -
Home.hasPermissions()现在同时包含 OAuth 结构访问和应用权限授予。
其他值得注意的变更
- Android 示例应用可删除仅支持 Matter 的设备、重命名设备、替换已弃用的 API 调用。
修复的已知问题
- 已返回底座的吸尘器设备不会注册“已返回底座”状态。
已知问题
- 在手机上退出登录并重新登录后,Home API 应用无法控制设备。解决方法:关闭应用并等待至少 10 秒。
2025-06-26
Home API 公开 Beta 版 1.3.2此版本修复了 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:25.23.31
- Google 中枢固件、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此版本修复了 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:25.19.32
- Google 集线器固件,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
新功能
-
引入了
SyntheticSwitchtrait,可简化对 Matter 开关设备生成的事件的处理,并允许开关触发自动化启动方式。 -
ExtendedDoorLock特征存在破坏性更改:user_id字段数据类型已从String更改为Long。使用此特征的应用需要重新编译。
其他值得注意的变更
- Android 示例应用添加了用于记录结构、设备、类型、特征和自动化操作状态的函数,以便更轻松地进行调试。
修复的已知问题
-
如果在 Google Home 应用中未设置住宅位置,则在创建自动化操作时,Google Home 应用会因出现
FailedPreconditionException而崩溃。 -
在 Android 示例应用中,具有
connectivityStatePARTIALLY_ONLINE的设备之前显示为离线。此状态现在表示为“在线”。
已知问题
- 在 Android 示例应用中,“创建自动化操作”按钮有时需要多次点按才能触发。
2025-05-12
Home API 公开 Beta 版版本 1.3此版本修复了 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:25.16.33
- Google 集线器固件,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
新功能
-
在 Automation API 中添加了对周期性预定事件启动方式的支持,使开发者能够使用
cron表达式创建基于时钟时间、太阳时间和日历条件的周期性运行的自动化操作。 - 在 Device API 中添加了重命名设备的功能。
- 在 Structure API 中添加了重命名房间的功能。
修复的已知问题
- 从 Wi-Fi 切换到移动网络时,设备控制延迟可能会增加。
- 中枢恢复出厂设置后,设备可能会显示为离线。
已知问题
2025-04-09
Home API 公开 Beta 版版本 1.2.1此版本修复了 bug,并提升了 Home API Android SDK 的 Beta 版质量。
最低版本
- Google Play 服务:25.09.33
- Google 集线器的最低固件版本:
- 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
新功能
- 提升了从 Home Graph 加载对象时的性能。
- Automation API
- 新增了对 实体过滤器的支持,该过滤器可让自动化操作根据自动化操作中指定的条件动态选择设备。
- Device API
BasicInformationTrait中现已提供云到云设备信息。
已知问题
- 从 Wi-Fi 切换到移动网络时,设备控制延迟可能会增加。
- 中枢恢复出厂设置后,设备可能会显示为离线。
修复的已知问题
- 如果在初始化之前或初始化完成之前调用 Discovery API,系统会抛出
HomeException,其中包含code 14: UNKNOWN和消息“No route found.”。 - 在包含多个结构和多个用户的环境中,切换结构和用户可能会导致未返回任何设备。
2025-03-14
Home API 公开 Beta 版发布版本 1.2.0此版本修复了 bug,并提升了 Home API 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 设备类型和集群。
新功能
- Automation API:
- 支持在自动化条件中使用日期范围和部分日期。请参阅使用包含 between 的日期。
- 在之前的版本中,Discovery API 本应针对某些位图字段返回
BitmapConstraint,但却返回了NumberSetConstraint。这些字段现在会按预期返回BitmapConstraint。这仅限于LevelControl特征命令中的optionsMask和optionsOverride位图。
已知问题
- 从 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此版本修复了 bug,并提升了 Home API 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:
- 提供事件流,用于通知已添加、更改和移除的结构、房间和设备。
- 请参阅订阅实体关系事件。
- 批处理 API(实验性):
- 允许开发者以批处理方式发送多个命令,这些命令会同时执行。
- 请参阅一次发送多条命令。
已知问题
- 在加载、创建和修改自动化操作时,用户可能需要等待很长时间。
- 从“相机”应用启动设置流程的用户需要扫描两次二维码才能完成 Matter 调试。
- 在包含 200 部以上设备的结构中,Discovery API 可能只会返回无候选设备。
修复的已知问题
- 切换已登录的 Google 账号可能会失败并导致错误。
- Google TV 设备可能无法用于使用
MediaPlayback特征的自动化操作。 - 在仅包含 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 的 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 集线器的结构中:
- Matter 设备在 Google Home 应用 (GHA) 中可能显示为离线。
- Google 助理无法控制 Matter 设备。
- 智能显示屏无法控制 Matter 设备,也无法显示任何 Matter 设备的状态。
- 对于某些设备,应用可能无法始终反映准确的状态,并且您的应用报告的状态可能与 Google 应用(例如 Google Home 应用 [GHA])报告的状态不同。这通常是因为设备未向 Google 报告状态。
- 解决方法:使用 Google 应用检查状态可解决不一致问题。
修复的已知问题
- 如果在调试过程中将应用最小化,调试可能会失败。
- 解决方法:在应用中使用 Commissioning API 时,使用
suppressHalfSheetNotification()API 来禁止显示半屏通知。
- 解决方法:在应用中使用 Commissioning API 时,使用
- 服务器端问题可能会导致“Ok Google”启动器无法在自动化操作中正常运行。
- 使用运行 Fuchsia 且结构中没有任何 Matter 设备的 hub 时,如果 hub 处于空闲状态超过 3 小时,调试第一个 Matter 设备会导致该 Matter 设备处于离线状态。
- 在对中枢执行恢复出厂设置后,即使设备报告为在线,向新调试的设备发送的命令也可能会失败。