如需使用该功能，请联系ZEGO技术支持。
AIAEC轻量模式支持智能识别并且消除回声。相较传统AEC算法，人声保真度效果提升明显，且没有额外的延迟与功耗增量。适用于实时KTV、高音质语聊与视频等场景。
改进优化
发布日期：2024-09-27
支持分别设置观众在上麦前和下麦后的拉流资源类型，使拉流方式更灵活，可设置分别为：通过RTC拉流、超低延迟直播（L3）拉流或CDN拉流中任意一种拉流方式。例如，可用于实现直播连麦场景中，观众上麦前默认使用L3拉流，上麦互动时切换为通过RTC拉流，下麦后恢复为通过L3拉流。
发布日期：2024-07-26
注意：如需使用该功能，请联系ZEGO技术支持。
注意：若某条流设置为允许审核，如果开发者没有发起审核任务，这条流也不会被送审。
当调用审核接口时，默认会对房间内的所有流进行审核。如果客户端要控制某条流不可以被送审，可以在调用[startPublishingStream]接口开始推流时，将送审标识[streamCensorFlag]参数设置为1（不允许）。
使用ZEGO超低延迟直播（L3）拉流时，支持根据用户的网络带宽自适应平滑切换不同码流，保障用户的流畅播放体验。
[ZegoPlayerConfig]新增adaptiveSwitch和adaptiveTemplateIDList参数，用于支持OnlyL3拉流模式下，基于网络环境的码率自适应切换。
新增[switchPlayingStream]接口，用于开发者拉CDN流时，平滑切换至其他CDN流，即成功拉到新流后，才会停止拉旧流。
例如，当视频画面从小窗口切换为大窗口时，需将视频切换为码率和分辨率更高的流，此时将会在成功拉到新流后，才会停止拉旧流，以达到平滑切换的效果。
控制本端客户端编码兼容范围为房间内所有推流用户或所有用户，即当指定范围内存在用户不支持H.265时，本端客户端编码动态回退。
废弃删除
发布日期：2024-06-05
发布日期：2024-05-29
媒体播放器新增[enableVoiceChanger]接口，支持针对媒体播放器输出的声音内容开启变声效果，同时选择需要的变调音效。
为提升在变声情况下的播放体验，废弃媒体播放器[ZegoMediaPlayer.setVoiceChangerParam]接口，请使用[ZegoMediaPlayer.enableVoiceChanger]代替。
发布日期：2024-04-23
该功能默认不开启（mixImageCheckMode默认取值为0），表示严格执行图片校验，即必须满足参数原有的“支持协议和格式”、“图片大小”、“图片资源请求成功”等规则，才能正常发起混流任务。
发布日期：2024-03-29
发布日期：2024-03-14
注意：
该功能默认不开启（即quicConnectMode默认为0，表示正常建立连接）。
注意：该功能只在发起转推时生效，转推过程中如果出现断连，SDK会保持重试逻辑，此时无该回调通知。
该回调只会通知给转推发起者、而不是推流发起者。如果转推发起者和推流发起者不是同一个用户，建议开发者从服务端发起转推、并接收该通知。
自定义视频渲染支持独立通道控制。例如，针对指定流ID只进行SDK内部渲染、但不执行自定义渲染。
注意：该功能会增加性能消耗，请酌情使用。
支持在获取到ExpressSDK视频前处理过的数据后，再进行其他的视频前处理操作（例如美颜等，需要开发者自行实现）、或将处理过的视频数据直接用于预览或推流。
注意：外部采集功能和视频前处理功能不能同时使用，否则可能会出现拉流画面异常。
房间内有用户不支持H.265格式时，支持推流端回退到H.264格式重新推流。
优化媒体推流器的回调通知逻辑，增加对“不支持的音频采样率”（例如，不支持24K的采样率）的错误回调，帮助开发者快速定位问题。
优化色彩增强算法，在画面色彩饱和度较高的场景下，相较之前的版本表现更佳。
发布日期：2024-01-16
发布日期：2023-12-27
注意：该功能获取的结果为房间内实时流列表；如果房间服务断开连接，获取的结果可能不准确。
支持获取当前播放的媒体文件的帧率统计信息，可以用于数据展示、异常监控等。
支持在本地缓存网络资源，如果需要播放同一个网络资源时，将优先使用缓存数据，提升用户体验。
发布日期：2023-11-29
注意：如需使用该功能，请联系ZEGO商务人员。
通过在云端转码服务中应用领先的编解码算法、以及其他视频前处理能力，持续优化视频播放的清晰度与流畅度，显著提升画质。该功能适用于以下场景：
支持向指定的客户端或客户服务器发送房间实时消息；消息类型分为“普通消息”、“有序消息”，其中后者保证严格按照顺序接收消息。该功能适用于主播需要管理房间内的麦位等场景中，例如：
注意：该功能仅支持截图的前处理，不支持其他处理（如旋转、水印等）。
当采集设备输出的视频格式为MJPEG时，默认开启硬件解码加速能力，防止出现因设备性能不足而导致的帧率不足等问题。
该功能主要适用于在4K分辨率的采集设备上使用。
自动混流接口支持设置水位，控制混流服务器拉流缓存的自适应调整的区间范围下限，以便在“混流耗时”和“推流端不稳定导致的画面卡顿”之间保持平衡。该功能设置后，仅对新的输入流生效，对于已经开始混流的输入流不生效。
例如实时合唱KTV场景中，推流端网络轻微波动可能会导致混流卡顿，此时观众观看时也会有较高概率出现卡顿。通过调节水位下限，可以优化观众端卡顿问题，但会增大延迟。
新增支持将直播流作为输入流，进行混流处理；直播输入流的URL支持RTMP和HTTP-FLV两种协议。该功能适用于将主播连麦的RTC画面流与云端体育直播流、游戏直播画面流等进行混合，实现游戏或体育直播解说的场景中。
在使用自定义音视频采集功能、且对应的采集源音频延迟不一致的情况下，可以在混流时自定义音频偏移值，从而实现混流输出后的音视频对齐，保证观众端的体验。
音效播放器支持分别设置推流音量、本地播放音量，保证本端和远端的音量大小都处于合适的区间。
优化服务端混流及单流转码能力，提高编码效率，同等码率下提升5%以上的主客观画质。
发布日期：2023-11-09
发布日期：2023-10-13
媒体播放器支持伴奏音质增强，提升伴奏的音质以及现场的氛围感，适用于语聊房、K歌等场景中。
支持提取、编码和传输开发者自定义采集的RGBA通道中的Alpha通道数据，从而在拉流端渲染出透明背景的主体，实现更加沉浸、真实的视频场景。
在低照度增强的自动模式下，亮度的动态调整将更加流畅平滑，提升用户视觉体验。
优化网络测速的期望推、拉流码率上限，提升至15M。开发者可以在推拉流前，检查音视频质量与当前网络的匹配程度，以保证通话质量稳定。
注意：播放过程中，如果修改了媒体流类型，会在下一次播放时生效。
发布日期：2023-09-08
注意：该功能需要Windows10.18362或以上版本。
多源采集模块在进行屏幕采集时，支持系统WGC（WindowsGraphicsCapture）采集，且默认使用该模式，采集效率更高。
多源采集模块在进行屏幕采集时，支持用户设置独立的预览和推流区域。
该功能可用于直播等场景中，观众可以基于网络质量、终端设备等，选择不同分辨率的流进行观看，确保播放的流畅性。
注意：当前官网SDK不包含此功能，如有需要，请联系ZEGO技术支持特殊编包。
发布日期：2023-08-16
发布日期：2023-08-09
新增支持抛出编码和硬件解码的低帧率告警回调，在1v1聊天、直播等场景中，开发者可基于该回调，实现调整推流分辨率、触发转码等操作。
媒体播放器支持设置网络资源的HttpHeaders，开发者可基于该配置，自定义限定网络资源的访问方式，加强资源的安全防护。
发布日期：2023-07-13
在万人范围音视频、游戏语音场景中，支持设置3D音效距离的衰减范围区间[min,max]。距离小于min时，音量不会随着距离的增加而衰减；距离大于max时，将无法听到对方的声音。
发布日期：2023-06-09
该功能可用于视频会议、1v1音视频通话等场景中，帮助用户更好的保护个人隐私，以及提升通话的趣味性。
新增增强型KTV混响效果，实现更集中、亮度更好的KTV人声效果。与之前的KTV混响音效相比，EnhancedKTV混响效果缩短了混响时长，提高了干湿比。
原有的KTV混响音效仅适用于人声瑕疵较为明显的用户，增强型KTV混响效果适用于大多数专业用户和普通用户。
开发者可以通过设置媒体播放器、音效播放器的位置和朝向，实现本地音频、在线音频资源的3D音效。该功能可用于在虚拟场景中设置物品的音效、以及指定位置的背景音乐等。
针对媒体播放器正在播放的视频文件，开发者可以主动获取视频的分辨率、帧率等信息。
媒体播放器倍速的上限提升到4倍速。例如，用户在播放音视频文件时，如果已设置为2倍速播放，长按屏幕时可以加速至4倍速。
当麦克风与人体区域存在部分重叠时，可以保留重叠区域的麦克风形状，以维持完整的人体区域形状。
发布日期：2023-05-11
该功能可用于自定义采集渲染场景中。例如：用户外放背景音乐，同时上麦进行发言，其中背景音乐不是使用自定义渲染或外部渲染的声音，可通过该功能消除推流中包含的背景音乐回声。
发布日期：2023-04-14
支持动态开关流量控制功能，同时支持设置流量控制属性等。
删除SDK内部一些没必要的内存申请，优化SDK内存使用率，相比上个版本，内存使用率减少了10%左右。
为规避数据同步异常的情况，将在3.4.0及以上版本，废弃[onPlayerRecvSEI]接口，若需收取远端流的SEI内容，请使用[onPlayerSyncRecvSEI]接口替代。
发布日期：2023-03-10
在外放场景中，设备的麦克风与扬声器过近，容易导致人声模糊或沉闷。在该场景下，人声增强可以有效提升人声清晰度并改善沉闷感，因此在外放场景下，建议开启该功能。
为实现外放场景下的人声增强效果，可开启人声增强音效并设置增强等级，增强等级推荐配置为4，可用于KTV外放场景下，精细控制人声效果。
注意：通过CDN拉取转码流时，必须使用转推CDN。如需使用该功能，请联系ZEGO技术支持。
单流转码，指在云端把每条原始流转换为不同编码格式、不同分辨率的转码流。拉流时需传入转码模板ID拉取转码流。在直播等场景中，观众可以基于接入网络质量、终端设备等，自行选择不同分辨率的流进行观看，以保证播放的流畅性。
同一个混流任务支持输出多个分辨率的视频流，可用于实现混流场景下的转码需求。
在混流功能支持将白板中的操作内容转成实时视频，且支持设置白板配置信息，例如，设置白板ID、白板宽高比、是否支持加载动态PPT等。
针对KTV场景的AEC优化，实现了：
发布日期：2023-02-23
发布日期：2023-01-13
范围场景支持设置推拉流模式，推拉流模式包括：是否允许拉取范围内的流、是否允许推流到世界。
注意：本功能为内测功能，如需接入体验，请联系ZEGO商务人员。
注意：自定义信令配置默认大小为1KB，如需扩展到4KB，请联系ZEGO技术支持进行处理。
发布日期：2022-12-09
面向在线KTV、一起看电影、看比赛等、视频会议、在线教育等音视频源丰富多样的互动场景，多源采集提供了灵活易用的音视频采集源与通道管理能力，大量减少开发者的开发及维护成本。
ZEGO自研调度系统针对网络质量极差地区进行了深度优化。
发布日期：2022-11-25
发布日期：2022-11-14
发布日期：2022.10.28
新增主体分割和传输功能。通过AI算法，将视频画面中的主体（多数情况下主体是人）从背景中分离出来，返回带透明通道的数据给SDK做编码处理。实现只传输视频中的主体而非原始矩形视频的效果。
SDK支持获取当前设备指定视频编解码器的编解码模式的支持情况，从而更好的帮助开发者选择使用的编码器及编码模式并获得更好的效果。
以上两个接口均包含三个枚举值：支持硬件或软件，支持硬件，支持软件。以Android端为例，isVideoEncoderSupported(ZegoVideoCodecID.H265,ZegoVideoCodecBackend.HARDWARE)，即表示检查当前设备是否支持H265的硬编，若支持，则返回true。
注意：该功能默认开启，如需关闭该功能，请联系ZEGO技术支持。
在App有获取地理位置权限的情况下，开发者可以选择是否允许ZEGOSDK获取系统缓存的GPS信息，默认进行获取。当开发者希望关闭该功能时，需要联系ZEGO技术支持进行设置。
支持每次开启远端摄像头后，SDK拉流并渲染完第一帧远端摄像头视频数据后进行回调，开发者可利用该回调统计首帧耗时，或更新播放流的UI组件。
针对1v1通话场景进行了优化，适用在纯RTC场景下使用。
对空间音频能力进行了优化，用户可以区分前后音源，从而达到更好的沉浸感。
SDK优化了内部策略，在音视频的场景下，支持最小下行50kbps拉流不卡顿，保障更好的极端弱网下的体验。
发布日期：2022.09.09
发布日期：2022.08.09
注意：若要开启该功能，需要联系ZEGO技术支持。
推拉流质量回调会每隔3s回调一次质量最差的结果，当周期内出现严重的抖动或丢包时，能够立刻反馈出流质量差。
优化日志上报策略，提高日志上传效率。
根据拉流质量动态调整拉流策略，提升整体拉流质量以及观众播放体验。
AGC新改进的谐波检测算法存在崩溃问题，现回退至老版本的谐波检测算法。
发布日期：2022.07.14
发布日期：2022.07.08
开发者可以根据业务场景选择不同的低照度增强模式：当希望自行判断是否需要进行低照度增强时，可以通过切模式1和2来控制；当希望SDK自动增强时，可以使用模式3，SDK将自动判断用户所处的光照环境，开启或关闭低照度增强。
修复2.20.0~2.20.2版本SDK采用L3拉流时，如果拉到的流是2.15.0及之前版本SDK推送的流，可能会失败的问题。
发布日期：2022.06.20
发布日期：2022.06.18
发布日期：2022-06-09
注意：必须等待媒体播放器结束播放后，接口调用才能生效。
注意：图片地址长度不得超出1024字节，否则出现错误码1005034；图片格式应为JPG和PNG格式，否则出现错误码1005035；图片不得超过1M，否则出现错误码1005036。
支持通过[startMixerTask]接口的“ZegoMixerImageInfo”类型参数，设置图片地址，将单条输入流的内容设置为图片，用于替代视频，即当使用图片时不显示视频。该功能的使用场景为连麦时，视频用户可能需要暂时关闭摄像头而显示其头像图片，或者当视频用户和音频用户连麦，需要显示音频用户的头像图片。
开发者发现推流用户违规时，调用[mutePlayStreamVideo]接口暂停拉流用户拉取违规用户的视频流，要求违规用户整改。使用本功能，可避免因拉流用户的视频界面依然保留最后一帧导致的违规风险。
提供新的音量增益方式，开发者可以根据实际需求选择合适的音量增益方式。
注意：如需使用该功能，请联系ZEGO技术支持开通后台服务。
表示消息输入长度超出限制。出现此错误码时，请检查输入内容长度或联系ZEGO技术支持扩展消息内容长度。