发布日期: 2024-04-23
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
ZegoVoiceChangerPreset 新增 “汽车人”、“没电了” 两种变声效果的枚举值,丰富变声效果。
相关 API 请参考 setVoiceChangerPreset
相关 API 请参考 enableViewMirror
ZegoMixerTask 新增参数 mixImageCheckMode,用于控制背景图(backgroundImageURL)、输入流占位图(inputList.imageInfo.url)、水印图片(watermark.imageURL)等图片资源校验失败时,能否正常发起混流任务。
该功能默认不开启(mixImageCheckMode 默认取值为 0),表示严格执行图片校验,即必须满足参数原有的 “支持协议和格式”、“图片大小”、“图片资源请求成功” 等规则,才能正常发起混流任务。
ZEGO 服务端 API 混流接口此前已支持该功能,详情请参考 开始混流 的 CheckImageMode 参数。
相关 API 请参考 startMixerTask
AI 变声功能对运行设备的性能有一定要求,开发者可以通过 isAIVoiceChangerSupported 接口提前判断设备能否支持运行 AI 变声功能。
相关 API 请参考 isAIVoiceChangerSupported
改进优化
优化超分效果,降低了算法锐度,从而提升了在原始画面有噪点、画面中有人脸等情况下的主观质量。例如,主播脸上的瑕疵不会被突出、主播的发缝不会变得更明显。
优化超分算法在高通芯片上的帧率表现。
问题修复
发布日期: 2024-03-29
问题修复
发布日期: 2024-03-14
新增功能
注意:
该功能的安全性与传统方式相比稍低,请酌情使用。
使用该功能时,需要将 ZegoCDNConfig > protocol 设置为 “quic”。
ZegoCDNConfig 新增 quicConnectMode 属性,开发者在使用 QUIC 协议进行 CDN 推拉流时,可以设置为 QUIC 建连模式(即 quicConnectMode 取值为 1),0-RTT 建立连接,快速启用服务。目前已适配华为、网宿、腾讯等厂商的 CDN 直播产品。
该功能默认不开启(即 quicConnectMode 默认为 0,表示正常建立连接)。
相关 API 请参考 ZegoCDNConfig > quicConnectMode
注意:该功能只在发起转推时生效,转推过程中如果出现断连,SDK 会保持重试逻辑,此时无该回调通知。
发起转推任务时,支持通过 addPublishCdnUrl 接口,设置转推 CDN 的超时时间,用于监控流是否存在。例如,开发者已经发起转推任务,但该条流还未开始推流,在超过设置的超时时间后,SDK 会返回一个流不存在的回调通知。
该回调只会通知给转推发起者、而不是推流发起者。如果转推发起者和推流发起者不是同一个用户,建议开发者从服务端发起转推、并接收该通知。
相关 API 请参考 addPublishCdnUrl
ZegoDataRecordProgress 新增 quality 属性,在本地录制过程中,通过该属性回调录制文件的帧率、码率等质量数据。
相关 API 请参考 onCapturedDataRecordProgressUpdate
自定义视频渲染支持独立通道控制。例如,针对指定流 ID 只进行 SDK 内部渲染、但不执行自定义渲染。
相关 API 请参考 enableCapturedVideoCustomVideoRender, enableRemoteVideoCustomVideoRender
注意:
该功能会增加性能消耗,请酌情使用。
SurfaceTexture 类型的视频数据不支持使用该功能。
支持在获取到 Express SDK 视频前处理过的数据后,再进行其他的视频前处理操作(例如美颜等,需要开发者自行实现)、或将处理过的视频数据直接用于预览或推流。
相关 API 请参考 sendCustomVideoProcessedTextureData
注意:外部采集功能和视频前处理功能不能同时使用,否则可能会出现拉流画面异常。
支持在开启外部采集功能后,分别通过 setLowlightEnhancement 和 enableColorEnhancement 接口,开启低照度增强和色彩增强,对采集画面进行调整,以满足业务需要。
相关 API 请参考 setLowlightEnhancement, enableColorEnhancement
注意:如需使用该功能,请联系 ZEGO 技术支持。
房间内有用户不支持 H.265 格式时,支持推流端回退到 H.264 格式重新推流。
改进优化
优化媒体推流器的回调通知逻辑,增加对“不支持的音频采样率”(例如,不支持 24K 的采样率)的错误回调,帮助开发者快速定位问题。
相关 API 请参考 onMediaDataPublisherFileClose
优化色彩增强算法,在画面色彩饱和度较高的场景下,相较之前的版本表现更佳。
注意:如需使用该功能,请联系 ZEGO 技术支持。
问题修复
发布日期: 2024-01-16
问题修复
发布日期: 2024-01-03
问题修复
发布日期: 2023-12-30
问题修复
发布日期: 2023-12-27
新增功能
注意:
如需使用该功能,请联系 ZEGO 技术支持。
版权音乐插件包无法单独使用,必须与 Express SDK 搭配使用。
支持版权音乐功能插件化,当开发者的业务场景仅需更新版权音乐相关的代码时,可以单独集成插件包,无需更新 Express SDK,即可平滑迁移。
注意:该功能获取的结果为房间内实时流列表;如果房间服务断开连接,获取的结果可能不准确。
支持开发者从客户端获取房间内的流列表,可以用于处理业务侧的相关逻辑。
相关 API 请参考 getRoomStreamList
注意:如需使用该功能,请联系 ZEGO 技术支持。
支持对转推到 CDN 的音视频流补静音帧,可以用于避免因时间戳不同步、造成的卡顿或音画不同步等问题发生。
支持获取当前播放的媒体文件的帧率统计信息,可以用于数据展示、异常监控等。
相关 API 请参考 getPlaybackStatistics
支持在本地缓存网络资源,如果需要播放同一个网络资源时,将优先使用缓存数据,提升用户体验。
相关 API 请参考 enableLocalCache, onMediaPlayerLocalCache
问题修复
发布日期: 2023-11-29
新增功能
注意:如需使用该功能,请联系 ZEGO 商务人员。
通过在云端转码服务中应用领先的编解码算法、以及其他视频前处理能力,持续优化视频播放的清晰度与流畅度,显著提升画质。该功能适用于以下场景:
观看量较大的秀场直播等场景。在保证视频流畅性和高质量的同时,节约带宽成本;同等主观画质下,能够降低 30% 左右的码率。
视频内容更复杂、色彩和纹理细节更丰富的弹幕游戏直播、体育直播等场景。同等拉流码率条件下,实现更高清的观看体验。
相关 API 请参考 ZegoMixerOutputVideoConfig > enableLowBitrateHD
针对各种摄像头等设备采集到的画面色彩偏灰、或饱和度偏低的情况,支持在保护人体肤色的同时,增强画面色彩,使其更加鲜艳明亮,更符合人眼真实的视觉感受,详情请参考 推流视频增强。
相关 API 请参考 enableColorEnhancement
支持向指定的客户端或客户服务器发送房间实时消息;消息类型分为 “普通消息”、“有序消息”,其中后者保证严格按照顺序接收消息。该功能适用于主播需要管理房间内的麦位等场景中,例如:
通过主播客户端,向需要闭麦的用户发送消息,接到消息的客户端进行闭麦。
主播希望将某用户踢出房间时,通过主播客户端,向对方的客户服务器发送消息、并踢出该用户。
相关 API 请参考 sendTransparentMessage
注意:该功能仅支持截图的前处理,不支持其他处理(如旋转、水印等)。
当采集设备输出的视频格式为 MJPEG 时,默认开启硬件解码加速能力,防止出现因设备性能不足而导致的帧率不足等问题。
该功能主要适用于在 4K 分辨率的采集设备上使用。
注意:
该功能默认不开启,即服务端使用默认的配置值。
该功能会增大延迟,请酌情使用。
自动混流接口支持设置水位,控制混流服务器拉流缓存的自适应调整的区间范围下限,以便在“混流耗时”和“推流端不稳定导致的画面卡顿”之间保持平衡。该功能设置后,仅对新的输入流生效,对于已经开始混流的输入流不生效。
例如实时合唱 KTV 场景中,推流端网络轻微波动可能会导致混流卡顿,此时观众观看时也会有较高概率出现卡顿。通过调节水位下限,可以优化观众端卡顿问题,但会增大延迟。
相关 API 请参考 ZegoAutoMixerTask > minPlayStreamBufferLength
新增支持将直播流作为输入流,进行混流处理;直播输入流的 URL 支持 RTMP 和 HTTP-FLV 两种协议。该功能适用于将主播连麦的RTC 画面流与云端体育直播流、游戏直播画面流等进行混合,实现游戏或体育直播解说的场景中。
在使用自定义音视频采集功能、且对应的采集源音频延迟不一致的情况下,可以在混流时自定义音频偏移值,从而实现混流输出后的音视频对齐,保证观众端的体验。
相关 API 请参考 ZegoMixerInput > advancedConfig
媒体播放器支持在检测到视频分辨率发生变化时,抛出相关回调通知开发者。该功能适用于推流画面的分辨率存在多次变更,需要调整推流端编码分辨率、拉流端渲染视图大小进行匹配的场景中。
相关 API 请参考 onMediaPlayerVideoSizeChanged
音效播放器支持分别设置推流音量、本地播放音量,保证本端和远端的音量大小都处于合适的区间。
相关 API 请参考 ZegoAudioEffectPlayer > setPublishVolume, ZegoAudioEffectPlayer > setPlayVolume, ZegoAudioEffectPlayer > setPublishVolumeAll, ZegoAudioEffectPlayer > setPlayVolumeAll
支持获取 3A 等音频前处理操作之前的音频数据。开发者可以通过 [enableBeforeAudioPrepAudioData] 接口开启该功能,然后通过 [onBeforeAudioPrepAudioData] 回调抛出音频数据。
相关 API 请参考 enableBeforeAudioPrepAudioData, onBeforeAudioPrepAudioData
改进优化
优化服务端混流及单流转码能力,提高编码效率,同等码率下提升 5% 以上的主客观画质。
用户在 A 设备上登录成功后,A 设备断网;然后使用同一 userID 在 B 设备上登录成功。此时如果 A 设备网络恢复,重连会失败,并抛出 1002086 错误码,提示该 userID 已在其他设备登录。
问题修复
发布日期: 2023-11-18
问题修复
发布日期: 2023-11-09
问题修复
发布日期: 2023-10-13
新增功能
注意:
“AI 变声”功能为付费功能,如需申请体验或咨询正式收费标准,请联系 ZEGO 商务人员。
当前官网 SDK 不包含此功能,如有需要,请联系 ZEGO 技术支持特殊编包。
新增 AI 变声功能,实时通话中的“柯南变声领结”,完美重现目标角色的音色与韵律,同时保留用户的语速、情感、语调,随心所欲切换音色,超低延迟让用户畅享社交语聊、直播、游戏语音等场景,详情请参考 AI 变声。
相关 API 请参考 createAIVoiceChanger, destroyAIVoiceChanger
注意:
当前官网 SDK 不包含此功能,如有需要,请联系 ZEGO 技术支持特殊编包。
虚拟背景的视频填充方式为居中及等比例缩放,视频过大时,超出部分会被裁减。
使用主体分割功能时,虚拟背景支持使用视频素材,视频素材的最终帧率会与编码帧率保持一致,且循环播放。视频素材的限制说明,请参考 主体分割。
相关 API 请参考 enableVideoObjectSegmentation
媒体播放器支持伴奏音质增强,提升伴奏的音质以及现场的氛围感,适用于语聊房、K 歌等场景中。
相关 API 请参考 enableLiveAudioEffect
注意:由于音频 Dump 文件属于用户的隐私敏感数据,因此开发者实现该能力时,请务必认真阅读 《即构隐私政策》 中关于 “使用音频 Dump 功能” 的内容。此外,在收集音频 Dump 文件时,请在获得用户授权同意时,同步注明 Express SDK 收集目的。
支持将处理前后的音频数据保存下来并上传,用于定位音频相关问题、提高问题排查效率、缩短接入时间,详情请参考 如何获取、上传音频的 Dump 文件?
相关 API 请参考 startDumpData, stopDumpData, uploadDumpdata, removeDumpData, onRequestDumpData, onStartDumpData, onStopDumpData, onUploadDumpData
支持提取、编码和传输开发者自定义采集的 RGBA 通道中的 Alpha 通道数据,从而在拉流端渲染出透明背景的主体,实现更加沉浸、真实的视频场景。
相关 API 请参考 enableAlphaChannelVideoEncoder
改进优化
在低照度增强的自动模式下,亮度的动态调整将更加流畅平滑,提升用户视觉体验。
相关 API 请参考 setLowlightEnhancement
优化网络测速的期望推、拉流码率上限,提升至 15M。开发者可以在推拉流前,检查音视频质量与当前网络的匹配程度,以保证通话质量稳定。
相关 API 请参考 startNetworkSpeedTest
注意:新增接口 muteAllPlayAudioStreams、muteAllPlayVideoStreams 与旧接口 muteAllPlayStreamAudio、muteAllPlayStreamVideo 之间不能混用。
新增接口 muteAllPlayAudioStreams、muteAllPlayVideoStreams 接口,用于在拉流时接收所有远端用户的音视频数据;同时支持通过 mutePlayStreamAudio、mutePlayStreamVideo 接口,单独控制指定的流的接收状态。
旧接口 muteAllPlayStreamAudio、muteAllPlayStreamVideo 调用后,无法单独控制指定流的接收状态。
相关 API 请参考 muteAllPlayAudioStreams, muteAllPlayVideoStreams, mutePlayStreamAudio, mutePlayStreamVideo
注意:播放过程中,如果修改了媒体流类型,会在下一次播放时生效。
使用媒体播放器播放音视频文件时,支持通过 setPlayMediaStreamType 接口,设置为“仅播放音频” 或“仅播放视频”,不消耗音视频解码性能。
相关 API 请参考 setPlayMediaStreamType
问题修复
相关 API 请参考 onAudioMixingCopyData
发布日期: 2023-09-08
新增功能
相关 API 请参考 onPlayerRecvMediaSideInfo
注意:
如需使用该功能,请联系 ZEGO 技术支持。
转码会造成额外的延迟,不建议您在使用 RTC 拉流的麦上场景中使用该功能。
RTC 拉流时,支持通过预设的转码模板触发单流转码任务,输出不同分辨率的转码流,详情请参考 单流转码。
该功能可用于直播等场景中,观众可以基于网络质量、终端设备等,选择不同分辨率的流进行观看,确保播放的流畅性。
相关 API 请参考 ZegoPlayerConfig > codecTemplateID
相关 API 请参考 onPublisherDummyCaptureImagePathError
相关 API 请参考 enablePublishDirectToCdn
注意:当前官网 SDK 不包含此功能,如有需要,请联系 ZEGO 技术支持特殊编包。
支持均衡型 AI 降噪模式,与原有模式相比,在相同的人声保真效果前提下,噪音抑制效果明显提升,可以达到干净无噪音或不扰人的程度;但性能消耗稍微增加。适用于街道、马路、市场等较为嘈杂(信噪比低)的户外环境中,详情请参考 场景化 AI 降噪。
相关 API 请参考 ZegoANSMode > ZegoANSModeAIBalanced
改进优化
扩大 setLogConfig 接口的生命周期为 App 生命周期,且优先级高于 setEngineConfig 接口中的配置。
相关 API 请参考 setLogConfig, setEngineConfig
优化 App 休眠时的重试规则,登录房间和推拉流过程中,“App 休眠时间”也计入“最大允许重试时间”。
问题修复
发布日期: 2023-08-16
问题修复
发布日期: 2023-08-09
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
开发者设置“智能云代理”模式后,在 RTC 或 L3 拉流时,会优先使用直连网络模式进行尝试。如果直连网络不可用、且当前是蜂窝网络,则继续留在直连模式重试;如果直连网络不可用、且当前是非蜂窝网络,则切到云代理模式,详情请参考 云代理。
自定视频前处理功能支持“双输出”,即支持输出“内存数据”和 “2D 纹理数据”。开发者可以通过这些数据,实现第三方美颜功能,更高性能地进行人脸检测和美颜。
相关 API 请参考 onCapturedUnprocessedRawData, ZegoVideoBufferTypeGLTexture2DAndRawData
注意:如需使用该功能,请联系 ZEGO 技术支持。
新增支持抛出编码和硬件解码的低帧率告警回调,在 1v1 聊天、直播等场景中,开发者可基于该回调,实现调整推流分辨率、触发转码等操作。
相关 API 请参考 onPlayerLowFpsWarning, onPublisherLowFpsWarning
新增从非 UI 线程抛出视频网络首帧的回调 onPlayerSyncRecvVideoFirstFrame,该回调不受 UI 卡顿的影响,能够更准确的统计视频首帧数据。
相关 API 请参考 onPlayerSyncRecvVideoFirstFrame
媒体播放器支持设置网络资源的 Http Headers,开发者可基于该配置,自定义限定网络资源的访问方式,加强资源的安全防护。
相关 API 请参考 setHttpHeader
改进优化
问题修复
发布日期: 2023-07-13
新增功能
注意:
使用此功能前,需要先调用 setVideoConfig 接口,指定视频编码格式 codecID 为 “ZegoVideoCodecIDH264DualStream(大小流编码)”。
设置大流、小流的分辨率的 “比例” 需要保持一致,否则调用接口会出错。
在指定编码格式为 “大小流编码” 的情况下,支持分别设置大流和小流的分辨率、帧率和码率,详情请参考 视频大小流和分层编码。
相关 API 请参考 ZegoExpressEngine > setVideoConfig, setPublishDualStreamConfig
在万人范围音视频、游戏语音场景中,支持设置 3D 音效距离的衰减范围区间 [min, max]。距离小于 min 时,音量不会随着距离的增加而衰减;距离大于 max 时,将无法听到对方的声音。
相关 API 请参考 setReceiveRange, setAudioReceiveRange
新增语音检测(1018xxxxx)、万人范围音视频(1019xxxxx)、屏幕采集(1020xxxxx)三个模块的错误码,详情请参考 常见错误码。
改进优化
相关 API 请参考 onNetworkQuality
相关 API 请参考 submitLog
问题修复
发布日期: 2023-06-09
新增功能
在实景或绿幕场景中,开发者可以通过该功能对用户的背景进行虚化模糊处理,或替换为自定义图片背景,详情请参考 主体分割。
该功能可用于视频会议、1v1 音视频通话等场景中,帮助用户更好的保护个人隐私,以及提升通话的趣味性。
相关 API 请参考 enableVideoObjectSegmentation
屏幕采集功能在仅支持采集图像的基础上,增加了采集系统音频的能力,从而实现共享演示课件画面的同时,共享正在播放的音乐。该功能可用于在线教学、游戏直播等场景中。
相关 API 请参考 startScreenCapture
新增增强型 KTV 混响效果,实现更集中、亮度更好的 KTV 人声效果。与之前的 KTV 混响音效相比,Enhanced KTV 混响效果缩短了混响时长,提高了干湿比。
原有的 KTV 混响音效仅适用于人声瑕疵较为明显的用户,增强型 KTV 混响效果适用于大多数专业用户和普通用户。
相关 API 请参考 setReverbPreset
开发者可以通过设置媒体播放器、音效播放器的位置和朝向,实现本地音频、在线音频资源的 3D 音效。该功能可用于在虚拟场景中设置物品的音效、以及指定位置的背景音乐等。
相关 API 请参考 ZegoMediaPlayer > updatePosition, ZegoAudioEffectPlayer > updatePosition
针对媒体播放器正在播放的视频文件,开发者可以主动获取视频的分辨率、帧率等信息。
相关 API 请参考 getMediaInfo
媒体播放器倍速的上限提升到 4 倍速。例如,用户在播放音视频文件时,如果已设置为 2 倍速播放,长按屏幕时可以加速至 4 倍速。
相关 API 请参考 ZegoMediaPlayer > setPlaySpeed
改进优化
为了方便开发者使用屏幕共享功能,从 3.6.0 版本开始,在本地下载的 SDK 中提供了 AAR 包,并在 Maven 在线集成方式的 AAR 包中携带了屏幕共享的 Service 声明,开发者无需手动在自己工程中声明,详情请参考 屏幕共享。
注意: 当前官网 SDK 不包含此功能,如有需要,请联系 ZEGO 技术支持特殊编包。
当麦克风与人体区域存在部分重叠时,可以保留重叠区域的麦克风形状,以维持完整的人体区域形状。
相关 API 请参考 enableVideoObjectSegmentation
问题修复
发布日期: 2023-05-11
新增功能
在进行音视频推流时,通过 onPublisherSendAudioFirstFrame、onPublisherSendVideoFirstFrame 回调,监听“首帧音频”或“首帧视频”的发布时机。该功能可用于统计音视频推流的耗时、或更新 UI 表现等。
相关 API 请参考 onPublisherSendAudioFirstFrame, onPublisherSendVideoFirstFrame
在通过媒体播放器进行音视频渲染时,通过 onMediaPlayerFirstFrameEvent 回调,监听渲染完成后的“首帧音频”或“首帧视频”的发布时机。该功能可用于音视频渲染的耗时、或更新 UI 表现等。
相关 API 请参考 onMediaPlayerFirstFrameEvent
注意:如需使用该功能,请联系 ZEGO 技术支持。
使用外部采集功能时,支持通过实验性 API 接口主动偏移 NTP 时间戳。该功能可用于 KTV 的合唱、伴奏、歌词对齐等场景。
多房间模式下,支持通过 switchRoom 接口,快速便捷地实现切换房间的功能。
相关 API 请参考 switchRoom
改进优化
注意:如需使用该功能,请联系 ZEGO 技术支持。
针对华为机型设备,SDK 支持通过相关配置,降低 80% 的视频硬解耗时时长。
问题修复
发布日期: 2023-04-14
新增功能
针对在线播放器的版权音乐保护,媒体播放器支持边下载边回调未解密的二进制数据,由开发者解密后再传回媒体播放器播放,过程中不会产生文件或缓存文件。
相关 API 请参考 setBlockDataHandler
注意:
相关 API 请参考 enableVideoObjectSegmentation
支持动态开关流量控制功能,同时支持设置流量控制属性等。
相关 API 请参考 enableTrafficControl, setMinVideoBitrateForTrafficControl, setMinVideoFpsForTrafficControl, setMinVideoResolutionForTrafficControl
改进优化
删除 SDK 内部一些没必要的内存申请,优化 SDK 内存使用率,相比上个版本,内存使用率减少了 10% 左右。
废弃删除
为规避数据同步异常的情况,将在 3.4.0 及以上版本,废弃 [onPlayerRecvSEI] 接口,若需收取远端流的 SEI 内容,请使用 [onPlayerSyncRecvSEI] 接口替代。
相关 API 请参考 onPlayerSyncRecvSEI
发布日期:2023-03-23
问题修复
发布日期: 2023-03-10
新增功能
在外放场景中,设备的麦克风与扬声器过近,容易导致人声模糊或沉闷。在该场景下,人声增强可以有效提升人声清晰度并改善沉闷感,因此在外放场景下,建议开启该功能。
为实现外放场景下的人声增强效果,可开启人声增强音效并设置增强等级,增强等级推荐配置为 4,可用于 KTV 外放场景下,精细控制人声效果。
相关 API 请参考 enableSpeechEnhance
注意:如需使用该功能,请联系 ZEGO 技术支持。
在自定义音频采集和 SDK 内部渲染模式下,支持混音自适应对齐和 AEC 功能,可使在实现 KTV 场景下的合唱时,达到更好的效果。
媒体播放器支持通过渲染 Alpha 通道,实现播放透明特效文件功能,详情请参考 播放透明礼物特效。
相关 API 请参考 loadResourceWithConfig
注意:通过 CDN 拉取转码流时,必须使用转推 CDN。如需使用该功能,请联系 ZEGO 技术支持。
单流转码,指在云端把每条原始流转换为不同编码格式、不同分辨率的转码流。拉流时需传入转码模板 ID 拉取转码流。在直播等场景中,观众可以基于接入网络质量、终端设备等,自行选择不同分辨率的流进行观看,以保证播放的流畅性。
注意:
同一个混流任务支持输出多个分辨率的视频流,可用于实现混流场景下的转码需求。
在混流功能支持将白板中的操作内容转成实时视频,且支持设置白板配置信息,例如,设置白板 ID、白板宽高比、是否支持加载动态 PPT 等。
相关 API 请参考 setWhiteboard, startMixerTask
场景化音视频配置新增 [StandardVoiceCall] 标准语音通话场景,适用于 1v1 纯语音通话场景,详情请参考 场景化音视频配置。
相关 API 请参考 setRoomScenario
改进优化
注意:[enableVideoSuperResolution] 修改了调用时机,需要在 [initVideoSuperResolution] 后才能调用。
相关 API 请参考 enableVideoSuperResolution, initVideoSuperResolution
注意:[enableVideoSuperResolution] 修改了调用时机,需要在 [initVideoSuperResolution] 后才能调用。
相关 API 请参考 initVideoSuperResolution, uninitVideoSuperResolution
针对 KTV 场景的 AEC 优化,实现了:
问题修复
发布日期: 2023-02-23
问题修复
发布日期: 2023-01-13
新增功能
范围场景支持设置推拉流模式,推拉流模式包括:是否允许拉取范围内的流、是否允许推流到世界。
相关 API 请参考 enablePlayInRange, enablePublishToWorld
注意:本功能为内测功能,如需接入体验,请联系 ZEGO 商务人员。
改进优化
注意:自定义信令配置默认大小为 1KB,如需扩展到 4KB,请联系 ZEGO 技术支持进行处理。
发布日期: 2022-12-12
问题修复
发布日期: 2022-12-09
新增功能
面向在线 KTV、一起看电影、看比赛等、视频会议、在线教育等音视频源丰富多样的互动场景,多源采集提供了灵活易用的音视频采集源与通道管理能力,大量减少开发者的开发及维护成本。
多源采集能力对屏幕共享、混音等常见能力的实现路径,进行缩短优化及归一化设计,从 3.1.0 版本后,您可以不用再通过自定义采集实现上述复杂的能力,详情请参考 多源采集文档 。 主要能力特性如下:
注意:如需使用该功能,请联系 ZEGO 技术支持。
通过设置 SDK 的云代理接口,将 SDK 对应的所有流量通过云端的代理服务器进行中转,实现与 RTC 通信,详情请参考 云代理文档 。
相关 API 请参考 setCloudProxyConfig
改进优化
ZEGO 自研调度系统针对网络质量极差地区进行了深度优化。
问题修复
Logout
信令可能失败的问题发布日期: 2022-11-14
问题修复
发布日期: 2022-11-03
问题修复
发布日期:2022.10.28
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
新增 enableVideoSuperResolution 接口支持对某一条视频流进行超分辨率处理,从而得到更好的画质。超分辨率,简称超分,是客户端对拉取的视频流的宽和高进行实时倍增处理的技术,例如,从 640x360 超分为 1280x720,详情请参考 超分辨率 文档。
相关 API 请参考 enableVideoSuperResolution、onPlayerVideoSuperResolutionUpdate
注意:如需使用该功能,请联系 ZEGO 技术支持。
场景化 AI 降噪功能,在之前针对所有非人声进行降噪的基础上,新增支持在音乐场景下的降噪能力,通过识别音乐,智能调整降噪效果还原音乐音质。SDK 会实时对麦克风输入内容进行音乐检测,在声卡、弹唱或近场音乐场景下,自动调整降噪等级,保证音乐的高保真音质,详情请参考 场景化 AI 降噪 文档。
注意:如需使用该功能,请联系 ZEGO 技术支持。
SDK 面向虚拟场景提供有序、高频、低延时、大规模的状态同步云服务,帮助客户快速实现玩家位置、动作、形象等实时信息同步能力,同时单场景中支持 1 万个用户同时在线。
大型虚拟世界中,用户一般不需要感知较远的场景或远端用户,ZEGO 提供 AOI(Area Of Interest)能力,减免用户可见范围外的信息,极大减少客户流量成本以及用户端流量及性能消耗。
相关 API 请参考 ZegoRangeScene
注意:如需使用该功能,请联系 ZEGO 技术支持进行特殊编包。
万人范围音视频功能支持超大规模的范围音视频互动,云端服务基于用户位置动态选路,在大型虚拟场景中保持沉浸式互动体验的同时大量减少客户音视频成本。
依赖多人状态实时同步服务,根据云端用户位置自动拉取收听范用内的远端音视频并提供空间音效。单场景内最大支持 1 万用户同时开启麦克风及摄像头,用户默认拉取距离最近的 12 路(可配置)音视频。
相关 API 请参考 ZegoRangeScene
为方便开发者快速接入,降低开发者接入门槛,SDK 提供多种预设场景。开发者可根据所需场景,选择对应的房间模式 ZegoScenario,SDK 将自动应用适合该场景的音视频编解码器、音视频参数、流控策略等配置,从而快速实现该场景下的最佳效果。
当前支持场景包括秀场直播、KTV、标准 1v1 音视频通话、高画质 1v1 音视频通话、标准语聊房、高音质语聊房,详情请参考 场景化音视频配置 文档。
相关 API 请参考 setRoomScenario
SDK 支持获取当前设备指定视频编解码器的编解码模式的支持情况,从而更好的帮助开发者选择使用的编码器及编码模式并获得更好的效果。
以上两个接口均包含三个枚举值:支持硬件或软件,支持硬件,支持软件。以 Android 端为例,isVideoEncoderSupported(ZegoVideoCodecID.H265, ZegoVideoCodecBackend.HARDWARE),即表示检查当前设备是否支持 H265 的硬编,若支持,则返回 true。
相关 API 请参考 isVideoEncoderSupported、isVideoDecoderSupported
注意:如需使用该功能,请联系 ZEGO 技术支持。
注意:该功能默认开启,如需关闭该功能,请联系 ZEGO 技术支持。
在 App 有获取地理位置权限的情况下,开发者可以选择是否允许 ZEGO SDK 获取系统缓存的 GPS 信息,默认进行获取。当开发者希望关闭该功能时,需要联系 ZEGO 技术支持进行设置。
支持每次开启远端摄像头后,SDK 拉流并渲染完第一帧远端摄像头视频数据后进行回调,开发者可利用该回调统计首帧耗时,或更新播放流的 UI 组件。
相关 API 请参考 onPlayerRenderCameraVideoFirstFrame
改进优化
注意:如需使用该功能,请联系 ZEGO 技术支持。
针对 1v1 通话场景进行了优化,适用在纯 RTC 场景下使用。
对空间音频能力进行了优化,用户可以区分前后音源,从而达到更好的沉浸感。
优化 AGC 自动增益控制算法,当采集音量过大时,不会造成破音情况。
SDK 优化了内部策略,在音视频的场景下,支持最小下行 50 kbps 拉流不卡顿,保障更好的极端弱网下的体验。
问题修复
废弃删除
废弃 ZegoScenario 场景枚举中的 [General],[Communication], [Live] 三种场景,详情请参考 场景化音视频配置 文档。
发布日期:2022.09.09
新增功能
由于移动端摄像头具备角度、分辨率、旋转等特性,开发者需要做许多复杂的适配。
当前 SDK 对各种配置进行封装,对外提供简单的模式选择,在原有自定义模式基础上,新增固定比例模式、自适应模式及对齐模式,可有效降低开发者接入成本,详情请参考 视频采集旋转 。
相关 API 请参考:setAppOrientationMode
改进优化
注意:如需使用该功能,请联系 ZEGO 技术支持。
优化超分功能表现,提高支持的最大分辨率、提升机型覆盖、优化资源占用和推理速度。
为了提升 Android 端开发体验,从 v2.23.0 版本开始将以 jar 包的形式交付 Java 源码,开发者可通过 Android Studio 导入源码 jar 包以获得 API 注释,详情请参考 Express Android SDK 如何查看 API 注释和文档?。
为了方便跨平台框架开发者,我们给 Java SDK 附带了 C++ 接口头文件。由于 C++ 接口是 Header Only 形式,仅使用 Java 接口时不会增大集成 SDK 后的包大小,另外请勿同时使用两套 API 以避免 SDK 生命周期错乱。
问题修复
发布日期:2022.08.09
新增功能
若在内网或防火墙场景下,您可以通过代理服务器与公网交互,并通过 setEngineConfig 设置代理服务器地址,保证 ZEGO 音视频云服务正常,目前仅支持 socks5,详情请参考 本地代理。
相关 API 请参考 setEngineConfig
注意:
相关 API 请参考 enableCustomVideoCapture
新增 setAudioDeviceMode 接口进行动态修改设备的音频模式,该配置决定设备的音量模式、前处理模式以及 Mic 占用逻辑,您可以根据具体场景进行选择,详情请参考 如何设置音频设备模式 ZegoAudioDeviceMode?。
相关 API 请参考 setAudioDeviceMode
注意:
相关 API 请参考 enableAlignedAudioAuxData、onAlignedAudioAuxData、enableAux
CDN Plus将 ZEGO 自研高质量 L3 拉流与多个优质第三方 CDN 进行无缝融合,实现直播内容分发,当发生 CDN 质量灾害时,可以通过云端质量结合的方式快速感知,并通过秒级切换 L3 及其他优质 CDN 的方式来保障直播的流畅稳定,从而防止因 CDN 云商故障导致的长时间、大面积的运营事故及造成的业务损失。
改进优化
当远端用户异常时,onNetworkQuality 每 2s 回调一次质量未知状态(ZegoStreamQualityLevelUnknown 状态),当用户该状态持续 8s 后,则认为远端用户已异常断开,此时回调质量异常状态(ZegoStreamQualityLevelDie 状态)。
相关 API 请参考 onNetworkQuality
推拉流质量回调会每隔 3s 回调一次质量最差的结果,当周期内出现严重的抖动或丢包时,能够立刻反馈出流质量差。
相关 API 请参考 onPlayerQualityUpdate,onPublisherQualityUpdate,onNetworkQuality
优化日志上报策略,提高日志上传效率。
根据拉流质量动态调整拉流策略,提升整体拉流质量以及观众播放体验。
AGC 新改进的谐波检测算法存在崩溃问题,现回退至老版本的谐波检测算法。
问题修复
发布日期:2022.07.14
问题修复
发布日期:2022.07.08
新增功能
注意:应在调用 createEngine 接口创建引擎后,再调用 setLowlightEnhancement 接口。
当推流端用户周围环境较暗、或摄像头设置的帧率较高,导致直播画面比较暗,无法正常显示或识别主体的情况下,可调用 setLowlightEnhancement 接口,设置低照度增强,提升视频画面亮度。低照度增强功能包含三种模式:1:不开启低照度增强(默认)、2:开启低照度增强 、3:自动开关低照度增强。
开发者可以根据业务场景选择不同的低照度增强模式:当希望自行判断是否需要进行低照度增强时,可以通过切模式 1 和 2 来控制;当希望 SDK 自动增强时,可以使用模式 3 ,SDK 将自动判断用户所处的光照环境,开启或关闭低照度增强。
相关 API 请参考 setLowlightEnhancement
在调用 startMixerTask 接口混流时,开发者可以通过 “ZegoMixerInput” 类型参数,设置 “cornerRadius”(视频画面圆角半径),将视频边框设置为圆角。“cornerRadius” 的单位为 px,取值不得超过视频画面宽高中较短者的一半。
相关 API 请参考 startMixerTask
注意:若希望通过地区、用户等更多维度,从云端控制拉流方式,请联系 ZEGO 技术支持进行相关配置。
拉流接口新增 CDN_PLUS 的拉流资源模式(ZegoResourceType),开发者可按流维度自行开启使用CDN_PLUS 拉流。CDN Plus 拉流是比 CDN 拉流直播质量更高,但是价格接近 CDN 的一种性价比高的拉流方式,详情请参考 CDN Plus 拉流。
相关 API 请参考 startPlayingStream
改进优化
新增 1002074、1002075、1002076、1002077、1002078、1002079、1002080 等错误码。开启强制登录鉴权后,如果 Token 错误时,会返回这些错误码,详情请参考 常见错误码 中的详细解释和处理建议。
问题修复
修复 2.20.0 ~ 2.20.2 版本 SDK 采用 L3 拉流时,如果拉到的流是 2.15.0 及之前版本 SDK 推送的流,可能会失败的问题。
发布日期:2022.06.20
问题修复
发布日期:2022.06.18
问题修复
发布日期:2022-06-09
新增功能
在调用 createEngine 接口初始化引擎以及 createMediaPlayer 接口创建媒体播放器后,可以调用 setActiveAudioChannel 接口设置左声道、右声道或立体声。初始化时,媒体播放器默认为全部声道。
相关 API 请参考 setActiveAudioChannel
注意:必须等待媒体播放器结束播放后,接口调用才能生效。
调用 createEngine 接口初始化引擎,调用 createMediaPlayer 接口创建媒体播放器,可以调用 clearView 清除遗留的最后一帧画面。
相关 API 请参考 clearView
注意:当通过 setVideoConfig 设置的帧率小于 enableCameraAdaptiveFPS 期望帧率最小值时,将使用 setVideoConfig 设置的帧率值。由于不同的手机厂商的硬件和算法策略不同,该接口在不同的机型或同一机型的前后摄像头上,效果存在一定差异。
当推流端用户设置的帧率较高,而所处环境光照较低无法正常显示或识别主体的情况下,可以调用 enableCameraAdaptiveFPS 接口,在一定范围内自动降低帧率来增加曝光时间,从而提升视频画面亮度。该功能常用于对曝光要求较高的直播场景。enableCameraAdaptiveFPS 接口需在调用 createEngine 接口初始化引擎之后,启动摄像头前调用。
相关 API 请参考 enableCameraAdaptiveFPS
注意:图片地址长度不得超出1024 字节,否则出现错误码 1005034;图片格式应为 JPG 和 PNG 格式,否则出现错误码 1005035;图片不得超过 1M,否则出现错误码 1005036。
支持通过 startMixerTask 接口的 “ZegoMixerImageInfo” 类型参数,设置图片地址,将单条输入流的内容设置为图片,用于替代视频,即当使用图片时不显示视频。该功能的使用场景为连麦时,视频用户可能需要暂时关闭摄像头而显示其头像图片,或者当视频用户和音频用户连麦,需要显示音频用户的头像图片。
相关 API 请参考 startMixerTask
注意:如需使用该功能,请联系 ZEGO 技术支持。
开发者发现推流用户违规时,调用 mutePlayStreamVideo 接口暂停拉流用户拉取违规用户的视频流,要求违规用户整改。使用本功能,可避免因拉流用户的视频界面依然保留最后一帧导致的违规风险。
注意:如需使用该功能,请联系 ZEGO 技术支持。
提供新的音量增益方式,开发者可以根据实际需求选择合适的音量增益方式。
注意:如需使用该功能,请联系 ZEGO 技术支持开通后台服务。
在调用 startPublishingStream 接口开始推流时,开发者可以设置 “ZegoStreamCensorshipMode” 参数,进行流级别的音视频自动审核,自动鉴别涉黄涉政内容,以此降低开发者的接入难度和业务维护成本。
相关 API 请参考 startPublishingStream
改进优化
从 v2.20.0 版本起,实时音视频和实时语音之间不再有 API 的差异,即可以随时从实时音视频 SDK 切换到实时语音 SDK,反之亦然。两种 SDK 之间唯一的区别是对于实时语音 SDK 来说,部分跟视频相关的 API (比如视频编码参数设置、预览和拉流的 ZegoCanvas 参数等)设置后没有效果,但不会报错。注意此次改动可能会产生极少数不兼容问题,具体请参考 FAQ 文档 升级 Express v2.20.0 或以上版本后编译报错?
表示消息输入长度超出限制。出现此错误码时,请检查输入内容长度或联系 ZEGO 技术支持扩展消息内容长度。
在版权音乐初始化时,由于未设置 AppSign 或 Token,导致鉴权失败,会出现此错误码。此时,如果是使用 AppSign 鉴权,请在初始化 SDK 时传入 AppSign;如果是使用 Token 鉴权,在调用 initCopyrightedMusic 接口前,请调用 loginRoom 接口并传入 Token,以供鉴权。
相关 API 请参考 initCopyrightedMusic,loginRoom
问题修复
发布日期:2022-06-01
新增功能
畅直播首次发布,提供超低延迟直播、CDN Plus直播、CDN直播3种差异化服务,并提供多种直播推流、直播拉流等核心功能,更多功能和详情请参考 概述。
联系我们
文档反馈