发版说明

  • iOS

更新时间

查看实时互动 RTC 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

注意

通过 CocoaPods 集成 iOS SDK 时,需要在 Podfile 顶部配置声网 CocoaPods CDN 源。具体配置方式请参考下载 SDK。

已知问题和局限性

AirPods Pro 蓝牙连接问题

由于 AirPods Pro 不支持在通话音量模式下使用 A2DP 协议,可能会导致该设备在该模式下无法成功连接。

该版本于 2026 年 9 月 22 日发布。

新增特性

声网高级美颜 2.1

该版本支持声网高级美颜 2.1 API,并新增美颜人脸检测能力。使用声网高级美颜功能的客户可以检测人脸置信度。使用 RTC SDK v4.7.0 及以上版本集成声网高级美颜时,请参考实现声网高级美颜;如果仍使用 RTC SDK v4.6.x,请继续参考声网高级美颜 2.0 文档。

改进

音视频链路性能优化

该版本针对音视频链路与线程调度机制做了专项优化,显著降低各音视频场景 CPU 消耗,同步提升长时间运行稳定性。

音频 SDK FFmpeg 插件集成优化

该版本调整了音频 SDK 中 FFmpeg player 插件的加载方式。Agoraffmpeg.xcframework 已调整为可选插件 AgoraffmpegExtension.xcframework。SDK 包中默认包含该插件,你可以根据业务需要选择是否集成。未加载 FFmpeg player 插件时,MediaPlayer 使用系统原生播放能力,实际支持的音频文件格式取决于系统支持的容器格式和音频编解码器;集成并加载 FFmpeg player 插件后,MediaPlayer 可支持更多音频格式和播放能力。

视频首帧体验优化

该版本优化了视频帧传输调度机制,提升了频道内首个用户订阅流的出图速度。

1v1 连麦延时体验优化

该版本优化了视频1v1等实时互动场景下的音视频策略,在保障画质的前提下改善端到端延迟,并提升突发抖动等弱网场景下的播放流畅性。

音频场景码率优化

该版本优化了音频场景下的码率开销,保障音质的前提下提升了音频流传输效率。

视频方向处理优化

该版本改进了横竖屏切换过程中的视频方向处理,降低设备旋转后视频 UI 旋转延迟或异常的概率。

后台摄像头采集与重新开播体验优化

该版本改进了 App 进入后台后的摄像头采集状态处理,解决主播重新开播时本地或远端画面偶现黑屏的问题。

Native 与 Web 互通弱网体验优化

该版本优化了视频 1v1 弱网场景下 Native 与 Web 互通的音视频体验。

问题修复

该版本修复了以下问题:

  • 修复了 iOS 26 上触发系统键盘语音转文字后,播放端低概率无声的问题。
  • 修复了使用蓝牙音频设备上麦后,音频路由异常切换或远端音频无声的问题。
  • 修复了聊天室上下麦场景中,先关闭本地音频、切换观众/主播角色后再开启本地音频时导致的低概率远端无声的问题。
  • 修复了 AI QoS 配置下,通话刚开始时偶现首句音频丢字或异常的问题。
  • 修复了音视频互动、屏幕共享、视频帧数据访问和音视频统计等场景下偶现 App 崩溃的问题,提升了 SDK 稳定性。