发版说明
macOS 15 Sequoia Beta 系统问题 (macOS)
当 App 路径（以及 App 名称）中包含中文字符时，编译后的 Metal shader library 中可能不包含任何方法，导致 App 无法正常运行。
v4.4.0
该版本于 2024 年 8 月 29 日发布。
该版本对部分功能的实现方式进行了优化，包括 SDK 的行为变更、API 的改名或删除，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。
-
为区分不同插件回调中的上下文信息，该版本将原有的插件相关回调删除并新增可标识插件上下文信息的对应回调（见下表），你可以通过各回调中的
ExtensionContext了解插件的名称、使用该插件的用户 ID、和提供插件的服务商名等信息。原有回调 现有回调 onExtensionEventonExtensionEventWithContextonExtensionStartedonExtensionStartedWithContextonExtensionStoppedonExtensionStoppedWithContextonExtensionErroronExtensionErrorWithContext -
该版本修改了
ExternalVideoFrame中的以下成员名称：d3d11_texture_2d更名为d3d11Texture2d。texture_slice_index更名为textureSliceIndex。metadata_buffer更名为metadataBuffer。metadata_size更名为metadataSize。
该版本新增 AI 调音器功能，可以实现类似物理声卡对音质和音色的提升。你可以通过调用 enableVoiceAITuner 方法并传入 VoiceAiTunerType 枚举中支持的音效类型来启用 AI 调音器功能，实现大叔音、萝莉音、烟嗓歌声等声音效果。
该版本在 VideoApplicationScenarioType 类下新增枚举 ApplicationScenario1v1（1v1 视频通话）。你可以调用 setVideoScenario 将视频业务场景设置为 1v1 视频通话，针对该场景低延迟、高画质的体验要求，SDK 进行了策略调优，提升了画质、首帧出图、中低端机延迟及弱网流畅度等性能表现。
该版本新增自适应硬解支持，改进了低端机的渲染流畅性，有效降低系统负载。
Windows 设备上默认启用 DirectX 11 渲染器，可提供高性能、高质量的图形渲染能力。
为了避免磨皮美颜程度较高时丢失非脸部区域的细节，该版本改进了磨皮美颜效果的实现算法。磨皮美颜现在会识别人脸的各个部位，应用在除嘴巴、眼睛和眉毛之外的人脸皮肤区域，且支持最多同时对两张人脸磨皮。
该版本还进行了如下改进：
- 优化了传输策略，调用
enableInstantMediaRendering不再对传输链路的安全性产生影响。 onLocalVideoStateChanged回调中新增LocalVideoStreamReasonScreenCaptureDisplayDisconnected枚举，表示进行屏幕采集的显示器已断开连接。- 优化了共享窗口的视频链路，降低了 CPU 占用率。(macOS)
- 优化了屏幕共享场景下的回声消除。
- 该版本在
Metadata中新增channelId参数，用于获取发送 Metadata 的源频道名称。 - 废弃了
ClientRoleChangeFailedReason中的冗余枚举值ClientRoleChangeFailedRequestTimeOut、ClientRoleChangeFailedConnectionFailed。
该版本修复了用户主动拒绝授权 App 使用音视频设备的权限后进行音视频互动时 App 崩溃的问题。(macOS)
v4.3.2
该版本于 2024 年 6 月 6 日发布。
该版本提升了 setRemoteSubscribeFallbackOption 方法的易用性，取消了调用时序要求，即：在加入频道前后，均可调用 setRemoteSubscribeFallbackOption 动态切换弱网环境下的音视频流回退选项。
该版本修复了以下问题：
- 音视频互动过程中偶现视频流畅度不佳。
- 接收端 App 解码后的视频分辨率为奇数时偶现 App 崩溃。
- 远端用户离开频道时偶现崩溃。
- 调用
startScreenCaptureByWindowId共享 PPT 窗口，当 PPT 播放动画画面时，接收端偶现画面闪烁。(Windows) - 在 Windows 7 系统上调用
startScreenCaptureByWindowId共享 WPS PPT 窗口，并设置ScreenCaptureParameters的enableHighLight为true开启窗口描边，放映该 PPT 后退出放映，之后选择最大化 PPT 窗口，窗口描边没有保留原始窗口大小，不符合预期。(Windows) - 调用
startScreenCaptureByWindowId共享窗口，并设置ScreenCaptureParameters的windowFocus和enableHighLight为true以前置指定窗口并开启窗口描边，如果当前该窗口被其他窗口覆盖，无法前置该窗口，不符合预期。(Windows) - 在 Windows 7 设备上共享窗口并对窗口描边时，点击桌面控件导致描边部分闪烁。(Windows)
- 调用
leaveChannelEx离开频道时，偶现不传入options参数导致的 App 崩溃。
v4.3.1
该版本于 2024 年 5 月 9 日发布。
为提升在线会议、秀场、在线教育等场景中的主播演讲效果，该版本新增 enableCameraCenterStage 方法开启人像锁定功能。该功能可确保主播无论移动与否，始终位于画面中心，以取得良好的演讲效果。
在开启人像锁定前，建议你先调用 isCameraCenterStageSupported 查询当前设备性能是否支持该功能。支持的设备清单可参考 API 文档。
该版本在 EncryptionConfig 中新增 datastreamEncryptionEnabled 成员用于启用数据流加密。你可以在调用 enableEncryption 开启加密时来进行设置。如果在数据流加密或解密的过程中遇到问题导致失败，你可以通过新增的 EncryptionErrorDatastreamDecryptionFailure 和 EncryptionErrorDatastreamEncryptionFailure 枚举得知。
该版本新增视频小流的自适应配置功能，当你调用 setDualStreamMode 在发送端设置双流模式并设置视频小流时，SDK 的默认行为如下所示：
- 将视频小流的默认编码分辨率设为原始视频编码分辨率的 50%。
- 视频小流的码率根据视频分辨率和帧率自动匹配，无需指定。
- 新增
enableEncryptionEx方法，用于多频道场景下开启媒体流或数据流加密。 - 新增
setAudioMixingPlaybackSpeed方法，用于设置音乐文件的播放速度。 - 新增
getCallIdEx方法，用于多频道场景下获取通话 ID。
该版本对屏幕共享的游戏场景进行了专项优化，在超高清（4K, 60 fps）游戏场景下提升了性能表现，增强了窗口采集的稳定性，为游戏玩家带来更清晰、流畅、稳定的游戏体验。
该版本在 AudioDeviceInfo 中新增 deviceTypeName 成员，用于获取音频设备的类型，如 built-in、USB、HDMI 等。
为了提高纯色背景下开启虚拟背景时人像分割的精确度和稳定性，该版本优化了绿幕分割算法：
- 支持识别任意纯色背景，不再局限于绿幕。
- 对背景颜色的识别更加准确，并且在分割人像时露出的背景更少。
- 分割后的人像边缘（尤其是手指边缘）更加稳定，显著减少边缘的画面闪动现象。
该版本在 EarMonitoringFilterType 中新增 EarMonitoringFilterReusePostProcessingFilter(1 << 15) 枚举。针对复杂的音效处理场景，你可以指定该选项，复用发送端音效处理后的 Audio filter，从而降低 CPU 的消耗。需要注意的是该选项会导致耳返延迟增加，适用于对耳返延迟不敏感的使用场景。
该版本还进行了如下改进：
- 优化了非屏幕共享场景的视频编解码策略，节省系统性能开销。
- 优化了媒体播放器对 WebM 格式视频的处理能力，支持渲染 Alpha 通道。
- 在
AudioEffectPreset中新增RoomAcousticsChorus（合唱音效），可使人声在合唱场景下更具空间立体感。 - 在
RemoteAudioStats中新增e2eDelay，用于报告从发送端采集音频起，到接收端开始播放音频时的延时。
该版本修复了以下问题：
- 使用媒体播放器播放包含 SEI 数据的媒体流时，SEI 数据的输出与视频渲染不同步。
- 屏幕共享场景中，App 调用
enableLoopbackRecording开启声卡采集功能采集共享屏幕的音频，本地用户手动禁用本地音频采集设备后，声卡采集的音频发送失败，远端用户听不见共享屏幕的声音。(Windows) - 在音视频互动中，如果用户将耳机插入设备并手动将系统音频输出切换为扬声器，之后 App 调用
setPlaybackDevice方法指定音频播放设备为耳机，用户移除耳机后，音频输出并未按预期行为切换至扬声器。 (macOS)
- 在共享 Excel 文档窗口时，偶现远端用户看到的画面出现绿屏。(Windows)
- 在使用 Intel 显卡的设备上发布视频小流偶现性能回退。(Windows)
- 当发送端用户的网络环境恶化（例如弱网）时，接收端偶现视频流畅度降低、卡顿增加。
enableCameraCenterStage(macOS)isCameraCenterStageSupported(macOS)EncryptionConfig中新增datastreamEncryptionEnabledEncryptionErrorType中新增如下枚举：EncryptionErrorDatastreamDecryptionFailureEncryptionErrorDatastreamEncryptionFailure
AudioDeviceInfo中新增deviceTypeName(macOS)RemoteAudioStats新增e2eDelayErrorCodeType新增ErrDatastreamDecryptionFailedAudioEffectPreset新增RoomAcousticsChorusgetCallIdExenableEncryptionExsetAudioMixingPlaybackSpeedEarMonitoringFilterType新增枚举EarMonitoringFilterBuiltInAudioFilters(1 << 15)
v4.3.0
该版本于 2024 年 2 月 28 日发布。
该版本对部分功能的实现方式进行了优化，涉及一些 API 的改名、删除或行为变更，为确保项目的正常运行，你需要在升级到该版本后更新 App 中的代码。
为了使一些回调中的参数以及枚举类中的枚举命名更加便于理解，该版本进行了如下修改，请在升级到该版本后修改回调中的参数设置。
| 回调 | 原有参数名 | 现有参数名 |
|---|---|---|
onLocalAudioStateChanged | error | reason |
onLocalVideoStateChanged | error | reason |
onDirectCdnStreamingStateChanged | error | reason |
onRtmpStreamingStateChanged | errCode | reason |
| 原有枚举类 | 现有枚举类 |
|---|---|
LocalAudioStreamError | LocalAudioStreamReason |
LocalVideoStreamError | LocalVideoStreamReason |
DirectCdnStreamingError | DirectCdnStreamingReason |
MediaPlayerError | MediaPlayerReason |
RtmpStreamPublishErrorType | RtmpStreamPublishReason |
有关具体枚举的改名详见 API 变更。
为提升接口易用性，该版本删除了部分跨频道媒体流转发的方法和回调，请改用下表中列出的替代选项：
| 已删除的方法和回调 | 替代的方法和回调 |
|---|---|
| startOrUpdateChannelMediaRelay |
| startOrUpdateChannelMediaRelayEx |
onChannelMediaRelayEvent | onChannelMediaRelayStateChanged |
该版本对 LocalVideoStreamReason 枚举类中的枚举进行了如下修改：
LocalVideoStreamReasonScreenCapturePaused（原LocalVideoStreamErrorScreenCapturePaused）的值从 23 变更为 28。 (Windows)LocalVideoStreamReasonScreenCaptureResumed（原LocalVideoStreamErrorScreenCaptureResumed）的值从 24 变更为 29。 (Windows)LocalVideoStreamErrorCodecNotSupport的枚举名变更为LocalVideoStreamReasonCodecNotSupport。
出于安全性和性能考虑，自该版本起，SDK 对日志进行加密，并且不再支持通过控制台打印明文日志。针对不同的需求，请参考以下解决方案：
- 如果需要得知 API 的调用情况，请查看 API 的日志并自行打印 SDK 回调日志。
- 如有其他特殊需求，请联系技术支持并附上对应的加密日志。
- 在 v4.3.0 之前，当你调用
disableAudio关闭整个音频模块后，声卡采集功能不会被关闭。 - 从 v4.3.0 起，当你调用
disableAudio关闭音频模块后，声卡采集功能也会被关闭，如果你需要再次启用声卡采集功能，需要在调用enableAudio启用音频模块后再次调用enableLoopbackRecording。
该版本支持在本地预览同时预览多个画面、且画面中显示的视频分别处于视频链路上的不同观测位置。使用方式举例如下：
- 调用
setupLocalVideo设置第一个视图：在VideoCanvas中设置position参数为PositionPostCapturerOrigin（该枚举为该版本新增），对应本地采集视频之后、前处理之前的位置，此处观测到的视频不具备前处理的效果。 - 调用
setupLocalVideo设置第二个视图：在VideoCanvas中设置position参数为PositionPostCapturer，此处观测到的视频具备视频前处理的效果。 - 观察本地预览效果：视图一为真人原始视频；视图二为经过视频前处理的虚拟人像（包括美颜、虚拟背景、水印本地预览）效果。
该版本新增 queryDeviceScore 方法，用于查询设备的评分等级，以保证用户设置的参数不会超出其设备能力。例如，在高清或超高清视频场景下，可以先调用该方法查询设备的等级评分，如果返回的评分较低（比如低于 60），则需要适当调低视频分辨率，以避免影响视频体验。不同业务场景要求的最低设备评分等级不同，具体评分推荐请联系技术支持。
该版本新增 selectMultiAudioTrack 方法，支持分别设置本地播放和发送至远端的音轨。在 K 歌等场景下，主播可以根据需求选择在本地播放一路音轨（如原声），然后发送另一路音轨至远端（如伴奏）以提升听众体验。 使用该功能前，需要通过 openWithMediaSource 打开媒体文件，并通过 MediaSource 中新增的 enableMultiAudioTrack 成员来开启音轨控制。
该版本通过了如下 API 的测试验证，可以应用于全系列 RTC 4.x SDK。
setRemoteSubscribeFallbackOption：设置弱网环境下订阅的音视频流回退选项。onRemoteSubscribeFallbackToAudioOnly：订阅流已回退为音频流或恢复为音视频流回调。setPlaybackDeviceVolume(Windows)：设置播放设备音量。getRecordingDeviceVolume(Windows)：获取音频采集设备音量。setPlayerOptionInInt和setPlayerOptionInString：设置媒体播放器选项，用于提供技术预览或特别定制功能。enableCustomAudioLocalPlayback：设置是否在本地播放外部音频源。
该版本对 SDK 内部任务的调度机制进行了优化，具体表现在以下方面：
- 远端及本地的首帧出图与出声速度均有明显提升。
- API 的调用耗时和响应耗时缩短 50% 以上。
- SDK 的并行处理能力有明显提升，在较低端的设备上也能体验到较高的视频质量 (720P，24 fps)；并且在高分辨率和高帧率视频场景下的图像处理更加稳定。
- SDK 的稳定性进一步增强，在各种特定场景下崩溃率有明显下降。
该版本为用户提供更灵活的耳返音频调整选项，支持调用 setInEarMonitoringVolume 将耳返音量设置为原始音量的 4 倍。
- 该版本优化了
setZones方法的设计，支持将zones参数设置为NULL，表示清除所有隔声区域。 - 自该版本起，在调用
ILocalSpatialAudioEngine中的方法之前，无需先取消订阅频道内所有远端用户的音频流。
该版本还进行了如下改进：
- 优化视频模块的算法、减小视频传输时对带宽的要求，在网络环境保持不变的情况下，为用户提供了更好的视频体验。
onLocalVideoStateChanged回调中新增LocalVideoStreamReasonScreenCaptureAutoFallback枚举，表示屏幕共享过程中发生意外错误（可能由于窗口阻塞失败），导致性能下降，但屏幕共享过程本身没有受到影响。- 该版本优化了 SDK 的域名解析策略，提高了复杂网络环境下调用
setLocalAccessPoint解析域名时的稳定性。 - 传入含透明背景的图片作为虚拟背景的自定义背景图时，支持自定义图片透明背景的填充色。
LocalAudioStats新增earMonitorDelay和aecEstimatedDelay成员，分别用于报告耳返延迟和回声消除 (Acoustic Echo Cancellation, AEC) 延迟。- 新增
onPlayerCacheStats回调，当媒体资源开始缓存后，SDK 会每秒触发一次该回调，报告当前缓存的媒体资源的相关数据。 - 新增
onPlayerPlaybackStats回调，当媒体资源开始播放后，SDK 会每秒触发一次该回调，报告媒体当前播放的媒体资源的相关信息。你可以通过PlayerPlaybackStats来获取当前音、视频的码率等信息。
该版本修复了以下问题：
- 当同时共享两路屏幕共享视频流时，
onLocalVideoStats回调上报的captureFrameRate为 0，不符合预期。 - 在指定屏幕区域共享时，鼠标在共享区域内的坐标不准确。当鼠标位于共享区域的边界附近时，可能导致共享的画面中看不到鼠标。(Windows)
- 使用 3.5 mm 耳机多次插拔设备后，SDK 未能检测到音频路由的变化。(Windows)
VideoCanvas新增subviewUid和uid成员enableCustomAudioLocalPlaybackqueryDeviceScoreMediaSourceType中新增CustomVideoSource枚举AudioRoute中新增RouteBluetoothDeviceA2DP枚举selectMultiAudioTrackonPlayerCacheStatsonPlayerPlaybackStatsPlayerPlaybackStats
- 以下枚举名中的
error字段全部修改为reason：LocalAudioStreamErrorOkLocalAudioStreamErrorFailureLocalAudioStreamErrorDeviceNoPermissionLocalAudioStreamErrorDeviceBusyLocalAudioStreamErrorRecordFailureLocalAudioStreamErrorEncodeFailureLocalAudioStreamErrorRecordInvalidId(Windows)LocalAudioStreamErrorPlayoutInvalidId(Windows)LocalVideoStreamErrorOkLocalVideoStreamErrorFailureLocalVideoStreamErrorDeviceNoPermissionLocalVideoStreamErrorDeviceBusyLocalVideoStreamErrorCaptureFailureLocalVideoStreamErrorCodecNotSupportLocalVideoStreamErrorDeviceNotFoundLocalVideoStreamErrorDeviceDisconnectedLocalVideoStreamErrorDeviceInvalidIdLocalVideoStreamErrorScreenCaptureWindowMinimizedLocalVideoStreamErrorScreenCaptureWindowClosedLocalVideoStreamErrorScreenCaptureWindowOccludedDirectCdnStreamingErrorOkDirectCdnStreamingErrorFailedDirectCdnStreamingErrorAudioPublicationDirectCdnStreamingErrorVideoPublicationDirectCdnStreamingErrorNetConnectDirectCdnStreamingErrorBadNamePlayerErrorNonePlayerErrorInvalidArgumentsPlayerErrorInternalPlayerErrorNoResourcePlayerErrorInvalidMediaSourcePlayerErrorUnknownStreamTypePlayerErrorObjNotInitializedPlayerErrorCodecNotSupportedPlayerErrorVideoRenderFailedPlayerErrorInvalidStatePlayerErrorUrlNotFoundPlayerErrorInvalidConnectionStatePlayerErrorSrcBufferUnderflowPlayerErrorInterruptedPlayerErrorNotSupportedPlayerErrorTokenExpiredPlayerErrorUnknownRtmpStreamPublishErrorOkRtmpStreamPublishErrorInvalidArgumentRtmpStreamPublishErrorEncryptedStreamNotAllowedRtmpStreamPublishErrorConnectionTimeoutRtmpStreamPublishErrorInternalServerErrorRtmpStreamPublishErrorRtmpServerErrorRtmpStreamPublishErrorTooOftenRtmpStreamPublishErrorReachLimitRtmpStreamPublishErrorNotAuthorizedRtmpStreamPublishErrorStreamNotFoundRtmpStreamPublishErrorFormatNotSupportedRtmpStreamPublishErrorNotBroadcasterRtmpStreamPublishErrorTranscodingNoMixStreamRtmpStreamPublishErrorNetDownRtmpStreamPublishErrorInvalidPrivilegeRtmpStreamUnpublishErrorOk
startChannelMediaRelayupdateChannelMediaRelaystartChannelMediaRelayExupdateChannelMediaRelayExonChannelMediaRelayEventChannelMediaRelayEvent
v4.2.6
该版本于 2023 年 11 月 21 日发布。
该版本修复了在特定场景（网络丢包率较高、主播在不销毁引擎时退出频道然后重新进入频道）下，接收端的视频出现卡顿或冻结。
v4.2.4
该版本于 2023 年 10 月 24 日发布。
该版本修复了如下问题：
AgoraRtcWrapper 中的 CFBundleShortVersionString 版本号错误，导致 App 无法被提交至 App Store。(macOS)
v4.2.3
该版本于 2023 年 10 月 13 日发布。
为方便接入声网云市场提供的第三方视频审核服务，该版本有以下改动：
ContentInspectType中新增contentInspectImageModeration枚举值，代表使用声网云市场视频审核插件对视频截图并上传。ContentInspectConfig中新增的serverConfig可选参数用于云市场视频审核相关服务端配置，配置后可同时接入多个云市场审核插件并实现灵活控制插件开关等功能，详情请联系技术支持。
此外，该版本还新增了 enableContentInspectEx 方法，支持同时对多条视频流截图并上传。
自该版本起，SDK 支持 ID3D11Texture2D 类型的视频格式，提升了游戏场景中视频帧的渲染效果。你可以在调用 pushVideoFrame 方法将外部原始视频帧推送到 SDK 时，设置 format 为 VideoTextureId3d11texture2d；并通过设置 d3d11_texture_2d 和 texture_slice_index 属性，来确定要使用的 ID3D11Texture2D 纹理对象。
为了帮助用户在屏幕共享场景下了解本地视频出错的准确原因，onLocalVideoStateChanged 回调中新增了如下几组枚举：
LocalVideoStreamErrorScreenCapturePaused(23)：屏幕采集已暂停。当前屏幕可能已切换到安全桌面，例如 UAC 对话框或者 Winlogon 桌面。LocalVideoStreamErrorScreenCaptureResumed(24)：屏幕采集已从暂停状态中恢复。LocalVideoStreamErrorScreenCaptureWindowHidden(25)：当前屏幕采集的窗口处于隐藏状态，并且在当前屏幕上不可见。LocalVideoStreamErrorScreenCaptureWindowRecoverFromHidden(26)：进行屏幕采集的窗口已经从隐藏状态中恢复。LocalVideoStreamErrorScreenCaptureWindowRecoverFromMinimized(27)：进行屏幕采集的窗口已经从最小化状态中恢复。
该版本新增了 isFeatureAvailableOnDevice 方法，用于查询设备能力是否满足虚拟背景、美颜等进阶功能的使用要求。
在使用进阶功能前，你可以根据查询结果判断当前设备是否支持这些功能，从而避免在低端设备上开启进阶功能导致性能下降或功能不可用的问题。你可以根据该方法的返回值，决定是否显示或启用相应的功能按钮，或者在设备能力不足时，为用户提示相应信息。
此外，自该版本起，调用 enableVirtualBackground 和 setBeautyEffectOptions 时，SDK 会自动对当前设备能力进行检查，并在设备能力不足时，通过返回错误码 -4: ErrNotSupported 表示该设备不支持开启该功能。
该版本升级了虚拟背景算法，降低了虚拟背景功能的内存占用。相比之前的版本，在低端机上使用虚拟背景功能时 App 运行占用的内存降低了约 4% 到 10%（具体数值取决于设备型号和平台）。
该版本优化了在超高清（4K，60 fps）游戏共享场景下的性能和编码效率，有效降低了屏幕共享时系统资源占用率。
该版本还进行了如下改进：
- 当调用
setPlaybackSpeed设置音频文件的播放速度时，传入非法参数后会返回错误码-2，表示方法中设置了无效的参数，需要重新设置参数。 - 优化了 Token 解析时的逻辑，避免传入非法 Token 后 App 发生崩溃。
该版本修复了以下问题：
- 加入频道偶现的崩溃。(macOS)
- 在屏幕共享场景下偶现崩溃、掉帧。(Windows)
- 调用一次
takeSnapshotEx获取视频截图会收到多次onSnapshotTaken视频截图结果回调。 - 调用
playEffect使用相同的soundId播放两个不同的音效文件，偶现第一个音效文件播放完毕后会重复播放。
-
ContentInspectType新增contentInspectImageModeration -
ContentInspectConfig中新增serverConfig可选参数 -
onLocalVideoStateChanged中新增如下枚举：LocalVideoStreamErrorScreenCapturePausedLocalVideoStreamErrorScreenCaptureResumedLocalVideoStreamErrorScreenCaptureWindowHiddenLocalVideoStreamErrorScreenCaptureWindowRecoverFromHiddenLocalVideoStreamErrorScreenCaptureWindowRecoverFromMinimized
-
ExternalVideoFrame中新增d3d11_texture_2d和texture_slice_index成员 -
VideoPixelFormat中新增VideoTextureId3d11texture2d枚举
v4.2.2
该版本于 2023 年 8 月 1 日发布。
该版本新增通配 Token。生成 Token 时，在用户 ID 不为 0 的情况下，声网支持你将频道名设为通配符，从而生成可以加入任何频道的通配 Token。在需要频繁切换频道及多频道场景下，使用通配 Token 可以避免 Token 的重复配置，有助于提升开发效率，减少你的 Token 服务端的压力。详见使用通配 Token。
声网 4.x RTC SDK 均支持使用通配 Token。
该版本新增 preloadChannel 和 preloadChannelWithUserAccount 方法，支持角色为观众的用户在加入频道前预先加载一个或多个频道。该方法调用成功后可以减少观众加入频道的时间，从而缩短观众听到主播首帧音频以及看到首帧画面的耗时，提升观众端的音视频体验。
在同时预加载多个频道时，为避免观众在切换不同频道时需多次申请 Token 从而导致切换频道时间增长，因此声网推荐使用通配 Token 来减少你的业务服务端获取 Token 导致的耗时，进一步加快切换频道的速度，详见使用通配 Token。
该版本在 VideoCanvas 中增加了 backgroundColor 成员，支持你在设置本地或远端视频显示属性时，自定义视频画布的背景颜色。
该版本在 ChannelMediaOptions 中新增下列成员，支持你发布第三个、第四个摄像头和屏幕采集到的视频流：
-
publishThirdCameraTrack：发布第三个摄像头采集的视频。 -
publishFourthCameraTrack：发布第四个摄像头采集的视频。 -
publishThirdScreenTrack：发布第三个屏幕采集的视频。 -
publishFourthScreenTrack：发布第四个屏幕采集的视频。信息目前 SDK 支持在同一时间、同一
RtcConnection中发布多路音频流、一路视频流。
该版本升级了虚拟背景的人像分割算法，全面提升了人像分割的准确度、人像边缘与虚拟背景间的平滑度以及人物移动时边缘的贴合度，同时优化了虚拟背景在会议、办公、居家等场景下，以及逆光、弱光等条件下的人物边缘精度。
该版本将跨频道连麦时媒体流转发的目标频道增加至 6 个，在调用 startOrUpdateChannelMediaRelay 和 startOrUpdateChannelMediaRelayEx 时，你可以指定最多 6 个目标频道。
为提升设备编解码能力查询功能，该版本在 CodecCapInfo 中新增 codecLevels 成员。当成功调用 queryCodecCapability 后，可通过 codecLevels 得知当前设备对于 H.264 和 H.265 格式的视频的硬件和软件解码能力等级。
- 在屏幕共享场景下，SDK 根据共享的场景自动调节发送端的帧率。尤其是在共享文档场景下，避免发送端的视频码率超出预期的情况，以提高传输效率、减小网络负担。
- 为帮助用户了解更多类型的远端视频状态改变的原因，
onRemoteVideoStateChanged回调中新增了RemoteVideoStateReasonCodecNotSupport枚举，表示本地的视频解码器不支持对收到的远端视频流进行解码。
该版本修复了以下问题：
- 加入频道后，偶现本地用户听自己及远端的声音时出现杂音。 (macOS)
- 网络异常导致频道连接断开后，频道连接恢复较慢。
- 在屏幕共享场景下，部分机型偶现屏幕共享画面出图延迟高于预期。
- 自采集场景下，
setBeautyEffectOptions、setLowlightEnhanceOptions、setVideoDenoiserOptions和setColorEnhanceOptions无法自动加载插件。 - 多设备音频录制场景下，反复插拔或开启/禁用音频录制设备后，偶现调用
startRecordingDeviceTest进行音频采集设备测试时听不到声音。 (Windows)
preloadChannelpreloadChannelWithUserAccountupdatePreloadChannelTokenChannelMediaOptions中增加下列成员：publishThirdCameraTrackpublishFourthCameraTrackpublishThirdScreenTrackpublishFourthScreenTrack
CodecCapLevelsVIDEO_CODEC_CAPABILITY_LEVELVideoCanvas中增加backgroundColor成员CodecCapInfo中增加codecLevels成员RemoteVideoStateReason中增加RemoteVideoStateReasonCodecNotSupport枚举
v4.2.1
该版本于 2023 年 6 月 21 日发布。
该版本改进了网络传输策略，提升了音视频交互的流畅度。
该版本修复了以下问题：
- SDK 不兼容部分旧版本 AccessToken 导致无法加入频道。
- 发送端调用
setAINSMode开启 AI 降噪功能后，接收端用户偶现回声。 - 使用媒体播放器播放媒体文件时出现短暂杂音。
- 发送端启用屏幕共享功能后，偶现接收端看到共享画面的延迟较高。 (macOS)
- 发送端将两路摄像头采集的视频进行本地合图并发布后，接收端偶现第二路摄像头画面缺失。 (Windows)
v4.2.0
该版本于 2023 年 5 月 26 日发布。
该版本对部分功能的实现方式进行了优化，请在升级到该版本后更新 App 代码。
原有用于摄像头和屏幕采集的方法已删除，请改用下表中列出的替代方法，并通过设置 sourceType 来指定视频源。
| 已删除方法 | 替代方法 |
|---|---|
| startCameraCapture |
| stopCameraCapture |
| startScreenCaptureBySourceType |
| stopScreenCaptureBySourceType |
-
onCaptureVideoFrame和onPreEncodeVideoFrame回调中新增了sourceType参数，用于表示具体的视频源类型。 -
以下回调已删除，请通过
onPreEncodeVideoFrame和onCaptureVideoFrame中的sourceType参数得知视频源类型。(Windows)onSecondaryPreEncodeCameraVideoFrame(Windows)onScreenCaptureVideoFrameonPreEncodeScreenVideoFrameonSecondaryPreEncodeScreenVideoFrame(Windows)
ChannelMediaOptions中的publishCustomAudioTrackEnableAec已删除，请改用publishCustomAudioTrack。ChannelMediaOptions中的成员publishTrancodedVideoTrack变更为publishTranscodedVideoTrack。ChannelMediaOptions中的成员publishCustomAudioSourceId变更为publishCustomAudioTrackId。
- 删除
InterfaceIdType中的AgoraIidMediaRecorder。在创建录制对象前无需再获取AgoraIidMediaRecorder接口类指针，你可以直接调用该版本新增的createMediaRecorder方法创建录制对象。 (Windows) - 删除
getMediaRecorder方法，可通过该版本新增的createMediaRecorder方法来创建录制对象。(macOS) - 删除
startRecording、stopRecording、setMediaRecorderObserver中的connection参数。 - 删除
IMediaRecorder类中的release方法，你可直接调用该版本新增的destroyMediaRecorder方法来销毁录制对象以释放资源。
LocalTranscoderConfiguration中的VideoInputStreams变更为videoInputStreams。TranscodingVideoStream中的枚举类MediaSourceType变更为VideoSourceType。
自该版本起，SDK 新增对第三方虚拟声卡的支持，你可以将第三方虚拟声卡作为 SDK 的音频输入或输出设备。你可以通过 stateChanged 回调来了解当前 SDK 选择的输入输出设备是否为虚拟声卡。
加频道时如果设置 AgoraALD、Soundflower 作为系统的默认输入或输出设备，会造成无声。
自该版本起，SDK 对视频编码的算法进行了优化，将默认的视频编码分辨率从 640 × 360 提升为 960 × 540，以适应设备性能和网络带宽的提升，在各种音视频互动场景下，为用户提供全链路的高清体验。
如果你想自定义视频编码分辨率，可调用 setVideoEncoderConfiguration 方法，重新设置视频编码参数配置中的视频编码分辨率。
onApiCallExecuted已删除，请改用相关频道和媒体的事件通知得知 API 的执行结果。IAudioFrameObserver类名变更为IAudioPcmFrameSink，因此下列方法原型也有相应更新：(Windows)onFrameIMediaPlayer下的registerAudioFrameObserver和unregisterAudioFrameObserver。
startChannelMediaRelay、updateChannelMediaRelay、startChannelMediaRelayEx和updateChannelMediaRelayEx已废弃，请改用startOrUpdateChannelMediaRelay和startOrUpdateChannelMediaRelayEx。
该版本新增 AI 降噪功能。开启该功能后，SDK 会智能识别和消除背景噪音，无论是在嘈杂的公共场所，还是在需要保持低延迟的实时竞技场景，都能够确保声音传输的清晰度，为用户提供更高质量的音频体验。你可以通过该版本新增的 setAINSMode 方法开启 AI 降噪，并根据实际场景，将降噪模式设置为均衡模式、强降噪模式或低延时模式。
为了增加实时视频通话的趣味性、保护用户隐私，该版本增强了虚拟背景功能。你可以在调用 enableVirtualBackground 方法时，将自定义背景设置为更多类型：
- 将背景处理为 Alpha 信息，不作替换，仅分割人像和背景，可结合本地合图功能实现人像画中画效果。
- 将背景替换为多种格式的本地视频。
该版本新增 setVideoScenario 方法用于设置视频业务场景，SDK 会根据不同场景自动启用最佳实践策略，调整关键性能指标，进而优化视频质量，提升用户体验。无论是正式的商务会议还是轻松的在线聚会，该功能都能确保视频质量满足需求。目前，该特性主要为实时视频会议场景提供了以下针对性的优化：
- 针对会议场景对小流码率要求较高的情况，自动启用多项抗弱网技术，提升小流的抗弱网能力，确保多路流订阅时接收端的流畅性。
- 实时监测接收端大小流的订阅人数，根据订阅人数动态调节大流配置、动态开启和关闭小流，以节省上行带宽和消耗。
该版本新增本地录制远端音视频功能。本地用户可以录制远端用户的音频视频流，便于将来回放、分析或分享，适用于在线教育、企业培训、在线会议等多类场景。为更准确报告录制状态，该版本在 onRecorderStateChanged、onRecorderInfoUpdated 中新增 channelId 和 uid 参数，用于表示录制的音视频流的具体信息，并新增 createMediaRecorder 方法，用于创建本地或远端的录制对象。
你可以通过如下方法体验本地录制远端音视频功能：
createMediaRecorder：创建录制对象。如需同时录制本地和远端的音视频，可以多次调用该方法创建多个录制对象。setMediaRecorderObserver：设置录制回调对象。startRecording：开始录制。stopRecording：停止录制。destroyMediaRecorder：销毁录制对象。
自该版本起，本地合图功能支持 macOS。此外，该版本新增了 onLocalVideoTranscoderError 回调，当你在开启本地合图或者更新本地合图配置失败时，SDK 会触发该回调并报告合图失败的原因。
在实时合唱的场景中，可能会出现网络原因导致各接收端下行链路不一致的情况，该版本新增 getNtpWallTimeInMs 方法获取当前的 NTP (网络时间协议) 时间，用于对齐多个接收端的歌词和音乐，实现合唱同步、歌词进度同步等，为用户提供更佳的协同体验。
该版本新增 enableInstantMediaRendering 方法，用于开启音视频帧的加速渲染模式，可加快用户加入频道后的首帧出图与出声速度。
该版本新增 startMediaRenderingTracing 和 startMediaRenderingTracingEx 方法，SDK 以调用该方法的时刻作为起点，开始跟踪频道内视频帧的渲染状态，并通过 onVideoRenderingTracingResult 回调报告相关事件的信息。
声网推荐你将该方法和 App 中的 UI 设置（按钮、滑动条等）结合使用。例如：在终端用户点击“加入频道”按钮的时刻调用该方法进行打点，然后通过 onVideoRenderingTracingResult 回调获取视频帧渲染过程中的指标，从而方便开发者针对指标进行专项优化，以提高出图效率。
该版本新增了 setLocalVoiceFormant 方法，用于设置共振峰比率以改变语音的音色。该方法还可以和 setLocalVoicePitch 方法一起使用，同时调节音调和音色，实现更多样化的变声效果。
提升了渲染的兼容性，解决了部分设备渲染失败而导致的黑屏问题。
针对自定义视频和音频采集场景，该版本新增 getCurrentMonotonicTimeInMs 方法用于获取当前的 Monotonic Time，将该值传入视频帧和音频帧的时间戳，可以精确控制音视频时序，确保音视频同步。
该版本新增 startCameraCapture 和 startScreenCaptureBySourceType 方法，通过多次调用并指定 sourceType 参数可以开启多路摄像头采集的视频流和多路屏幕采集的视频流，用于本地合图或多频道发布。适用于如远程医疗、远程教育等连接多个摄像头和显示器的场景。
该版本新增 startOrUpdateChannelMediaRelay 和 startOrUpdateChannelMediaRelayEx 方法，通过一个方法实现开始跨频道转发和更新转发的目标频道，提升了接口易用性；同时，优化内部交互次数，有效降低调用了延迟。在降低开发难度的同时，为开发者提供更顺畅的使用体验。
为更好地满足音频自采集的场景需求，该版本新增了 createCustomAudioTrack 和 destroyCustomAudioTrack 方法用于创建和销毁自定义音频轨道，并提供了两种音频轨道类型供用户选择，进一步提升了自采集音频处理的灵活性和易用性：
- 可混音的音频轨道：支持将多路外部音频源混合发布到同一频道中，适用于多路音频源的自采集场景。
- 非混音的音频轨道：仅支持将一路外部音频源发布到单个频道中，适用于实时低延迟的自采集场景。
自该版本起，SDK 对 onRenderVideoFrame 回调进行了优化，在不同的视频处理模式下返回值的意义不同：
- 当视频处理模式为
ProcessModeReadOnly时，返回值无实际含义。 - 当视频处理模式为
ProcessModeReadWrite时，返回true代表设置 SDK 接收视频帧；返回false代表设置 SDK 丢弃视频帧。
该版本修复了以下问题：
- 当快速切换身份角色时，观众端听不到声音。
- 接收端默认接收小流几秒后自动变为大流。(macOS)。
- 屏幕共享偶现共享画面抖动。(macOS)
- 使用媒体播放器播放网络摄像头的 RTSP 码流时，偶现花屏。 (Windows)
- 使用媒体播放器播放采样率超过 48 kHz 的音频时，播放失败。
- 把播放器的渲染视图设为 UIViewController 的视图后，使用播放器播放视频，视频窗口切到全屏时视频画面会从左下角开始逐渐放大。 (macOS)
- 在本地合图场景下，不支持对 PNG 和 GIF 图片的 Alpha 通道渲染，导致透明底色的图片显示为非透明底色。
- 加入频道后添加水印然后删除，远端仍能看到水印。 (Windows)
- 开始屏幕共享后添加水印，远端接收的屏幕共享画面没有水印。 (Windows)
- 加入频道后接入外接摄像头，调用
setDevice指定视频采集设备为该外接摄像头，方法未生效。 - 在屏幕共享场景下，如果将一个窗口设置为前置和描边，则必现窗口前置失败。(Windows)
- 当频道内有多路视频流时，调用部分视频增强插件相关 API 偶现失败。
- 客户端主动退出频道时未向服务端发起请求，导致服务端判定为退出频道超时。
startCameraCapturestopCameraCapturestartScreenCaptureBySourceTypestopScreenCaptureBySourceTypestartOrUpdateChannelMediaRelaystartOrUpdateChannelMediaRelayExgetNtpWallTimeInMssetVideoScenariogetCurrentMonotonicTimeInMsonLocalVideoTranscoderErrorstartLocalVideoTranscoder(Mac)updateLocalTranscoderConfiguration(Mac)setAINSModecreateCustomAudioTrackdestroyCustomAudioTrackcreateMediaRecorderdestroyMediaRecorderAudioTrackConfigRecorderStreamInfoAudioAinsModeAudioTrackTypeVideoApplicationScenarioTypeScreenCaptureFramerateCapabilityRtcEngineContext中新增domainLimit和autoRegisterAgoraExtensions属性onRecorderStateChanged、onRecorderInfoUpdated中新增channelId和uid参数onCaptureVideoFrame和onPreEncodeVideoFrame中增加sourceType参数BackgroundSourceType中新增BackgourndNone和BackgroundVideoenableInstantMediaRenderingstartMediaRenderingTracingstartMediaRenderingTracingExonVideoRenderingTracingResultMediaTraceEventVideoRenderingTracingInfo
startChannelMediaRelaystartChannelMediaRelayExupdateChannelMediaRelayupdateChannelMediaRelayExonChannelMediaRelayEventChannelMediaRelayEvent
startPrimaryScreenCapturestartSecondaryScreenCapturestopPrimaryScreenCapturestopSecondaryScreenCapturestartPrimaryCameraCapturestartSecondaryCameraCapturestopPrimaryCameraCapturestopSecondaryCameraCaptureonSecondaryPreEncodeCameraVideoFrame(Windows)onScreenCaptureVideoFrameonPreEncodeScreenVideoFrameonSecondaryPreEncodeScreenVideoFrame(Windows)onApiCallExecutedChannelMediaOptions中的publishCustomAudioTrackEnableAecgetMediaRecorderIMediaRecorder类中的releaseAgoraIidMediaRecorder(Windows)startRecording、stopRecording、setMediaRecorderObserver中删除connection参数
v4.1.0
该版本于 2022 年 12 月 20 日发布。
如果你已经使用了以下类或方法，请在升级到该版本后重新调用方法并更新参数设置：
删除了 enableDualStreamMode 中的 sourceType 参数，因为 SDK 支持对自定义采集或 SDK 采集的各种视频源开启双流模式，不再需要指定视频源类型。
该本版新增耳返功能。你可以调用 enableInEarMonitoring 开启耳返功能。
如需调节耳返音量，你可以调用 setInEarMonitoringVolume。
为方便用户在任何阶段知悉本地网络的连接类型，该版本新增 getNetworkType 方法。你可以通过该方法获取正在使用的网络连接的类型，包括 UNKNOWN、DISCONNECTED、LAN、WIFI、2G、3G、4G、5G。当本地网络连接类型发生改变时，SDK 会触发 onNetworkTypeChanged 回调，报告当前的网络连接类型。
声网服务器会根据音量大小对音频流进行筛选，选出 N 路音量最大的音频流并传输至接收端。N 默认为 3 路，如需自定义设置 N，请联系技术支持。
同时，声网还支持发流端自定义设置是否参与音强选流，不参与选流的音频流会直接和被选出的 N 路音频流一同传输至接收端。在大型会议等多人发流的场景下，开启音强选流功能可以帮助减轻接收端的下行带宽压力和系统资源消耗，详见音强选流。
该版本新增音强选流功能，如需开启该功能，请联系技术支持。
该版本对双流模式做了优化，在加入频道前后均可调用 enableDualStreamMode 和 enableDualStreamModeEx。
扩展了订阅视频小流的实现方式，SDK 默认在发送端开启小流 auto 模式（即：默认不主动发送小流），可通过以下步骤开启发送小流：
- 接收端主播调用
setRemoteVideoStreamType或setRemoteDefaultVideoStreamType发起接收小流申请。 - 发送端收到申请后自动切换为发送小流模式。
如果你想修改上述发送端的默认行为，可以调用 setDualStreamMode 方法，将 mode 参数设置为 disableSimulcastStream (始终不发送小流) 或 enableSimulcastStream (始终发送小流)。
SDK 默认使用播放设备为声卡采集设备，自该版本起，你可以另外指定声卡采集设备并将其采集到的音频发布到远端。
setLoopbackDevice：用于指定声卡采集设备，当你不希望当前的播放设备为声卡采集设备时，可以调用该方法另外指定别的设备作为声卡采集设备。getLoopbackDevice：用于获取当前的声卡采集设备。followSystemLoopbackDevice：用于设置声卡采集设备是否跟随系统默认的播放设备。
该版本新增了如下适用于空间音频场景的特性，在虚拟互动场景下可以有效提升用户的临场感体验。
- 隔声区域：你可以通过调用
setZones设置隔声区域和声音衰减系数。当音源 (可以为用户或媒体播放器) 跟听声者分属于音障区域内部和外部时，会体验到类似真实环境中声音在遇到建筑隔断时的衰减效果。你也可以通过调用setPlayerAttenuation和setRemoteAudioAttenuation方法分别针对媒体播放器和用户设置声音衰减属性，并指定是否使用该设置强制覆盖setZones中的声音衰减系数。 - 多普勒音效：你可以通过设置
SpatialAudioParams中的enable_doppler参数开启多普勒音效，在声源和接收方发生高速相对位移的情况下（比如赛车游戏场景），接收方会体验到明显的音调变化。 - 耳机均衡器：你可以通过调用
setHeadphoneEQPreset方法使用预设的耳机均衡效果，以改善耳机的听感。如果在调用setHeadphoneEQPreset后仍未达到预期的耳机均衡效果，你可以调用该方法进行调节。
该版本新增 setRemoteVideoSubscriptionOptions 和 setRemoteVideoSubscriptionOptionsEx 方法，当你调用 registerVideoEncodedFrameObserver 方法为编码后的视频注册视频帧观测器时，SDK 默认订阅编码后的视频帧。如果你想要修改订阅选项，可以调用新增的方法进行设置。
有关更多注册视频观测器和订阅选项的介绍，详见 API 参考。
自该版本起，SDK 支持 MPUDP 协议，在 UDP 协议的基础上，允许连接并使用多个路径来最大化信道资源的使用。你可以同时在不同终端使用不同的物理网卡并将其聚合，达到有效对抗网络抖动、提升传输质量的效果。
如果你希望体验该功能，请联系 sales@shengwang.cn。
该版本新增 registerExtension 方法，用于注册插件。当使用第三方插件时，你需要按照以下顺序调用插件相关的 API：
调用 loadExtensionProvider -> registerExtension -> setExtensionProviderProperty -> enableExtension。
该版本新增了一系列回调，帮助你更好地了解音视频设备的状态。
onVideoDeviceStateChanged：当视频设备的状态发生改变时上报。onAudioDeviceStateChanged：当音频设备的状态发生改变时上报。onAudioDeviceVolumeChanged：当音频设备或 App 的音量发生改变时上报。
该版本在 CameraCapturerConfiguration 中增加了 followEncodeDimensionRatio 成员参数，你可以在使用摄像头采集视频时，通过该成员参数设置是否跟随 setVideoEncoderConfiguration 中已经设置的视频宽高比。
该版本增加了一系列多频道相关的方法，你可以通过调用这些方法，实现对多频道中音视频流的管理。
- 新增
muteLocalAudioStreamEx和muteLocalVideoStreamEx方法，分别用于取消或恢复发布本地音频流和视频流。 - 新增
muteAllRemoteAudioStreamsEx和muteAllRemoteVideoStreamsEx方法，分别用于取消或恢复订阅所有远端用户的音频流和视频流。 - 新增
startRtmpStreamWithoutTranscodingEx、startRtmpStreamWithTranscodingEx、updateRtmpTranscodingEx和stopRtmpStreamEx方法，用于实现多频道场景下的旁路推流。 - 新增
startChannelMediaRelayEx、updateChannelMediaRelayEx、pauseAllChannelMediaRelayEx、resumeAllChannelMediaRelayEx和stopChannelMediaRelayEx方法，用于实现多频道场景下的跨频道媒体流转发。 leaveChannelEx方法新增options参数，用于在多频道场景下离开频道时，选择是否停止麦克风采集。
一般场景下，声网默认的视频编码配置能满足需求。对于特定场景，该版本在 VideoEncoderConfiguration 中新增 advanceOptions 成员参数，用于视频编码属性的进阶设置：
compressionPreference：视频编码的压缩偏好设置，用于选择视频的低延时或高质量偏好。encodingPreference：视频编码器偏好设置，用于进阶设置视频编码属性，视频编码器偏好设置，用于选择视频的自适应偏好、软件编码偏好或硬件编码偏好。
使用声网私有媒体服务器的场景下，为支持用户在调用 setLocalAccessPoint 方法时的进阶设置，该版本在 LocalAccessPointConfiguration中新增 advancedConfig 成员参数，该参数支持如下设置：
logUploadServer：默认情况下，SDK 会将日志上传至声网的日志服务器。你可以通过该参数自定义日志上传的服务器。
为方便用户分辨切换后的用户角色属于互动直播还是极速直播，该版本在 onClientRoleChanged 回调中新增 newRoleOptions 参数，该参数取值如下：
AudienceLatencyLevelLowLatency(1): 低延时，属于极速直播。AudienceLatencyLevelUltraLowLatency(2): 超低延时，属于互动直播。
该版本优化了 onVideoSizeChanged 的触发逻辑，当单独调用 startPreview 时，也可触发该回调并上报本地视频大小发生改变。
该版本缩短了首帧出图时间，以提升用户视频体验。
该版本对屏幕共享功能做了一系列优化，除以下列出的功能性改进之外，还有一部分可用性提升，详见问题修复。
- 支持超高清视频 (分辨率为 4K，帧率为 60 fps)，你可以在满足要求的设备上使用该功能。声网推荐的最低设备规格为：intel(R) Core(TM) i7-9750H CPU @ 2.60GHZ。
- 在
ScreenCaptureSourceInfo中增加了minimizeWindow成员，用于表示目标窗口是否已最小化。 - 在
ScreenCaptureParameters中增加了enableHighLight、highLightColor和highLightWidth成员，支持你在屏幕共享时对目标窗口或屏幕进行描边。 - 兼容更多主流 App，包括但不限于：WPS Office，Microsoft Office PowerPoint，Visual Studio Code，Adobe Photoshop，Windows Media Player，Scratch。
- 兼容更多设备和操作系统，包括但不限于：Windows 8 系统，无独立显卡的设备，双显卡设备。
- 兼容更多设备和场景，包括但不限于：双显卡设备，使用外接屏幕进行屏幕共享。
为提升 CDN 推流的用户体验，当设置的视频分辨率超出摄像头设备支持的范围时，SDK 会根据你的设置进行自适应，取最接近、且长宽比与你设置的分辨率一致的值进行采集、编码、推流，同时通过 onDirectCdnStreamingStats 回调报告推送的视频流的实际分辨率。
该版本对 updateChannelMediaRelay 方法做了如下优化：
- 4.1.0 版本前：如果服务器内部原因导致目标频道更新失败，SDK 返回错误码
RelayEventPacketUpdateDestChannelRefused(8)，你需要重新调用updateChannelMediaRelay方法。 - 4.1.0 版本及之后：如果服务器内部原因导致目标频道更新失败，SDK 会重新尝试更新直到目标频道更新成功。
该版本基于 AI 方法重构了 AEC 算法，相比传统 AEC 算法，新的算法可以在较恶劣的回信比 (echo-to-signal) 条件下保存完整、清晰、流畅的近端人声，显著提高系统的回声消除和双讲性能，带给用户更舒适的通话和直播体验。适用于会议、语聊、K 歌等场景。
该版本对虚拟背景算法做了如下优化：
- 在处理虚拟背景的边界时更加细腻，抠图精细程度达到发丝级别。
- 在人像静止或移动时都能确保虚拟背景的稳定性，有效解决背景闪烁、超出画面范围的问题。
- 支持更多应用场景，无论在黑夜、白天、室内、室外等各种环境下都能获得良好的虚拟背景效果。
- 支持识别多种姿态，包括半身静态、身体晃动、手部摆动，并支持精细识别手指动作，在不同手势下均能达到良好的虚拟背景效果。
- 降低了推送外部音频源时的上行延迟。
- 提升了会议场景 (
audioScenarioMeeting) 默认参数配置下的回声消除性能。 - 提升了 SDK 视频渲染的流畅度。
- 降低了当主播调用
muteLocalVideoStream方法时本地设备的 CPU 占用率和耗电量。 - 增强对不同网络协议栈的识别能力，在多种运营商网络场景下提升 SDK 的接入能力。
该版本修复了以下问题：
- 在频道内调用
setVideoEncoderConfigurationEx将视频的分辨率调高时，偶现失效。 - 使用媒体播放器播放视频，先调用
play再调用pause暂停播放后，调用seek指定一个新的播放位置，偶现视频画面依然是暂停播放时的画面；调用resume恢复播放后，偶现视频画面出现快进。 - 在直播场景下，主播在扬声器和听筒之间进行切换后，观众听主播的声音会听到滋啦杂声。
- 调用
getExtensionProperty失败，返回空字符串。 - 当以观众身份进入一个已播放较长时间的直播间，首帧出图时间缩短。
- 通过摄像头采集视频时，如果在
CameraCapturerConfiguration中设置的视频宽高比例和在setVideoEncoderConfiguration中设置的不一致，导致本地视频预览的画面比例未按照后者的设置呈现。 - 在屏幕共享场景下，偶现系统声音音量变小。
- 在屏幕共享场景下，远端用户看到的画面偶现黑屏、卡顿、崩溃。
- 在屏幕共享场景下，偶现
onNetworkQuality回调报告频道内指定用户的上下行网络状态不准确。
- 调用
stopPreview关闭本地视频预览时，导致已设置的虚拟背景一定概率失效。 - 开启虚拟背景并设置为背景虚化效果时，多次退出频道再加入频道时偶现崩溃。
- 本地端使用 1920 x 1080 的摄像头作为视频采集源，偶现远端视频的分辨率与本地端不一致。
- 在屏幕共享场景下，将共享的窗口最小化时，偶现远端用户出现黑屏或远端画面切换为视频小流。
- 在直播场景下，主播开启屏幕共享时，偶现观众听主播说话有回声。
- 在屏幕共享场景下，在横屏显示器与竖屏显示器之间共享屏幕时出现黑屏。
- 调用
startScreenCaptureByDisplayId进行屏幕共享时无法屏蔽窗口。 - 在屏幕共享场景下，在共享窗口中看到的鼠标位置与实际位置有偏差。
- 从普通场景切换屏幕共享场景后，由于两种场景下设置的分辨率不同导致偶现崩溃。
- 在屏幕共享场景下，将共享的窗口最小化或关闭共享窗口时，共享窗口自动切换为该 App 的其他窗口。
- 在屏幕共享场景下，当共享的窗口为半屏模式时，对窗口的描边不正确。
- 启动并停止音频采集设备测试后，启动音频播放设备测试时必现无声。
onVideoPublishStateChanged回调报告的视频源类型不准确。
getNativeHandlegetPlaybackDefaultDevicegetRecordingDefaultDeviceenableDualStreamModeExsetDualStreamModesetDualStreamModeExSimulcastStreamModegetNetworkTypesetLoopbackDevice(Windows)getLoopbackDevice(Windows)followSystemLoopbackDevice(Windows)setZonessetPlayerAttenuationsetRemoteAudioAttenuationsetHeadphoneEQPresetsetHeadphoneEQParametersHeadphoneEqualizerPresetsetRemoteVideoSubscriptionOptionssetRemoteVideoSubscriptionOptionsExVideoSubscriptionOptionsAdvancedOptionsEncodingPreferenceCompressionPreferenceadjustUserPlaybackSignalVolumeExRhythmPlayerStateTypeRhythmPlayerErrorTypeenableAudioVolumeIndicationExonVideoDeviceStateChangedonAudioDeviceStateChangedonAudioDeviceVolumeChangedregisterExtension(Windows)muteLocalAudioStreamExmuteLocalVideoStreamExmuteAllRemoteAudioStreamsExmuteAllRemoteVideoStreamsExstartRtmpStreamWithoutTranscodingExstartRtmpStreamWithTranscodingExupdateRtmpTranscodingExstopRtmpStreamExstartChannelMediaRelayExupdateChannelMediaRelayExpauseAllChannelMediaRelayExresumeAllChannelMediaRelayExstopChannelMediaRelayExLocalAccessPointConfigurationAdvancedConfigInfoLogUploadServerInfo
enableDualStreamMode：删除sourceTypeChannelMediaOptions：新增isAudioFilterableenableInEarMonitoring：支持 PC 端setEarMonitoringAudioFrameParameters：支持 PC 端setInEarMonitoringVolume：支持 PC 端onEarMonitoringAudioFrame：支持 PC 端SpatialAudioParams：新增enable_dopplerScreenCaptureSourceInfo：新增minimizeWindowScreenCaptureParameters：支持 Windows 平台CameraCapturerConfiguration：新增followEncodeDimensionRatioleaveChannelEx：新增optionsVideoEncoderConfiguration：新增advanceOptionsLocalAccessPointConfiguration：新增advancedConfigonClientRoleChanged：新增newRoleOptionsVideoCanvas：新增setupMode、mediaPlayerId和cropAreaLocalVideoStats：新增hwEncoderAccelerating
onApiCallExecutedChannelMediaRelayEvent：废弃RelayEventPacketUpdateDestChannelRefused(8)
v4.0.0
该版本于 2022 年 9 月 29 日发布。
v4.0.0 SDK 包名由 electron-agora-rtc-ng 变更为 agora-electron-sdk，且对部分功能的实现方式进行了优化，从而导致与 v3.7.0 不兼容。如下为存在兼容性变更的主要功能：
- 多频道
- 媒体流发布控制
- 警告码
升级 SDK 后，你需要结合实际业务场景更新 App 代码，详见迁移指南。
该版本支持通过设置 IRtcEngineEx 和 ChannelMediaOptions，实现一个 IRtcEngine 实例同时采集多路音视频源并发布到远端，适应各种业务场景。例如：
- 调用
joinChannel加入首个频道后，多次调用joinChannelEx加入多个频道，通过不同的用户 ID 和ChannelMediaOptions设置发布指定的流到不同的频道。 - 支持通过设置
ChannelMediaOptions中的publishSecondaryCameraTrack和publishSecondaryScreenTrack同时发布多路摄像头采集或者屏幕共享的视频流。
同时，该版本支持通过 createCustomVideoTrack 方法实现自定义视频采集。你可以参考如下步骤，体验同时发布多路自定义采集视频流：
- 创建自采集视频轨道：调用
createCustomVideoTrack方法创建一个自定义视频轨道，并获得视频轨道 ID。 - 设置频道中待发布的自采集视频轨道：在每个频道的
ChannelMediaOptions中，将customVideoTrackId参数设置为你想要发布的视频轨道 ID，并将publishCustomVideoTrack设置为true。 - 推送外部视频源：调用
pushVideoFrame，并将videoTrackId指定为你想要发布的自定义视频轨道 ID，即可根据步骤 2 的设置，实现在多个频道中发布对应的自定义视频源。
结合多频道能力，你还可以体验如下功能：
- 将多组音视频流通过不同的用户 ID (
uid) 发布到远端。 - 将多路音频流混音后通过一个用户 ID (
uid) 发布到远端。 - 将多组视频频流通过不同的用户 ID (
uid) 发布到远端。 - 将多路视频流合图后通过一个用户 ID (
uid) 发布到远端。
为提升视频互动体验，SDK 对视频采集、编码、解码、渲染全流程做出了优化，自该版本起支持 4K 分辨率。优化了 FEC（Forward Error Correction）算法，可根据视频帧包数与帧率进行自适应切换，降低 4K 场景下的视频卡顿率。
你可以在调用 setVideoEncoderConfiguration 时，设置编码分辨率为 4K (3840 × 2160)、帧率为 60 fps。当你的设备不支持 4K 时，SDK 支持自动回退到适合的分辨率和帧率。
该功能对设备性能和网络带宽有一定要求，在不同的平台上支持的上下行帧率也不同，如需体验该功能，请联系技术支持。
高分辨率可能会影响集合分辨率从而导致费用变更。详见计费策略。
为减少 SDK 包体积、集成时间，以及简化 API 的调用步骤，该版本支持内置媒体播放器。调用 createMediaPlayer 创建媒体播放器后，你可以通过 IMediaPlayer 类的一系列方法体验内置媒体播放器的各类功能：
- 自动播放本地、在线、自定义的媒体资源。
- 预先加载待播放的媒体资源。
- 根据网络情况切换媒体资源的播放线路。
- 将媒体播放器的音视频流推送到任意频道、分享给远端用户。
- 实时缓存媒体资源文件，该功能开启后，播放器会预先缓存当前正在播放的媒体文件的部分数据到本地，可提高播放流畅度，帮助节省网络流量。
自该版本起，SDK 支持新版 AI 降噪（相对于 v3.7.0 中的基础 AI 降噪）功能。相比原版 AI 降噪，新版 AI 降噪具有更好的人声保真度、更干净的噪声抑制，并新增了去混响 (Dereverberation) 能力。 如果你希望体验新版 AI 降噪，请联系 sales@shengwang.cn。
为还原音频的细节、提升音频的清晰度，该版本新增 UltraHighQualityVoice。在语聊、歌唱等以人声为主的场景中，你可以调用 setVoiceBeautifierPreset 并使用该枚举体验超高音质。
该版本为实时合唱赋予了如下能力：
- 支持两人及两人以上合唱。
- 每位歌手相互独立。一位歌手出现问题或退出合唱，其他歌手还可以继续合唱。
- 极低延时体验。每位歌手可以实时听到彼此的歌声，观众也可以实时听到每位歌手。
该版本新增 AudioScenarioChorus 枚举来设置极低延时。使用该枚举后，在网络条件良好的情况下，用户可以体验到极低延时的实时合唱。
为满足各类业务场景对频道管理的需求，该版本在 ChannelMediaOptions 结构体中新增了如下功能：
- 设置或切换多种音视频源的发布
- 设置或切换频道场景、用户角色
- 设置或切换订阅视频的大小流类型
- 控制音频发布时延
在调用 joinChannel 或 joinChannelEx 时设置 ChannelMediaOptions，明确媒体流发布和订阅行为，例如，是否发布摄像头采集或者屏幕共享的视频流，是否要主动订阅远端用户的音视频流。加入频道后，调用 updateChannelMediaOptions 随时更新 ChannelMediaOptions 中的设置，例如，切换发布的音视频源。
该版本优化了开启屏幕共享的逻辑，你可以根据实际场景选择不同的方式开启屏幕共享：
- 在加入频道前调用
startScreenCaptureByDisplayId，然后调用joinChannel[2/2] 加入频道并设置publishScreenTrack或publishSecondaryScreenTrack为true，即可开始屏幕共享。 - 在加入频道后调用
startScreenCaptureByDisplayId，然后调用updateChannelMediaOptions设置publishScreenTrack或publishSecondaryScreenTrack为true，即可开始屏幕共享。
该版本新增音视频流订阅黑/白名单功能，支持灵活订阅频道内发流用户的音视频流。你可以通过以下 API 来将指定用户的用户 ID 加入到相应的音视频黑白名单中，从而实现订阅/不订阅指定用户的音频或视频流。在多频道场景下，你可以通 IRtcEngineEx 类下的同名方法来实现该功能。
setSubscribeAudioBlocklist：设置音频订阅黑名单。setSubscribeAudioAllowlist：设置音频订阅白名单。setSubscribeVideoBlocklist：设置视频订阅黑名单。setSubscribeVideoAllowlist：设置视频订阅白名单。
如果某个用户同时在音频或视频订阅的黑、白名单中，只有黑名单会生效。
为方便用户灵活修改音频场景，该版本新增 setAudioScenario 方法，支持你根据业务需求设置音频场景。例如，如果你在频道内想将音频场景从自动场景 (AudioScenarioDefault) 切换为高音质场景 (AudioScenarioGameStreaming)，你可以调用该方法。
该本版新增 setLocalAccessPoint 方法，用于在成功部署声网混合云、私有化平台后，指定 Local Access Point 来设置本地代理。你可以联系 sales@shengwang.cn 了解和部署声网混合云或声网私有化平台。
该版本新增垫片推流功能，支持你在发流时使用本地 png 格式的图片来替代当前发布的视频流画面进行推流。你可以通过 enableVideoImageSource 来开启该功能，并通过 options 参数自定义垫片图片；在你关闭垫片功能之后，远端用户看到的依旧是当前你发布的视频流画面。
该版本新增本地合图功能，可支持在本地将多路视频流合并为一路视频流。常见场景如下：
在直播场景或使用旁路推流功能时，可以在本地将多个主播的画面合并为一个画面。
将本地采集的多路视频流（例如：摄像头采集的视频、屏幕共享流、视频文件、图片等）合并为一路视频流，然后在频道内发布已合图的视频流。
你可以调用 startLocalVideoTranscoder 方法开启本地合图、调用 stopLocalVideoTranscoder 方法停止本地合图；在开启本地合图后，可以调用 updateLocalTranscoderConfiguration 进行本地合图的配置更新。
视频采集设备可能支持多种视频格式，每一种格式都支持不同的视频帧宽度、视频帧高度、帧率组合。
该版本新增 numberOfCapabilities 和 getCapability 方法，用于获取视频采集设备支持的视频格式数量以及指定视频格式下的视频帧详细信息。在调用 startPrimaryCameraCapture 或 startSecondaryCameraCapture 方法使用摄像头采集视频时，你可以使用指定的视频格式进行采集。
SDK 会根据你在 VideoEncoderConfiguration 中的设置，自动选择选择视频采集设备的最佳视频格式进行采集。一般情况下，你不需要用到该组新增方法。
该版本通过 leaveChannel 和 joinChannel 切换频道即可实现和 v3.7.0 中 switchChannel 一样的切换速度，无需额外调用 switchChannel 方法。
该版本新增支持推送 I422 格式的外部视频帧，你可以通过 pushVideoFrame[1/2] 方法将 I422 格式的外部视频帧推送至 SDK。
该版本在 onAudioVolumeIndication 的 AudioVolumeInfo 中新增 voicePitch 参数。你可以通过 voicePitch 获取本地用户的人声音调，从而实现唱歌评分等业务功能。
该版本优化了 startPreview 方法的调用逻辑。如果你需要开启本地视频预览，你可以直接通过 startPreview 方法来开启视频预览，无调用时序要求。
你可以通过 setRemoteDefaultVideoStreamType 方法，根据你想要订阅的视频流分辨率和码率来灵活设置默认订阅视频流类型。