Home APIs iOS SDK 版本说明

2026-10-22

  Home API 正式版 1.11.1  

此版本修复了一些 bug，并提升了 Home API iOS SDK 的正式版质量。

最低版本

新功能

其他值得注意的变更

2026-09-23

  Home API 正式版 1.11  

此版本修复了一些 bug，并提升了 Home API iOS SDK 的正式版质量。

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本。不支持 Xcode 27。
  • 对于 Matter 调试：iOS 26.0+
  • Google Hub 固件、Cast、Nest WiFi Pro：3.78.548779
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.79.550760
  • Google Hub 固件，Fuchsia：31.20260429.103.8712702
  • Google Hub 固件、Google TV Streamer (4k)：UTTK.260317.003
  • iOS SDK：home_platform_ios_1.11
  • Google Home 应用：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

其他值得注意的变更

2026-09-16

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

新功能

2026-09-16

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

示例应用

2026-08-28

  Home API 正式版 1.10.1  

此版本修复了一些 bug，并提升了 Home API iOS SDK 的正式版质量。

最低版本

新功能

其他值得注意的变更

2026-08-07

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

示例应用

2026-07-30

  Home API 正式版 1.10  

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

最低版本

2026-07-09

Home.presentPermissionsUpdate() 方法已弃用。 应用现在应通过 Home 实例上的 permissions 属性与 UserScopedPermissionsController 进行交互。

即将发生的更改

2026-07-08

适用于 iOS 的边界路由器设备指南现已发布。

新内容

2026-07-07

Home API iOS 示例应用已针对 Home API 1.9.1 版本进行了更新。

示例应用

2026-06-26

  Home API 公开 Beta 版 1.9.1  

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

最低版本

新功能

修复的已知问题

  • 只有在使用 iOS 设备创建结构并与基于 Cast OS 的集线器（例如 Google Home、Google Nest Mini 或 Google Nest Audio 智能音箱）配对时，才支持调试。

2026-06-09

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

示例应用

2026-05-29

  Home API 公开 Beta 版 1.9  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 26.0+
  • Google Hub 固件、Cast、Nest WiFi Pro：3.78.518349
  • Google Hub 固件、Cast、所有其他基于 Cast 的 Hub：3.78.526062
  • Google hub 固件，Fuchsia：30.20260121.103.1602904
  • Google hub 固件、Google TV Streamer (4k)：UTTK.250729.004 (14748786)
  • iOS SDK：home_platform_ios_1.8.0_0
  • Google Home 应用：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

已知问题

  • 只有在使用 iOS 设备创建结构并与基于 Cast OS 的集线器（例如 Google Home、Google Nest Mini 或 Google Nest Audio 智能音箱）配对时，才支持调试。

2026-05-06

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

示例应用

2026-05-01

  Home API 公开 Beta 版 1.8.1  

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

最低版本

新功能

修复的已知问题

  • 当示例应用在后台和前台运行时，直播会中断。
  • 如果用户通过“我的账号”撤消权限，Google Home 应用可能会崩溃。解决方法是重启应用。
  • 飞利浦 BLE 灯未显示正确状态。

已知问题

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

2026-04-10

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

示例应用

2026-04-09

  Home API 公开 Beta 版 1.8  

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

最低版本

  • 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
  • iOS SDK：home_platform_ios_1.8.0_0
  • Google Home 应用：适用于任何版本
  • androidx.core 库：适用于任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

修复的已知问题

  • Nest Cam（室外用，有线版，第 2 代）可能无法调试。其图块保持灰显状态，系统会显示出错提示，并且无法控制摄像头。
  • 无法更改 Google Nest Learning Thermostat（第 4 代）v4 的温度单位（摄氏度/华氏度）。
  • 在移动版网页版 Google Home 中，顶部图标和返回按钮被标题遮挡。用户可能无法返回或看到关键界面元素。
  • 在同一控制器上切换用户后，GHA 设备模块会离线。在多用户家庭中，如果用户使用同一控制器，则可能会遇到设备离线的情况，直到应用重新启动。

已知问题

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

2026-03-13

  Home API 公开 Beta 版 1.7.1  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • 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.260120.001
  • iOS SDK：home_platform_ios_1.7.1
  • Google Home 应用最低版本：1.7.1
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

其他值得注意的变更

  • 简化的订阅意见征求流程。

示例应用

修复的已知问题

  • 历史记录过滤功能在初始加载时不会显示当天和设备的所有预期事件。解决方法：清除所有过滤条件，以便显示所有事件。
  • 对于 Nest Cam（室内用/室外用，电池版或有线版）和 Nest Doorbell（电池版，第 2 代），电池设置中没有“电池剩余时间”选项。

已知问题

  • Nest Cam（室外用，有线版，第 2 代）可能无法调试。其图块保持灰显状态，系统会显示出错提示，并且无法控制摄像头。
  • 无法更改 Google Nest Learning Thermostat（第 4 代）v4 的温度单位（摄氏度/华氏度）。
  • 在移动版网页版 Google Home 中，顶部图标和返回按钮被标题遮挡。用户可能无法返回或看到关键界面元素。
  • 在同一控制器上切换用户后，GHA 设备模块会离线。在多用户家庭中，如果用户使用同一控制器，则可能会遇到设备离线的情况，直到应用重新启动。
  • Matter 设备调试可能会失败。

2026-02-13

Home API iOS 示例应用已针对 Home API 1.7 版本进行了更新。

示例应用

2026-02-09

  Home API 公开 Beta 版 1.7  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • 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
  • iOS SDK：home_platform_ios_1.7.0
  • Google Home 应用最低版本：1.7
  • Matter 版本：1.4.1.0
  • Matter 版本：对 1.5.0 的实验性支持

新功能

其他值得注意的变更

修复的已知问题

  • History API 始终会返回 nextPageToken，从而导致无限循环。
  • “视频流已断开连接”错误可能会中断长时间的摄像头视频流会话。
  • 在执行 CommissionDeviceCommand 期间，Matter 设备调试失败。

已知问题

  • 历史记录过滤功能在初始加载时不会显示当天和设备的所有预期事件。解决方法：清除所有过滤条件，以便显示所有事件。
  • 对于 Nest Cam（室内用 / 室外用，电池版或有线版）和 Nest Doorbell（电池版，第 2 代），电池设置中没有“电池剩余时间”选项。
  • “当前摄像头设备软件版本”可能不会显示正确的软件版本。
  • 系统会忽略提示音时长设置。
  • 关闭 Nest Doorbell（电池版，第 2 代）摄像头会导致屏幕冻结。
  • Nest Cam IQ 摄像头设置应仅显示三个铃声主题，但实际显示的要多得多。
  • 即使设备实际上处于离线状态，飞利浦 BLE 灯也会错误地显示为“在线”。解决方法：不要仅依赖智能家居设备类型 (SHDT) 在线状态。而是应针对具有 LOCAL_SYNC 来源的设备使用目标设备状态服务 (TDSS) 映射。

2025-12-22

  Home API 公开 Beta 版 1.6  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • 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
  • iOS SDK：home_platform_ios_1.6.0
  • Google Home 应用最低版本：1.6
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • iOS 示例应用为摄像头和门铃添加了更多设置，默认使用 Swift Package Manager 集成 SDK。

修复的已知问题

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

2025-10-22

  Home API 公开 Beta 版 1.5.1  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • Google Hub 固件，Cast：3.76.495998
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.1.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

修复的已知问题

  • 使用示例应用时，直播会意外崩溃。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由云到云支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS 版 GHA 添加 Thread 边界路由器。

2025-09-26

  Home API 公开 Beta 版 1.5.0  

此版本引入了对摄像头设备的支持，包含问题修复，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • Google Hub 固件，Cast：3.76.495998
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.0.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • iOS 示例应用添加了对摄像头设备类型和 Hub 激活的支持。

修复的已知问题

  • 创建自动化操作时出错，并且未知设备类型错误地显示为可选选项。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由云到云支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS GHA 添加 Thread 边界路由器。

2025-08-28

  Home API 公开 Beta 版 1.4.1  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • Google Hub 固件，Cast：3.76.495998
  • Google Hub 固件，Fuchsia：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.4.1.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.1.0

新功能

其他值得注意的变更

  • iOS 示例应用添加了温控器控制功能。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS 版 GHA 添加 Thread 边界路由器。

2025-07-30

  Home API 公开 Beta 版 1.4.0  

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

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
  • 对于 Matter 调试：iOS 17.6+
  • Google Hub 固件、Cast：3.75.456944
  • Google Hub 固件，Fuchsia：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.4.0.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

其他值得注意的变更

  • iOS 示例应用不再支持删除仅支持 Matter 的设备。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS 版 GHA 添加 Thread 边界路由器。

2025-06-26

  Home API 公开 Beta 版 1.3.2  

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

最低版本

  • iOS：iOS 16.4 及更高版本、Xcode 15.3 及更高版本
  • Google Hub 固件，Cast：3.75.456944
  • Google Hub 固件，Fuchsia：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.3.2.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.0.0

新功能

修复的已知问题

  • 由云到云支持的温控器可能无法正常运行。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS GHA 添加 Thread 边界路由器。

2025-06-05

  Home API 公开 Beta 版 1.3.1  

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

最低版本

其他值得注意的变更

修复的已知问题

  • 在网络从本地切换到 Wi-Fi 或在应用之间切换时，iOS 版 GHA 可能会崩溃。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 由云到云支持的温控器可能无法正常运行。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 支持的风扇设备类型。
  • 使用 iOS Home API 调试 Matter-over-Thread 设备时出错。解决方法：在同一部手机上通过 iOS 版 GHA 添加 Thread 边界路由器。

2025-05-09

  Home API 公开 Beta 版 1.3  

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

最低版本

新功能

修复的已知问题

  • 在 iOS 版 Google Home 应用中授予权限时，“了解详情”和“返回”按钮可能无法响应。解决方法：长按“了解详情”链接，在系统浏览器中打开该链接，或点按左上角的关闭按钮退出视图。
  • 基本视频播放器可能无法在示例应用中运行。
  • 由云端到云端支持的窗帘设备类型可能无法控制。
  • 在 Google Home 应用打开时撤消权限会导致应用崩溃。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 由云到云支持的温控器可能无法正常运行。
  • 在示例应用中，可能无法控制由 Cloud-to-cloud 支持的风扇设备类型。
  • 在网络从本地切换到 Wi-Fi 或在应用之间切换时，iOS 版 GHA 可能会崩溃。

2025-04-09

  iOS Home API 公开 Beta 版发布  

在公开开发者 Beta 版期间，所有开发者都可以开始构建和测试其 iOS 应用。

此版本包含问题修复，并提升了 Home API iOS SDK 的正式版 (GA) 质量。

最低版本

  • 汇总到 connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS：iOS 16.4 及更高版本、Xcode 15.3 及更高版本
  • Google hub 固件最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.0_1.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本：1.4.0.0
    • 注意：不支持临时 Matter 设备类型和集群。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟时间可能会增加。
  • 在 iOS 版 Google Home 应用中授予权限时，了解详情和返回按钮可能没有响应。
    • 解决方法：长按了解详情链接，在系统浏览器中打开该链接，或点按左上角的关闭按钮退出视图。
  • 在 Google Home 应用打开时撤消权限会导致应用崩溃。
  • 基本视频播放器可能无法在示例应用中运行。
  • 由云到云支持的温控器可能无法正常运行。
  • 在示例应用中，可能无法控制由云端到云端支持的风扇设备类型。
  • 由云端到云端支持的窗帘设备类型可能无法控制。
  • 在网络从本地切换到 Wi-Fi 或在应用之间切换期间，iOS 版 GHA 可能会崩溃。

修复的已知问题

  • 不支持设备命名和重命名。
  • 对于配置，结构中的第一个 Matter 设备需要使用 iOS Google Home 应用进行配置。Home API 目前无法创建新结构，只能添加到 2023 年之前创建的结构的现有结构中。2023 年之后创建的结构不受此问题影响。