发版说明

  • Electron

更新时间

查看实时互动 RTC 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

该版本于 2026 年 3 月 5 日发布。

升级必看 (Electron)

该版本对部分功能的实现方式进行了优化,包括 SDK 的行为变更、API 的废弃及删除,为确保项目的正常运行,你需要在升级到该版本后更新 App 中的代码。

直推 CDN 相关接口废弃 (Electron)

该版本废弃直推 CDN 功能的相关接口,并会在后续版本中删除,请改用服务端旁路推流。

  • setDirectCdnStreamingAudioConfiguration
  • setDirectCdnStreamingVideoConfiguration
  • startDirectCdnStreaming
  • stopDirectCdnStreaming
  • DirectCdnStreamingMediaOptions
  • DirectCdnStreamingStats
  • DirectCdnStreamingState
  • DirectCdnStreamingReason

虚拟节拍器接口废弃 (Electron)

该版本废弃虚拟节拍器功能的相关接口,并会在后续版本中删除。

水印接口废弃 (Electron)

该版本废弃水印功能的相关接口,推荐使用该版本新增的水印接口。

冗余接口删除 (Electron)

该版本删除了下列冗余接口及参数:

  • setLocalPublishFallbackOption
  • onLocalPublishFallbackToAudioOnly
  • onDownlinkNetworkInfoUpdated
  • onWlAccStats
  • enableWirelessAccelerate

美妆功能实现变更 (Electron)

受该版本美颜重构的影响,自 v4.6.2 起,不再支持调用 setExtensionProperty 启用美妆功能,改用 STYLE_MAKEUP 节点实现。

新增域名白名单 (Electron)

如果你由之前的版本升级到 v4.6.2 且使用了域名白名单功能(RtcEngineConfig 下的 domainLimit 为 true),请在白名单中添加以下域名,以确保互通顺畅:

  • *.rtnsvc.com
  • *.realtimemesh.com

EncodedVideoFrameInfo 结构体删除参数 uid (Electron)

该版本删除了 EncodedVideoFrameInfo 结构体中的 uid 参数。你可以直接从 onEncodedVideoFrameReceived 回调中获取 uid 信息。如果你之前集成过相关代码,请相应更新集成逻辑。

新增特性 (Electron)

多路分辨率视频流 (Electron)

该版本新增多路分辨率视频流(Adaptive Bitrate Video Streaming,简称 ABR)功能,支持对同一视频源设置同时发送多路不同分辨率的视频流,并支持多频道场景。接收端通过自动/手动订阅目标分辨率的视频流。

启用 ABR 后,你可以配置不同分辨率的视频流(最多四层分辨率,即一个最高分辨率的主流和三层其他较低分辨率的视频流),并设置视频流的分辨率、码率、是否启用分层推流回退等选项来灵活控制流的发布。启用分层推流回退后,SDK 会在弱网环境下自动回退到低分辨率的视频流,确保流畅的观看体验。订阅端可根据实际需求选择想要接收的视频流。适用于会议场景、大班课、互动直播等多终端、多网络环境,可显著提升弱网下的观看体验。

多路径网络传输 (Electron)

该版本新增多路径传输功能,适用于终端支持多网卡传输(比如 5G、Wi-Fi、LAN)的设备,可以有效降低甚至消除弱网带来的体验回退,适用于弱网环境、对传输稳定性要求高的实时音视频通信场景,如车载、IoT、火车、高速公路等复杂网络环境。通过在 ChannelMediaOptions 中设置 enableMultipath 为 true,可开启多路径传输能力。支持两种传输模式(MultipathMode):

  • 动态模式:(默认)根据网络状况动态选择最佳路径进行传输,适用于流量敏感、对体验要求比较高的场景,如会议、教育等。动态模式下,你可以通过 preferMultipathType 指定首选的网络传输路径(如优先 Wi-Fi 或移动网络)。
  • 全冗余模式:数据会在所有可用网络路径上同时传输,适用于流量不敏感,对体验有极致要求的场景,如户外采播、平行操控等。该模式会产生额外费用,如需使用请联系技术支持。

上下行还可分别通过 ChannelMediaOptions 中的 uplinkMultipathMode、downlinkMultipathMode 配置。启用后,SDK 会通过回调 onMultipathStats 实时上报各路径的传输统计信息,包括每一个传输路径的流量消耗,便于开发者监控和优化网络表现。

视频质量评分 (Electron)

该版本在 RemoteVideoStats 中新增 mosValue 成员,报告声网实时视频 MOS(平均主观意见分)评估系统对接收到的远端视频流的质量评分。评分共有 5 个档次,5 分表示视频画质优秀,画面清晰无噪点,1 分表示视频画质极差,画面严重模糊。你可以通过该参数实时观测远端视频流的主观画质表现,便于动态调整视频参数、优化用户体验,或用于质量监控和告警等场景。如需启用该功能,请联系技术支持。

支持添加多个水印 (Electron)

该版本废弃了 addVideoWatermark 和 addVideoWatermarkEx 方法,新增 addVideoWatermarkWithConfig 和 addVideoWatermarkWithConfigEx 方法,支持通过水印 ID 来给视频添加多个水印,并可对水印进行排序。如果你需要移除指定水印,可调用 removeVideoWatermark 方法。

Token 更新结果回调 (Electron)

该版本新增 onRenewTokenResult 回调及 RenewTokenErrorCode 错误码。当调用 renewToken 方法更新 Token 后,SDK 会通过 onRenewTokenResult 回调通知 Token 更新的结果,并通过 RenewTokenErrorCode 返回详细的错误码,开发者可在回调中根据错误码及时处理 Token 更新失败的场景。

Media Player 支持获取音频缓冲延迟 (Electron)

为解决 K 歌场景中可能会出现的主唱与伴唱伴奏不同步的问题,该版本在 Media Player 模块中新增 getAudioBufferDelay 方法,用于获取播放媒体文件时毫秒级的音频缓冲延迟。

其他 (Electron)

  • 新增 setPlaybackAudioFrameBeforeMixingParameters 方法用于设置 onPlaybackAudioFrameBeforeMixing 回调中返回的音频帧格式,包括采样率、声道数以及每次回调的数据采样点数。调用此方法后,SDK 会按照设定的参数返回混音前的原始音频数据,便于开发者进行自定义处理或分析。
  • 新增 preloadEffectEx 方法,用于将指定音效文件预加载到指定频道,支持本地或在线音效文件,便于后续快速播放,适合多频道场景。
  • 新增 playEffectEx 方法,用于在指定频道播放音效文件,支持设置循环次数、音调、空间位置、音量、是否发布到频道及播放起始位置等参数,满足丰富的音效播放需求。
  • 本地截图上传功能支持通过 ContentInspectModule 中新增的 position 成员设置截图的视频观测位置,从而实现对原始视频数据或效果处理前后的视频流进行截图并上传。
  • 为了提升用户使用绿幕或蓝幕开启虚拟背景功能时,人像分割的准确性和稳定性,该版本在 SegmentationProperty 中新增 screenColorType 属性,支持指定背景幕布的颜色为绿色、蓝色或自动识别。

改进 (Electron)

美颜重构 (Electron)

该版本对美颜功能进行了彻底重构和升级,不仅拓展了美颜功能,提升了美颜效果和性能,还解决了美颜参数配置复杂、集成成本高、美颜资源依赖网络易失效等痛点。主要改进包括:

  • 新增美颜功能:新增白牙、去法令纹、去黑眼圈、亮眼等美肤功能;美妆特效新增卧蚕和面部高光;美型功能从 11 个增加到 29 个。
  • API 大幅简化:将过去版本中的基础美颜、美型、美妆、滤镜功能整合为 BEAUTY、STYLE_MAKEUP、FILTER 三个核心节点 (node),通过 IVideoEffectObject 统一管理生命周期和参数设置,减少频繁 API 调用带来的性能负担。
  • 预设模板开箱即用:提供多套预设风格模板(如"自然美颜"、"学姐妆"、"冷白滤镜"),大幅简化集成流程,无需手动调试数十项参数。
  • 美颜参数动态控制:该版本新增实时获取美颜参数的能力,开发者可通过 key-value 方式动态读取或修改任意细粒度参数(如磨皮强度、口红类型)。同时支持:调用预设模板快速启用风格效果、保存主播自定义参数配置、随时重置参数至默认状态,极大提升了业务层状态同步的灵活性和开发效率。
  • 美颜资源外置:该版本通过美颜资源外置化设计,将所有美颜资源(特效、滤镜、妆容)均打包为本地 bundle 文件,彻底消除因网络下载失败导致美颜失效的风险。

playEffect 支持无缝切换 (Electron)

该版本新增支持音效文件的无缝切换。对于同一个音效文件,如果先调用 preloadEffect 再调用 playEffect,在播放完成或通过 stopEffect 停止播放后,SDK 不会关闭该音效文件。当再次调用 playEffect 时,SDK 会直接复用已加载的文件进行播放,从而实现循环播放和无缝切换。该能力同样适用于多频道场景。

屏蔽窗口支持第二屏幕 (Electron)

在 4.6.2 之前的版本中,通过屏幕 ID(startScreenCaptureByDisplayId)进行屏幕共享时,不支持在多屏场景下配置屏蔽窗口(ScreenCaptureParameters 中的 excludeWindowList)。为提升屏幕共享体验,该版本新增支持该配置。

同时,为便于识别屏幕共享过程中屏蔽窗口的状态,该版本在 LocalVideoStreamReason 中新增 LocalVideoStreamReasonScreenCaptureExcludeWindowFailed,用于报告屏幕共享屏蔽窗口失败的情况。

onVideoDeviceStateChanged 回调时机优化 (Electron)

该版本优化了 onVideoDeviceStateChanged 回调的触发时机。在此前版本中,该回调仅在加入频道后才能触发。从 4.6.2 起,在 IRtcEngine 完成初始化后即可收到一次该回调,加入频道后仍可继续监听该事件。

onNetworkQuality 准确性提升 (Electron)

该版本提升了 onNetworkQuality 回调中网络质量评估的准确性,使回调数据更贴近用户的主观体验。

onPlaybackAudioFrame 支持 24k 采样率的音频帧 (Electron)

该版本在 onPlaybackAudioFrame 中新增支持采样率为 24000 Hz 的音频数据。在调用 setPlaybackAudioFrameParameters 设置播放音频数据格式时,可以将 sampleRate 设为 24000。

onEncodedVideoFrameReceived 回调支持获取频道 ID (Electron)

该版本在 onEncodedVideoFrameReceived 回调中新增 channelId 参数,方便你在获取编码后视频数据时识别其所属频道。

其他改进 (Electron)

  • 优化了在 Windows 11 24H2 及后续版本上的权限请求,避免非必要地获取位置信息。
  • 在与 Web 端互通时,新增对 g711 和 g722 音频编解码器的支持,进一步提升了跨平台音频播放的兼容性和清晰度。
  • 优化了屏幕共享文档场景下的共享视频清晰度。
  • 该版本新增错误码 ErrPcmSendFormat (200) 和 ErrPcmSendBufferOverflow (201),用于报告 PCM 数据发送相关错误。

问题修复 (Electron)

该合并版本修复了以下问题:

  • 开启导唱功能播放多音轨歌曲时,调用 setAudioPitch 方法调整歌曲音调后出现杂音。
  • 主播端调用 createCustomAudioTrack 创建自定义音频采集轨道并将 trackType 设为 AudioTrackDirect,调用 pushAudioFrame 将自采集音频推送到频道内,然后调用 playEffect 播放音效,频道内的观众听主播的音频有杂音。
  • 集成了 SDK 的 App 在音视频互动过程中偶现主线程阻塞导致的 UI 卡顿。
  • 开启屏幕共享功能并将 ScreenCaptureParameters 的 enableHighLight 设为 true 对共享窗口进行描边,将共享窗口置于最上层并最大化后,本地预览的共享画面出现闪烁。
  • 应用程序共享外接屏幕的视频流,断开外接屏幕连接后偶现应用程序崩溃。
  • 调用 openWithMediaSource 并通过 source 参数将 isLiveSource 设为 true 并播放纯视频流,播放失败。
  • 发送端传输多声道编码音频时,接收端偶现杂音。
  • App 集成媒体播放器场景下,先后两次调用 open 打开不同媒体资源,第二次打开时,媒体播放器信息变化回调 onPlayerInfoUpdated 返回第一次媒体资源的信息,不符合预期。
  • 调用 enableAudioVolumeIndication 启用用户音量提示本地发流用户和远端用户音量相关信息,用户音量提示回调 onAudioVolumeIndication 返回的本地用户音量为 0。
  • 使用 21:9 的显示屏(带鱼屏)进行音视频互通和屏幕共享场景下,设置高分辨率,如 3840*2160,屏幕共享画面在本地预览和接收端显示被裁剪。
  • App 调用 enableVideoImageSource 启用垫片推流功能,偶现发送端推流成功但是 onVideoPublishStateChanged 返回当前的发布状态不是 PublishStatePublished,不符合预期。
  • 多频道场景下,App 在调用 joinChannelEx 成功前调用 setupRemoteVideoEx 初始化远端用户视图,偶现远端用户视图首帧图像显示延时大。
  • 调用 open 打开在线音效文件后,调用 playEffect 开始播放,当调用 seek 指定播放位置后,音效文件会从头开始播放。
  • 在媒体音量模式下,主播在频道中发布麦克风采集的音频流,同时调用 playEffect 播放音效文件、调用 startAudioMixing 播放音乐文件,偶现回声。
  • 调用 joinChannelEx 加入频道,然后调用 startOrUpdateChannelMediaRelay 开始跨频道媒体流转发,下麦、退出频道后重新加入频道开始连麦,偶现 onChannelMediaRelayStateChanged 回调报告 state 为 RelayStateFailure,code 为 RelayErrorServerErrorResponse。
  • 部分机型的笔记本电脑开启节能模式下,发送端共享屏幕和音频,偶现接收端听到回声。
  • 在线教育场景下,偶现教师端本地看多个学生端音画不同步。
  • 第二次调用 enumerateVideoDevices 接口获取设备列表不生效。
  • Windows 7 设备上共享 PPT 窗口,当 PPT 以全屏自动播放模式运行且包含大量动画时,远端看到的画面有概率出现闪烁。

已知问题和局限性 (Electron for 统信 OS)

系统兼容性说明

统信 OS 版本基于标准 Electron SDK 进行适配和优化,专门针对国产操作系统和芯片架构进行了兼容性验证。

该版本于 2025 年 9 月 29 日发布,基于 RTC Native v4.5.1 开发。

系统兼容性 (Electron for 统信 OS)

  • 支持的芯片架构:海光 C86,兼容 x86-64 架构,支持海光系列处理器
  • 支持的操作系统:统信 OS,统信桌面操作系统 V20 及以上版本

功能特性 (Electron for 统信 OS)

音视频通话 (Electron for 统信 OS)

  • 支持一对一音视频通话(1v1)
  • 支持一对多音视频通话(1vN)
  • 支持多人音视频会议(NvN)

视频能力 (Electron for 统信 OS)

  • 屏幕共享:支持全屏共享、窗口共享、区域共享
  • 基础美颜:支持磨皮、美白等基础美颜功能

音频能力 (Electron for 统信 OS)

  • 基础降噪:支持环境噪音抑制
  • 回声消除:支持声学回声消除 (AEC)

基础能力 (Electron for 统信 OS)

  • 网络检测:支持网络质量检测和上报
  • 设备检测:支持音视频设备枚举和状态检测

SDK 下载 (Electron for 统信 OS)

前往下载页获取 SDK。