本文提供 QNRTC iOS SDK 4.x 以上版本的发布说明。

• 若您想要查看 3.x 版本之前的发布说明，可查看 3.x 及之前版本的更新日志
• 若您正在使用 3.x 或者更低版本的 SDK，想要升级至 5.x，则可参考 5.x 版本迁移指南。

• 注意：5.x 版本是基于 4.x 版本开发的重构版本，SDK 使用了统一的 C++ RTC 内核, 保证了 QRTC 在各个端上处理逻辑的一致性，同时接口和 4.x 基本兼容。若您使用的是 4.x 的版本，可根接口 5.x 版本迁移指南进行升级；若您使用的 3.x 及之前的版本，可参考各端的迁移指南，进行版本迁移。

• 支持麦克风启动开关及错误回调
• 支持更多外部音频格式导入
• 优化拥塞算法提高带宽利用率
• 优化 OC 代码线程使用安全
• 修复销毁 RTCClient 偶现奔溃的问题
• 修复混音 destroy track 偶现奔溃的问题
• 修复通话模式蓝牙断开再连接切换到媒体模式非预期的问题
• 修复订阅远端画面本地渲染不清晰的问题

• CustomAudioTrack 支持混音功能
• 新增加 AudioFilter 模块
• 支持软件回音消除
• 外部导入音频支持多种格式
• 支持语音激励
• 支持 pc 重连超时、mcu 获取超时时间
• 修复已知 crash 问题

• 支持信令 quic
• 支持 mcu 备用域名设置
• 支持软件编码
• 修复多个线上偶现 crash

• 支持设置房间重连超时时间
• 支持视频编码参数的预设配置接口
• 支持软件编码
• 支持视频降级默认值自动区分场景
• 支持本地及远端视频 stats 回调宽高信息
• 优化在弱网传输时的重传和接收 buffer 策略，降低卡顿率
• 优化平台层断线重连的反应时间
• 转推异常断开时回调新增错误码 QNRTCErrorLiveStreamingClosedError
• 修复订阅相同 Track 多次导致订阅失败的问题
• 修复销毁 Track 后再发布会 crash 的问题
• 修复取消发布后仍回调 stats 的问题
• 修复偶现远端离开房间本地 crash 的问题
• 修复日志文件 Tag 非法及 Size 过小的 crash 问题
• 修复连麦时订阅还未成功便立即取消订阅发生 crash 的问题

• 支持发布多音频 Track
• 支持音频场景化配置
• 支持日志文件上传
• 支持设置视频在弱网下的降级模式
• 支持切换摄像头结果回调
• 支持摄像头采集运行过程中发生错误回调
• 提升抗丢包抗抖动能力
• 优化本地渲染 CPU 占用
• 优化包体大小
• 修复加房间成功后立即离开概率性奔溃的问题
• 修复获取 remoteUserList 的音频 track 数组错误的问题
• 修复 iOS 16.4.1 推流画面模糊的问题
• 修复 iOS 13.x 上 Metal 本地预览黑屏的问题
• 修复 iOS 15.5 音频打断奔溃的问题

• 修复在重连失败再次加入房间后，离开房间会崩溃的问题
• 修复采集分辨率和编码分辨率不一致，导致画面被裁剪的问题
• 优化在 RTT 一定波动网络环境下视频卡顿的现象

• 支持动态修改本地视频 Track 的编码参数
• 修复本地 Track 的 mute 状态在重连过程中有可能失效的问题
• 修复使用在线资源进行混音时 seek 操作导致概率奔溃的问题
• 修复断线重连失败偶现奔溃的问题

• 支持推流固定分辨率
• 支持通话模式开关
• 支持音乐、音效通过 RTC 进行本地播放
• 支持外部音源 (PCM) 混音
• 优化弱网下视频质量调整策略，平衡清晰度和流畅性
• 修复不实现摄像头采集代理本地内置美颜不生效的问题
• 修复加房间 userData 传 NSNull 会奔溃的问题
• 修复 iOS 16 以上开启摄像头采集线程卡顿、回声消除失效的问题
• 修复稳定性崩溃问题

• 支持创建纯音频合流转推任务
• 去除合流转推对 isHoldLastFrame 的支持
• 缩小 FFmpeg 的包体大小，改为静态库由 QNRTCKit.framework 内部链路
• 修复远端音视频传输统计数据中 uplinkRTT 以及 uplinkLostRate 值错误的问题
• 修复本地质量等级变更回调 didNetworkQualityNotified 未触发的问题
• 修复跨房信息配置初始化方法 initWithToken 设置 token 无效的问题

• 新增多重混音功能，支持同时混音背景音乐和音效

• 发布 QNRTCKit.framework
• 发布 FFmpeg.framework
• 删除 HappyDNS.framework

• 升级 DNS 解析依赖库 HappyDNS 版本为 1.0

• 新增本地音频 track 获取音量接口
• 修复 iOS 15.4 视频帧率不稳定问题
• 修复配置跨房连麦信息后 crash 问题

• 新增远端音频获取音量接口

• 新增使用场景 QNClientMode 和用户角色 QNClientRole
• 新增跨房媒体转发功能

• 发布 QNRTCKit.framework v4.0.0
• 新增核心类 QNRTC 和 QNRTCClient，移除 QNRTCCEngine 接口类
• 新增 QNLocalTrack 和 QNRemoteTrack 及其衍生的子类，对不同类型的音视频轨道做了区分，并提供了丰富的控制接口
• 优化事件监听逻辑，提供更丰富更具体的事件监听