ZEGO 即构实时音视频 SDK - 更新日志

3.21.0（2025-07-02）

新增功能

  1. 媒体播放器新增清理最后一帧的能力，mediaPlayer-> clearView

3.17.4（2025-01-09）

新增功能

添加 [setAudioDeviceMode] 接口，用于设置音频设备模式。

3.17.3（2024-12-02）

新增功能

1. 新增屏幕共享功能

iOS 屏幕共享分为应用内共享与跨应用共享，分别用于当前应用分享与系统级别的应用分享。如使用跨应用共享，需要在 iOS 原生工程新建 Broadcast Upload Extension 进程用于录制屏幕。 Android 为更符合隐私规范，需开发者主动声明屏幕共享权限：

  • 如果目标 Android SDK 版本低于 34.0.0 版本，需设置 `FOREGROUND_SERVICE`` 权限声明。
  • 如果目标 Android SDK 版本是 34.0.0 及以后版本，需要设置 FOREGROUND_SERVICE 及 FOREGROUND_SERVICE_MEDIA_PROJECTION 权限声明。 详情请参考 屏幕共享 文档。

相关 API 请参考 startScreenCapture、stopScreenCapture、updateScreenCaptureConfig、mobileScreenCaptureExceptionOccurred，mobileScreenCaptureStart

2. 媒体播放器新增设置视图模式

新增 ZegoViewMode 参数，用于设置媒体播放器的视图模式，详情请参考 媒体播放器 文档。

改进优化

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

3.16.5（2024-11-12）

修复开始/停止本地录制接口调用异常

3.16.4（2024-09-30）

  1. 新增媒体播放器新增设置视图模式
  2. 修复停止本地声浪 [stopSoundLevelMonitor] 接口在Android上调用不生效

3.16.3（2024-09-19）

问题修复

  1. 修复远端音量通知事件回调数据结构

3.16.2（2024-08-23）

问题修复

1.修复 Android 特定场景摄像头无法打开的问题 2.修复 Android 某些机型屏幕录制时，应用杀死后不会自动停止录屏权限的问题 3.修复 iOS 频繁推流/停止推流偶现崩溃问题

3.16.0（2024-08-05）

新增功能

  1. [loginRoom] 与 [logoutRoom] 接口完善 promise 能力，登录和登出会异步返回相应的结果
  2. 升级 native sdk 到 3.16.0

3.15.1（2024-06-17）

新增功能

  1. 适配 vue3 框架；
  2. 新增 [roomStateChanged] 回调，监听房间状态变更；
  3. 新增 [setStreamExtraInfo] 接口，设置流附加消息；

3.14.5（2024-05-10）

1. 支持 iOS 17.0 版本

注意：从该版本起，不再支持 iOS 11.0 及之前的版本。

从 2024-04-29 开始，所有上架 App Store 的应用必须支持 iOS 17.0 版本，详情请参考 Apple 开发者网站官方说明。

3.10.2（2023-11-24）

问题修复

  1. 修复移动端休眠检测模块误报，影响到房间重登录、推拉流重试逻辑的问题

3.10.1（2023-11-12）

问题修复

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

3.9.0（2023-09-20）

1. 新增本地媒体录制功能。

开发者可将音视频流录制成本地文件，用于以后回放等用途。

相关 API 请参考 startRecordingCapturedData, stopRecordingCapturedData，capturedDataRecordStateUpdate，capturedDataRecordProgressUpdate

3.6.0（2023-06-29）

新增功能

1. 当设置为后置摄像头时可以使用手机手电筒

相关 API 请参考 enableTorch

1.8.0（2023-04-25）

新增功能

1. 媒体播放器支持播放透明特效

媒体播放器支持通过渲染 Alpha 通道，实现播放透明特效文件功能，详情请参考 播放透明礼物特效|_blank。

相关 API 请参考 loadResourceWithConfig|_blank

1.6.3（2022-05-17）

修复 Android jitpack 访问失败导致打包失败的问题，改为本地依赖

1.6.2（2022-04-15）

问题修复

1. 修复了日志上报时，日志文件收集异常的问题

2. 修复了部分手机的回声消除问题

1.6.1（2022-03-29）

优化更新

1. 修复推拉流过程中，因视图被频繁创建销毁导致预览异常的问题

1.6.0（2022-03-28）

新增功能

1. 媒体播放器支持倍速播放

在加载资源完成后，调用 [setPlaySpeed] 接口可以设置媒体播放器的视频播放倍速，支持 0.5 ~ 2.0 倍，默认为 1.0，即正常速度。

相关 API 请参考 setPlaySpeed

2. 支持设置和获取音频质量配置

在预览推流前，调用 [setAudioConfig] 接口可以配置推流的音频码率、声道数、音频编码。调用 [getAudioConfig] 接口可以获取当前的音频质量配置。

相关 API 请参考 setAudioConfig, getAudioConfig

1.5.0（2022-03-21）

改进优化

1. 优化了鉴权方式

1.5.0 及以上版本，在创建引擎时将 AppSign 传空或不传，并且在登录房间时必须传入 Token，鉴权通过后即可使用实时音视频功能，具体请参考 使用 Token 鉴权|_blank。

1.5.0 之前版本，在创建引擎时传入 AppSign，鉴权通过后即可使用实时音视频功能。

相关 API 请参考 createEngineWithProfile|_blank, loginRoom|_blank

问题修复

1. 修复了Android平台下标签被隐藏销毁是主动停止推拉流导致的黑屏问题

1.4.0（2022-01-21）

新增功能

  1. 新增 Token 鉴权功能

Token 鉴权功能指的是用户登录房间，或是在房间内进行推/拉流等操作时，ZEGO 服务端根据用户登录时携带的 Token 参数，判断用户是否有对应的权限，避免因权限控制缺失或操作不当引发的风险问题。目前仅支持用户登录房间和用户房间内推流两个权限的校验。

相关 API 请参考 loginRoom, renewToken, roomTokenWillExpire

  1. 新增混流功能

混流功能包括手动混流、自动混流和全自动混流。

手动混流：自定义控制混流任务和混流内容，包括输入流、混流布局等，支持手动混视频流和音频流，常用于跨房间连麦场景。 自动混流：指定房间，自动将房间内的所有音频流进行混流，只支持自动混音频流，常用于纯语聊场景。 全自动混流：每个房间都自动混音频流，只支持全自动混音频流，常用于纯语聊场景。 相关 API 请参考 startMixerTask, stopMixerTask, startAutoMixerTask, stopAutoMixerTask

  1. 新增转推 CDN 功能

支持将音视频流从 ZEGO 音视频云推送到 ZEGO 自有 CDN 或第三方 CDN 的过程，常用于单主播直播场景，例如电商直播、游戏直播、大班课等。

相关 API 请参考 addPublishCdnUrl, removePublishCdnUrl

  1. 新增基础美颜功能

ZEGO 提供了全新的基础美颜功能，为用户呈现出良好的肌肤状态，打造自然的美颜效果。开发者需要在推流前先调用 [startEffectsEnv] 接口初始化美颜环境，然后调用 [enableEffectsBeauty] 接口开启美颜功能。通过 [setEffectsBeautyParam] 接口可以按需调整美白、磨皮、锐化以及红润的程度，实现基础美颜能力。

该功能常用于视频通话、直播等场景。

相关 API 请参考 startEffectsEnv, stopEffectsEnv, enableEffectsBeauty, setEffectsBeautyParam

  1. 新增水印和截图功能

支持在推拉流过程中对画面进行截图，并可以为视频流设置水印，可用于鉴黄等场景。

相关 API 请参考 takePublishStreamSnapshot, takePlayStreamSnapshot, setPublishWatermark

问题修复

  1. 修复了 远端视图中 “streamID” 为空导致的崩溃问题。

1.3.1（2022-01-05）

修复一部分用户登录异常的问题

1.3.0（2022-01-01）

新增功能

  1. 新增多房间功能

同一个用户可以同时加入多个房间，并同时在多个房间内（目前默认最多同时加入 5 个房间）推流、拉流、发送实时消息和接收消息回调。本功能可以隔离多个房间的消息及回调，实现更灵活的连麦业务。ZEGO 推荐用于跨房间连麦和在线教育的超级小班场景。

需要在初始化 SDK 之前，调用 [setRoomMode] 接口，通过 [ZegoRoomMode] 类设置多房间模式，然后调用 [loginRoom] 接口登录多房间。

相关 API 请参考 setRoomMode, loginRoom

问题修复

  1. 修复了 iOS 平台上，移除 zego-view 标签时，原生视图状态没有被重置的问题

1.2.0（2021-11-18）

  1. 废弃旧的 [createEngine] 接口

为了降低开发者对环境的理解，废弃了掉测试环境，统一使用环境。在 2.13.0 及以上版本废弃了原有的 [createEngine] 接口，请使用 [createEngineWithProfile] 接口代替。

1.1.0（2021-09-24）

新增功能

  1. 支持摄像头关闭时推送静态图片

关闭摄像头时，支持持续推送 JPEG/JPG、BMP 和 HEIF 格式的静态图片。例如，主播退后台的时候，会主动关闭摄像头，此时观众侧需要展示主播暂时离开的图片。

初始化 SDK 后，关闭摄像头之前通过 [setDummyCaptureImagePath] 接口设置所推静态图片的路径，开始正常推流后，调用 [enableCamera] 接口关闭摄像头时会开始推静态图片，调用 [enableCamera] 接口打开摄像头时会结束推静态图片。

相关 API 请参考 setDummyCaptureImagePath

  1. 新增手动混流功能

新增手动混流功能，可以自定义控制混流任务和混流内容，包括输入流、混流布局等，支持手动混视频流和音频流，常用于多人互动直播和跨房间连麦场景。调用 [startMixerTask] 接口可以启动手动混流，调用 [stopMixerTask] 可以停止手动混流。

相关 API 请参考 startMixerTask, stopMixerTask

  1. 新增摄像头变焦功能

通过 SDK 设置摄像头的变焦倍数，可实现拍摄时放大远方物体的效果。启动摄像头后，调用 [getCameraMaxZoomFactor] 接口可以获取摄像头的最大变焦倍数。调用 [setCameraZoomFactor] 接口可以设置摄像头的变焦倍数，最小值为 “1.0”。

相关 API 请参考 getCameraMaxZoomFactor, setCameraZoomFactor

  1. 增加试验性 API 功能

ZEGO 通过此 API 提供 RTC 业务中的部分技术预览或特别定制功能，例如手电筒打开功能，方便客户灯光暗的时候提升亮度。

需要获取该功能的使用方法或其详情可咨询 ZEGO 技术支持。

相关 API 请参考 callExperimentalAPI

1.0.4（2021-07-13）

修复设置isUserStatusNotify不生效的问题

1.0.3（2021-07-08）

  1. 修复addPublishCdnUrl 参数传递错误的问题

1.0.2（2021-06-18）

  1. 修复流房间出现混乱的问题
  2. 修复拉流延时的问题

1.0.1（2021-06-15）

修复iOS创建引擎异常问题

1.0.0（2021-06-15）

正式版发布，包含基础的实时音视频功能、常用视频配置、房间实时消息、推拉流信息监测、编解码与分层编码、视频播放器、流量控制等进阶功能。

0.1.5（2021-05-20）

修复iOS层设置播放音量的问题

0.1.4（2021-05-19）

1、修复setPlayVolume在iOS层调用失败的bug 2、修复Android层自定义信令回调为true的bug

0.1.3（2021-05-17）

修复已知bug

0.1.2（2021-03-15）

  1. 兼容最新 SDK

0.1.1（2020-12-10）

支持IM收发消息 支持iOS平台