发布日志

3.21.0 版本

发布日期： 2025-07-29

新增功能

1. Windows 新增在窗口采集时选择是否采集音频

   在窗口采集时，可以设置是否采集音频以满足不同场景下的需求。

   相关 API 请参考 enableAudioCapture

改进优化

1. 更新集成 Express Native SDK 至 3.21.0 版本

问题修复

1. 修复媒体播放器 loadResource 时展示首页的问题
2. 修复拉流时可能出现花屏的问题

3.20.2 版本

发布日期： 2025-04-08

改进优化

更新集成 Express Native SDK 至 3.20.2 版本。

3.18.1 版本

发布日期： 2024-12-17

改进优化

更新集成 Express Native SDK 至 3.18.1 版本。

3.18.0 版本

发布日期： 2024-12-05

改进优化

更新集成 Express Native SDK 至 3.18.0 版本。

3.12.4 版本

发布日期： 2024-01-18

改进优化

1. 更新 iOS SDK 内的隐私清单文件PrivacyInfo.xcprivacy

   注意：如客户集成的是 3.13.2 版本之前的 SDK，如想发布到 App Store，需下载最新版本的 SDK，并拷贝 PrivacyInfo.xcprivacy 文件到旧版 SDK 相应位置。

   请将 iOS SDK 内的隐私清单文件 PrivacyInfo.xcprivacy 升级到新版本，详情请参考 SDK 包内的 “ZegoExpressEngine.framework” 文件夹下的“PrivacyInfo.xcprivacy”。

问题修复

1. 修复切换网络时，如果网络异常，极低概率下会出现 UI 卡顿的问题

3.12.3 版本

发布日期： 2024-01-08

新增功能

1. 支持版权音乐插件

   注意：

2. 如需使用该功能，请联系 ZEGO 技术支持。

3. 版权音乐插件包无法单独使用，必须与 Express SDK 搭配使用。

   支持版权音乐功能插件化，当开发者的业务场景仅需更新版权音乐相关的代码时，可以单独集成插件包，无需更新 Express SDK，即可平滑迁移。

4. 支持对转推到 CDN 的音视频流补静音帧

   注意：如需使用该功能，请联系 ZEGO 技术支持。

   支持对转推到 CDN 的音视频流补静音帧，可以用于避免因时间戳不同步、造成的卡顿或音画不同步等问题发生。

5. 媒体播放器支持在本地缓存网络资源

   支持在本地缓存网络资源，如果需要播放同一个网络资源时，将优先使用缓存数据，提升用户体验。

   相关 API 请参考 enableLocalCache、onMediaPlayerLocalCache

6. 所有网络请求支持 IPv6 协议

7. 支持 MJPEG 格式的硬件解码加速

   注意：该功能仅支持截图的前处理，不支持其他处理（如旋转、水印等）。

   当采集设备输出的视频格式为 MJPEG 时，默认开启硬件解码加速能力，防止出现因设备性能不足而导致的帧率不足等问题。

   该功能主要适用于在 4K 分辨率的采集设备上使用。

8. 媒体播放器支持回调视频分辨率改变事件

   媒体播放器支持在检测到视频分辨率发生变化时，抛出相关回调通知开发者。该功能适用于推流画面的分辨率存在多次变更，需要调整推流端编码分辨率、拉流端渲染视图大小进行匹配的场景中。

   相关 API 请参考 onMediaPlayerVideoSizeChanged

改进优化

1. 优化服务端混流及单流转码能力

   优化服务端混流及单流转码能力，提高编码效率，同等码率下提升 5% 以上的主客观画质。

2. 优化 AEC（回声消除）算法，实现更好的 AEC 效果

3. 优化网络连接策略，提升音视频通话体验

4. 优化多端登录逻辑

   用户在 A 设备上登录成功后，A 设备断网；然后使用同一 userID 在 B 设备上登录成功。此时如果 A 设备网络恢复，重连会失败，并抛出 1002086 错误码，提示该 userID 已在其他设备登录。

问题修复

1. 修复 Windows 平台上某些情况下 N 卡硬解退出时产生崩溃的问题

2. 修复 Windows 平台上摄像头异常时的重启策略问题

3. 修复 Windows 或 macOS 系统休眠时，SDK 收不到网络状态变化通知，导致网络类型判断不准确的问题

3.10.1 版本

发布日期： 2023-11-10

新增功能

1. 媒体播放器支持伴奏音质增强

   媒体播放器支持伴奏音质增强，提升伴奏的音质以及现场的氛围感，适用于语聊房、K 歌等场景中。

   相关 API 请参考 enableLiveAudioEffect

问题修复

1. 修复开启低照度增强后出现黑屏的问题

3.9.0 版本

发布日期： 2023-09-22

新增功能

1. 支持分割和传输视频画面中的主体

   注意：如需使用该功能，请联系 ZEGO 技术支持。

   新增主体分割功能。通过 AI 算法，将视频画面中的主体（多数情况下主体是人）从背景中分离出来，返回带透明通道的数据给 SDK 做编码处理。实现只传输视频中的主体而非原始矩形视频的效果。

   当前仅支持通过内部采集的方式使用该能力，详情请参考 主体分割。

2. 媒体播放器支持获取媒体流视频信息

   针对媒体播放器正在播放的视频文件，开发者可以主动获取视频的分辨率、帧率等信息。

   相关 API 请参考 getMediaInfo

改进优化

1. 优化 SDK 兼容性，支持 Electron 13 及以上版本的热更新

   注意：该优化不能和非 Context-Aware 类型的插件一起使用，例如 zego-express-engine-electron-plugin-screen-capture。

问题修复

1. 修复 macOS 应用上架异常的问题

3.8.1 版本

发布日期： 2023-08-17

新增功能

1. Windows 支持指定显卡硬编，支持硬编硬解的纹理输入输出

   Windows 支持指定显卡硬编，支持硬编硬解的纹理输入输出，提升了 Windows 平台硬件编解码的效率，端到端时延降低了 15 ms ~ 100 ms（具体优化效果与使用的显卡相关），该功能可用于远程控制等低延迟场景中。

2. 屏幕采集功能支持获取采集源为“窗口”时的矩形区域

   屏幕采集功能新增接口 getCaptureSourceRect，用于获取采集源为“窗口”时的矩形区域。

   相关 API 请参考 getCaptureSourceRect

改进优化

1. 优化低照度增强算法的噪点表现

2. 优化媒体播放器加载资源的 URL 长度，最大支持 2048 字节

3. 优化媒体播放器 SEI 信息与相应帧数据的回调同步，保证 SEI 和画面的一致性

问题修复

1. 修复推流时出现水印崩溃的问题

2. 修复使用 Token 鉴权时，在 [createEngine] 之后、[destroyEngine] 之前变更了 userID，可能导致推拉流失败的问题

3.7.0 版本

发布日期：2023-07-17

改进优化

1. 优化 SDK 内部逻辑，减少 400KB ~ 600KB 的内存占用

2. 优化 SDK 视频采集策略，提升画质

3. 在断网导致的推拉流重试状态中，支持回调本地网络质量

   相关 API 请参考 onNetworkQuality

4. 优化 SDK 的内部逻辑，提升弱网环境下的通话体验

问题修复

1. 修复 MediaRecorder、AudioObserver 停止推流后，未恢复本地推流，继续采集的问题

2. 修复 NetMonitor 模块多线程死锁的问题

3. 修复 isVideoDecoderSupported 接口返回值类型错误的问题

4. 修复 onNetworkSpeedTestQualityUpdate 回调中网络测速质量参数 quality 接收不到数据的问题

5. 修复影响 Electron 应用上架 AppStore 的问题

3.6.0 版本

发布日期：2023-06-20

新增功能

1. 新增地理围栏功能

   注意：

2. 如需使用该功能，请联系 ZEGO 技术支持。

3. 请在创建引擎之前，配置地理围栏信息。

   将音视频及信令数据访问限定在某一区域，用以满足地区数据隐私安全相关法规，即限定用户访问某一特定区域的音视频服务，详情请参考 地理围栏。

   相关 API 请参考 setGeoFence

4. 外部采集支持主动偏移 NTP 时间戳

   注意：如需使用该功能，请联系 ZEGO 技术支持。

   使用外部采集功能时，支持通过实验性 API 接口主动偏移 NTP 时间戳。该功能可用于 KTV 的合唱、伴奏、歌词对齐等场景。

5. 新增音视频推流的首帧回调

   在进行音视频推流时，通过 onPublisherSendAudioFirstFrame、onPublisherSendVideoFirstFrame 回调，监听“首帧音频”或“首帧视频”的发布时机。该功能可用于统计音视频推流的耗时、或更新 UI 表现等。

6. 多房间模式下支持快速切换房间

   多房间模式下，支持通过 switchRoom 接口，快速便捷地实现切换房间的功能。

7. 支持同时停止或恢复所有拉取的音频流

   新增 muteAllPlayStreamAudio 接口，当开发者需要快速关闭、或恢复远端音频时，可调用此接口，同时停止或恢复所有正在拉取的音频流。相比于重新拉流，通过该功能可以极大降低耗时，提升互动体验。

8. 媒体播放器支持播放音乐时获取声浪和频谱

   媒体播放器新增声浪频谱回调和开关接口，可以控制是否开启回调以及回调的频率，从而获取媒体播放器当前的声浪和频谱。在通过媒体播放器播放资源，如一起看电影、游戏语聊房场景时，通过该功能可以做频谱动画的功能，增加趣味性。

   创建媒体播放器后，调用 enableSoundLevelMonitor 接口可以开启声浪监听，开启后可以通过 onMediaPlayerSoundLevelUpdate 回调监听声浪的变化。

   创建媒体播放器后，调用 enableFrequencySpectrumMonitor 接口可以开启频谱监听，开启后可以通过 onMediaPlayerFrequencySpectrumUpdate 回调监听频谱的变化。

问题修复

1. 修复媒体播放器在部分 m3u8 文件格式中，不能通过 seekTo 接口使播放进度跳转到 0 的问题

2. 修复重新推流后，拉流端视频卡顿的偶现问题

3. 修复使用媒体播放器时可能会导致内存泄露的问题

3.4.2 版本

发布日期：2023.04.26

新增功能

1. 支持多源采集能力

   面向在线 KTV、一起看电影、看比赛等、视频会议、在线教育等音视频源丰富多样的互动场景，多源采集提供了灵活易用的音视频采集源与通道管理能力，大量减少开发者的开发及维护成本。

   多源采集能力对屏幕共享、混音等常见能力的实现路径，进行缩短优化及归一化设计，从 3.4.2 版本后，您可以不用再通过自定义采集实现上述复杂的能力，详情请参考 多源采集文档。

   主要能力特性如下：

   • 推流通道支持设置或切换多种音视频源。
   • 支持屏幕共享、混音等常见能力。

2. Express Electron SDK 支持 Linux 平台

   注意：如需使用该功能，请联系 ZEGO 技术支持。

问题修复

1. 修复游戏语音在某些情况下收听异常的问题

2. 修复 macOS 平台屏幕共享实际采集帧率小于设置的帧率的问题

3.3.0 版本

发布日期：2023.03.17

改进优化

1. 优化 SDK 采集渲染逻辑，提升了渲染性能。

2. SDK 支持适配到 Electron 23.0.0 版本，同时解决了 Electron 12.x.x 版本渲染相关的问题。

问题修复

1. 修复少数情况下出现的连麦崩溃的问题

3.2.0 版本

发布日期：2023.02.02

改进优化

1. 摄像头数据插件功能扩展

   摄像头数据插件功能，支持获取前处理后的数据。

   相关 API 请参考 getCameraVideoDataCapturePlugin，enableCustomVideoProcessing，registerCustomVideoProcessPlugin

2. 流控开启接口支持设置指定通道

   相关 API 请参考 enableTrafficControl

3. 自定义信令配置支持扩展到 4KB

   注意：自定义信令配置默认大小为 1KB，如需扩展到 4KB，请联系 ZEGO 技术支持进行处理。

问题修复

1. 修复网络时间模块重试失败的问题

2. 修复特定场景下可能导致崩溃的问题

3.1.1 版本

发布日期：2022.12.22

新增功能

1. 新增流媒体加密功能

   支持使用 AES-128/192/256 对流媒体数据加密。

   相关 API 请参考 setPublishStreamEncryptionKey, setPlayStreamDecryptionKey

2. 新增设置拉流优先级权重的功能

   支持设置拉流优先级的权重。当开发者业务上，需要对某流优先保证质量时，可使用此接口。

   当开发者业务上，需要对某流优先保证质量时，可使用此接口。例如：上课场景，学生拉多路流，则可设置老师流高优先级。

   相关 API 请参考 setPlayStreamFocusOn

3. 支持设置视频帧率和视频分辨率的最小值

   新增 setMinVideoFpsForTrafficControl 和 setMinVideoResolutionForTrafficControl 接口，可以用于用户网络不佳且开启了流量控制时，通过调用接口设置最低视频帧率及分辨率，帮助用户综合控制视频的显示效果。

4. 支持设置 H.265 编码自动降级

   使用 H.265 编码方式推流时，支持在异常情况下 H.265 编码自动降级到 H.264 编码：

   • 开启自动降级后，当不支持 H.265 编码或编码 H.265 失败时，SDK 内部会尝试降级使用 H.264 编码进行推流。
   • 关闭自动降级后，当不支持 H.265 编码或编码 H.265 失败时，直接推流失败。

   例如：在多人连麦直播、秀场直播场景下，使用 H.265 编码推流，达到不降低画质的情况下节省 CDN 流量的目的。

   相关 API 请参考 enableH265EncodeFallback

5. 支持获取当前设备指定视频编解码器的编解码能力支持情况

   SDK 支持获取当前设备指定视频编解码器的编解码模式的支持情况，从而更好的帮助开发者选择使用的编码器及编码模式并获得更好的效果。

   • 通过 isVideoEncoderSupported 接口，可获取当前编码器的硬件或软件编码支持情况。
   • 通过 isVideoDecoderSupported 接口，可获取当前解码器的硬件或软件解码支持情况。

   以上两个接口均包含三个枚举值：支持硬件或软件，支持硬件，支持软件。

6. 支持设置低照度增强

   注意：应在调用 createEngine 接口创建引擎后，再调用 setLowlightEnhancement 接口。

   当推流端用户周围环境较暗、或摄像头设置的帧率较高，导致直播画面比较暗，无法正常显示或识别主体的情况下，可调用 setLowlightEnhancement 接口，设置低照度增强，提升视频画面亮度。低照度增强功能包含三种模式：1：不开启低照度增强（默认）、2：开启低照度增强 、3：自动开关低照度增强。

   开发者可以根据业务场景选择不同的低照度增强模式：当希望自行判断是否需要进行低照度增强时，可以通过切模式 1 和 2 来控制；当希望 SDK 自动增强时，可以使用模式 3 ，SDK 将自动判断用户所处的光照环境，开启或关闭低照度增强。

7. 支持对音频设备音量进行监控

   可以监控音频输入/输出设备的音量。

   相关 API 请参考 startAudioDeviceVolumeMonitor, stopAudioDeviceVolumeMonitor

8. 支持对音频设备静音

   可根据需要对音频输入/输出设备静音。

   相关 API 请参考 muteAudioDevice

9. 支持把引擎播放的声音混到推流中

   该功能支持用户将 SDK 播放的声音混入推流中。例如：在直播上课时，老师与学生连麦，老师可以将拉流声音混入推流中。

   相关 API 请参考 enableMixEnginePlayout

10. 支持稳态语音检测

    支持检测语音的稳态状况。例如：指定采集后类型而且使用麦克风采集时，可以通过此接口检测主播是否有持续稳定的语音输入。

    相关 API 请参考 startAudioVADStableStateMonitor, stopAudioVADStableStateMonitor

11. 新增混流输入参数

    新增混流输入参数，支持设置输入流的音量 volume、文本水印 label 等参数。

    相关 API 请参考 ZegoMixerInput

12. 新增设备音量变更、语音状态变化事件的回调接口

    新增回调接口：

    • onAudioDeviceVolumeChanged：接收音频设备音量变更事件的回调。调用 startAudioDeviceVolumeMonitor 开启音频设备的音量监控后，如果音量发生变化，会触发此回调。

    • onAudioVADStateUpdate：检测音频数据的稳态语音状态的回调。调用 startAudioVADStableStateMonitor 启动语音状态检测，且处于正在推流的状态或预览预览状态，会触发此回调。

3.1.0 版本

发布日期：2022.12.12

改进优化

1. 对渲染逻辑上进行了内部优化，一定程度上提升了渲染性能

2. 大幅度提升极端弱网地区的音视频连通率，并降低连通耗时

   ZEGO 自研调度系统针对网络质量极差地区进行了深度优化。

问题修复

1. 修复特定场景下 SDK 出现 UI 线程卡住的问题

2. 修复发送房间 [Logout] 信令可能失败的问题

3. 修复视频外部采集在内存模式下，偶现的访问野指针崩溃的问题

3.0.3 版本

发布日期：2022.11.28

问题修复

1. 修复多房间模式下，停止推流时，房间内其他人收不到流删除通知的问题

2. 修复使用自定义视频前处理时，调用 destroyEngine 接口可能导致 UI 卡住的问题

3.0.1 版本

发布日期：2022.11.04

新增功能

1. 新增浑厚、低沉等十种音效预设值。

   setVoiceChangerPreset 接口的 preset 参数新增浑厚、低层等十种音效预设值。

2. 新增自定义视频采集推流的图像填充模式

   新增 setCustomVideoCaptureFillMode 接口支持设置自定义视频采集推流的图像填充模式

3. 新增 registerCustomAudioProcessPlugin 、unregisterCustomAudioProcessPlugin 接口用于设置音频数据插件

   媒体播放器新增 registerCustomAudioProcessPlugin 、unregisterCustomAudioProcessPlugin 接口用于设置音频数据插件，主要用于获取媒体播放器音频数据。

4. 支持设置 SDK 数据缓存目录

   支持通过 setEngineConfig 接口的 advancedConfig 参数中的 data_cache_dir 字段，设置 SDK 数据缓存目录。

改进优化

注意：升级到 3.0.1 版本 SDK 时，同时若有使用到屏幕采集插件 SDK zego-express-engine-electron-plugin-screen-capture ，请务必更新到最新版本 0.3.0-114，进行搭配使用。

1. 优化了自定义视频采集的流畅度。

问题修复

1. 修复媒体播放器在某些特殊场景下崩溃的问题

2. 修复某些特殊 macOS 系统上，收不到音频首帧回调的问题

3. 修复自定义视频采集在某些异常场景下崩溃的问题

废弃删除

1. 废弃了 [ZegoScenario] 的三种旧版本场景 废弃 [ZegoScenario] 场景枚举中的 [General]，[Communication]， [Live] 三种场景，详情请参考 场景化音视频配置 文档。

2. 删除了 [setDebugVerbose]、[setPlayStreamVideoLayer]、[loginMultiRoom] 等接口，详情请参考 3.0.0 及以上版本升级指南。

3. 删除 [onDeviceError] 回调接口。

2.23.0 版本

发布日期：2022.09.13

新增功能

1. 新增获取摄像头数据插件功能

   支持获取摄像头数据插件，主要用于通过 Node.js 插件获取摄像头数据的场景。

   相关 API 请参考 getCameraVideoDataCapturePlugin

2. 混流视频新增部分输出参数

   支持配置混流视频输出的相关参数，开发者可设置视频混流相关配置。

   相关 API 请参考 startMixerTask

3. 支持推流指定 NTP 校准

   用于开发者在指定推流过程中进行 NTP 校准，主要用于混流场景下的流对齐。

   相关 API 请参考 startPublishingStream

2.22.0 版本

发布日期：2022.08.10

新增功能

1. 新增音效播放器功能

   音效是指为了增强真实感或者烘托场景氛围播放的简短效果音，例如，在直播期间播放掌声、礼物音效、提示音等；在游戏中，播放子弹声、碰撞打击声。

   音效播放器支持音效播放（可以多音效重叠播放）、播放控制（如暂停播放、音量调节、设置播放进度）、预加载音效等功能。

   相关 API 请参考 createAudioEffectPlayer, destroyAudioEffectPlayer

2. 新增接口 isFeatureSupported 接口，支持查询 SDK 支持的功能特性

   由于 SDK 支持特性裁包功能，部分特性可能已被裁剪，现提供 isFeatureSupported 接口，用于查询 SDK 是否支持指定的功能特性，例如，查询是否支持媒体播放器功能。

   相关 API 请参考 isFeatureSupported

3. 支持使用 logoutRoom 接口退出所有房间

   在用户使用多房间的场景下，可以调用一次 logoutRoom 接口，退出所有已登录的房间。

   相关 API 请参考 logoutRoom

2.21.2 版本

发布日期：2022.07.26

改进优化

1. 版权音乐相关接口回调方式优化

   优化版权音乐相关接口的回调方式，可降低开发者调用接口的复杂度，SDK 通过 Promise 将回调结果返回给调用者。

   相关 API 请参考 initCopyrightedMusic，sendExtendedRequest，getLrcLyric，getKrcLyricByToken，requestSong，requestAccompaniment，requestAccompanimentClip，download，getStandardPitch，loadCopyrightedMusicResourceWithPosition，loadResourceWithPosition

2.21.1 版本

发布日期：2022.07.15

问题修复

1. 修复纯音频场景发送 SEI 失败的问题

2.21.0 版本

发布日期：2022-07-12

新增功能

1. 新增版权音乐功能

   注意：如需使用该功能，请联系 ZEGO 技术支持。

   支持通过版权音乐功能，获取版权歌曲或伴奏资源，并结合媒体播放器进行本地播放控制。可以用于在线 KTV 、语聊房等合唱或使用背景音乐的场景。

2. 新增自定义音频功能

   注意：如需使用自定义音频采集功能，需要根据 SDK 提供的插件模板进行采集插件开发，再将采集插件通过 registerCustomAudioCapturePlugin 注册到 SDK。

   • 客户需要从现有音频流、音频文件、或者定制的采集系统中获得采集后输入，交给 SDK 传输。
   • 客户有自己对 PCM 输入源做特殊的音效处理的需求，在音效处理后输入，交给 SDK 传输。

   相关 API 请参考 enableCustomAudioIO，registerCustomAudioCapturePlugin，unregisterCustomAudioCapturePlugin

3. 支持设置声卡采集的音量

   用户可通过 SetMixSystemPlayoutVolume 调整系统声卡采集的音量大小。

   相关 API 请参考 SetMixSystemPlayoutVolume

4. 支持获取同步网络时间信息

   在进行多端行为同步时，可通过 getNetworkTimeInfo 获取同步网络时间，对当前时间进行校准。

   相关 API 请参考 getNetworkTimeInfo

5. 支持开启混流精准对齐功能

   常用于 KTV 等需要混流对齐的场景。

   相关 API 请参考 setStreamAlignmentProperty

问题修复

1. 修复了自定义视频采集内存泄露的问题。
2. 修复了媒体播放器 crash 的问题。
3. 修复了当视频源宽高比例发生变化时，使用 canvas2d 渲染出现上一帧残留的问题。

2.19.0 版本

发布日期：2022-05-13

新增功能

1. 支持设置所有拉流音量

   Express-Video SDK 新增 [setAllPlayStreamVolume] 接口，用于设置所有拉流的音量大小。即本端用户可以控制所有音频流的播放音量。

   相关 API 请参考 setAllPlayStreamVolume

问题修复

1. Express-Video SDK 修复了 onAudioDeviceStateChanged 回调接口参数错误的问题。