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

近期重要更新

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

---

[5.5.40] - 2024-04-03

新增特性

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

改进优化

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

新增 API

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

变更 API

接口	变更说明
NERtcChannelProfileType	房间场景新增以下枚举值： kNERtcChannelProfileVideoCall = 3 kNERtcChannelProfileHighQualityVideoCall = 4 kNERtcChannelProfileChatroom = 5 kNERtcChannelProfileHighQualityChatroom = 6 kNERtcChannelProfileMeeting = 7

[5.5.32] - 2024-03-15

改进优化

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

[5.5.30] - 2024-02-29

变更 API

接口/回调/类	接口/回调/类说明
NERtcScreenCaptureParameters	新增加成员变量 force_update_data，用于设置 SDK 高亮时，是否触发 onScreenCaptureSourceDataUpdate 回调。默认为 false（不回调）。

改进优化

• 提升了屏幕共享的采集效率。
• 提升了重新开始屏幕共享时的响应速度。

问题修复

修复了视频渲染的偶现崩溃问题。

[5.5.21] - 2024-01-18

新增 API

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

变更 API

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

改进优化

低端设备音频质量改进。

[5.5.11] - 2023-12-05

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

[5.5.10] - 2023-10-31

升级必看

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

新增特性

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

新增API

接口/回调	接口/回调说明
initSpatializer	初始化空间音效
setAudioRecvRange	设置空间音效的距离衰减属性和语音范围
setRangeAudioTeamID	设置范围语音的队伍号
setRangeAudioMode	设置范围语音的模式
setSubscribeAudioAllowlist	设置只订阅指定用户的音频流
setSubscribeAudioBlocklist	设置不订阅指定用户的音频流
onFirstVideoFrameRender	已接收到远端视频首帧并完成渲染的回调
onAudioHasHowling	啸叫消失的回调

变更 API

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

改进优化

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

[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 平台，修改为同时支持 macOS 和 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	调节本地播放的指定房间内所有远端用户的音量。	在多房间场景中，可以使用该方法单独调整主房间或者某个子房间的所有远端用户的播放音量。	设置通话音量

改进优化

新增支持 Mac ARM 64 架构。

[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 进入子房间。
• 支持日志加密默认开启。
• 各端对齐日志的内容、文件命名和默认存放路径。macOS 端的默认日志路径为：~/Documents/Logs。

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