发布日志

3.25.0 版本

发布日期：2026-10-22

新增功能

1. 支持媒体数据推流

   支持通过指定推流通道发布本地媒体文件（mp4 / m4a / aac，需专用工具转换），适用于 AI 课堂等服务端拉流场景。

   注意

   需在创建引擎前设置引擎高级配置 ext_capture_and_inner_render=true（外部采集 + 内部渲染），并在开始推流前创建媒体数据推流器。

   相关 API 请参考： createMediaDataPublisher、 destroyMediaDataPublisher、 ZegoMediaDataPublisher、 ZegoMediaDataPublisherConfig、 ZegoMediaDataPublisherMode、 onMediaDataPublisherFileOpen、 onMediaDataPublisherFileClose、 onMediaDataPublisherFileDataBegin、 onMediaDataPublisherFileDataEnd

2. 支持通过监听音频数据回调获取原始 PCM 音频数据

   调用 startAudioDataObserver 并通过 ZegoAudioDataCallbackBitMask 按需开启回调，调用 stopAudioDataObserver 关闭。音频帧以 ArrayBuffer 形式回调，采样率与声道由 ZegoAudioFrameParam 指定。

   注意

   onPlayerAudioData 需处于拉流状态才会回调，且该回调不支持 8000 / 22050 / 24000 Hz 采样率。

   相关 API 请参考： startAudioDataObserver、 stopAudioDataObserver、ZegoAudioFrameParam、ZegoAudioDataCallbackBitMask、 onCapturedAudioData、 onPlaybackAudioData、 onMixedAudioData、 onPlayerAudioData

3. 支持带 VAD（人声检测）的声浪信息回调

   在 startSoundLevelMonitor 中将 ZegoSoundLevelConfig.enableVAD 设为 true 后，可获取携带 VAD 状态的本地与远端声浪信息。

   相关 API 请参考： startSoundLevelMonitor

改进优化

1. 优化接口参数类型校验

   SDK 接口可选参数支持不传或传 null、undefined；参数类型不匹配时将返回明确的错误提示，便于快速定位问题。

2. 提升回调稳定性

   回调中未捕获的内部异常将被捕获并记录日志，避免内部异常导致应用崩溃。

3. 提升 SDK 稳定性，并升级底层音视频引擎

问题修复

1. 修复 onRemoteSoundLevelInfoUpdate 回调声浪信息数据结构错误的问题，现与 onRemoteSoundLevelUpdate 保持一致。

2. 修复 onPlayerRecvSEI 和 onPlayerSyncRecvSEI 回调中可能出现的数据错乱或崩溃问题。

3. 修复 startNetworkSpeedTest 解析 expectedDownlinkBitrate 配置错误，导致测速失败的问题。

4. 修复使用纹理渲染功能概率崩溃的问题。

5. 修复 ZegoAudioEffectPlayer.loadResource 未返回实际错误码的问题。

3.23.0 版本

发布日期：2026-02-10

新增功能

1. 新增性能监控接口 startPerformanceMonitor。

改进优化

1. 改进设备类型查询机制，提升信息获取的准确性
2. 优化视频预览场景下旋转角度的处理逻辑
3. 优化水印图片加载流程，提升加载效率
4. 优化音频播放采样率配置，改善音频渲染的质量
5. 优化折叠屏设备摄像头切换流程，提升切换的稳定性

问题修复

1. 修复硬解码场景下偶现黑屏的问题
2. 修复音频回调可能导致崩溃的问题
3. 修复设置视频渲染控件时可能导致崩溃的问题

3.22.1 版本

发布日期：2025-10-28

改进优化

优化更新拉流视图的过程。

问题修复

修复已知问题。

3.21.1 版本

发布日期：2025-08-06

改进优化

1. 更新 SDK 命名并同步上线至 OpenHarmony 仓库

   更新了 SDK 命名，新版本集成 SDK 的流程有所变化，详细请参考 集成 SDK。

3.21.0 版本

发布日期：2025-08-01

新增功能

1. 新增 license 鉴权功能

   相关 API 请参考：setLicense

2. 新增地理围栏功能

   相关 API 请参考：setGeoFence

3. 新增自定义预览截图功能

   相关 API 请参考：takePublishStreamSnapshotByConfig

4. 新增 3 种混响音效，分别为：HipHop、Misty、ThreeDimensionalVoice

   相关 API 请参考：HipHop、 Misty、 ThreeDimensionalVoice

5. 支持在 Native 层处理自定义音视频数据

6. 支持设置推流视频源

   相关 API 请参考：setVideoSource

7. 支持设置或切换不同的回声消除模式

   相关 API 请参考：SetAECMode

8. 支持设置或切换不同的噪声抑制模式

   相关 API 请参考：SetANSMode

问题修复

1. 修复若干已知问题

1.2.0 版本

发布日期：2024-11-07

新增功能

1. 适配 HarmonyOS 发布版本

   该版本适配了 HarmonyOS 5.0.0 Release，对应 API 版本为 API 12 Release。接入过程可能会遇到系统特性导致的问题，详情请参考 已知问题及解决方案。

2. 新增 KTV 模块

   支持 KTV 点歌、版权内容中心曲库等能力。支持的版权音乐厂商包括音速达、音集协、网易。

3. 新增游戏语音模块

   主要包括：

   • 范围语音：房间内的收听者对音频的接收距离有范围限制，若发声者与自己的距离超过该范围，则无法听到声音。
   • 3D 音效：声音有 3D 空间感，且按距离衰减。
   • 小队语音：玩家可以选择加入小队，并支持在房间内自由切换“全世界”、“仅小队”、“隐秘小队”语音模式，不同模式下所能通话的范围不同。

   相关 API 请参考：createRangeAudio、ZegoRangeAudio

4. 使用 HarmonyOS 系统的折叠屏手机，支持多摄像头自动选择功能

5. 视频编码格式支持使用 VP8 编码

问题修复

1. 修复已知问题

1.1.1 版本

发布日期：2024-08-27

问题修复

1. 修复已知问题

1.1.0 版本

发布日期：2024-08-15

新增功能

补齐主要能力，包括：

• 通信能力：使用 Token 鉴权、通话质量监测。
• 音频能力：自定义音频处理、自定义音频采集与渲染、变声/混响/立体声。
• 视频能力：视频采集旋转、硬件编解码。
• 其他能力：音视频录制、音效文件播放器。

1.0.0 版本

发布日期：2024-04-29

新增功能

首次发布，支持登录房间、推流、拉流等实时音视频基础功能。