Home APIs iOS SDK 版本说明

2025-12-22

  Home API 公开 Beta 版版本 1.6  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
    • 对于 Matter 调试：iOS 17.6 及更高版本
  • Google 集线器的最低固件版本：
    • Cast：
      • Nest WiFi Pro：3.75.479819
      • 所有其他基于 Cast 的 hub：3.77.505721
    • Fuchsia：28.20250723.103.2100300
    • Google TV Streamer（4K）：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.6.0
  • Google Home 应用最低版本：1.6
  • Matter 版本： 1.4.1.0

新功能

  • Automation API
    • 新增了对 实体过滤条件的支持，可让自动化操作根据自动化操作中指定的条件动态选择设备。
    • 在自动化操作启动方式和条件中添加了对天气特征的支持。请参阅基于天气情况的启动器。
  • Device API
    • 支持更多摄像头和门铃设备功能
      • 新设置：
        • 夜视模式开启/关闭。
        • 状态 LED 亮度。
        • 相机视口。
        • 图片方向。
        • 唤醒灵敏度。
        • 事件录制时长上限。
        • 提示音。

        如需了解详情，请参阅 iOS 相机设备指南。

  • Structure API
  • iOS 示例应用
    • 支持更多设置
      • 摄像头：
        • 麦克风开/关。
        • 录音功能开启/关闭。
        • 图片方向。
        • 夜视模式开启/关闭。
        • 摄像头扬声器音量。
        • 状态 LED 亮度。
      • 门铃：
        • 麦克风开/关。
        • 录音功能开启/关闭。
        • 图片方向。
        • 夜视模式开启/关闭。
        • 摄像头扬声器音量。
        • 状态 LED 亮度。
        • 提示音。
    • 默认使用 Swift Package Manager 集成 SDK。

修复的已知问题

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

2025-10-22

  Home API 公开 Beta 版 1.5.1  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

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

新功能

  • Structure API
    • 借助 Hub 激活 API，您可以程序化地发现和激活 Google Home Hub。请参阅 iOS 上的 Hub 激活 API。

已知问题

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

修复的已知问题

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

2025-09-26

  Home API 公开 Beta 版 1.5.0  

此版本引入了对相机设备的支持，包含 bug 修复，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

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

新功能

  • Device API
    • 添加了 相机设备类型。以下摄像头功能也适用于门铃：
      • 摄像头实时画面
      • 摄像头双向对讲
      • 相机开始和停止录制
  • iOS 示例应用
    • 支持相机设备类型：
      • 摄像头实时画面。
      • 摄像头双向对讲。
      • 相机开始和停止录制。
      • 受限的设备类型权限。
    • 支持 Hub 激活。

已知问题

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

修复的已知问题

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

2025-08-28

  Home API 公开 Beta 版版本 1.4.1  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • iOS：iOS 17.0 及更高版本、Xcode 15.3 及更高版本
    • 对于 Matter 调试：iOS 17.6 及更高版本
  • Google Hub 固件最低版本：
    • Cast 版本：3.76.495998
    • 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  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

新功能

  • Device API
    • 以编程方式移除 Matter 设备的功能。请参阅移除设备。

iOS 示例应用

  • 删除仅支持 Matter 的设备。

已知问题

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

2025-07-08

借助 Cast 固件版本 3.76.479819，Nest WiFi Pro 现在可以充当 Home API 中枢。

2025-06-26

  Home API 公开 Beta 版版本 1.3.2  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • iOS：iOS 16.4 及更高版本、Xcode 15.3 及更高版本
  • Google Hub 固件最低版本：
    • Cast 版本：3.75.456944
    • 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  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • 汇总到 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.3.0.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本： 1.4.0.0

新功能

已知问题

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

修复的已知问题

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

2025-05-09

  Home API 公开 Beta 版版本 1.3  

此版本修复了 bug，并提升了 Home API iOS SDK 的 Beta 版质量。

最低版本

  • 汇总到 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.3.0.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本： 1.4.0.0

新功能

  • Device API
  • Structure API
    • 支持更改 Room 名称

已知问题

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

修复的已知问题

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

2025-04-09

  iOS Home API 公开 Beta 版发布  

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

此版本修复了多项 bug，并提升了 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 应用处于打开状态时撤消权限会导致该应用崩溃。
  • 基本视频播放器可能无法在示例应用中正常运行。
  • 基于云到云的温控器可能无法正常工作。
  • 在示例应用中，对 Cloud-to-Cloud 支持的风扇设备类型的控制可能无法正常运行。
  • 由云到云支持的窗帘设备类型的控制可能无法正常运行。
  • 在网络从本地更改为 Wi-Fi 或在应用之间切换时，GHA 的 iOS 版本可能会崩溃。

修复的已知问题

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