本文介绍网易云信音视频通话 NERTC SDK iOS 端的版本更新日志。具体功能请前往 下载 SDK 和 查看 API 文档。

单击展开查看 3.0.0 (2019-09-29) ~ 4.6.62 (2023-10-31) 版本 NERTC SDK 的更新日志。

⭐重要更新提示

• 4.6.29开始，支持 高级 Token 鉴权 , 支持对用户创建、加入房间和订阅、发布音视频流的权限进行校验，帮助您有效避免客户端遭遇破解攻击的问题。
• 4.6.20开始，支持以 插件化 方式集成 美颜、虚拟背景、AI 降噪、AI 啸叫检测，提升 SDK 集成的灵活性与易操作性，您可以根据需要自行选择是否集成对应特性的动态库，使 App 的包体积更小，具体请参考 集成 SDK。
• 4.6.20开始，支持通过 视频辅流通道 开启本地摄像头采集、自定义视频源输入等，具体请参考 设置视频编码属性 和 自定义视频采集。

⭐4.6.62 (2023-10-31)

问题修复

• SDK 数据上报相关的优化和调整。
• 修复 onNERtcEngineVideoFrameCaptured:rotation: 接口返回的 I420 数据格式问题。
• 修复由于系统异常导致 SDK 崩溃问题。

⭐4.6.61 (2023-09-01)

新增特性

新增特性	特性描述
外部 PCM 音频数据混音	支持将外部 PCM 数据混入 RTC 本地播放或者发送远端，用于实现例如 一起看抖音 等场景。

新增 API

API	API 说明
INERtcEngineEx#startExternalAudioMixingWithId:option	开启外部 PCM 音频数据混音
INERtcEngineEx#stopExternalAudioMixingWithId	关闭外部 PCM 音频数据混音
INERtcEngineEx#pushExternalAudioMixingFrameWithId:frame	推送 PCM 音频帧数据用于混音
INERtcEngineEx#setExternalAudioMixingPlaybackVolumeWithId:volume	设置外部 PCM 数据混音本地播放音量
INERtcEngineEx#getExternalAudioMixingPlaybackVolumeWithId:volume	获取外部 PCM 数据混音的播放音量
INERtcEngineEx#setExternalAudioMixingSendVolumeWithId:volume	设置外部 PCM 数据混音发送音量
INERtcEngineEx#getExternalAudioMixingSendVolumeWithId:volume	获取外部 PCM 数据混音的播放音量
NERtcEngineDelegateEx#onNERtcEngineLocalFirstAudioPacketSent	本地第一帧音频发送到远端的回调。

问题修复

• 修复频繁调用 playEffect 和 stopEffect 导致无响应的问题。

• 在不开启本地音频采集但播放伴音的场景中，优化角色切换时的音频发送逻辑。

⭐4.6.56 (2023-06-30)

修复若干已知问题。

⭐4.6.53 (2023-05-11)

新增特性

新增特性	特性描述
自定义加密	媒体流加密 新增支持自定义加密模式。除了国密算法，您可以使用自己独特的加密算法，使产品更安全、更难被攻击者破解。

⭐4.6.52 (2023-05-04)

问题修复

修复 iOS 端的用户加入房间失败时，没有触发回调的问题。

⭐4.6.50 (2023-03-28)

新增特性

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

改进优化

• 优化特定情况下 AudioSession 被修改导致的音频无声问题。
• 播放伴音时，支持选择系统自带 App 的媒体库中的音乐。

新增 API

API	API 说明
adjustChannelPlaybackSignalVolume	调节本地播放的指定房间内所有远端用户的音量。
getFrameBufferType	视频外部渲染自定义格式。

⭐4.6.43 (2023-02-20)

问题修复

修复了引擎创建期间，操作手机音量键，偶现的崩溃问题。

⭐4.6.42 (2023-02-01)

问题修复

修复部分场景下无法自动订阅音频的问题。

⭐4.6.40 (2023-01-10)

升级必看

• 自 4.6.40 起，AI 降噪功能以 插件化 方式提供，对应的 AI 降噪库为 NERtcAiDenoise.framework，可以与核心 SDK（基础音视频库）搭配使用，具体集成方式请参考 集成 SDK。

• 自 4.6.40 起，废弃 key kNERtcKeyVideoCaptureObserverEnabled，注册视频数据回调 功能请通过新接口 setVideoFrameObserver 实现。

• 自 4.6.40 起，新增 pushExternalSubStreamVideoEncodedFrame 接口，单独提供视频 辅流 编码帧的传输通道，原先的 pushExternalVideoEncodedFrame 接口只用于推送主流编码帧，因此若您已经使用原先接口实现裸流辅流输入，请修改对应代码。

新增特性

新增特性	特性描述	相关文档
音频裸流传输支持 ASL 选路	支持将编码后音频的音量数据传递给 SDK，以支持音频裸流参与 ASL 选路。	音频裸流传输
自定义视频画布颜色	支持设置视频画布的背景色，当视频尺寸与显示视窗尺寸不一致时，可以自定义改变传统黑框的颜色。	NERtcVideoCanvas

改进优化

• 支持平滑入会，优化摄像头预览期间的入会体验。
• 支持动态设置引擎回调，提高多场景切换的易用性。

新增 API

API	API 说明
setEngineEventDelegate	设置事件通知回调。
setVideoFrameObserver	注册视频数据观测器对象。
pushExternalSubStreamVideoEncodedFrame	通过辅流通道推送外部视频编码帧。

变更 API

API	API 说明
pushExternalAudioEncodedFrame	encodedAudioFrame 参数对应的 NERtcAudioEncodedFrame 类型新增 rmsLevel 字段，对应音频裸流主流的音量值。
pushExternalSubStreamAudioEncodedFrame	encodedAudioFrame 参数对应的 NERtcAudioEncodedFrame 类型新增 rmsLevel 字段，对应音频裸流辅流的音量值。
setupLocalVideoCanvas	canvas 参数对应的 NERtcVideoCanvas 类型新增 backgroundColor 字段，对应本端视频主流画布的背景颜色。
setupRemoteVideoCanvas	canvas 参数对应的 NERtcVideoCanvas 类型新增 backgroundColor 字段，对应远端视频主流画布的背景颜色。
setupLocalSubStreamVideoCanvas	canvas 参数对应的 NERtcVideoCanvas 类型新增 backgroundColor 字段，对应本端视频辅流画布的背景颜色。
setupRemoteSubStreamVideoCanvas	canvas 参数对应的 NERtcVideoCanvas 类型新增 backgroundColor 字段，对应远端视频辅流画布的背景颜色。

⭐4.6.29 (2022-11-18)

新增特性

新增特性	特性描述	相关文档
高级 Token 鉴权	支持对用户创建、加入房间和订阅、发布音视频流的权限进行校验，帮助您有效避免客户端遭遇破解攻击的问题。	高级 Token 鉴权
设置混音文件音调	支持调整伴音和音效文件的音调，以实现例如在 K 歌场景中，为了使歌曲更适合主播的声线音域，升高或降低伴奏的音阶。	音效与伴音
音视频裸流传输	支持音视频裸流传输，您可以向 NERTC SDK 提供自定义格式的音视频编码数据，并由 NERTC SDK 进行推流。	音频裸流传输、视频裸流传输

改进优化

优化加入房间进程。

问题修复

修复伴音场景下的已知问题。

新增 API

API	API 说明
joinChannelWithToken	加入音视频房间（原同名接口保留，此接口新增 channelOptions 参数，用于携带自定义入会信息）。
updatePermissionKey	设置新的权限密钥。
setEffectPitchWithId	设置音效文件的音调。
getEffectPitchWithId	获取音效文件的音调。
setEffectPositionWithId	设置音效文件的播放位置。
setAudioMixingPitch	设置伴音文件的音调。
getAudioMixingPitch	获取伴音文件的音调。
pushExternalAudioEncodedFrame	推送外部音频主流编码帧。
pushExternalSubStreamAudioEncodedFrame	推送外部音频辅流编码帧。
setPreDecodeObserver	注册解码前媒体数据观测器。
pushExternalVideoEncodedFrame	推送外部视频主流或辅流编码帧。
setVideoEncoderQosObserver	注册视频编码 QoS 信息监听器。
onNERtcEngineUserDidJoinWithUserID	远端用户加入房间回调（原同名回调不推荐使用，此回调新增 joinExtraInfo 参数，用于返回自定义入会信息）。
onNERtcEngineUserDidLeaveWithUserID	远端用户离开房间回调（原同名回调不推荐使用，此回调新增 leaveExtraInfo 参数，用于返回自定义入会信息）。
onNERtcEnginePermissionKeyWillExpire	权限密钥即将过期回调。
onNERtcEngineUpdatePermissionKey	更新权限密钥成功回调。
onAudioEffectTimestampUpdateWithId	监听音效文件的实时播放进度。
onNERtcEnginePreDecoderFrame	解码前媒体数据回调。
onNERtcEngineRequestSendKeyFrame	I 帧请求事件回调。
onNERtcEngineVideoCodecUpdated	视频编码器类型信息回调。
onNERtcEngineBitrateUpdated	视频码率信息回调。

⭐4.6.22 (2022-11-02)

改进优化

1. 视频后处理中增加丢帧处理机制。
2. 第三方美颜处理机制优化。
3. 耳返延时优化。

问题修复

1. 修复应用退出后台后，用户快速重新加入房间，信令恢复时的异步崩溃问题。
2. 修复音频场景为语音聊天室场景（CHATROOM）时，SDK 识别到 otg 声卡时会自动切换到音乐场景（MUSIC）。
3. 修复快速反复进出房间后，最后一次加入房间时无 onUserJoined 回调的问题。
4. 修复安全通审核自动打码视频主流，但在视频辅流中生效的问题。

变更 API

API	API 说明
NERtcVideoFrame	新增 uBuffer、vBuffer 参数，提供 U、V 指针。

⭐4.6.20 (2022-09-08)

升级必看

自 4.6.20 起，支持以 插件化 方式集成美颜、虚拟背景等功能，提升 SDK 集成的灵活性与易操作性，您根据需要自行选择是否集成对应特性的动态库，以实现轻量接入裁剪包，更多请参考 集成 SDK。

新增特性

新增特性	特性描述	相关文档
视频辅流通道优化	支持通过视频辅流通道开启本地摄像头采集、自定义视频源输入等。	设置视频属性
监听音频辅流音量	支持监听房间内远端用户音频辅流的瞬时音量的回调。	监听发言者音量

改进优化

1. 优化高级美颜效果。
2. 优化视频超分效果。
3. HTTP DNS 解析优化，实现防域名劫持。

新增 API

API	API 说明
enableLocalVideo:streamType:	开启或关闭本地视频流的采集和发送（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
muteLocalVideo:streamType	取消或恢复发布本地视频流（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
setLocalVideoConfig:streamType	设置视频编码属性（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
setCameraCaptureConfig:streamType	设置本地摄像头的采集配置（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
setExternalVideoSource:streamType,enable:	开启外部视频输入（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
startPreview:streamType	开启视频预览（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
stopPreview:streamType	关闭视频预览（原同名接口保留，此接口新增 streamType 参数，用于开启辅流通道）。
onNERtcEngineUser:videoMuted:streamType	远端用户暂停或恢复发送视频流的回调（原同名接口保留，此接口新增 streamType 参数，用于辅流通道）。
onEngineFirstVideoFrameDecoded:width:height:streamType	已接收到远端视频首帧并完成解码的回调（原同名接口保留，此接口新增 streamType 参数，用于辅流通道）。
onNERtcEngineFirstVideoDataDidReceiveWithUserID:streamType	已显示远端视频首帧的回调（原同名接口保留，此接口新增 streamType 参数，用于辅流通道）。

变更 API

API	API 说明
onNERtcEngineLocalVideoWatermarkStateWithStreamType:state:	state 参数对应的 NERtcLocalVideoWatermarkState 类型新增 kNERtcLocalVideoWatermarkStateSetSuccess 等 4 种枚举值，支持字体设置错误等新增水印异常状态回调。
onRemoteAudioVolumeIndication:totalVolume:	speakers 参数对应的 NERtcAudioVolumeInfo 类型新增 subStreamVolume 字段，对应远端辅流音量回调值。
setBeautyEffectWithValue:atType:	type 参数对应的 NERtcBeautyEffectType 类型新增 kNERtcBeautyShortFace 等 5 种枚举值，支持短脸等新增美颜效果。

⭐4.6.14 (2022-08-15)

改进优化

修复部分场景下的偶现崩溃。

⭐4.6.13 (2022-06-29)

改进优化

稳定性提升。

问题修复

修复频繁进出房间时的偶现崩溃。

⭐4.6.12 (2022-06-15)

问题修复

1. 修复部分场景下的帧率下降问题。
2. 修复使用虚拟背景功能场景下的已知问题。

⭐4.6.10 (2022-06-01)

新增特性

新增特性	特性描述	相关文档
虚拟背景	支持通过自动识别用户人像，虚化用户周围的真实环境，或者以指定颜色的图片或自定义图像替代真实背景。	虚拟背景
网易云信美颜	网易云信自研的基础美颜和高级美颜功能，支持在音视频通话或互动直播场景中，对人脸进行美肤、美型等美颜调整，或通过画面滤镜改变视频的色调与氛围。	网易云信美颜
音频辅流	支持通过辅流输入伴音文件或自定义音频源。	音效与伴音 自定义音频采集与渲染
自定义混响效果	支持自定义设置本地人声的混响回声效果，赋予声音一定的立体效果。	美声变声与混响
视频编码水印	支持为视频流画面添加编码水印，例如添加公司名称、标语等文字水印、录制时间等时间戳水印、以及 logo 等图片水印。	水印

改进优化

1. 修复同一 uid 在多端登录导致的互踢问题。
2. 分离音频的引擎启动逻辑和流发布逻辑，有效减少大房间的性能压力。
3. 支持在房间中根据不同场景切换音频模式，即允许在加入房间后动态切换 audioProfile。

新增 API

API	API 说明
enableVirtualBackground	开启虚拟背景。
onNERtcEngineVirtualBackgroundSourceEnabled	通知虚拟背景是否成功开启的回调。
startBeauty	开启美颜功能模块。
stopBeauty	结束美颜功能模块。
isOpenBeauty	暂停或恢复美颜效果。
setBeautyEffectWithValue	设置美颜效果。
addTempleteWithPath	导入美颜资源或模型。
addBeautyFilterWithPath	添加滤镜效果。
removeBeautyFilter	移除滤镜。
enableAudioVolumeIndication	开启说话者音量提示（原同名接口保留，此接口新增 enableVad 参数，用于设置是否启用本地采集人声监测）。
onLocalAudioVolumeIndication	提示本地用户瞬时音量的回调（原同名接口保留，此接口新增 vadFlag 参数，用于监测是否存在人声）。
enableLocalSubStreamAudio	开启音频辅流。
subscribeRemoteSubStreamAudio	订阅远端用户辅流。
muteLocalSubStreamAudio	静音本地音频辅流。
setExternalSubStreamAudioSource	开启外部音频辅流输入。
pushExternalSubStreamAudioFrame	推送外部音频辅流数据帧。
onNERtcChannelUserSubStreamAudioDidStart	通知远端用户开启音频辅流的回调。
onNERtcChannelUserSubStreamAudioDidStop	通知远端用户关闭音频辅流的回调。
onNERtcChannelUser:subStreamAudioMuted	通知远端用户暂停或恢复音频辅流的回调。
setAudioSubscribeOnlyBy	设置本地用户音频只能被房间内其他指定用户订阅。
setStreamAlignmentProperty	对齐本地系统时间与服务端时间。
getNtpTimeOffset	获取本地系统时间与服务端时间的差值。
setLocalVoiceReverbParam	开启本地语音混响效果。
getVersion	查询 SDK 版本号。
switchCameraWithPosition	指定前置或后置摄像头。
setLocalVideoWatermarkConfigs	设置视频水印。
onNERtcEngineLocalVideoWatermarkStateWithStreamType	通知水印是否成功设置的回调。
enableMediaPub	发布或停止发布本地音频。
onNERtcEngineSubStreamAudioFrameDidRecord	本地音频辅流数据回调。
onNERtcEnginePlaybackSubStreamAudioFrameBeforeMixingWithUserID	获取开启音频辅流的远端用户的辅流数据。

变更 API

API	API 说明
startAudioMixingWithOption	Option 参数新增 startTimeStamp 和 sendWithAudioType 字段，设置文件播放的起始位置和音频类型。
setAudioProfile	支持在房间内动态调用此接口设置音频属性。
setCameraCaptureConfig	Config 参数废弃 preference 字段。

废弃 API

API	API 说明
setLocalCanvasWatermarkConfigs	此接口已废弃，请使用新接口 setLocalVideoWatermarkConfigs。
setRemoteCanvasWatermarkConfigs	此接口已废弃。

⭐4.6.0 (2022-02-28)

网易云信于 2022 年 2 月 28 日发布了 NERTC SDK 最新版本 4.6.0。

新增特性

新增特性	特性描述	相关文档
设置音频订阅优先级	支持优先订阅远端某用户发布的音频流。在 ASL 策略下，即在服务器线路上选择最清晰的三条音频流传输给本地用户时，本地用户设置优先订阅一个成员的音频流后，即使该成员的说话音量较低或不够清晰，本地用户仍能接收到该指定成员的音频流。	设置音频订阅优先级
音频循环缓存录制	在原有的支持实时写文件基础上，支持设置仅录制最近一段时间内的音频数据，最高为 15 分钟。	客户端音频录制
视频图像畸变矫正	支持通过畸变矫正算法调整视窗内元素边角，还原真实画面和场景。	视频图像畸变矫正
云代理	支持使用云代理服务穿透防火墙限制，使用固定 IP 连接到网易云信服务器。	云代理

改进优化

改进优化	特性描述	相关文档
单声道最高支持码率提升	单声道最高音频码率从 64 Kbps 提升至 96 Kbps。	设置音频属性
音视频 2.0 SDK 增加裁剪包选项	用户可以根据实际场景中使用功能的差异，裁剪不需要的功能项。目前可裁剪的功能项包括：视频通话、耳返、AI 降噪、AI 超分、美声变声、H265 和 VP8 视频编解码技术、Protocol Buffers 协议、SCTP 协议等。	-

新增 API

API	API 说明
setRemoteHighPriorityAudioStream	设置某用户的音频流为高优先级。
startAudioRecordingWithConfig	开启音频录制。
enableVideoCorrection	开启视频图像畸变矫正功能。
setVideoCorrectionConfig	设置视频图像矫正参数。
setCloudProxy	开启并设置云代理服务。
onNERtcEngineMediaRightChangeWithAudio	通知音视频权限是否被禁止的回调。
startAudioDumpWithType	开启音频 dump。

变更 API

API	API 说明
startAudioRecording	新增参数 recordPosition、recordCycleTime，但均只可设为默认值，建议您改用新接口 startAudioRecordingWithConfig。
setParameters	新增参数 kNERtcKeyAutoSubscribeVideo。
setLocalVideoConfig	通过 orientationMode 设置本地视频编码的旋转方向时会同时影响本端预览画面和远端视频画面。

⭐4.5.3 (2022-02-15) V4.5.3 版本主要修复如下问题：

• 特殊场景下，加入房间卡死。
• 在多房间场景下，后加入的房间使用自定义输入或屏幕共享时，概率出现闪退。

⭐4.5.1 (2021-11-12)

修复极端场景下的偶现崩溃。

⭐4.5.0 (2021-10-22)

网易云信于 2021 年 10 月 22 日发布了 NERTC SDK 最新版本 4.5.0。

新增特性

新增特性	特性描述	相关文档
多房间管理	加入多个频道后，用户可以同时接收多个频道的流，但只能同时在一个频道内发流。该功能适用于用户需要同时接收多个频道的流，或频繁切换频道发流的场景。	加入多房间
通话前网络探测	在通话前进行 Last-mile 网络探测，可以获取通话前上下行网络的带宽、丢包、网络抖动和往返时延数据，有效帮助本地用户判断和预测上行网络质量是否良好。	通话前网络探测
摄像头采集偏好设置	通过设置摄像头采集偏好，您可以根据实际场景选择优先保证设备性能还是视频质量。	setCameraCaptureConfig
云端录制支持通过服务端 API 接口配置	云端录制支持通过服务端接口进行录制任务的配置。	-

改进优化

改进优化	特性描述	相关文档
优化本地视频编码属性配置	支持动态调整。在 4.5.0 版本之前，本地视频编码配置在下次开启本端视频时生效。V4.5.0 版本开始，您可以根据业务需求，在通话中动态调整视频分辨率等编码属性。 分辨率设置超限时取上限值（1080P）。在 4.5.0 版本之前，通过 setLocalVideoConfig 设置分辨率时，如果分辨率设置超出参数上限（1080P），则取最小值 360P。V4.5.0 版本开始，取最大值 1080P。	setLocalVideoConfig
支持静音状态下回调采集音量	支持设置静音状态下是否返回真实采集音量	KNERtcKeyEnableReportVolumeWhenMute

新增 API

API	API 说明
setCameraCaptureConfig	设置本地摄像头的采集偏好等配置。
onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID	获取指定远端用户混音前的音频数据。在多房间场景下可以通过 channelId 识别不同的房间。原接口 onPlaybackAudioFrameBeforeMixingWithUserID 即将废弃，请改用新接口。
createChannel 接口类	创建并获取一个 IRtcChannel 对象，用于多房间场景。
INERtcChannel 接口类	在指定房间中实现实时音视频功能。通过创建多个 NERtcChannel 对象，用户可以同时加入多个房间。
NERtcChannelDelegate 接口类	监听和报告指定频道的事件和数据。
startLastmileProbeTest	开始通话前网络质量探测。
stopLastmileProbeTest	停止通话前网络质量探测。
onNERtcEngineLastmileQuality	通话前网络上下行 last mile 质量状态回调。
onNERtcEngineLastmileProbeTestResult	通话前网络上下行 Last mile 质量探测报告回调。

变更 API

API	API 说明
NERtcAudioSendStats	增加 cap_volume，即采集音量。
NERtcVideoLayerSendStats	增加 captureWidth 和 captureHeight，即本地视频的采集宽高。
setParameters	增加参数 KNERtcKeyEnableReportVolumeWhenMute，设置本地用户静音时是否返回原始音量。
setLocalVideoConfig	生效时机由下次开启本段视频时生效，改为实时生效。 分辨率参数设置超限时取最大值。

废弃 API

API	API 说明
onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID	即将废弃，请改用新接口 onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID。新接口在多房间场景下可以通过 channelId 识别不同的房间。

⭐4.4.2 (2021-09-08)

网易云信于 2021 年 9 月 8 日发布了 NERTC SDK 最新版本 4.4.2。

问题修复

修复某些场景下的入会失败问题。

⭐4.4.1 (2021-09-03)

网易云信于 2021 年 9 月 3 日发布了 NERTC SDK 最新版本 4.4.1。

新增特性

新增特性	特性描述	相关文档
支持静音状态下回调采集音量	支持设置静音状态下是否返回真实采集音量	KNERtcKeyEnableReportVolumeWhenMute

改进优化

完善音效功能。

问题修复

修复一些偶现的崩溃问题。

API 变更

变更 API

API	API 说明
setParameters	增加参数 KNERtcKeyEnableReportVolumeWhenMute。

⭐4.4.0 (2021-07-13)

网易云信于 2021 年 7 月 13 日发布了 NERTC SDK 最新版本 4.4.0。

新增特性

新增特性	特性描述	相关文档
加入房间时自动生成 uid	加入音视频房间时，可以不设置 uid，此时网易云信服务器会自动为您生成一个随机 uid。此 uid 在 NERtcJoinChannelCompletion 中返回，请注意处理相关逻辑。	joinChannelWithToken:
支持视频 AI 超分功能	客户端开启 AI 超分功能之后，符合超分条件的视频流会自动进行 AI 超分处理。	AI 超分
支持媒体流加密	网易云信在默认加密算法的基础上，提供了国密加密方案，进一步保障数据安全。	媒体流加密

改进优化

• 网络类型检测新增 5G 类型。
• 解耦麦克风和伴音功能，在不开本地音频采集的前提下，可以直接使用伴音。
• 优化跨网情况下网络重连场景。当用户网络发现变更时，对应的媒体服务器地址也会择优重连。

新增 API

API	API 说明
getEffectDurationWithId	获取音效文件时长。
getEffectCurrentPositionWithId	获取音效的播放进度。
enableSuperResolution	启用或停止 AI 超分。
enableEncryption	开启或关闭媒体流加密。

变更 API

API	变更说明
startAudioMixingWithOption:	从 4.4.0 版本开始，开启或关闭本地音频采集的操作不再影响音乐文件播放，即 enableLocalAudio(false) 后仍旧可以播放音乐文件。
joinChannelWithToken:	从 4.4.0 版本开始，uid 可选且默认为 0。
onNERtcEngineNetworkConnectionTypeChanged:	增加 5G 枚举。
NERtcJoinChannelCompletion	NERtcJoinChannelCompletion 增加 uid，表示本地用户 ID。请注意相关逻辑适配。

废弃 API

无

⭐4.3.2 (2021-06-23)

修复了伴音相关的稳定性问题。

⭐4.3.0 (2021-06-04)

网易云信于 2021 年 6 月 4 日发布了 NERTC SDK 最新版本 4.3.0。

新增特性

新增特性	特性描述	相关文档
伴音音量设置的生效周期调整	通过 startAudioMixingWithOption: 播放伴音时，如果手动设置了伴音播放音量或发送音量，则当前通话中再次调用时默认沿用此设置。	startAudioMixingWithOption:
支持更多伴音格式	伴音格式支持 MP3、M4A、AAC、3GP、WMA 和 WAV。	playEffectWitdId:effectOption:
在音视频通话协议中支持 VP8 编解码	移动端新增了 VP8 编解码器，可以与仅支持 VP8 的浏览器通过 VP8 编码进行音视频通话。	-
视频编码属性支持旋转方向模式和镜像模式	默认情况下，SDK 在编码时不对视频作镜像和旋转操作。您可以通过参数来设置视频编码的旋转方向模式和镜像模式，以控制远端用户看到的视频画面。	setLocalVideoConfig:
视频流回退	网络不理想的环境下，音视频的质量都会下降。为提升用户体验，您可以通过指定接口设置视频流回退选项。在网络条件差、无法同时保证音频和视频质量的情况下，SDK 会自动将视频流从大流切换为小流，或将媒体流回退为音频流，从而提高音视频质量。	setLocalPublishFallbackOption 等视频流回退相关 API。

改进优化

优化高清音质下语音的传输码率，在弱网情况下预计减少 1/3。

新增 API

API	API 说明
setVideoRotationMode	设置本地视频画面的旋转模式。
adjustUserPlaybackSignalVolume	调节本地播放的指定远端用户的信号音量。
setLocalPublishFallbackOption	设置弱网条件下发布的音视频流回退选项。
setRemoteSubscribeFallbackOption	设置弱网条件下订阅的音视频流回退选项。
onNERtcEngineLocalPublishFallbackToAudioOnly:streamType:	本地发布流已回退为音频流或恢复为音视频流回调。
onNERtcEngineRemoteSubscribeFallbackToAudioOnly:isFallback:streamType:	远端订阅流已回退为音频流或恢复为音视频流回调。

变更 API

API	变更说明
startAudioMixingWithOption:	通过 startAudioMixingWithOption: 播放伴音时，如果手动设置了伴音播放音量或发送音量，则当前通话中再次调用时默认沿用此设置。
playEffectWitdId:effectOption:	伴音格式支持 MP3、M4A、AAC、3GP、WMA 和 WAV。
setLocalVideoConfig:	增加 mirrorMode 用于指定镜像模式。增加 orientationMode 用于指定旋转方向模式。

废弃 API

无

⭐4.2.1 (2021-05-19)

网易云信于 2021 年 5 月 19 日发布了 NERTC SDK 最新版本 4.2.1。

新增特性

新增特性	特性描述	相关文档
调节远端用户在本地播放的音量	通过 adjustUserPlaybackSignalVolume 可以调节指定远端用户混音后的音频流在本地播放的音量。	adjustUserPlaybackSignalVolume
跨房间媒体流转发	在 NERTC 直播场景的音视频房间中，跨房间媒体流转发功能可实现主播角色跨房间与其他主播实时交流互动，在娱乐场景下可实现跨直播间连麦效果。	跨房间媒体流转发

新增 API

API	API 说明
adjustUserPlaybackSignalVolume	调节本地播放的指定远端用户的信号音量。
startChannelMediaRelay:	开始跨房间媒体流转发。
updateChannelMediaRelay:	更新媒体流转发的目标房间。
stopChannelMediaRelay	停止跨房间媒体流转发。
onNERtcEngineChannelMediaRelayStateDidChange:channelName:	跨房间媒体流转发状态发生改变回调。
onNERtcEngineDidReceiveChannelMediaRelayEvent:channelName:error:	媒体流相关转发事件回调。

变更 API

无

废弃 API

无

⭐4.2.0 (2021-05-12)

网易云信于 2021 年 5 月 12 日发布了 NERTC SDK 最新版本 4.2.0。

新增特性

新增特性	特性描述	相关文档
设置用户媒体流优先级	支持设置本地用户的媒体流为优先级。如果某个用户的优先级为高，那么该用户媒体流的优先级就会高于其他用户，弱网环境下 SDK 会优先保证其他用户收到的、高优先级用户的媒体流的质量。	setLocalMediaPriority
客户端截图功能	支持针对实时视频流进行截图，包括本地主流画面、本地辅流画面、远端主流和辅流画面。音视频通话过程中，用户可以通过视频截图功能截取实时视频流画面，以便后续的存档分析、事件备忘、证据留存等等。	视频截图
画布水印功能	视频画布中支持添加文字水印、时间戳水印和图片水印，适用于信息安全、版权声明、防伪、宣传等场景。	水印
客户端音频录制	支持在客户端侧进行实时音频流录制，包含房间内所有用户混流后的音频数据。开启录制时可以指定录制文件的存放路径及格式、录制采样率、音质等。	客户端音频录制

改进优化

新增功能	功能描述
优化耳机场景表现效果	优化戴耳机场景下回声和双讲卡顿效果。优化耳返的延时，从 300ms 降低到 80ms。
iOS 端支持 AI 视频超分	通过信号的抽取或者插入来实现低分辨率视频在传输后进行细节补充的效果，以优化接收端的视频清晰度、从而提升用户体验，CPU 和 GPU 的开销在业务可接受范围内。

问题修复

修复蓝牙耳机音频通话被系统电话打断后，无法恢复到蓝牙耳机的问题。

新增 API

API	API 说明
setLocalMediaPriority	设置本地用户的媒体流优先级。
takeLocalSnapshot	本地视频画面截图。
takeRemoteSnapshot	远端视频画面截图。
onTakeSnapshotResult	截图结果回调。
setLocalCanvasWatermarkConfigs	添加本地视频画布水印。
setRemoteCanvasWatermarkConfigs	添加远端视频画布水印。
startAudioRecording	开始客户端录音。
stopAudioRecording	停止客户端录音。
onNERtcEngineAudioRecording	音频录制状态回调。

变更 API

无

废弃 API

无

⭐4.1.1 (2021-04-19)

H265 硬编解码兼容提升。

⭐4.1.0 (2021-04-07)

网易云信于 2021 年 4 月 7 日发布了 NERTC SDK 最新版本 4.1.0。

新增特性

新增特性	特性描述	相关文档
支持双人通话的独立场景	NERTC 在 4.1.0 版本中提供了更加适合双人房间场景的底层策略，优化双人房间时的音视频质量效果。双人通话功能适用于点对点通话的业务场景。	双人通话
NERTC R​estful API 支持用房间名称（cname）发起调用	音视频通话和互动直播场景的服务端 API 通过新 URL 的方式支持使用房间名称发起调用，同时原 URL 及调用方式仍旧保留以保证新老兼容。	API 概览

改进优化

新增功能	功能描述
优化音视频大房间的表现效果	客户端上实现音频选路策略 ASL，在大房间的场景中降低客户端上性能消耗，来提升客户端上能支持的用户连接上限。配合级联服务器的使用，可以将房间内并发人数提升到万人。详细说明请参考 大房间使用说明。
优化变声美声效果	改造现有美声变声接口，提供更加丰富的美声和混响效果。新版美声变声接口有改动，若您已接入美声功能，升级 4.1.0 版本时请注意接口变更。详细说明请参考 美声与变声。
视频引擎优化	支持视频 AI 超分，通过机器学习等 AI 算法，改善因受限于网络带宽限制或实时性的要求导致视频分辨偏低的问题，实现低分辨率视频在传输后进行细节补充的效果以优化接收端的视频清晰度，从而提升用户体验。 NE265 新增支持 iOS 端硬件编码，目前 NE265 编码协议，支持 mac&windows&iOS 端的编码和 Native 全端的解码。整体压缩效率较 NE264 提升 40，但编码速度慢 25%。 NE264 新增支持 AOS 端的硬件编码器，编码效率更高，优化支持硬件编码的设备上的用户体验。

新增 API

API	API 说明
setAudioEffectPreset	设置 SDK 预设的人声的变声音效。
setVoiceBeautifierPreset	设置 SDK 预设的美声效果。
setLocalVoicePitch	设置本地语音音调。
setLocalVoiceEqualizationOfBandFrequency:withGain	设置本地语音音效均衡，即自定义设置本地人声均衡波段的中心频率。

变更 API

API	API 说明
setParameters	复杂参数设置接口。

废弃 API

API	API 说明
setLocalVoiceEqualizationPreset	设置 SDK 预设的美声效果。推荐改用新方法 setVoiceBeautifierPreset。
setLocalVoiceEqualizations	设置本地语音音效均衡。推荐改用新方法 setLocalVoiceEqualizationOfBandFrequency:withGain。
setLocalVoiceChangerPreset	使用 SDK 预设的变声效果。推荐改用新方法 setAudioEffectPreset 和 setLocalVoicePitch。
setLocalVoiceReverbPreset	使用 SDK 预设的混响效果。推荐改用新方法 setVoiceBeautifierPreset。

⭐4.0.3 (2021-03-26)

修复

• 修复偶现的 crash 问题
• 优化音视频通话过程中带宽使用情况

⭐4.0.1 (2021-03-05)

修复

1. 修复 video 下码率分配异常的问题。
2. 优化音频质量。

⭐4.0.0 (2021-02-24)

网易云信于 2021 年 2 月 24 日发布了 NERTC SDK 最新版本 4.0.0，在音视频能力和性能方面均有显著优化。从 4.0.0 版本开始，NERTC 支持媒体补充增强信息（SEI）、可设置视频镜像模式、新增美声变声功能。

⭐新增特性

新增特性	特性描述	相关文档
发送媒体补充增强信息	NERTC 支持将时间戳等自定义数据作为流媒体补充增强信息（SEI Supplemental Enhancement Information）的一部分，通过流媒体通道将其与视频内容打包在一起，发送给远端用户，以此实现文本数据与音视频内容的精准同步的目的。	媒体补充增强信息
美声与变声	支持美声的预设效果、美声的自定义调节、变声的预设效果和混响的场景化效果。	美声与变声
自定义音频渲染	NERTC SDK 支持自定义音频渲染功能。拉取远端发送的音频数据之后，可使用自定义的渲染器进行音频渲染。	自定义音频采集与渲染

⭐改进优化

新增功能	功能描述
伴音错误码优化	增加伴音任务状态相关的错误码，为伴音问题排查提供依据。

API 变更

新增 API

API	API 说明
setLocalVoiceEqualizationPreset	设置 SDK 预设的美声效果。
setLocalVoiceEqualizations	设置本地语音音效均衡，即自定义设置本地人声均衡波段的中心频率。
setLocalVoiceReverbPreset	设置 SDK 预设的混响效果。
setLocalVoiceChangerPreset	设置 SDK 预设的人声的变声音效。
sendSEIMsg	通过主流通道发送媒体补充增强信息。
sendSEIMsg	发送媒体补充增强信息。通过本接口可指定发送 SEI 时使用主流或辅流通道。
NERtcEngineVideoSEIObserver	注册 SEI 观测者。注册观测器并拉流成功后，当远端流发送 SEI，本端会收到 onNERtcEngineRecvSEIMsg 回调。
onNERtcEngineRecvSEIMsg	收到远端流的 SEI 内容回调。
setExternalAudioRender	设置外部音频渲染
pullExternalAudioFrame	拉取外部音频数据

变更 API

API	API 说明
onAudioMixTaskStateChanged	伴音错误码回调，NERtcAudioMixingErrorCode 增加 kNERtcAudioMixingErrorFatal 等错误码。
NERtcVideoCanvas	画布类中增加 mirrorMode，用于设置视频镜像模式。
addLiveStreamTask	创建推流任务。NERtcLiveStreamTaskInfo 增加 config 结构体，用于配置音视频流属性。
updateLiveStreamTask	更新推流任务。NERtcLiveStreamTaskInfo 增加 config 结构体，用于配置音视频流属性。
setAudioProfile	设置音频场景与模式。scenario 参数新增 CHATROOM 枚举值，表示语音聊天室场景。

⭐3.9.0 (2021-01-08)

新增

1. 新增实时音视频辅流功能。
2. 支持设置屏幕共享内容类型。
3. 直播模式下支持设置房间角色。
4. 支持自定义音频输入。
5. 音频支持 AI 降噪能力。
6. 支持音视频啸叫检测。

技术优化

1. 支持全新的 NEVC 编码协议，同等码率下提升视频整体清晰度，提高鲁棒性和错误恢复能力。
2. 屏幕共享画面优化，提升静态共享画面的清晰度，优化用户体验。
3. 支持暗场景视频图像增强，优化暗场景下的通话体验。

⭐3.8.1 (2020-12-04)

新增

1. 房间连接状态通知功能。
2. 支持视频设备调试与配置。
3. 在语音场景中新增一档高清语音选项。

⭐3.7.3 (2020-11-20)

优化

针对音视频引擎底层模块进行优化。

⭐3.7.1 (2020-10-29)

修复

• 修复释放 engine 偶发的 crash 问题

• 修复播放采样率异常触发的麦开启问题

⭐3.7.0 (2020-09-28)

新增

• 新增发布流类型配置以及大小流开关。

• 新增视频属性灵活配置。

• 新增双声道效果支持。

优化

• 回声消除模块优化，提升单讲、双讲场景下的音质效果。

• 进入房间时默认打开音频设备。

⭐3.6.2 (2020-08-31)

新增

• 新增支持视频外部渲染。

修复

• 修复异常网络下偶现的崩溃的问题。

• 修复偶现无声音问题。

⭐3.6.0 (2020-08-20)

新增

• 新增音视频质量透明数据回调功能。

• 新增音视频设置房间模式功能。

• 新增伴音在线音频文件支持。

优化

• 优化本地渲染体验，使渲染效果更加流畅。

• 优化音频质量，保证多端音量稳定。

⭐3.5.2 (2020-07-21)

优化

• 语音场景下优化音频降噪能力，提升默认的降噪等级。

⭐3.5.1 (2020-07-06)

修复

• 修复无远端音频的情况下，音频回调不会触发的问题。

⭐3.5.0 (2020-06-23)

新增

• 新增自定义视频数据输入功能。

• 新增互动直播支持占位图片功能。

• 新增订阅/取消订阅所有远端音频功能。

优化

• 优化视频清晰度订阅机制，通过订阅大小流的方式来选择订阅视频的清晰度。

• 优化蓝牙耳机通话场景适配。

• 优化视频抗丢包能力,视频抗丢包能力提升到 40%（50ms rtt 情况下）。

变更

• 弃用通话模式设置，统一为多人会议场景。

⭐3.4.2 (2020-05-28)

新增

• 支持 NAT64 网络。

优化

• 互动直播任务，连续操作的时序保证。

⭐3.4.1 (2020-05-11)

优化

• 修复了 iOS 在某些版本上偶现的崩溃问题。

⭐3.4.0 (2020-04-28)

新增

• 新增互动直播推流功能。

• 音频效果优化，新增音乐场景模式支持。

• 新增网络状态回调。

优化

• 音频通话效果优化。

• 网络切换优化，网络变更音视频恢复更加流畅。

⭐3.3.0 (2020-03-31)

新增

• 新增音频场景设置。

• 新增音频数据回调。

• 新增屏幕共享功能。

⭐3.2.0 (2020-01-15)

新增

• 新增录屏模式。

• 支持音视频加密功能。

• 接口优化接入更加方便。

⭐3.1.0 (2019-11-19)

新增

• 支持多人会议功能。

• 支持多流发送与订阅功能。

⭐3.0.0 (2019-09-29)

新增

• 支持音视频通话功能。

5.9.0 (2025-07-02)

新增功能

• 新增视频色彩空间功能：支持多种色彩标准（如 BT.709）和色彩范围（Limited/Full Range），适用于高质量视频直播、影视制作及专业视频会议场景，提升视频画质表现力。

  • 支持设置视频采集的色彩空间参数，通过 NERtcCameraCaptureConfiguration 配置。
  • 支持在自采集模式下设置色彩空间参数，通过 NERtcVideoFrame 中的 ColorRange（色彩范围）和 ColorMatrix（色彩矩阵标准）相关枚举选项。
  • 支持画面渲染和自渲染时的色彩空间处理。
  • 支持截图功能和视频算法（美颜、人脸检测、视频增强等）兼容各种色彩空间。
  • 屏幕共享组件 NERtcReplayKit.xcframework 在视频帧回调 onReceiveVideoFrame 中通过 colorSpace 返回视频色彩空间数据。

• RTMP 拉流播放功能：拉流时无需加入房间，适用于直播观看和直播连麦场景，实现更灵活的内容分发。

• 字幕翻译增强：支持多源语言和多目标语言的实时翻译。

• 跨房间推流控制：提供更精细的直播控制能力，支持暂停（pause）和恢复（resume）跨房间推流。

• 虚拟背景能力上报：在用户加入房间事件时，上报设备支持的虚拟背景能力级别信息，适用于需要根据设备性能动态调整虚拟背景效果的场景。

功能优化

• 优化 AEC（回声消除）配置系统，提升通话音质。
• 增强音频外部数据处理的稳定性，添加空指针保护。

5.8.20 (2025-05-30)

新增功能

自定义重连时长配置：支持开发者根据业务需求自定义网络重连时长，可设置重连间隔和最大重连次数。适用于网络环境不稳定的远程会议、在线客服、医疗问诊等场景，确保通话连续性。

功能优化

• 网络连接性能提升：媒体连接建立过程优化，支持 IPv4 和 IPv6 并发连接，自动选择最优网络路径，显著提升首次连接速度和连接成功率。适用于跨国视频会议、复杂网络环境下的移动办公场景。

• AI 降噪功能优化：AI 降噪模块体积减少，降低应用包大小的同时保持卓越降噪效果，有效消除键盘声、环境噪音等干扰。

5.8.15 (2025-04-29)

• 媒体传输层现支持 IPv4 和 IPv6 网络协议的同时连接，大幅提高了网络适应性。
• 针对视频中流处理机制，优化了多人视频会议中的资源分配和传输控制。
• 修复了多项潜在问题。

5.8.10 (2025-04-01)

AI 降噪升级到 4.0 版本。AI 降噪新增音效增强模式，可精准消除背景人声，提升语音清晰度，优化通话体验。

5.8.5 (2025-03-20)

• 新增支持 IPv6 网络解析与接入，提升全球网络兼容性。
• 新增音频的 AI 降噪与啸叫检测功能开关，开发者可一键启用或关闭。
• 新增支持 AI 服务相关操作的数据回调（onAiData）。

5.8.0 (2025-02-26)

• 支持 Simulcast（Simultaneous Multistream，多流传输）视频编码和传输技术，同时发送三个不同分辨率和码率的视频流，提高音视频的网络条件和设备性能适应性。相关 API 请参考 setVideoStreamLayerCount。
• 其他已知问题优化修复。

5.7.0 (2025-01-20)

• 支持通过加密的 WSS（WebSocket Secure）协议通道传输实时通信中的信令数据。
• 将实时视频流推流到直播服务器时，支持超时检测，提升直播的稳定性。
• 修复已知问题，提升用户体验。

5.6.50 (2024-12-27)

新增特性

AI 任务支持实时字幕、AI 打断功能。相关接口请参考 startASRCaption。使用示例请参考 基于 RTC SDK 实现与 AI 数字人音视频互动。

升级更新

支持 XCFramework 框架格式。采用 手动集成 RTC SDK 的开发者，在从低版本升级至 5.6.50 版本时，请注意 .framework 文件已更名为 .xcframework，需重新添加 XCFramework 依赖。更多详情请参考 升级指南。

5.6.40 (2024-11-22)

新增特性

• 新增两路视频传输通道，用户可以同时发送两路视频流。最高可同时支持发送四路视频。适用于直播、监控、远程协作等场景中。
• 提升虚拟背景容错能力。传入无效文件作为虚拟背景时，虚拟背景使用单色模式。
• 新增获取网络类型功能（getNetworkType），包括 2G、3G、4G、5G、Wi-Fi、运营商网络、以太网、无网络等结果。

升级更新

针对构建了多房间功能的用户需注意，多房间场景下的接口行为变更如下：

• 本地音频采集和发送接口 enableLocalAudio 打开音频设备时，互斥修改为不互斥。
• 本地媒体流（主流）的发送接口 enableMediaPub 发布音频流时，不互斥修改为互斥。

即在多房间下实现发送音频流，如果只需保持设备按需开启，您需要：

1. 先关闭上一个房间的音频流，即 enableMediaPub=false / enableLocalAudio=false。
2. 然后在当前房间实现发送音频数据流，即 enableMediaPub=true / enableLocalAudio=true。

在多房间下实现发送音频流，如果需要音频采集设备一直开启，您需要：

1. 在成员加入每个房间前，调用一次 enableLocalAudio。
2. 后续音频流发布到具体的房间只需由 enableMediaPub 控制。

5.6.30 (2024-08-22)

• 新增直播推流的实时质量透明数据回调。
• 提升了虚拟背景开启的设备适配性和覆盖面。具体请参考 getFeatureSupportedType() 和 enableVirtualBackground()。
• 改进了通话模式下的回声消除策略。
• 提升了通话模式下的突发弱网抗性。

5.6.25 (2024-07-24)

• NERtcLiveStreamTaskInfo 中 taskId 字段变更为可选，支持不设置或设置为空。在这种情况下，推流任务 ID 由 SDK 生成并管理，并将在用户离开时自动清除。如果需要手动清除推流任务，调用 removeLiveStreamTask 接口，并将 task_id 指定为空即可。
• 提升了 CDN 推流成功率，详细教程请参考 CDN 推流。

5.6.20 (2024-07-10)

• 增加了标准场景下的 KTV 模式（kNERtcChannelProfileKaraoke），优化外放情况下的音质，深度适配 K 歌业务场景。
• 扩大了智码超清的适用范围。在远端使用硬件解码视频的情况下，也能完整支持。
• 优化了使用外部渲染时的性能。

5.6.10 (2024-06-14)

• 提升了秀场直播场景中的音视频效果，以及接入易用性。从 5.6.10 版本起，您可以仅集成 NERTC SDK，用更少的 API 调用，就实现秀场直播的典型场景。详情请参考 CDN 推流。
• 改进了视频编码策略，在低端机型设备上也有更好地的能表现。
• 优化了软编模式下的视频抗锯齿算法，提升了视频清晰度。

5.6.0 (2024-05-10)

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

5.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 路径。

5.5.32 (2024-03-15)

改进优化

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

新增 API

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

5.5.30 (2024-02-29)

问题修复

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

5.5.21 (2024-01-18)

新增 API

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

变更 API

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

改进优化

SDK 包体积减少约 60%。

5.5.11 (2023-12-05)

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

5.5.10 (2023-10-31)

升级必看

如果您计划将应用中使用的旧版本 RTC SDK 从 5.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）回调。

改进优化

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

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)

新增特性

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

新增 API

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

改进优化

• AI 降噪能力优化。

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

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

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

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

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

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

• 优化包大小。

  5.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)

新增特性

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

5.3.1 (2023-05-05)

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

升级必看

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

新增特性

新增特性	特性描述	相关文档
插件化集成人脸增强、视频超分、视频降噪功能	支持通过插件化集成人脸增强、视频嘲讽、视频降噪功能，提升 SDK 集成的灵活性与易操作性，减小 App 的包体积。	集成 SDK
本地数据通道	支持通过本地数据通道传输除音、视频数据之外的其他数据，例如传输游戏数据、传输传感器数据等。	不涉及
子房间功能优化	支持自定义视频采集、设置房间中用户音量实时回调、切换前后置摄像头。	多房间管理
麦克风关闭时发伴音	支持用户在麦克风关闭时，发送伴音。	音效与伴音
支持自定义视频辅流	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）。编码水印可以从源头保证数据的真实性，具体请参考 水印。