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

近期重要更新

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

---

[5.4.10] - 2023-10-20

新增特性

序号	新增特性	特性描述	相关文档
1	屏幕共享	屏幕共享支持获取可共享的窗口列表、高亮显示共享窗口的边框、在屏幕共享过程中快速切换共享的窗口。	屏幕共享

新增API

接口/回调	接口/回调说明
getScreenCaptureSources	获取可共享窗口和屏幕的列表。
setScreenCaptureSource	在屏幕共享过程中快速切换共享的窗口。

变更 API

接口/回调	变更说明
startScreenCaptureByScreenRect	开启屏幕共享的 NERtcScreenCaptureParameters 参数中，新增 enable_high_light 、high_light_width、high_light_color、high_light_length字段，用于设置高亮显示共享窗口的边框参数。
startScreenCaptureByDisplayId
startScreenCaptureByWindowId
startScreenCaptureByDisplayId	由原先的只支持 macOS 平台，修改为同时支持 Windows 和 macOS 平台。

[5.5.2] - 2023-10-07

改进优化

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

[5.5.0] - 2023-08-29

改进优化

• 优化 SDK 的包体积大小

• 优化 SDK 的首帧耗时

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

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

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

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

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

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

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

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

• 支持华为 AudioKit

[5.4.7] - 2023-08-09

问题修复

修复部分已知问题。

[5.4.3] - 2023-07-27

改进优化

• 音频 opus 编码器支持 24kHz 采样率。
• Windows 端支持硬件编码和硬件解码，桌面端适配硬编硬解。
• 针对 Windows 端和 macOS 端，优化增益调整策略，使主讲人的语音更突出，通过控制其他杂音（周围小声音或远处干扰音）的语音放大策略。

问题修复

修复部分已知问题。

[5.4.1] - 2023-07-18

新增API

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

问题修复

修复部分已知问题。

[5.4.0] - 2023-07-04

新增特性

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

新增API

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

改进优化

• AI 降噪能力优化，提升了人声音质和降噪量，有效地抑制各种噪声而不会损伤人声。在教育和会议场景中，它针对人声（如小孩声和笑声）做了保护，避免这些声音被过度抑制。
• 优化 AEC 算法，重点改进本端和远端双讲时的效果。
• 通过优化音频 NACK 请求，降低音频在弱网环境下的端到端延时。
• 在弱网络条件下优化首帧耗时。
• 改善极端弱网络环境下的视频清晰度。
• 优化包大小，移除 VP9 编码。
• 优化 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	麦克风关闭时发伴音	支持用户在麦克风关闭时，发送伴音。	音效与伴音

改进优化

• 支持非主播角色成员或在连接异常状态下，删除推流任务。
• 支持通过不同的 uid 进入子房间。
• 支持日志加密默认开启。
• 各端对齐日志的内容、文件命名和默认存放路径。Windows 端的默认日志路径为：EXE 同级目录下的 logs 文件夹，子目录的命名规则为AppKey 前6位_AppKey hash值的前 9 位。

新增API

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

变更 API

接口/回调	变更说明
setLocalVideoWatermarkConfigs	NERtcVideoWatermarkTextConfig 和 NERtcVideoWatermarkTimestampConfig 结构体里的 fontPath 名字改为 fontName。
NERtcLocalVideoWatermarkState	删除了 kNERtcLocalVideoWatermarkStateFontPathEmpty 这个状态。
enableLocalVideo	开启屏幕共享接口 startScreenCapture 与开启本地视频辅流通道接口 enableLocalVideo 互斥。 如果当前正在屏幕共享，调用 enableLocalVideo 开启辅流时，需要调用stopScreenCapture 先停止屏幕共享。 如果当前正在使用本地视频辅流通道进行本地摄像头采集或者外部自定义视频输入，调用 startScreenCapture 开启屏幕共享时，需要先调用enableLocalVideo停止辅流。
onCaptureVideoFrame	视频采集数据回调 onCaptureVideoFrame 默认关闭。若您使用了视频采集数据回调功能，请先调用 setParameter方法开启此回调，将kNERtcKeyEnableVideoCaptureObserver参数设置为 true。
setParameter	新增 kNERtcKeyEnableVideoCaptureObserver 字段，用于开启视频采集数据回调。
NERtcEngineContext	废弃 log_file_max_size_KBytes 字段，日志加密和压缩后，不能完全按照该size进行控制。

功能下线

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