[4.0.3] - 2021-03-26

重要通知

网易云信新版文档中心现已正式上线！

音视频通话2.0、互动直播2.0、多人语音聊天室、PK 直播等产品和场景方案已迁移至新版文档中心维护，欢迎体验！

修复

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

[4.0.1] - 2021-03-05

修复

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

[4.0.0] - 2021-02-24

网易云信于 2021 年 2 月 24 日发布了 NERTC SDK 最新版本 V4.0.0，在音视频能力和性能方面均有显著优化。从 V4.0.0 版本开始，NERTC 支持媒体补充增强信息（SEI）、新增美声变声功能、支持旁路推流设置音频码率和单路视频透传。

新增特性

序号	新增特性	特性描述	相关文档
1	发送媒体补充增强信息	NERTC 支持将时间戳等自定义数据作为流媒体补充增强信息（SEI Supplemental Enhancement Information）的一部分，通过流媒体通道将其与视频内容打包在一起，发送给远端用户，以此实现文本数据与音视频内容的精准同步的目的。	[媒体补充增强信息](/docs/product/互动直播2.0/进阶功能/体验提升/媒体补充增强信息)
2	美声与变声	支持美声的预设效果、美声的自定义调节、变声的预设效果和混响的场景化效果。	[美声与变声](/docs/product/互动直播2.0/进阶功能/音频管理/美声与变声)
3	自定义音频渲染	NERTC SDK 支持自定义音频渲染功能。拉取远端发送的音频数据之后，可使用自定义的渲染器进行音频渲染。	[自定义音频采集与渲染](/docs/product/互动直播2.0/进阶功能/音频管理/自定义音频采集)
4	Windows 平台支持本地声卡采集	启用声卡采集功能后，声卡播放的声音会被合并到本地音频流中，发送到远端。	[startSystemAudioLoopbackCapture](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a45d3fc59eea60e414b87ea10a1be95b6)
5	旁路推流支持设置音频码率	旁路推流过程中，NERTC 在云端混流转码后可以自定义设置输出的音频码率，语音场景建议使用 64 kbps，音乐场景建议使用 128 kbps。	[设置音频码率](/docs/product/互动直播2.0/进阶功能/媒体流管理/旁路推流?#音视频流配置)
6	旁路推流支持单路视频透传	在互动直播的旁路推流过程中，如果房间中只有一路视频流输入，则不对输入视频流进行转码、不遵循转码布局，直接推流 CDN。	[开启单路视频透传](/docs/product/互动直播2.0/进阶功能/媒体流管理/旁路推流?#音视频流配置)

改进优化

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

API 变更

新增 API

API	API 说明
[setLocalVoiceEqualizationPreset](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a79fe83fc07f87dbf00fdbd8b838914e0)	设置 SDK 预设的美声效果。
[setLocalVoiceEqualizations](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a03054858d70109c4378a701c6fb25a50)	设置本地语音音效均衡，即自定义设置本地人声均衡波段的中心频率。
[setLocalVoiceReverbPreset](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#aadac953901152fb2d9f4b63827da8d61)	设置 SDK 预设的混响效果。
[setLocalVoiceChangerPreset](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a91f68db9b7efbce9b0f177b481f35d3f)	设置 SDK 预设的人声的变声音效。
[sendSEIMsg](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#aea98675fa90088569a24e57a4edf145a)	通过主流通道发送媒体补充增强信息。
[sendSEIMsg](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#ac8e8af17dcb2d80d2e1e00a9d0bd4856)	发送媒体补充增强信息。 通过本接口可指定发送 SEI 时使用主流或辅流通道。
[onRecvSEIMsg](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_event_handler_ex.html#a7ae085dd56871d5f27abc6498c02d6ac)	收到远端流的 SEI 内容回调。
[startSystemAudioLoopbackCapture](https://dev.yunxin.163.com/docs/interface/音视频2.0PC端/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a45d3fc59eea60e414b87ea10a1be95b6)	开启本地声卡采集。仅支持 Windows 平台。
[stopSystemAudioLoopbackCapture](https://dev.yunxin.163.com/docs/interface/音视频2.0PC端/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a0a5d8d372966c3114917a234189c7556)	关闭本地声卡采集。仅支持 Windows 平台。
[setSystemAudioLoopbackCaptureVolume](https://dev.yunxin.163.com/docs/interface/音视频2.0PC端/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a15b8dad41b24b2ac07a9aaed6351f53f)	设置本地声卡采集音量。仅支持 Windows 平台。
[setExternalAudioRender](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a37efd1ec3002171e754fadd46663867d)	设置外部音频渲染
[pullExternalAudioFrame](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#a22f7611bf3d9462c03d3bf77f1e5fdb4)	拉取外部音频数据

变更 API

API	API 说明
[onAudioMixingStateChanged](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_event_handler_ex.html#a39351279a586979bc1ef25d10433894b)	伴音错误码回调。 NERtcAudioMixingErrorCode 中增加 NERtcAudioMixingErrorFatal 等错误码。
[addLiveStreamTask](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#ae53d9d69d13da31179e98c467b3788d5)	创建推流任务。 NERtcLiveStreamTaskInfo 增加 config 结构体，用于配置音视频流属性。
[updateLiveStreamTask](https://dev.yunxin.163.com/docs/interface/%E9%9F%B3%E8%A7%86%E9%A2%912.0PC%E7%AB%AF/nertc_windows_sdk_api_doc/html/classnertc_1_1_i_rtc_engine_ex.html#abba8d7c5094509960589e9b6e56c0ef6)	更新推流任务。 NERtcLiveStreamTaskInfo 增加 config 结构体，用于配置音视频流属性。

[3.9.0] - 2021-01-08

新增

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

技术优化

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

[3.8.2] - 2020-12-11

修复

修复断网重连时，取屏发送可能无法正常恢复的问题。

[3.8.1] - 2020-12-04

新增

1. 频道连接状态通知功能。
2. 在语音场景中新增一档高清语音选项。

变更

1. 音频麦克风和扬声器音量控制到0会自动静音，音量从0修改到非0会解除静音。
2. 服务器录制开关默认关闭。

优化

1. 取屏模块优化，解决一些黑屏及启动异常问题。
2. 优化渲染模块。
3. 音频设备异常中断后自启动。

[3.7.3] - 2020-11-20

优化

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

[3.7.0] - 2020-09-28

新增

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

2. 新增视频属性灵活配置。

3. 新增双声道效果支持。

4. IRtcEngineEx接口支持屏幕分享暂停、恢复；分享桌面支持排除窗口。

优化

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

2. 进入频道时默认打开音频设备。

[3.6.2] - 2020-08-31

修复

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

新增

1. 支持遍历摄像头设备详细信息。

[3.6.0] - 2020-08-20

新增

1. IRtcMediaStatsObserver回调加强，追加通话中的状态回调。

2. 追加接口setChannelProfile。

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

变更

1. NERtcVideoProfileType移除kNERtcVideoProfileLowest项，不再支持。

优化

1. 优化windows下应用取屏功能

[3.5.4] - 2020-08-07

新增

1. IDeviceCollection追加接口：getDeviceInfo，检索有关索引设备的指定信息。

2. 追加通知 音频默认设备变更 onAudioDefaultDeviceChanged

3. 追加音频设备可选默认路由

	#define kNERtcAudioDeviceAutoID "nertc-audio-device-auto" /**< 音频设备自动选择ID，设置该ID为设备时，SDK会根据设备插拔系统设置等自动选择合适音频设备。*/

修复

1. windows 支持音频采集和播放的格式兼容，并解决部分用户的设备列表为空和设备无法打开的问题。

[3.5.1] - 2020-07-06

修复

1. 修复偶现的崩溃问题。

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

[3.5.0] - 2020-06-23

新增

1. 追加自定义视频输入，通过调用 IVideoDeviceManager::setDevice 指定特定kNERtcExternalVideoDeviceID外部视频采集设备,并且需要调用setExternalVideoSource为true，然后通过 enableLocalVideo 启动设备。如果原先已经开启了摄像头采集，会自动切换到外部设备采集，不需要再次调用 enableLocalVideo。自定义输入传入，通过pushExternalVideoFrame接口传递给SDK。

2. 追加动态调整屏幕共享截取区域接口updateScreenCaptureRegion。

3. 互动直播布局追加背景图片设置

变更

1. 修改subscribeRemoteVideoStream接口，移动到IRtcEngine，并修改订阅参数为大小流NERtcRemoteVideoStreamType

2. audio test相关接口startRecordDeviceTest、startPlayoutDeviceTest、startAudioDeviceLoopbackTest等接口只允许通话前使用。通话开始后不允许使用，并会把未主动结束的功能自动结束处理。如果用户有通话中需要测试音频设备的需求，请改用耳返enableEarback及播放音效playEffect，来测试麦克风和扬声器。

删除

1. 移除p2p模式及相关接口setChannelType。

2. 移除预创建房间接口precreateChannel。

3. 移除自动订阅模式，对端视频需要主动调用subscribeRemoteVideoStream订阅。

[3.4.2] - 2020-05-27

优化

1. 音频采集、播放设备遍历时，将系统默认设备放到遍历列表的第一个。

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

[3.4.0] - 2020-04-28

新增

1. 新增互动直播推流功能。

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

3. 新增网络状态回调。

优化

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

[3.3.0] - 2020-03-31

新增

1. 新增音频场景设置。

2. 新增音频数据回调。

3. 新增屏幕共享功能。

4. 设备检测功能。

[3.2.0] - 2020-01-15

新增

1. 支持音视频加密功能。

2. 接口优化接入更加方便。

[3.1.0] - 2019-11-19

新增

1. 支持多人会议功能。

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

[3.0.0] - 2019-09-29

新增

1. 支持音视频通话功能。