本文介绍 NERTC SDK iOS 端 V5.X 版本的更新日志。

近期重要更新

• V5.4.0开始，支持空间音效和范围语音 , 空间音效让听众可以感受到声音来自于特定的位置和空间环境，可以增强音频的真实感和沉浸感，让听众感受到更加真实的声音效果。
• V5.3.1开始，支持通过插件化集成人脸增强、视频超分、视频降噪功能，提升 SDK 集成的灵活性与易操作性，减小 App 的包体积，具体请参见集成 SDK。

---

[5.5.2] - 2023-10-07

改进优化

• 优化信令连接，提高在 UDP 不通情况下的入会速度和成功率。
• 优化信令数据，提高入会速度。

[5.5.0] - 2023-08-29

改进优化

• 优化 SDK 的包体积大小

• 优化 SDK 的首帧耗时

• 优化 ne264 编码器，提升弱网场景的视频体验

• 优化视频 pipeline，提升中低端手机的视频流畅度

• 虚拟背景功能适配更多机型

• 视频水印功能支持所有设备和平台

• 虚拟背景和视频水印功能启用硬件分级策略

• 针对低性能设备，提供更加稳定的音频质量

• 在 Music 场景，声音外放时，优化回声消除效果

• 针对噪声和回声处的音量放大做适当控制

• 支持华为 AudioKit

[5.4.8] - 2023-08-29

问题修复

修复部分已知问题。

[5.4.7] - 2023-08-09

问题修复

修复部分已知问题。

[5.4.3] - 2023-07-27

改进优化

音频 opus 编码器支持 24kHz 采样率。

问题修复

修复部分已知问题。

[5.4.1] - 2023-07-18

新增特性

支持 iPad 分屏旋转。

新增API

接口/回调	接口/回调说明
onNERtcEngineRemoteVideoSizeDidChangedWithUserID	远端视频分辨率变化的回调。
onNERtcEngineLocalVideoRenderSizeChanged	本地视频预览分辨率变化的回调。

问题修复

修复部分已知问题。

[5.4.0] - 2023-07-04

新增特性

序号	新增特性	特性描述	相关文档
1	空间音效	空间音效也称 3D 音效，是通过在音频信号中添加空间信息，使得听众可以感受到声音来自于特定的位置和空间环境。它可以增强音频的真实感和沉浸感，让听众感受到更加真实的声音效果。	空间音效

新增API

接口/回调	接口/回调说明
enableSpatializer	开启/关闭空间音效。
updateSpatializerAudioRecvRange	设置空间音效的距离衰减属性和语音范围。
setSpatializerRoomProperty	设置房间混响属性。
enableSpatializerRoomEffects	开启或关闭空间音效的房间混响效果。
updateSpatializerSelfPosition	设置说话者和接收者的位置信息。
setSpatializerRenderMode	设置渲染模式。

改进优化

• AI 降噪能力优化。

  提升了人声音质和降噪量，有效地抑制各种噪声而不会损伤人声。在教育和会议场景中，它针对人声（如小孩声和笑声）做了保护，避免这些声音被过度抑制。

• 优化 AEC 算法，重点改进本端和远端双讲时的效果。

  可在双讲场景下保存清晰、流畅的近端人声，为用户在会议、语聊等场景下提供更舒适的通话体验。

• 通过优化音频 NACK 请求，降低音频在弱网环境下的端到端延时。

• 在弱网环境下优化首帧耗时。

• 改善极端弱网环境下的视频清晰度。

• 优化包大小。

  V5.4.0 版本开始，默认支持 vp8 编解码能力，不再支持 vp9 编解码能力，在保障客户端与 Web 端互通能力的同时，减小包体大小。

• 优化 NE264 编码器。

• 提升低端手机的发送帧率。

  改善了低端机上前处理的帧率，及性能受限情况下的编码稳定性，低端机上可提升视频发送帧率。

[5.3.11] - 2023-08-16

问题修复

修复部分已知问题。

[5.3.8] - 2023-07-21

问题修复

修复部分已知问题。

[5.3.7] - 2023-06-16

问题修复

修复部分已知问题。

[5.3.6] - 2023-06-02

问题修复

修复部分已知问题。

[5.3.5] - 2023-05-24

新增特性

支持纯音频 SDK。请通过网易云信 SDK 下载中心下载纯音频的 SDK 包。

问题修复

修复部分已知问题。

[5.3.3] - 2023-05-15

新增特性

序号	新增特性	特性描述	相关文档
1	调节本地播放的指定房间内所有远端用户的音量。	在多房间场景中，可以使用该方法单独调整主房间或者某个子房间的所有远端用户的播放音量。	设置通话音量

[5.3.1] - 2023-05-05

网易云信于 2023 年 5 月 5 日正式发布 NERTC SDK V5.3.1 版本。该版本提供统一的业务需求实现和更友好的跨平台接入支持，并以更小的包体积帮助您实现快速接入。

升级必看

如果您计划将应用中使用的旧版本 RTC SDK 从 V4.6.X 升级为当前版本，请根据接口变更，更新相应的代码，具体请参考升级指南。

新增特性

序号	新增特性	特性描述	相关文档
1	插件化集成人脸增强、视频超分、视频降噪功能	支持通过插件化集成人脸增强、视频嘲讽、视频降噪功能，提升 SDK 集成的灵活性与易操作性，减小 App 的包体积。	集成 SDK
2	本地数据通道	支持通过本地数据通道传输除音、视频数据之外的其他数据，例如传输游戏数据、传输传感器数据等。	不涉及
3	子房间功能优化	支持自定义视频采集、设置房间中用户音量实时回调、切换前后置摄像头。	不涉及
4	麦克风关闭时发伴音	支持用户在麦克风关闭时，发送伴音。	音效与伴音
5	支持自定义视频辅流	pushExternalVideoFrame 接口中增加 streamType 参数，支持设置为 kNERtcVideoStreamTypeMain（主流） 或 kNERtcVideoStreamTypeSub（辅流）。	自定义视频采集

改进优化

• 支持非主播角色成员或在连接异常状态下，删除推流任务。
• 支持通过不同的 uid 进入子房间。
• 支持日志加密默认开启。
• 各端对齐日志的内容、文件命名和默认存放路径。iOS 端的默认日志路径为：~/Documents/Logs 。

新增API

接口/回调	接口/回调说明
enableLocalData	开启或关闭本地数据通道。
subscribeRemoteData	取消或恢复订阅指定远端用户数据通道流。
sendData	通过数据通道发送数据。
onNERtcEngineUserDataDidStart	远端用户通过数据通道发送数据的回调。
onNERtcEngineUserDataDidStop	远端用户停用数据通道的回调。
onNERtcEngineUserDataReceiveMessage	远端用户通过数据通道接收数据的回调。
onNERtcEngineUserDataStateChanged	远端用户数据通道使用状态改变通知回调。
onNERtcEngineUserDataBufferedAmountChanged	远端用户数据通道待传输数据量改变通知回调。

变更 API

接口/回调	变更说明
setLocalVideoWatermarkConfigs	NERtcVideoWatermarkTextConfig 和 NERtcVideoWatermarkTimestampConfig 结构体里的 fontPath 名字改为 fontName。
NERtcLocalVideoWatermarkState	删除了 kNERtcLocalVideoWatermarkStateFontPathEmpty 这个state。
RemoveLiveStreamTask	接口的调用时机变更。支持在不加入房间的状态下调用该接口，以便用户在切换角色之后、ondisconnect 等异常情况下删除推流任务。
setLocalRenderScaleMode	接口的调用时机变更。setLocalRenderScaleMode 接口需要在setupLocalVideoCanvas之后才生效。
setRemoteRenderScaleMode	接口的调用时机变更。setRemoteRenderScaleMode接口需要在setupRemoteVideoCanvas之后才生效。

功能下线

V5.3.0 及之后版本不再支持 画布水印（setLocalCanvasWatermarkConfigs 和 setRemoteCanvasWatermarkConfigs） 功能，统一使用编码水印（setLocalVideoWatermarkConfigs）。编码水印可以从源头保证数据的真实性，具体请参见水印。