文档中心
实时音视频
产品简介
发布日志

发布日志

更新时间：2025-02-14 20:06

3.19.0 版本

发布日期： 2025-02-14

新增功能

1. 支持针对媒体播放器输出的声音内容，开启变声效果

媒体播放器新增 [EnableVoiceChanger] 接口，支持针对媒体播放器输出的声音内容开启变声效果，同时选择需要的变调音效。

相关 API 请参考 ZegoMediaPlayer > EnableVoiceChanger

2. 支持将混流后的输出流加入到目标房间

混流功能支持将混流后的输出流，加入到指定房间，即支持设置输出流的目标房间信息（targetRoom）。每条输出流只支持加入一个房间，且一旦添加，混流过程中不支持动态更新房间。如需使用服务端接口实现该功能，可参考开始混流文档。

改进优化

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

3.16.2 版本

发布日期： 2024-08-19

新增功能

1. 支持在图片资源校验失败时，依然正常发起混流任务

ZegoMixerTask 新增参数 mixImageCheckMode，用于控制背景图（backgroundImageURL）、输入流占位图（inputList.imageInfo.url）、水印图片（watermark.imageURL）等图片资源校验失败时，能否正常发起混流任务。

该功能默认不开启（mixImageCheckMode 默认取值为 0），表示严格执行图片校验，即必须满足参数原有的 “支持协议和格式”、“图片大小”、“图片资源请求成功” 等规则，才能正常发起混流任务。

ZEGO 服务端 API 混流接口此前已支持该功能，详情请参考开始混流的 CheckImageMode 参数。

2. 新增电音音效

电音音效指的是可以让人说话、唱歌的声音，经过处理后带有电音的效果。该功能常用于KTV、语聊房场景。

在 [CreateEngine] 初始化 SDK 之前，调用 [SetElectronicEffects] 接口可以开启电音音效，并可根据需要设置不同模式的电音调式以及对应调式的起始音高。未调用此接口时，默认关闭电音音效。

开发者也可以通过 [SetVoiceChangerPreset] 接口预设常见的电音音效，目前支持预设 C 大调电音音效、A 小调电音音效、和声小调电音音效。

相关 API 请参考 SetElectronicEffects

3. 新增音效均衡器（EQ）

支持调整 10 个频带的增益值，从而达到调整音色的目的。

相关 API 请参考 SetAudioEqualizerGain

4. 新增支持设置和获取音频设备音量

注意：仅 Windows、macOS 及 Linux 支持该功能。

支持通过 [SetAudioDeviceVolume] 接口设置音频设备（扬声器或麦克风）的采集音量后再推拉流，但由于系统限制可能导致此接口调用失败，推荐直接使用 [SetCaptureVolume] 和 [SetPlayVolume] 接口来调节推拉流音量。

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

注意：仅 Windows 及 macOS 平台支持该功能。

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

6. 支持对音频设备静音或取消静音

注意：仅 Windows、macOS 及 Linux 平台支持该功能。

可根据需要对音频输入或输出设备静音或取消静音。

相关 API 请参考 MuteAudioDevice, IsAudioDeviceMuted

7. 支持获取当前使用的音频设备信息

注意：仅 Windows 和 macOS 平台支持该功能。

调用 [GetCurrentAudioDevice] 接口，可以获取当前使用的音频设备信息，包括设备 ID 和设备名称，减少开发者的开发量。

相关 API 请参考 GetCurrentAudioDevice

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

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

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

相关 API 请参考 SetDummyCaptureImagePath

9. 支持抛出 [SetDummyCaptureImagePath] 异常回调

相关 API 请参考 OnPublisherDummyCaptureImagePathError

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

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

11. 在推流时，可以控制该流是否允许审核

注意：若某条流设置为允许审核，如果开发者没有发起审核任务，这条流也不会被送审。

当调用审核接口时，默认会对房间内的所有流进行审核。如果客户端要控制某条流不可以被送审，可以在调用 [StartPublishingStream] 接口开始推流时，将送审标识 [streamCensorFlag] 参数设置为 1（不允许）。

12. H.265 客户端编码自动兼容策略新增用户级的协商范围

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

控制本端客户端编码兼容范围为房间内所有推流用户或所有用户，即当指定范围内存在用户不支持 H.265 时，本端客户端编码动态回退。

改进优化

1. 优化了基础美颜功能

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

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

2. 优化 Android 平台视频渲染功能

Android 平台视频渲染优先使用 SurfaceTexure 渲染。

废弃删除

1. 废弃拉流接口中关于 CDN Plus 的配置

下架畅直播概念，废弃 CDN Plus 直播相关接口。如需实现直播功能，推荐使用 ZEGO 自研超低延迟直播产品，实现更高质量的直播体验。

相关 API 请参考 ZegoStreamResourceModeCDNPlus

3.14.5 版本

发布日期： 2024-05-07

新增功能

1. 移动端开发支持 iOS 17.0 版本

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

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

改进优化

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

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

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

3.12.4 版本

发布日期： 2024-01-18

新增功能

1. 支持版权音乐插件

注意：

如需使用该功能，请联系 ZEGO 技术支持。
版权音乐插件包无法单独使用，必须与 Express SDK 搭配使用。

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

问题修复

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

3.12.3 版本

发布日期： 2024-01-08

问题修复

1. 修复 iOS 平台上调用 [EnableAudioCaptureDevice] 接口时偶现崩溃的问题

3.12.2 版本

发布日期： 2024-01-04

问题修复

1. 修复潜在问题

3.11.0 版本

发布日期： 2023-12-13

新增功能

1. 新增开启或关闭拉流对齐功能

该功能常用于 KTV 等需要混流对齐的场景，当拉流端播放时，通过 SetPlayStreamsAlignmentProperty 接口控制播放的实时音视频流是否需要精准对齐。若需要，则拉取的所有流中包含精准对齐参数的会进行对齐；若不需要，则所有流都不对齐。

相关 API 请参考 SetPlayStreamsAlignmentProperty

2. 推流视频支持色彩增强

针对各种摄像头等设备采集到的画面色彩偏灰、或饱和度偏低的情况，支持在保护人体肤色的同时，增强画面色彩，使其更加鲜艳明亮，更符合人眼真实的视觉感受，详情请参考推流视频增强。

相关 API 请参考 EnableColorEnhancement

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

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

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

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

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

5. 混流支持输入直播协议流

新增支持将直播流作为输入流，进行混流处理；直播输入流的 URL 支持 RTMP 和 HTTP-FLV 两种协议。该功能适用于将主播连麦的RTC 画面流与云端体育直播流、游戏直播画面流等进行混合，实现游戏或体育直播解说的场景中。

改进优化

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

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

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

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

4. 优化 Android 平台前后台切换策略，解决某些特定场景或机型采集静音的问题

5. 优化多端登录逻辑

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

问题修复

1. 修复 iOS 平台某些情况下硬编硬解导致崩溃的问题

2. 修复 iOS 平台摄像头恢复采集后，没有通知状态的问题

3. 修复 Android 平台某些情况下解码导致崩溃的问题

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

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

3.10.2 版本

发布日期： 2023-11-20

问题修复

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

3.10.1 版本

发布日期： 2023-11-09

问题修复

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

3.8.1 版本

发布日期： 2023-08-17

新增功能

1. 新增支持“智能云代理”模式

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

开发者设置“智能云代理”模式后，在 RTC 或 L3 拉流时，会优先使用直连网络模式进行尝试。如果直连网络不可用、且当前是蜂窝网络，则继续留在直连模式重试；如果直连网络不可用、且当前是非蜂窝网络，则切到云代理模式，详情请参考云代理。

2. 自定义视频前处理功能支持双输出

自定视频前处理功能支持“双输出”，即支持输出“内存数据”和 “2D 纹理数据”。开发者可以通过这些数据，实现第三方美颜功能，更高性能地进行人脸检测和美颜。

3. 媒体播放器支持设置网络资源的 Http Headers

媒体播放器支持设置网络资源的 Http Headers，开发者可基于该配置，自定义限定网络资源的访问方式，加强资源的安全防护。

4. 支持多源采集能力

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

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

主要能力特性如下：

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

改进优化

1. 优化 iOS 平台的视频渲染效果

3.7.0 版本

发布日期： 2023-07-18

新增功能

1. 开启视频大小流编码后，除大流的视频参数外，新增支持设置小流的视频参数

注意：

使用此功能前，需要先调用 SetVideoConfig 接口，指定视频编码格式 codecID 为 “ZegoVideoCodecIDH264DualStream（大小流编码）”。
设置大流、小流的分辨率的 “比例” 需要保持一致，否则调用接口会出错。

在指定编码格式为 “大小流编码” 的情况下，支持分别设置大流和小流的分辨率、帧率和码率，详情请参考视频大小流和分层编码。

相关 API 请参考 SetVideoConfig, SetPublishDualStreamConfig

2. 支持动态修改 AudioDeviceMode

新增 SetAudioDeviceMode 接口进行动态修改设备的音频模式，该配置决定设备的音量模式、前处理模式以及 Mic 占用逻辑，您可以根据具体场景进行选择，详情请参考如何设置音频设备模式 ZegoAudioDeviceMode？

3. 万人范围音视频、游戏语音支持配置 3D 音效距离的衰减范围

在万人范围音视频、游戏语音场景中，支持设置 3D 音效距离的衰减范围区间 [min, max]。距离小于 min 时，音量不会随着距离的增加而衰减；距离大于 max 时，将无法听到对方的声音。

相关 API 请参考 SetReceiveRange, SetAudioReceiveRange

4. Express Unity3D SDK 新增支持在 WebGL 环境中运行

在 WebGL 环境中运行的 Unity 工程，新增支持使用 ZEGO RTC 服务的部分功能和接口，包括音视频通话、设备管理等能力。

请参考功能总览查看具体的功能和接口支持情况，并参考跑通示例源码和集成 SDK 进行接入。

改进优化

1. 支持在调用 [DestroyEngine] 接口后，生成日志上传任务

3.4.2 版本

发布日期： 2023-04-25

新增功能

1. 支持开启摄像头自适应帧率

注意：当通过 SetVideoConfig 设置的帧率小于 EnableCameraAdaptiveFPS 期望帧率最小值时，将使用 SetVideoConfig 设置的帧率值。由于不同的手机厂商的硬件和算法策略不同，该接口在不同的机型或同一机型的前后摄像头上，效果存在一定差异。

当推流端用户设置的帧率较高，而所处环境光照较低无法正常显示或识别主体的情况下，可以调用 EnableCameraAdaptiveFPS 接口，在一定范围内自动降低帧率来增加曝光时间，从而提升视频画面亮度，该功能常用于对曝光要求较高的直播场景。EnableCameraAdaptiveFPS 接口需在调用 CreateEngine 接口初始化引擎之后，启动摄像头前调用。

相关 API 请参考 EnableCameraAdaptiveFPS

2. 支持设置低照度增强

注意：需在调用 CreateEngine 接口创建引擎后，再调用 SetLowlightEnhancement 接口。

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

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

相关 API 请参考 SetLowlightEnhancement

3. 支持开启系统声卡采集

开启声卡采集后，可以将系统播放的声音混入推流中，如浏览器播放的声音、第三方播放器软件播放的声音等，并支持通过 SetMixSystemPlayoutVolume 设置采集音量。

相关 API 请参考 EnableMixSystemPlayout、SetMixSystemPlayoutVolume

问题修复

1. 修复应用退出时，有可能崩溃的问题

废弃删除

1. 从 3.4.2 版本开始，废弃了对 iOS 11.0 以下版本的支持，iOS Deployment Target（最低支持版本）提升到 iOS 11.0

具体说明，请参考 App Store submission requirement starts April 25 及 Xcode 14 Release Notes。

2. 从 3.4.2 版本开始，iOS SDK 不再支持 32 位 armv7 架构

具体说明，请参考 Xcode 14 Release Notes。

3.3.0 版本

发布日期： 2023-03-24

新增功能

1. 场景化音视频配置新增 `StandardVoiceCall` 标准语音通话场景

场景化音视频配置新增 StandardVoiceCall 标准语音通话场景，适用于 1v1 纯语音通话场景，详情请参考场景化音视频配置。

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

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

3.2.0 版本

发布日期： 2023-02-01

改进优化

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

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

问题修复

1. 修复当硬件解码故障后重启时，访问空指针崩溃的问题

2. 修复当 iOS 14 启动引擎后，访问不存在的 API 时，导致崩溃的问题

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

3.1.0 版本

发布日期： 2022-12-13

新增功能

1. “万人范围音视频”及“多人实时状态同步”功能支持使用场景模板

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

虚拟场景中，由于每个场景的地图大小、音视频互动玩法及规模不同，需要针对每个场景进行自定义配置。3.1.0 版本后，“万人范围音视频”及“多人实时状态同步”支持通过 SDK 接口，并使用模板 ID 指定场景。模板 ID 对应的配置项只能通过服务器 API 进行配置，详情请参考服务端 API - 场景模版配置。

2. “万人范围音视频”及“多人实时状态同步”功能支持使用 Token 基础鉴权

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

用户在登录场景时，可以带上 Token 参数，以验证合法性。

相关 API 请参考 ZegoSceneParam > token, ZegoRangeScene > RenewToken

3. SDK 支持设置云代理

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

通过设置 SDK 的云代理接口，将 SDK 对应的所有流量通过云端的代理服务器进行中转，实现与 RTC 通信，详情请参考云代理。

相关 API 请参考 SetCloudProxyConfig

3.0.3 版本

发布日期：2022-11-29

新增功能

1. 支持 Linux 平台

Express Unity3D SDK 现已支持 Linux x86_64 架构，开发环境要求，请参考集成 SDK。

问题修复

1. 修复 iOS、macOS、Windows 平台硬件解码可能会崩溃的问题

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

3.0.0 版本

发布日期：2022.11.01

本次更新包含不兼容改动，详情请参考 v3.0.0 升级指南。

新增功能

1. 新增基于摄像头打开后的视频首帧回调

支持每次开启远端摄像头后，SDK 拉流并渲染完第一帧远端摄像头视频数据后进行回调，开发者可利用该回调统计首帧耗时，或更新播放流的 UI 组件。

相关 API 请参考 OnPlayerRenderCameraVideoFirstFrame

2. 支持查询当前 SDK 具备的功能特性

由于 SDK 支持特性裁包，部分特性可能已被裁剪；可以使用此函数快速判断当前 SDK 是否支持指定的功能特性。

3. 新增房间维度的场景 Scenario

为方便开发者快速接入，降低开发者接入门槛，SDK 提供多种预设场景。开发者可根据所需场景，选择对应的房间模式 ZegoScenario，SDK 将自动应用适合该场景的音视频编解码器、音视频参数、流控策略等配置，从而快速实现该场景下的最佳效果。

当前支持场景包括秀场直播、KTV、标准 1v1 音视频通话、高画质 1v1 音视频通话、标准语聊房、高音质语聊房，详情请参考场景化音视频配置。

4. 新增调试助手功能

注意：该功能仅在开发阶段使用，请勿在线上版本开启此功能。

新增 EnableDebugAssistant 接口，开发者调用该接口开启调试助手功能，SDK 将会打印日志到控制台，并且在 SDK 其他接口的调用出现异常时，UI 会弹窗提示错误。

相关 API 请参考 EnableDebugAssistant

问题修复

1. 修复退出 App 时小概率崩溃的问题；

废弃删除

1. 废弃了 ZegoScenario 的三种旧版本场景

废弃 ZegoScenario 场景枚举中的 [General]，[Communication]， [Live] 三种场景，详情请参考场景化音视频配置。

2. 删除了 [SetDebugVerbose]、[SetPlayStreamVideoLayer]、[EnableAudioDataCallback] 等接口，详情请参考 3.0.0 版本升级指南。

2.23.0 版本

发布日期：2022.09.13

问题修复

1. 修复范围语音功能在退出小队后，在范围距离外还能听到原小队内的人的声音的问题

2.21.2 版本

发布日期：2022.08.02

新增功能

1. 新增获取视频渲染 Texture2D 的功能

注意：在 Unity 中，texture2D 坐标是从左下角开始，而图片坐标是从左上角开始，因此看到 Texture2D 默认渲染的画面 Y 轴是翻转的。

在 ZegoExpressEngine 的父类 IVideoSurface 中，新增接口 GetNativeTexture2D，用于拷贝一份 SDK 当前渲染画面的 Texture2D，供外部使用。

2.21.1 版本

发布日期：2022.07.15

新增功能

1. 混流支持设置视频边框为圆角

在调用 StartMixerTask 接口混流时，开发者可以通过 “ZegoMixerInput” 类型参数，设置 “cornerRadius”（视频画面圆角半径），将视频边框设置为圆角。“cornerRadius” 的单位为 px，取值不得超过视频画面宽高中较短者的一半。

2. 拉流接口增加 CDN Plus 拉流配置项

注意：若希望通过地区、用户等更多维度，从云端控制拉流方式，请联系 ZEGO 技术支持进行相关配置。

拉流接口新增 CDN_PLUS 的拉流资源模式（ZegoStreamResourceMode），开发者可按流维度自行开启使用CDN_PLUS 拉流。CDN Plus 拉流是比 CDN 拉流直播质量更高，但是价格接近 CDN 的一种性价比高的拉流方式，详情请参考 CDN Plus 拉流。

1. 修复了 DestroyEngine 可能导致 Unity Editor 闪退的问题

2. 修复了应用退出过程中触发 SDK 回调可能导致崩溃的问题

2.20.3 版本

发布日期：2022.07.01

新增功能

1. 新增音频数据监测功能

当开发者需要获取远端用户的音频数据或者需要获取本地麦克风采集到的数据另做他用（例如纯音频录制、纯音频第三方监控、纯音频实时分析）时，可调用 StartAudioDataObserver 接口开启实时音频数据监测。

2.20.2 版本

发布日期：2022.06.20

问题修复

1. 修复了一个概率性拉流失败的问题

2. 修复了在初始化 SDK 前，设置音频设备模式不生效的问题

2.20.0 版本

发布日期：2022-06-13

新增功能

1. 支持设置流级别的音视频自动审核

注意：如需使用该功能，请联系 ZEGO 技术支持开通后台服务。

在调用 StartPublishingStream 接口开始推流时，开发者可以设置 ZegoStreamCensorshipMode 参数，进行流级别的音视频自动审核，包含如涉黄、涉政等审核类型，以此降低开发者的接入难度和业务维护成本。

相关 API 请参考 StartPublishingStream

改进优化

1. 优化了混流精准对齐的接口调用逻辑

调用 StartPublishingStream 接口且将 ZegoPublisherConfig 中的 forceSynchronousNetworkTime 值设置为 1，则 SDK 内部会等到 OnNetworkTimeSynchronized 回调通知 NTP 网络时间同步完成后再推流，此时再调用 SetStreamAlignmentProperty 接口开启混流精准对齐功能。

问题修复

1. 修复了在 32 位 Android 手机上少量接口报错的问题

2.19.0 版本

发布日期：2022-05-18

新增功能

1. 支持返回登录房间和退出房间结果

[loginRoom] 接口新增 “callback” 参数，支持从 “callback“ 返回登录房间结果。

[logoutRoom] 接口新增 “callback” 参数，支持从 “callback“ 返回退出房间结果。

相关 API 请参考 LoginRoom, LogoutRoom

2. 新增房间状态变化通知 [onRoomStateChanged]

当房间的连接状态发生变化时会触发 [onRoomStateChanged] 回调，通过 “ZegoRoomStateChangedReason” 参数提供更加详细的连接状态及状态变化原因。

3. 新增开启人声检测功能以及人声部分的声浪回调

开发者在监听声浪回调时，往往只关注人声部分，可调用 StartSoundLevelMonitor 接口，传入 “ZegoSoundLevelConfig”，开启 VAD 人声检测。

SDK 在本地采集声浪回调 OnCapturedSoundLevelInfoUpdate、远端音频声浪回调 OnRemoteSoundLevelInfoUpdate 中也新增是否包含人声检测的参数。

4. 支持获取本端和远端的上下行网络质量

新增本地和远端用户的上下行网络质量回调 OnNetworkQuality，默认每两秒回调一次本地和每个拉取的远端用户的网络状况（包括未知、优秀、良好、中等、较差、网络断线）。当开发者希望分析链路上的网络情况，或想要了解本地和远端用户的网络状况时可以使用该功能。

5. 支持设置触发流量控制的关注因素

当通过 EnableTrafficControl 接口开启了指定推流通道的流量控制后，可通过 SetTrafficControlFocusOn 接口控制是否因为远端网络状况差而启动流量控制。

相关 API 请参考 SetTrafficControlFocusOn

6. 直推 CDN 的流支持通过 L3 拉流

直推 CDN 时，在不改变推流方式的情况下，SDK 从客户的 CDN 源站拉流，通过 L3 将音视频内容分发给观众，通过 ZegoResourceType 控制源站资源。该功能常用于直播场景。

1. 修复了从 CDN 拉流失败的问题

2.18.0 版本

发布日期：2022-04-19

新增功能

1. 新增媒体播放器功能

媒体播放器组件提供播放音视频媒体文件的能力，并且支持将播放的媒体文件的音画数据推流出去。

相关 API 请参考 CreateMediaPlayer, DestroyMediaPlayer

2. 新增自动混流功能

SDK 可以指定房间，由 ZEGO 实时音视频服务器自动将房间内的所有音频流进行混流（目前只支持混音频流），常用于纯语聊场景。

可以调用 StartAutoMixerTask 接口开启自动混流，调用 StopAutoMixerTask 接口关闭自动混流。

相关 API 请参考 StartAutoMixerTask, StopAutoMixerTask

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

调用 GetNetworkTimeInfo 接口可以获取当前网络时间（NTP），包括当前网络时间的时间戳和最大误差。在进行多端行为同步时，需要获取同步网络时间对当前时间进行校准。

4. 支持混流精准对齐功能

调用 SetStreamAlignmentProperty 接口可以开启或关闭混流精准对齐功能，常用于 KTV 等需要混流对齐的场景。

相关 API 请参考 SetStreamAlignmentProperty

问题修复

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

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

2.17.1 版本

发布日期：2022-03-30

问题修复

1. 修复了 iOS 平台 SDK 库打包格式不兼容 Plugins，导致导出 XCode 工程错误的问题

已将 iOS 平台 SDK 库格式改为 Plugins 兼容的 framework 格式。

2.17.0 版本

发布日期：2022-03-18

改进优化

1. 优化了鉴权方式

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

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

相关 API 请参考 CreateEngine, LoginRoom

问题修复

1. 修复了游戏语音中切换房间导致崩溃的问题

修复了开启游戏语音后调用 SwitchRoom 接口导致崩溃的问题。

2.16.0 版本

发布日期：2022-02-25

新增功能

1. 新增登录房间和用户房间内推流鉴权功能

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

相关 API 请参考 LoginRoom, RenewToken, onRoomTokenWillExpire

2. 支持设置播放视频流类型

当推流方通过 [SetVideoConfig] 设置了 “codecID” 为 “SVC” 时（在拉流前后均可设置），拉流方可以动态设置选用不同的流类型（小分辨率为标准图层的二分之一）。在网络较弱或者渲染的 UI 窗体较小的情况下，可以选择使用拉取小分辨率的视频来达到节省带宽的目的。

相关 API 请参考 SetPlayStreamVideoType

3. 新增混响高级参数和混响/变声的预设值

通过混响高级参数可以根据需要调节更精细的混响效果，并在原有预设混响中新增了录音室、KTV、摇滚、演唱会等效果，在预设变声中新增了磁性男和清新女音效，增加实时语音趣味性，能够适应更多的场景。

4. 支持设置混响回声参数

用户可以根据需要设置混响回声参数，最多允许设置 7 次回声 (delay)，并支持单独设置每个回声的延迟、衰减，以及整体的输入输出增益值。也可以搭配变声、混响以实现自定义各式各样的声音效果。

5. 新增空间音频能力

空间音频能够感知空间内 360° 的声音位置。开发者可以通过空间音频功能在音视频房间内营造更逼真的“座位”效果，用户可以通过空间音频感知声音的来源方向，还原线下场景。适用于语聊房、剧本杀和线上会议等场景。

相关 API 请参考 EnablePlayStreamVirtualStereo

6. 支持全方位虚拟立体声

新增支持全方位虚拟立体声，将单声道的声音，通过算法处理，模拟成立体感的声音。该功能常用于 KTV 场景中，可以使唱歌的声音更加有立体感。

当调用 [EnableVirtualStereo] 接口，将 angle 参数设置为 -1 时，表示立体声效果为全方位立体声。

相关 API 请参考 EnableVirtualStereo

7. 设置拉流优先级的权重

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

相关 API 请参考 SetPlayStreamFocusOn

8. 支持获取当前音频路由

音频路由是指 App 在播放音频时使用的音频输出设备，常见的音频路由有：扬声器、听筒、耳机、蓝牙设备等。开发者可以调用 [GetAudioRouteType] 接口获取当前音频路由。

9. 音效播放器新增支持设置变声效果

通过改变用户的音调，使输出的声音在感官上与原始声音不同，实现男声变女生等多种效果。

相关 API 请参考 SetVoiceChangerParam

10. 支持回调远端扬声器设备状态

与远端用户连麦成功后，当远端扬声器设备状态发生变更时，例如开/关扬声器，可以通过 [OnRemoteSpeakerStateUpdate] 回调监听。

相关 API 请参考 OnRemoteSpeakerStateUpdate

11. 新增音频设备路由变更通知回调 [OnLocalDeviceExceptionOccurred]

当有耳机插拔、扬声器和听筒切换等音频路由发生变化时会抛出此回调。

12. 新增本地设备异常回调 [OnLocalDeviceExceptionOccurred]

通过 [OnLocalDeviceExceptionOccurred] 回调可以设置要检测的设备类型，如摄像头、扬声器、麦克风等，开发者可以根据不同设备类型的错误回调进行相应的处理。

相关 API 请参考 OnLocalDeviceExceptionOccurred

13. 支持设置音频路由到扬声器

通过 [SetAudioRouteToSpeaker] 可以设置音频路由到扬声器，当选择不使用内置扬声器播放声音时，即设为 “false” 时，SDK 会根据系统调度选择当前优先级最高的音频输出设备播放声音。

相关 API 请参考 SetAudioRouteToSpeaker

14. 支持设置拉流缓存区间值

该功能用于指定播放缓存自适应调整的区间范围，开发者可根据场景进行设置。

相关 API 请参考 SetPlayStreamBufferIntervalRange

15. 拉流端提供关闭所有音频或视频的功能

当拉流时需要一次性关闭所有远端用户的音频或视频流时，可通过该功能实现。

相关 API 请参考 MuteAllPlayStreamAudio, MuteAllPlayStreamVideo

16. 新增对推流或拉流画面截图的功能

支持在推拉流过程中对画面进行截图，可用于鉴黄等场景。

相关 API 请参考 TakePublishStreamSnapshot, OnPublisherTakeSnapshotResult, TakePlayStreamSnapshot, OnPlayerTakeSnapshotResult

17. 新增本地预览首帧渲染回调

第一帧视频数据被渲染完之后会收到 [OnPublisherRenderVideoFirstFrame] 回调。

相关 API 请参考 OnPublisherRenderVideoFirstFrame

18. 支持设置所有拉流声音大小

本端用户可以通过 [SetAllPlayStreamVolume] 接口控制所有音频流的播放音量。

相关 API 请参考 SetAllPlayStreamVolume

19. 支持通过 [OnApiCalledResult] 委托函数获取到 ZEGO SDK 方法执行结果的详细信息

1. 废弃了旧版本的基础美颜相关接口

旧的美颜功能较为简单，不太符合开发者的预期，因此在 2.16.0 及以上版本废弃了 [EnableBeautify] 和 [SetBeautifyOption] 接口。

相关 API 请参考 EnableBeautify, SetBeautifyOption

2. 废弃 [SetBuiltInSpeakerOn] 接口

因为命名规范问题，在 2.16.0 及以上版本废弃 [SetBuiltInSpeakerOn] 接口，请使用 [SetAudioRouteToSpeaker] 来实现原来的功能。

相关 API 请参考 SetAudioRouteToSpeaker

3. 废弃 [OnDeviceError] 回调

为了让开发者直观的了解出现异常的设备类型以及具体的异常情况，在 2.16.0 及以上版本废弃了 [OnDeviceError] 回调，请使用 [OnLocalDeviceExceptionOccurred] 回调代替。

相关 API 请参考 OnDeviceError,OnLocalDeviceExceptionOccurred

2.15.3 版本

发布日期：2022-02-18

新增功能

1. 游戏语音支持设置隐秘小队模式

[ZegoRangeAudioMode] 枚举新增隐秘小队 SecretTeam，本地用户可以根据需要，在初始化游戏语音 [CreateRangeAudio] 之后，通过 [SetRangeAudioMode] 接口设置隐秘小队模式。该小队模式下，小队成员可以接收到世界模式用户的语音。

相关 API 请参考CreateRangeAudio, SetRangeAudioMode

2.15.2 版本

发布日期：2022-01-05

新增功能

1. 新增试验性 API

新增 [CallExperimentalAPI] 接口，ZEGO 通过此 API 提供 RTC 业务中的部分技术预览或特别定制功能，需要获取功能的使用或详情其详情可咨询 ZEGO 技术支持。新增 [onRecvExperimentalAPI] 回调委托，用于接收试验性 API JSON 内容。

相关 API 请参考 CallExperimentalAPI, onRecvExperimentalAPI

2.15.1 版本

发布日期：2021-12-24

新增功能

1. 游戏语音支持设置是否接收指定用户的音频数据

游戏语音模块新增 [MuteUser] 接口，本地用户可以根据需要，在初始化游戏语音 [CreateRangeAudio] 之后，通过 [MuteUser] 接口设置是否接收指定远端用户的音频数据。不接收时，可降低硬件和网络的开销。

当开发者需要快速关闭或恢复远端音频时可以使用该功能。

1. 修复了设置引擎进阶配置失败的问题

修复了 [SetEngineConfig] 接口中 “advancedConfig” 配置不生效的问题。

2.15.0 版本

发布日期：2021-12-17

新增功能

1. 支持游戏语音功能

新增游戏语音功能模块，可提供范围语音、3D音效、小队语音等功能。适用于吃鸡类游戏、元宇宙类场景。

范围语音：房间内的收听者对音频的接收距离有范围限制，若发声者与自己的距离超过该范围，则无法听到声音。为保证语音清晰，附近超过 20 人发声时，只能听到离自己最近的 20 个发声者的声音。

3D音效：声音有 3D 空间感且按距离衰减。

小队语音：玩家可以选择加入小队，并支持在房间内自由切换“全世界”模式和“仅小队”模式。

改进优化

1. 支持设置特定通道的音频配置

优化了 [SetAudioConfig] 接口，新增可选参数 “ZegoPublishChannel”，可指定通道号进行音频配置。

2. 拉流质量回调增加音频质量参数

[onPlayerQualityUpdate] 回调增加 mos 参数，表示当前音频质量情况。

相关 API 请参考 onPlayerQualityUpdate

问题修复

1. 修复了部分接口字符串拷贝错误的问题

1.2.0 版本

发布日期：2021-11-29

问题修复

发布日志

3.19.0 版本

1. 支持针对媒体播放器输出的声音内容，开启变声效果

2. 支持将混流后的输出流加入到目标房间

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

3.16.2 版本

1. 支持在图片资源校验失败时，依然正常发起混流任务

2. 新增电音音效

3. 新增音效均衡器（EQ）

4. 新增支持设置和获取音频设备音量

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

6. 支持对音频设备静音或取消静音

7. 支持获取当前使用的音频设备信息

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

9. 支持抛出 [SetDummyCaptureImagePath] 异常回调

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

11. 在推流时，可以控制该流是否允许审核

12. H.265 客户端编码自动兼容策略新增用户级的协商范围

1. 优化了基础美颜功能

2. 优化 Android 平台视频渲染功能

1. 废弃拉流接口中关于 CDN Plus 的配置

3.14.5 版本

1. 移动端开发支持 iOS 17.0 版本

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

3.12.4 版本

1. 支持版权音乐插件

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

3.12.3 版本

1. 修复 iOS 平台上调用 [EnableAudioCaptureDevice] 接口时偶现崩溃的问题

3.12.2 版本

1. 修复潜在问题

3.11.0 版本

1. 新增开启或关闭拉流对齐功能

2. 推流视频支持色彩增强

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

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

5. 混流支持输入直播协议流

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

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

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

4. 优化 Android 平台前后台切换策略，解决某些特定场景或机型采集静音的问题

5. 优化多端登录逻辑

1. 修复 iOS 平台某些情况下硬编硬解导致崩溃的问题

2. 修复 iOS 平台摄像头恢复采集后，没有通知状态的问题

3. 修复 Android 平台某些情况下解码导致崩溃的问题

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

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

3.10.2 版本

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

3.10.1 版本

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

3.8.1 版本

1. 新增支持“智能云代理”模式

2. 自定义视频前处理功能支持双输出

3. 媒体播放器支持设置网络资源的 Http Headers

4. 支持多源采集能力

1. 优化 iOS 平台的视频渲染效果

3.7.0 版本

1. 开启视频大小流编码后，除大流的视频参数外，新增支持设置小流的视频参数

2. 支持动态修改 AudioDeviceMode

3. 万人范围音视频、游戏语音支持配置 3D 音效距离的衰减范围

4. Express Unity3D SDK 新增支持在 WebGL 环境中运行

1. 支持在调用 [DestroyEngine] 接口后，生成日志上传任务

3.4.2 版本

1. 支持开启摄像头自适应帧率

2. 支持设置低照度增强

3. 支持开启系统声卡采集

1. 修复应用退出时，有可能崩溃的问题

1. 从 3.4.2 版本开始，废弃了对 iOS 11.0 以下版本的支持，iOS Deployment Target（最低支持版本）提升到 iOS 11.0

2. 从 3.4.2 版本开始，iOS SDK 不再支持 32 位 armv7 架构

3.3.0 版本

1. 场景化音视频配置新增 StandardVoiceCall 标准语音通话场景

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

3.2.0 版本

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

1. 修复当硬件解码故障后重启时，访问空指针崩溃的问题

2. 修复当 iOS 14 启动引擎后，访问不存在的 API 时，导致崩溃的问题

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

3.1.0 版本

1. “万人范围音视频”及“多人实时状态同步”功能支持使用场景模板

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

1. 场景化音视频配置新增 `StandardVoiceCall` 标准语音通话场景