ZEGO 即构实时音视频 SDK - 更新日志
3.21.0(2025-07-02)
新增功能
- 媒体播放器新增清理最后一帧的能力,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 参数,用于设置媒体播放器的视图模式,详情请参考 媒体播放器 文档。
改进优化
- 更新集成 Express Native SDK 至 3.17.3 版本
3.16.5(2024-11-12)
修复开始/停止本地录制接口调用异常
3.16.4(2024-09-30)
- 新增媒体播放器新增设置视图模式
- 修复停止本地声浪 [stopSoundLevelMonitor] 接口在Android上调用不生效
3.16.3(2024-09-19)
问题修复
- 修复远端音量通知事件回调数据结构
3.16.2(2024-08-23)
问题修复
1.修复 Android 特定场景摄像头无法打开的问题 2.修复 Android 某些机型屏幕录制时,应用杀死后不会自动停止录屏权限的问题 3.修复 iOS 频繁推流/停止推流偶现崩溃问题
3.16.0(2024-08-05)
新增功能
- [loginRoom] 与 [logoutRoom] 接口完善 promise 能力,登录和登出会异步返回相应的结果
- 升级 native sdk 到 3.16.0
3.15.1(2024-06-17)
新增功能
- 适配 vue3 框架;
- 新增 [roomStateChanged] 回调,监听房间状态变更;
- 新增 [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)
问题修复
- 修复移动端休眠检测模块误报,影响到房间重登录、推拉流重试逻辑的问题
3.10.1(2023-11-12)
问题修复
- 修复开启低照度增强后出现黑屏的问题
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)
新增功能
- 新增 Token 鉴权功能
Token 鉴权功能指的是用户登录房间,或是在房间内进行推/拉流等操作时,ZEGO 服务端根据用户登录时携带的 Token 参数,判断用户是否有对应的权限,避免因权限控制缺失或操作不当引发的风险问题。目前仅支持用户登录房间和用户房间内推流两个权限的校验。
相关 API 请参考 loginRoom, renewToken, roomTokenWillExpire
- 新增混流功能
混流功能包括手动混流、自动混流和全自动混流。
手动混流:自定义控制混流任务和混流内容,包括输入流、混流布局等,支持手动混视频流和音频流,常用于跨房间连麦场景。 自动混流:指定房间,自动将房间内的所有音频流进行混流,只支持自动混音频流,常用于纯语聊场景。 全自动混流:每个房间都自动混音频流,只支持全自动混音频流,常用于纯语聊场景。 相关 API 请参考 startMixerTask, stopMixerTask, startAutoMixerTask, stopAutoMixerTask
- 新增转推 CDN 功能
支持将音视频流从 ZEGO 音视频云推送到 ZEGO 自有 CDN 或第三方 CDN 的过程,常用于单主播直播场景,例如电商直播、游戏直播、大班课等。
相关 API 请参考 addPublishCdnUrl, removePublishCdnUrl
- 新增基础美颜功能
ZEGO 提供了全新的基础美颜功能,为用户呈现出良好的肌肤状态,打造自然的美颜效果。开发者需要在推流前先调用 [startEffectsEnv] 接口初始化美颜环境,然后调用 [enableEffectsBeauty] 接口开启美颜功能。通过 [setEffectsBeautyParam] 接口可以按需调整美白、磨皮、锐化以及红润的程度,实现基础美颜能力。
该功能常用于视频通话、直播等场景。
相关 API 请参考 startEffectsEnv, stopEffectsEnv, enableEffectsBeauty, setEffectsBeautyParam
- 新增水印和截图功能
支持在推拉流过程中对画面进行截图,并可以为视频流设置水印,可用于鉴黄等场景。
相关 API 请参考 takePublishStreamSnapshot, takePlayStreamSnapshot, setPublishWatermark
问题修复
- 修复了
远端视图中 “streamID” 为空导致的崩溃问题。
1.3.1(2022-01-05)
修复一部分用户登录异常的问题
1.3.0(2022-01-01)
新增功能
- 新增多房间功能
同一个用户可以同时加入多个房间,并同时在多个房间内(目前默认最多同时加入 5 个房间)推流、拉流、发送实时消息和接收消息回调。本功能可以隔离多个房间的消息及回调,实现更灵活的连麦业务。ZEGO 推荐用于跨房间连麦和在线教育的超级小班场景。
需要在初始化 SDK 之前,调用 [setRoomMode] 接口,通过 [ZegoRoomMode] 类设置多房间模式,然后调用 [loginRoom] 接口登录多房间。
相关 API 请参考 setRoomMode, loginRoom
问题修复
- 修复了 iOS 平台上,移除 zego-view 标签时,原生视图状态没有被重置的问题
1.2.0(2021-11-18)
- 废弃旧的 [createEngine] 接口
为了降低开发者对环境的理解,废弃了掉测试环境,统一使用环境。在 2.13.0 及以上版本废弃了原有的 [createEngine] 接口,请使用 [createEngineWithProfile] 接口代替。
1.1.0(2021-09-24)
新增功能
- 支持摄像头关闭时推送静态图片
关闭摄像头时,支持持续推送 JPEG/JPG、BMP 和 HEIF 格式的静态图片。例如,主播退后台的时候,会主动关闭摄像头,此时观众侧需要展示主播暂时离开的图片。
初始化 SDK 后,关闭摄像头之前通过 [setDummyCaptureImagePath] 接口设置所推静态图片的路径,开始正常推流后,调用 [enableCamera] 接口关闭摄像头时会开始推静态图片,调用 [enableCamera] 接口打开摄像头时会结束推静态图片。
相关 API 请参考 setDummyCaptureImagePath
- 新增手动混流功能
新增手动混流功能,可以自定义控制混流任务和混流内容,包括输入流、混流布局等,支持手动混视频流和音频流,常用于多人互动直播和跨房间连麦场景。调用 [startMixerTask] 接口可以启动手动混流,调用 [stopMixerTask] 可以停止手动混流。
相关 API 请参考 startMixerTask, stopMixerTask
- 新增摄像头变焦功能
通过 SDK 设置摄像头的变焦倍数,可实现拍摄时放大远方物体的效果。启动摄像头后,调用 [getCameraMaxZoomFactor] 接口可以获取摄像头的最大变焦倍数。调用 [setCameraZoomFactor] 接口可以设置摄像头的变焦倍数,最小值为 “1.0”。
相关 API 请参考 getCameraMaxZoomFactor, setCameraZoomFactor
- 增加试验性 API 功能
ZEGO 通过此 API 提供 RTC 业务中的部分技术预览或特别定制功能,例如手电筒打开功能,方便客户灯光暗的时候提升亮度。
需要获取该功能的使用方法或其详情可咨询 ZEGO 技术支持。
相关 API 请参考 callExperimentalAPI
1.0.4(2021-07-13)
修复设置isUserStatusNotify不生效的问题
1.0.3(2021-07-08)
- 修复addPublishCdnUrl 参数传递错误的问题
1.0.2(2021-06-18)
- 修复流房间出现混乱的问题
- 修复拉流延时的问题
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)
- 兼容最新 SDK
0.1.1(2020-12-10)
支持IM收发消息 支持iOS平台