本文介绍网易云信音视频通话 NERTC SDK iOS 端 V5.X 版本的更新日志。

⭐重要提示

• 从 v5.5.40 开始，为方便开发者快速接入，NERTC SDK 新增多种预设场景。当前支持的预设场景包括标准 1 对 1 音视频通话、高画质 1 对 1 音视频通话、标准语聊房、高音质语聊房、会议场景。
• 从 v5.5.32 开始，支持定制裁剪一些视频特效功能，有效减小包体积。
• 从 v5.5.10 开始，支持 限定 NERTC SDK 的访问区域。在出海场景中，满足客户在全球国家或地区的访问域名的合规性。

v5.6.0 (2024-05-10)

• 优化 QoS 弱网环境的对抗算法，提升抖动网络下的音频质量。
• 优化了音频编解码算法，提升音频质量。
• 减小了 SDK 包的体积。
• 增强了应用运行稳定性。

v5.5.40 (2024-04-03)

新增特性

• 为方便开发者快速接入，SDK 新增多种预设场景。当前支持的预设场景包括：标准 1 对 1 音视频通话、高画质 1 对 1 音视频通话、标准语聊房、高音质语聊房、会议场景。
• 支持初始化时指定 audio dump 路径。

改进优化

优化 AI 降噪设置，提升降噪效果。

新增 API

接口/回调	接口/回调说明
setAudioProfile:	设置音频编码属性
setAudioScenario:	设置音频编码属性的应用场景

变更 API

接口	变更说明
NERtcChannelProfileType	房间场景新增以下枚举值： kNERtcChannelProfileVideoCall = 3 kNERtcChannelProfileHighQualityVideoCall = 4 kNERtcChannelProfileChatroom = 5 kNERtcChannelProfileHighQualityChatroom = 6 kNERtcChannelProfileMeeting = 7
NERtcEngineContext	新增 audioDumpDir 参数，用于初始化时指定 audio dump 路径。

v5.5.32 (2024-03-15)

改进优化

• 优化音频编码传输策略，提升弱网和带限场景下的适应能力，降低设备功耗。
• 优化音频 3A 算法，提升扬声器外放场景的交互音质。
• 支持定制裁剪一些视频特效功能，减小包体积。

新增 API

接口/回调	接口/回调说明
onNERtcEngineLocalFirstAudioPacketSent:	音频首帧发送回调

v5.5.30 (2024-02-29)

问题修复

• 修复刚入会时的音频路由回调错误的问题。
• 修复视频渲染的偶现崩溃问题。

v5.5.21 (2024-01-18)

新增 API

接口/回调	接口/回调说明
isFeatureSupported	查询当前设备是否支持虚拟背景功能。

变更 API

接口	变更说明
NERtcError	新增以下枚举值： kNERtcErrJoinInterruptedDueToLeaveAction = 30028 kNERtcErrJoinInterruptedDueToDestroyAction = 30029 kNERtcErrJoinInterruptedDueToAppTermination = 30030
NERtcEncryptionConfig	增加成员变量自定义加密回调 observer。
NERtcEncryptionMode	增加枚举自定义加密模式 NERtcEncryptionModeCustom。
NERtcFeatureType	增加枚举 NERtcFeatureType.kNERtcFeatureTypeVirtualBackground ，功能类型为虚拟背景。

改进优化

SDK 包体积减少约 60%。

v5.5.11 (2023-12-05)

• 提升首次安装时的登录成功率。
• 修复特定条件下小概率的房间角色错误问题。
• 提升语聊房场景的音频效果。
• 提升稳定性。

v5.5.10 (2023-10-31)

升级必看

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

新增特性

新增特性	特性描述	相关文档
范围语音	在一个 RTC 房间内，用户可以与一定距离内的其他用户进行实时语音通话，支持 仅小队 或 所有人 的语音模式。它可以让玩家在游戏中实时交流，从而更好地协调战术和策略。	范围语音
音频推拉流的黑白名单	您可以设置推流白名单、拉流白名单或拉流黑名单，从而实现只推流给指定用户或只订阅指定用户的音频，以便满足游戏语音等场景下的需求。	设置音频转发路由
限定访问区域	为满足客户在海外访问域名合规性，云信支持访问区域限制功能。无论用户身处何地使用 App，SDK 都只会访问指定区域的域名。	限定 RTC SDK 的 访问区域

新增 API

接口/回调	接口/回调说明
initSpatializer	初始化空间音效
setAudioRecvRange	设置空间音效的距离衰减属性和语音范围
setRangeAudioTeamID	设置范围语音的队伍号
setRangeAudioMode	设置范围语音的模式
setSubscribeAudioAllowlist	设置只订阅指定用户的音频流
setSubscribeAudioBlocklist	设置不订阅指定用户的音频流
onFirstVideoFrameRender	已接收到远端视频首帧并完成渲染的回调
onAudioHasHowling	啸叫消失的回调
setDelegateQueue	若您的业务系统想要接入并获取 SDK 的统计数据，您可以根据需要调用该接口修改回调事件的队列线程

变更 API

接口/回调	变更说明
NERtcDistanceRolloffModel	空间音效的距离衰减模式新增kNERtcDistanceRolloffLinearOnly(3)选项，表示仅线性衰减，没有方位效果
setAudioRecvRange	接口名称修改，对应的原接口名称为 UpdateSpatializerAudioRecvRange。
updateSelfPosition	接口名称修改，对应的原接口名称为 UpdateSpatializerSelfPosition。
enableSpatializer	新增 applyToTeam 参数。
NERtcPositionInfo	结构体名称修改，对应的原结构体名称为 NERtcSpatializerPositionInfo。
NERtcOption	新增 areaCodeType 参数，用于限定访问区域。
onAudioHasHowling	原先只有检测到啸叫时会触发 onAudioHasHowling（true）回调，V5.5.10 版本新增当啸叫消失时，也会触发 onAudioHasHowling（false）回调。

改进优化

• 优化断网重连之后音画同步效果。
• 优化弱网场景入会时长和首帧耗时。
• 画质不变情况下，降低视频码率和性能开销。
• 优化音乐场景下回声消除和降噪效果。

v5.5.2 (2023-10-07)

改进优化

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

v5.5.0 (2023-08-29)

改进优化

• 优化 SDK 的包体积大小

• 优化 SDK 的首帧耗时

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

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

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

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

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

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

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

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

• 支持华为 AudioKit

v5.4.8 (2023-08-29)

问题修复

修复部分已知问题。

v5.4.7 (2023-08-09)

问题修复

修复部分已知问题。

v5.4.3 (2023-07-27)

改进优化

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

问题修复

修复部分已知问题。

v5.4.1 (2023-07-18)

新增特性

支持 iPad 分屏旋转。

新增 API

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

问题修复

修复部分已知问题。

v5.4.0 (2023-07-04)

新增特性

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

新增 API

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

改进优化

• AI 降噪能力优化。

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

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

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

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

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

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

• 优化包大小。

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

• 优化 NE264 编码器。

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

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

v5.3.11 (2023-08-16)

问题修复

修复部分已知问题。

v5.3.8 (2023-07-21)

问题修复

修复部分已知问题。

v5.3.7 (2023-06-16)

问题修复

修复部分已知问题。

v5.3.6 (2023-06-02)

问题修复

修复部分已知问题。

v5.3.5 (2023-05-24)

新增特性

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

问题修复

修复部分已知问题。

v5.3.3 (2023-05-15)

新增特性

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

v5.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）。编码水印可以从源头保证数据的真实性，具体请参考 水印。