发布日期: 2024-12-03
新增功能
如需使用该功能,请联系 ZEGO 技术支持。
AI AEC 轻量模式支持智能识别并且消除回声。相较传统 AEC 算法,人声保真度效果提升明显,且没有额外的延迟与功耗增量。适用于实时 KTV 、高音质语聊与视频等场景。
相关 API 请参考 ZegoAECModeAI
改进优化
部分机型由于睿频等原因引起性能不足,可能导致 AI 变声中途失效。现新增性能不足的相关回调通知,以便开发者做后续业务处理。
相关 API 请参考 aiVoiceChanger
问题修复
发布日期: 2024-09-27
改进优化
调用 loginRoom 接口登录房间时,userName
原来为必填字段,本次优化为非必填的可选字段。
相关 API 请参考 loginRoom
相关 API 请参考 setVoiceChangerParam
问题修复
发布日期: 2024-08-14
问题修复
发布日期: 2024-07-26
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
在 10ms 延迟下,依然保持纯净的降噪效果以及高保真的人声音质,适用于游戏语音、游戏开黑、实时合唱等对延迟较为敏感的场景,目前 AI 降噪已支持均衡模式、低延迟模式以及轻量模式,详情请参考 场景化 AI 降噪。
相关 API 请参考 setANSMode
注意:若某条流设置为允许审核,如果开发者没有发起审核任务,这条流也不会被送审。
当调用审核接口时,默认会对房间内的所有流进行审核。如果客户端要控制某条流不可以被送审,可以在调用 [startPublishingStream] 接口开始推流时,将送审标识 [streamCensorFlag] 参数设置为 1(不允许)。
相关 API 请参考 startPublishingStream, ZegoPublisherConfig > streamCensorFlag
媒体播放器的播放速度区间从 [0.5,4.0],扩大为 [0.3,4.0],更多内容请参考 媒体播放器。
相关 API 请参考 setPlaySpeed
注意:如需使用该功能,请联系 ZEGO 技术支持。
使用 ZEGO 超低延迟直播(L3)拉流时,支持根据用户的网络带宽自适应平滑切换不同码流,保障用户的流畅播放体验。
[ZegoPlayerConfig] 新增 adaptiveSwitch
和 adaptiveTemplateIDList
参数,用于支持 OnlyL3 拉流模式下,基于网络环境的码率自适应切换。
相关 API 请参考 startPlayingStream, adaptiveSwitch, adaptiveTemplateIDList
注意:如需使用该功能,请联系 ZEGO 技术支持。
新增 [switchPlayingStream] 接口,用于开发者拉 CDN 流时,平滑切换至其他 CDN 流,即成功拉到新流后,才会停止拉旧流。
例如,当视频画面从小窗口切换为大窗口时,需将视频切换为码率和分辨率更高的流,此时将会在成功拉到新流后,才会停止拉旧流,以达到平滑切换的效果。
相关 API 请参考 switchPlayingStream
注意:如需使用该功能,请联系 ZEGO 技术支持。
控制本端客户端编码兼容范围为房间内所有推流用户或所有用户,即当指定范围内存在用户不支持 H.265 时,本端客户端编码动态回退。
相关 API 请参考 loginRoom, startPublishingStream, ZegoPublisherConfig > codecNegotiationType, ZegoRoomConfig > capabilityNegotiationTypes
废弃删除
下架畅直播概念,废弃 CDN Plus 直播相关接口。如需实现直播功能,推荐使用 ZEGO 自研 超低延迟直播产品,实现更高质量的直播体验。
相关 API 请参考 ZegoStreamResourceModeCDNPlus
发布日期: 2024-06-05
问题修复
发布日期: 2024-05-29
新增功能
媒体播放器新增 [enableVoiceChanger] 接口 ,支持针对媒体播放器输出的声音内容开启变声效果,同时选择需要的变调音效。
相关 API 请参考 ZegoMediaPlayer > enableVoiceChanger
改进优化
优化 AI 场景化降噪中,“均衡模式”的降噪效果,在性能不变的情况下,人声清晰度、平稳度进一步提升,且噪音抑制更干净,详情请参考 场景化 AI 降噪。
废弃删除
为提升在变声情况下的播放体验,废弃媒体播放器 [ZegoMediaPlayer.setVoiceChangerParam] 接口,请使用 [ZegoMediaPlayer.enableVoiceChanger] 代替。
相关 API 请参考 ZegoMediaPlayer > enableVoiceChanger
发布日期: 2024-04-23
新增功能
ZegoVoiceChangerPreset 新增 “汽车人”、“没电了” 两种变声效果的枚举值,丰富变声效果。
相关 API 请参考 setVoiceChangerPreset
问题修复
发布日期: 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
改进优化
优化媒体推流器的回调通知逻辑,增加对“不支持的音频采样率”(例如,不支持 24K 的采样率)的错误回调,帮助开发者快速定位问题。
问题修复
发布日期: 2024-01-16
问题修复
发布日期: 2024-01-03
问题修复
发布日期: 2023-12-27
新增功能
注意:
如需使用该功能,请联系 ZEGO 技术支持。
版权音乐插件包无法单独使用,必须与 Express SDK 搭配使用。
支持版权音乐功能插件化,当开发者的业务场景仅需更新版权音乐相关的代码时,可以单独集成插件包,无需更新 Express SDK,即可平滑迁移。
注意:该功能获取的结果为房间内实时流列表;如果房间服务断开连接,获取的结果可能不准确。
支持开发者从客户端获取房间内的流列表,可以用于处理业务侧的相关逻辑。
相关 API 请参考 getRoomStreamList
注意:如需使用该功能,请联系 ZEGO 技术支持。
支持对转推到 CDN 的音视频流补静音帧,可以用于避免因时间戳不同步、造成的卡顿或音画不同步等问题发生。
支持获取当前播放的媒体文件的帧率统计信息,可以用于数据展示、异常监控等。
相关 API 请参考 getPlaybackStatistics
支持在本地缓存网络资源,如果需要播放同一个网络资源时,将优先使用缓存数据,提升用户体验。
相关 API 请参考 enableLocalCache
问题修复
发布日期: 2023-11-29
新增功能
支持向指定的客户端或客户服务器发送房间实时消息;消息类型分为 “普通消息”、“有序消息”,其中后者保证严格按照顺序接收消息。该功能适用于主播需要管理房间内的麦位等场景中,例如:
通过主播客户端,向需要闭麦的用户发送消息,接到消息的客户端进行闭麦。
主播希望将某用户踢出房间时,通过主播客户端,向对方的客户服务器发送消息、并踢出该用户。
相关 API 请参考 sendTransparentMessage
注意:
该功能默认不开启,即服务端使用默认的配置值。
该功能会增大延迟,请酌情使用。
自动混流接口支持设置水位,控制混流服务器拉流缓存的自适应调整的区间范围下限,以便在“混流耗时”和“推流端不稳定导致的画面卡顿”之间保持平衡。该功能设置后,仅对新的输入流生效,对于已经开始混流的输入流不生效。
例如实时合唱 KTV 场景中,推流端网络轻微波动可能会导致混流卡顿,此时观众观看时也会有较高概率出现卡顿。通过调节水位下限,可以优化观众端卡顿问题,但会增大延迟。
相关 API 请参考 ZegoAutoMixerTask > minPlayStreamBufferLength
新增支持将直播流作为输入流,进行混流处理;直播输入流的 URL 支持 RTMP 和 HTTP-FLV 两种协议。该功能适用于将主播连麦的RTC 画面流与云端体育直播流、游戏直播画面流等进行混合,实现游戏或体育直播解说的场景中。
在使用自定义音视频采集功能、且对应的采集源音频延迟不一致的情况下,可以在混流时自定义音频偏移值,从而实现混流输出后的音视频对齐,保证观众端的体验。
相关 API 请参考 ZegoMixerInput > advancedConfig
音效播放器支持分别设置推流音量、本地播放音量,保证本端和远端的音量大小都处于合适的区间。
相关 API 请参考 ZegoAudioEffectPlayer > setPublishVolume, ZegoAudioEffectPlayer > setPlayVolume, ZegoAudioEffectPlayer > setPublishVolumeAll, ZegoAudioEffectPlayer > setPlayVolumeAll
改进优化
用户在 A 设备上登录成功后,A 设备断网;然后使用同一 userID 在 B 设备上登录成功。此时如果 A 设备网络恢复,重连会失败,并抛出 1002086 错误码,提示该 userID 已在其他设备登录。
发布日期: 2023-10-13
新增功能
媒体播放器支持伴奏音质增强,提升伴奏的音质以及现场的氛围感,适用于语聊房、K 歌等场景中。
相关 API 请参考 enableLiveAudioEffect
注意:由于音频 Dump 文件属于用户的隐私敏感数据,因此开发者实现该能力时,请务必认真阅读 《即构隐私政策》 中关于 “使用音频 Dump 功能” 的内容。此外,在收集音频 Dump 文件时,请在获得用户授权同意时,同步注明 Express SDK 收集目的。
支持将处理前后的音频数据保存下来并上传,用于定位音频相关问题、提高问题排查效率、缩短接入时间,详情请参考 如何获取、上传音频的 Dump 文件?
相关 API 请参考 startDumpData, stopDumpData, uploadDumpData, removeDumpData, onRequestDumpData, onStartDumpData, onStopDumpData, onUploadDumpData
改进优化
优化网络测速的期望推、拉流码率上限,提升至 15M。开发者可以在推拉流前,检查音视频质量与当前网络的匹配程度,以保证通话质量稳定。
相关 API 请参考 startNetworkSpeedTest
注意:新增接口 [muteAllPlayAudioStreams]、[muteAllPlayVideoStreams] 与旧接口 [muteAllPlayStreamAudio]、[muteAllPlayStreamVideo] 之间不能混用。
新增接口 [muteAllPlayAudioStreams]、[muteAllPlayVideoStreams] 接口,用于在拉流时控制是否接收所有远端用户的音视频数据;同时支持通过 [mutePlayStreamAudio]、[mutePlayStreamVideo] 接口,单独控制指定的流的接收状态。
旧接口 [muteAllPlayStreamAudio]、[muteAllPlayStreamVideo] 调用后,无法单独控制指定流的接收状态。
相关 API 请参考 muteAllPlayAudioStreams, muteAllPlayVideoStreams, mutePlayStreamAudio, mutePlayStreamVideo
注意:播放过程中,如果修改了媒体流类型,会在下一次播放时生效。
使用媒体播放器播放音视频文件时,支持通过 [setPlayMediaStreamType] 接口,设置为“仅播放音频” 或“仅播放视频”,不消耗音视频解码性能。
相关 API 请参考 setPlayMediaStreamType
问题修复
发布日期: 2023-09-08
新增功能
相关 API 请参考 onPlayerRecvMediaSideInfo
相关 API 请参考 enablePublishDirectToCdn
注意:当前官网 SDK 不包含此功能,如有需要,请联系 ZEGO 技术支持特殊编包。
支持均衡型 AI 降噪模式,与原有模式相比,在相同的人声保真效果前提下,噪音抑制效果明显提升,可以达到干净无噪音或不扰人的程度;但性能消耗稍微增加。适用于街道、马路、市场等较为嘈杂(信噪比低)的户外环境中,详情请参考 场景化 AI 降噪。
相关 API 请参考 ZegoANSModeAIBalanced
改进优化
扩大 [setLogConfig] 接口的生命周期为 App 生命周期,且优先级高于 [setEngineConfig] 接口中的配置。
相关 API 请参考 setLogConfig, setEngineConfig
优化 App 休眠时的重试规则,登录房间和推拉流过程中,“App 休眠时间”也计入“最大允许重试时间”。
问题修复
发布日期: 2023-08-16
问题修复
发布日期: 2023-08-09
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
开发者设置“智能云代理”模式后,在 RTC 或 L3 拉流时,会优先使用直连网络模式进行尝试。如果直连网络不可用、且当前是蜂窝网络,则继续留在直连模式重试;如果直连网络不可用、且当前是非蜂窝网络,则切到云代理模式,详情请参考 云代理。
媒体播放器支持设置网络资源的 Http Headers,开发者可基于该配置,自定义限定网络资源的访问方式,加强资源的安全防护。
相关 API 请参考 setHttpHeader
改进优化
发布日期: 2023-07-13
新增功能
在万人范围音视频、游戏语音场景中,支持设置 3D 音效距离的衰减范围区间 [min, max]。距离小于 min 时,音量不会随着距离的增加而衰减;距离大于 max 时,将无法听到对方的声音。
相关 API 请参考 setReceiveRange, setAudioReceiveRange
新增语音检测(1018xxxxx)、万人范围音视频(1019xxxxx)、屏幕采集(1020xxxxx)三个模块的错误码,详情请参考 常见错误码。
改进优化
相关 API 请参考 onNetworkQuality
相关 API 请参考 submitLog
发布日期: 2023-06-09
新增功能
新增增强型 KTV 混响效果,实现更集中、亮度更好的 KTV 人声效果。与之前的 KTV 混响音效相比,Enhanced KTV 混响效果缩短了混响时长,提高了干湿比。
原有的 KTV 混响音效仅适用于人声瑕疵较为明显的用户,增强型 KTV 混响效果适用于大多数专业用户和普通用户。
相关 API 请参考 setReverbPreset
开发者可以通过设置媒体播放器、音效播放器的位置和朝向,实现本地音频、在线音频资源的 3D 音效。该功能可用于在虚拟场景中设置物品的音效、以及指定位置的背景音乐等。
相关 API 请参考 ZegoMediaPlayer > updatePosition, ZegoAudioEffectPlayer > updatePosition
媒体播放器倍速的上限提升到 4 倍速。例如,用户在播放音视频文件时,如果已设置为 2 倍速播放,长按屏幕时可以加速至 4 倍速。
相关 API 请参考 ZegoMediaPlayer > setPlaySpeed
问题修复
发布日期: 2023-05-11
新增功能
在进行音视频推流时,通过 [onPublisherSendAudioFirstFrame]、[onPublisherSendVideoFirstFrame] 回调,监听“首帧音频”或“首帧视频”的发布时机。该功能可用于统计音视频推流的耗时、或更新 UI 表现等。
相关 API 请参考 onPublisherSendAudioFirstFrame, onPublisherSendVideoFirstFrame
在通过媒体播放器进行音视频渲染时,通过 [firstFrameEvent] 回调,监听渲染完成后的“首帧音频”或“首帧视频”的发布时机。该功能可用于音视频渲染的耗时、或更新 UI 表现等。
注意:如需使用该功能,请联系 ZEGO 技术支持。
使用外部采集功能时,支持通过实验性 API 接口主动偏移 NTP 时间戳。该功能可用于 KTV 的合唱、伴奏、歌词对齐等场景。
多房间模式下,支持通过 [switchRoom] 接口,快速便捷地实现切换房间的功能。
相关 API 请参考 switchRoom
注意:
如需使用该功能,请联系 ZEGO 技术支持。
启动拉流以后,调用该接口才会生效。
支持开发者通过 [sendReferenceAudioPCMData] 接口,输入需要消除的声音(即参考信号),直接消除。
该功能可用于自定义采集渲染场景中。例如:用户外放背景音乐,同时上麦进行发言,其中背景音乐不是使用自定义渲染或外部渲染的声音,可通过该功能消除推流中包含的背景音乐回声。
相关 API 请参考 sendReferenceAudioPCMData
问题修复
废弃删除
具体说明,请参考 App Store submission requirement starts April 25 及 Xcode 14 Release Notes。
发布日期: 2023-04-14
新增功能
注意:
如需使用该功能,请联系 ZEGO 技术支持。
请在创建引擎之前,配置地理围栏信息。
将音视频及信令数据访问限定在某一区域,用以满足地区数据隐私安全相关法规,即限定用户访问某一特定区域的音视频服务,详情请参考 地理围栏。
相关 API 请参考 setGeoFence
状态同步及万人范围音视频功能支持通过流 ID 主动拉流或自定义拉流。该功能可实现无论距离多远都保持拉流的玩法,适用于虚拟世界中存在大屏或主播时,虚拟世界中任何一个地方的观众都可以通过拉流得到大屏或者主播声音的场景。
针对在线播放器的版权音乐保护,媒体播放器支持边下载边回调未解密的二进制数据,由开发者解密后再传回媒体播放器播放,过程中不会产生文件或缓存文件。
相关 API 请参考 setBlockDataHandler
支持动态开关流量控制功能,同时支持设置流量控制属性等。
相关 API 请参考 enableTrafficControl, setMinVideoBitrateForTrafficControl, setMinVideoFpsForTrafficControl, setMinVideoResolutionForTrafficControl
改进优化
删除 SDK 内部一些没必要的内存申请,优化 SDK 内存使用率,相比上个版本,内存使用率减少了 10% 左右。
废弃删除
注意:接口替换可能存在兼容性问题,请您注意查看 [onPlayerRecvSEI] 回调的废弃说明。
为规避数据同步异常的情况,将在 3.4.0 及以上版本,废弃 [onPlayerRecvSEI] 回调,若需收取远端流的 SEI 内容,请使用 [onPlayerSyncRecvSEI] 回调替代。
相关 API 请参考 onPlayerSyncRecvSEI, onPlayerRecvSEI
发布日期: 2023-03-10
新增功能
在外放场景中,设备的麦克风与扬声器过近,容易导致人声模糊或沉闷。在该场景下,人声增强可以有效提升人声清晰度并改善沉闷感,因此在外放场景下,建议开启该功能。
为实现外放场景下的人声增强效果,可开启人声增强音效并设置增强等级,增强等级推荐配置为 4,可用于 KTV 外放场景下,精细控制人声效果。
相关 API 请参考 enableSpeechEnhance
游戏语音支持自定义设置发声模式和收听模式,可用于实现加入小队后,需屏蔽非范围内的同一小队玩家的场景。
相关 API 请参考 setRangeAudioCustomMode
场景化音视频配置新增 [StandardVoiceCall] 标准语音通话场景,适用于 1v1 纯语音通话场景,详情请参考 场景化音视频配置。
相关 API 请参考 setRoomScenario
改进优化
针对 KTV 场景的 AEC 优化,实现了:
2.消除回声的同时,有效避免偶现的吞字或人声起伏的现象。
发布日期: 2023-02-23
问题修复
发布日期: 2023-01-13
新增功能
范围场景支持设置推拉流模式,推拉流模式包括:是否允许拉取范围内的流、是否允许推流到世界。
相关 API 请参考 enablePlayInRange, enablePublishToWorld
改进优化
注意:自定义信令配置默认大小为 1KB,如需扩展到 4KB,请联系 ZEGO 技术支持进行处理。
发布日期: 2022-12-09
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
通过该能力可快速实现移动及放置物品、抢占物品等互动玩法。以“抢椅子”玩法为例:
首先您需要提前通过 [createItem] 接口创建您视野范围内的“椅子”。
当您靠近“椅子”时,通过 [bindItem] 抢占“椅子”,获得其使用权。
假设您只允许 1 个用户抢占”椅子“,在您通过 [unbindItem] 释放权限前,其他用户都将无法抢占。
当您“坐在椅子上”时,可以通过 [updateItemStatus] 及 [updateItemCommand] 更新“椅子”的状态/指令,通知其他用户“您正坐在椅子上”。
相关 API 请参考 createItem, bindItem, unbindItem, updateItemStatus, updateItemCommand
注意:如需使用该功能,请联系 ZEGO 技术支持。
虚拟场景中,由于每个场景的地图大小、音视频互动玩法及规模不同,需要针对每个场景进行自定义配置。3.1.0 版本后,“万人范围音视频”及“多人实时状态同步”支持通过 SDK 接口,并使用模板 ID 指定场景。模板 ID 对应的配置项只能通过服务器 API 进行配置,详情请参考 服务端 API - 场景模版配置。
相关 API 请参考 templateID
注意:如需使用该功能,请联系 ZEGO 技术支持。
用户在登录场景时,可以带上 Token 参数,以验证合法性。
相关 API 请参考 ZegoSceneParam > token, ZegoRangeScene > renewToken
面向在线 KTV、一起看电影、看比赛等、视频会议、在线教育等音视频源丰富多样的互动场景,多源采集提供了灵活易用的音视频采集源与通道管理能力,大量减少开发者的开发及维护成本。
多源采集能力对屏幕共享、混音等常见能力的实现路径,进行缩短优化及归一化设计,从 3.1.0 版本后,您可以不用再通过自定义采集实现上述复杂的能力,详情请参考 多源采集 。
主要能力特性如下:
推流通道支持设置或切换多种音视频源。
支持屏幕共享、混音等常见能力。
注意:如需使用该功能,请联系 ZEGO 技术支持。
通过设置 SDK 的云代理接口,将 SDK 对应的所有流量通过云端的代理服务器进行中转,实现与 RTC 通信,详情请参考 云代理 。
相关 API 请参考 setCloudProxyConfig
改进优化
ZEGO 自研调度系统针对网络质量极差地区进行了深度优化。
问题修复
发布日期: 2022-11-15
问题修复
发布日期: 2022-10-28
本次更新包含不兼容改动,详情请参考 v3.0.0 升级指南。
新增功能
注意:如需使用该功能,请联系 ZEGO 技术支持。
场景化 AI 降噪功能,在之前针对所有非人声进行降噪的基础上,新增支持在音乐场景下的降噪能力,通过识别音乐,智能调整降噪效果还原音乐音质。SDK 会实时对麦克风输入内容进行音乐检测,在声卡、弹唱或近场音乐场景下,自动调整降噪等级,保证音乐的高保真音质,详情请参考 场景化 AI 降噪。
注意:如需使用该功能,请联系 ZEGO 技术支持。
SDK 面向虚拟场景提供有序、高频、低延时、大规模的状态同步云服务,帮助客户快速实现玩家位置、动作、形象等实时信息同步能力,同时单场景中支持 1 万个用户同时在线。
大型虚拟世界中,用户一般不需要感知较远的场景或远端用户,ZEGO 提供 AOI(Area Of Interest)能力,减免用户可见范围外的信息,极大减少客户流量成本以及用户端流量及性能消耗,详情请参考 多人状态实时同步。
相关 API 请参考 createRangeScene
注意:如需使用该功能,请联系 ZEGO 技术支持。
万人范围音视频功能支持超大规模的范围音视频互动,云端服务基于用户位置动态选路,在大型虚拟场景中保持沉浸式互动体验的同时大量减少客户音视频成本。
依赖多人状态实时同步服务,根据云端用户位置自动拉取收听范用内的远端音视频并提供空间音效。单场景内最大支持 1 万用户同时开启麦克风及摄像头,用户默认拉取距离最近的 12 路(可配置)音视频,详情请参考 万人范围音视频。
相关 API 请参考 createRangeScene
为方便开发者快速接入,降低开发者接入门槛,SDK 提供多种预设场景。开发者可根据所需场景,选择对应的房间模式 [ZegoScenario],SDK 将自动应用适合该场景的音视频编解码器、音视频参数、流控策略等配置,从而快速实现该场景下的最佳效果。
当前支持场景包括秀场直播、KTV、标准 1v1 音视频通话、高画质 1v1 音视频通话、标准语聊房、高音质语聊房,详情请参考 场景化音视频配置。
相关 API 请参考 setRoomScenario
注意:该功能默认开启,如需关闭该功能,请联系 ZEGO 技术支持。
在 App 有获取地理位置权限的情况下,开发者可以选择是否允许 ZEGO SDK 获取系统缓存的 GPS 信息,默认进行获取。当开发者希望关闭该功能时,需要联系 ZEGO 技术支持进行设置。
改进优化
对空间音频能力进行了优化,用户可以区分前后音源,从而达到更好的沉浸感。
SDK 优化了内部策略,在音视频的场景下,支持最小下行 50 kbps 拉流不卡顿,保障更好的极端弱网下的体验。
问题修复
废弃删除
废弃 [ZegoScenario] 场景枚举中的 [General],[Communication], [Live] 三种场景,详情请参考 场景化音视频配置。
发布日期: 2022-09-09
改进优化
为了方便跨平台框架开发者,我们给 Objective-C SDK 附带了 C++ 接口头文件。由于 C++ 接口是 Header Only 形式,仅使用 Objective-C 接口时不会增大集成 SDK 后的包大小,另外请勿同时使用两套 API 以避免 SDK 生命周期错乱。
问题修复
发布日期: 2022-08-09
新增功能
若在内网或防火墙场景下,您可以通过代理服务器与公网交互,并通过 [setEngineConfig] 设置代理服务器地址,保证 ZEGO 音视频云服务正常,目前仅支持 SOCKS5 协议,详情请参考 本地代理。
相关 API 请参考 setEngineConfig
注意:1. 在使用媒体播放器播放伴奏时,需要同时使用 [enableAux] 接口。
相关 API 请参考 enableAlignedAudioAuxData, onAlignedAudioAuxData, enableAux
由于 SDK 支持特性裁包,部分特性可能已被裁剪;可以使用此函数快速判断当前 SDK 是否支持指定的功能特性。
相关 API 请参考 isFeatureSupported
改进优化
当远端用户异常时,[onNetworkQuality] 每 2s 回调一次质量未知状态(ZegoStreamQualityLevelUnknown 状态),当用户该状态持续 8s 后,则认为远端用户已异常断开,此时回调质量异常状态(ZegoStreamQualityLevelDie 状态)。
相关 API 请参考 onNetworkQuality
推拉流质量回调会每隔 3s 回调一次质量最差的结果,当周期内出现严重的抖动或丢包时,能够立刻反馈出流质量差。
相关 API 请参考 onPlayerQualityUpdate, onPublisherQualityUpdate, onNetworkQuality
优化日志上报策略,提高日志上传效率。
AGC 新改进的谐波检测算法存在崩溃问题,现回退至老版本的谐波检测算法。
问题修复
发布日期: 2022-07-14
问题修复
发布日期: 2022-07-08
新增功能
SDK 默认的距离更新频率由 1s 改为 100ms,能够基本满足大部分开发者使用范围语音时的平滑衰减效果,优化了使用范围语音时声音衰减的体验,可以实现更平滑、自然的衰减效果。
若希望与实际的业务效果进行更优的匹配,可调用 [setPositionUpdateFrequency] 接口自行进行修改频率。
相关 API 请参考 ZegoRangeAudio > setPositionUpdateFrequency
在调用 [startMixerTask] 接口混流时,开发者可以通过 [ZegoMixerInput] 类型参数,设置 [cornerRadius](视频画面圆角半径),将视频边框设置为圆角。[cornerRadius] 的单位为 px,取值不得超过视频画面宽高中较短者的一半。
相关 API 请参考 startMixerTask
注意:若希望通过地区、用户等更多维度,从云端控制拉流方式,请联系 ZEGO 技术支持进行相关配置。
拉流接口新增 CDN_PLUS 的拉流资源模式(ZegoStreamResourceMode),开发者可按流维度自行开启使用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
注意:图片地址长度不得超出1024 字节,否则出现错误码 1005034;图片格式应为 JPG 和 PNG 格式,否则出现错误码 1005035;图片不得超过 1M,否则出现错误码 1005036。
支持通过 [startMixerTask] 接口的 [ZegoMixerImageInfo] 类型参数,设置图片地址,将单条输入流的内容设置为图片,用于替代视频,即当使用图片时不显示视频。该功能的使用场景为连麦时,视频用户可能需要暂时关闭摄像头而显示其图片,或者当视频用户和音频用户连麦,需要显示音频用户的图片。
相关 API 请参考 startMixerTask
注意:如需使用该功能,请联系 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-05-11
新增功能
直推 CDN 时,在不改变推流方式的情况下,SDK 从客户的 CDN 源站拉流,通过 L3 将音视频内容分发给观众,通过 [ZegoResourceType] 控制源站资源。该功能常用于直播场景。
相关 API 请参考 startPlayingStream
注意:目前只支持 RTC 场景,直推 CDN 和转推 CDN 场景下无效。
从 2.19.0 版本开始,支持在音视频场景下将 SEI(媒体补充增强信息)与音频帧同步发送。该功能常用于 SEI 与音频强相关的视频场景,例如实时 KTV。
在 2.19.0 之前版本中,SEI 数据是跟随视频帧数据一起发送,一般情况下视频帧率远低于音频帧率,导致混流对齐、伴奏对齐场景下等 SEI 精度/频率不足。
相关 API 请参考 onPlayerRecvAudioSideInfo, sendAudioSideInfo
改进优化
问题修复
发布日期: 2022-04-13
问题修复
发布日期: 2022-04-09
新增功能
注意:AI 降噪目前会对麦克风采集的音乐有较大损伤,包括人通过麦克风唱歌的声音。如需使用该功能,请联系 ZEGO 技术支持。
AI 降噪指的是 SDK 会对麦克风采集的声音进行降噪处理,在原有的稳态噪声正常处理的情况下,还会处理非稳态噪声,主要包括鼠标、键盘声、敲击、空调、厨房碗碟、嘈杂餐厅、环境风声、咳嗽、吹气 等非人声噪声。通过 [setANSMode] 接口中的 [ZegoANSMode] 参数设置 AI 降噪模式,并且可以实时调整降噪模式,详情请参考 AI 降噪。
该功能常用于通话、会议等没有背景音乐的场景,例如普通音质语聊房、语音会议、语音开黑、一对一视频通话。
相关 API 请参考 setANSMode
当音效播放器开始播放音效后, 调用 [ZegoAudioEffectPlayer] 的 [setPlaySpeed] 接口可以对音效设置四种播放速度(会同时设置本地播放速度和推流速度),分别为 0.5 倍速、原始速度、1.5 倍速和 2 倍速,默认为原始速度。
相关 API 请参考 ZegoAudioEffectPlayer > setPlaySpeed
QUIC 协议推拉流主要用于改善弱网环境下 CDN 直播质量不稳定的情况,但是改善有限,推荐使用低延时直播,享受高质量且低延时的直播服务。当前支持使用腾讯、网宿两家 CDN 直播产品的 QUIC 协议推流及拉流。
通过 [enablePublishDirectToCDN] 接口中的 [ZegoCDNConfig] 参数配置推流协议和 QUIC 版本,若想进行 QUIC 协议的自定义 CDN 拉流,需要通过 [startPlayingStream] 中的 [ZegoPlayerConfig] 参数配置拉流协议和 QUIC 版本。
相关 API 请参考 enablePublishDirectToCDN
发起推流后,可以通过 [onPublisherStreamEvent] 回调实时监听推流状态,该回调会返回当前使用的推流地址、资源类型和协议相关信息。
发起拉流后,可以通过 [onPlayerStreamEvent] 回调实时监听拉流状态,该回调会返回当前使用的拉流地址、资源类型和协议相关信息。
相关 API 请参考 onPublisherStreamEvent, onPlayerStreamEvent
调用 startMixerTask 开启或更新混流任务,支持通过 [backgroundUrl] 和 [inputVolume] 分别设置混流水印和混流的输入音量。
相关 API 请参考 startMixerTask
[loginRoom] 接口新增 [callback] 参数,支持从 [callback] 返回登录房间结果。
[logoutRoom] 接口新增 [callback] 参数,支持从 [callback] 返回退出房间结果。
相关 API 请参考 loginRoom, logoutRoom
当房间的连接状态发生变化时会触发 [onRoomStateChanged] 回调,通过 [ZegoRoomStateChangedReason] 参数提供更加详细的连接状态及状态变化原因。
相关 API 请参考 onRoomStateChanged
改进优化
调用 startMixerTask 接口,通过 [ZegoFontStyle] 中的 [border] 属性可以设置字体是否有边框,通过 [borderColor] 属性可以设置字体边框颜色。
相关 API 请参考 startMixerTask
新增 1005000 错误码,表示未开通混流服务。出现此错误码时,请在 ZEGO 控制台 自助开通混流服务(开通步骤请参考 项目管理 - 服务配置 中的“混流”),或联系 ZEGO 技术支持开通。
相关 API 请参考 startMixerTask
问题修复
发布日期: 2022-03-22
问题修复
发布日期: 2022-03-11
问题修复
发布日期: 2022-03-09
新增功能
稳态语音默认检测周期为 3 秒,用户如需修改默认检测周期,可通过 [startAudioVADStableStateMonitor] 接口自定义检测周期参数。
相关 API 请参考 startAudioVADStableStateMonitor
新增枚举 [ZegoRangeAudioModeSecretTeam] 隐秘小队模式。在该模式下,同一房间下的用户,收听者既能与同一小队的人交流,也能听到所有在音频接收范围内且为全世界模式发声者的声音,如太空狼人杀游戏场景。
相关 API 请参考 setRangeAudioMode
注意:该功能仅在开发阶段使用,请勿在线上版本开启此功能。
新增 [enableDebugAssistant] 接口,开发者调用该接口开启调试助手功能,SDK 将会打印日志到控制台,并且在 SDK 其他接口的调用出现异常时,UI 会弹窗提示错误。
相关 API 请参考 enableDebugAssistant
改进优化
2.17.0 及以上版本,在创建引擎时将 AppSign 传空或不传,并且在登录房间时必须传入 Token,鉴权通过后即可使用实时音视频功能,具体请参考 使用 Token 鉴权。
2.17.0 以下版本,在创建引擎时传入 AppSign,鉴权通过后即可使用实时音视频功能。
问题修复
发布日期: 2022-02-10
问题修复
发布日期: 2022-01-26
问题修复
发布日期: 2022-01-20
问题修复
发布日期: 2022-01-14
新增功能
游戏语音模块新增 [muteUser] 接口,本地用户可以根据需要,在初始化游戏语音 [CreateRangeAudio] 之后,通过 [MuteUser] 接口设置是否接收指定远端用户的音频数据。
该功能常用于游戏场景,例如发声者被墙壁阻挡,则听众不需要接收该声音。
相关 API 请参考 muteUser
支持外接音频设备的双声道内部采集,通过 [setAudioCaptureStereoMode] 接口可以设置音频采集声道模式,当开发者开启双声道采集后,使用支持双声道的音频设备,可以采集到双声道的音频数据并进行推流。
该功能常用于用户对声音的效果比较敏感的场景,例如语音电台、乐器演奏。
相关 API 请参考 setAudioCaptureStereoMode
[onPlayerQualityUpdate] 回调新增 [mos] 参数,表示对拉流音质的评分。开发者对音频质量比较关注时,可通过该参数了解当前音频的质量情况。
相关 API 请参考 onPlayerQualityUpdate
注意:如需使用该功能,请联系 ZEGO 技术支持。
为了在弱网环境下让推流端可以推更高画质的视频流,SDK 支持基于 rtmp over quic 协议来推流。
该功能常用于单主播直推 CDN、直播 PK 场景。
注意:如需使用该功能,请联系 ZEGO 技术支持。
2.15.0 及之前版本:SDK 在使用 [startPlayingStream] 拉 H.265 编码的流时,如果拉流端出现因硬件性能较差导致解码帧率不足时,SDK 无法主动降级,需要用户先停止拉 H.265 编码的流,再转拉 H.264 编码的流。
2.16.0 及以上版本:新增 H.265 拉流自动降级策略,在使用 [startPlayingStream] 拉 H.265 编码的流时,SDK 可以根据拉流质量情况,在拉流端硬件性能较差导致解码帧率不足的情况下,会自动降级拉 H.264 编码的流。
相关 API 请参考 startPlayingStream
改进优化
调用 [getNetworkTimeInfo] 接口获取同步网络时间信息时,SDK 会定时更新 NTP 时间,减少获取到的 NTP 时间误差。
相关 API 请参考 getNetworkTimeInfo
发布日期: 2021-12-09
新增功能
媒体播放器新增声浪频谱回调和开关接口,可以控制是否开启回调以及回调的频率,从而获取媒体播放器当前的声浪和频谱。在通过媒体播放器播放资源,如一起看电影、游戏语聊房场景时,通过该功能可以做频谱动画的功能,增加趣味性。
创建媒体播放器后,调用 [enableSoundLevelMonitor] 接口可以开启声浪监听,开启后可以通过 [onMediaPlayerSoundLevelUpdate] 回调监听声浪的变化。
创建媒体播放器后,调用 [enableFrequencySpectrumMonitor] 接口可以开启频谱监听,开启后可以通过 [onMediaPlayerFrequencySpectrumUpdate] 回调监听频谱的变化。
相关 API 请参考 enableSoundLevelMonitor, enableFrequencySpectrumMonitor
新增支持全方位虚拟立体声,将单声道的声音,通过算法处理,模拟成立体感的声音。该功能常用于 KTV 场景中,可以使唱歌的声音更加有立体感。
当调用 [enableVirtualStereo] 接口,将 angle 参数设置为 -1 时,表示立体声效果为全方位立体声。
相关 API 请参考 enableVirtualStereo
通过 [onLocalDeviceExceptionOccurred] 回调可以设置要检测的设备类型,如摄像头、扬声器、麦克风等,开发者可以根据不同设备类型的错误回调进行相应的处理。
相关 API 请参考 onLocalDeviceExceptionOccurred
开发者可以通过 Mac Catalyst 框架将 iOS 应用移植到 macOS 上。
改进优化
混流输出视频配置 [ZegoMixerOutputVideoConfig] 新增 encodeProfile 和 encodeLatency 参数、分别用于设置混流输出视频编码规格和混流输出视频编码延时。
登录房间导致网络测试停止,由于网络测试会占用带宽,请在登录房间之前进行。
用户登录房间时如果在服务器黑名单中,则会返回此错误码,表示禁止登录房间。
当使用 SDK 拉低延迟直播流时,若您未开通低延迟直播服务,则会返回此错误码。
问题修复
废弃删除
为了让开发者直观的了解出现异常的设备类型以及具体的异常情况,在 2.15.0 及以上版本废弃了 [onDeviceError] 回调,请使用 [onLocalDeviceExceptionOccurred] 回调代替。
相关 API 请参考 onLocalDeviceExceptionOccurred
发布日期: 2021-11-16
新增功能
开发者在需要做远程控制、云游戏等指令分发时,通过实时信令,可以低延迟获取发布端消息。
相关 API 请参考 createRealTimeSequentialDataManager
注意:如需使用该功能,请联系 ZEGO 技术支持。
支持通过版权音乐功能,获取版权歌曲或伴奏资源,并结合媒体播放器进行本地播放控制。可以用于在线 KTV、语聊房等合唱或使用背景音乐的场景。
注意:如需使用该功能,请联系 ZEGO 技术支持。
允许开发者自定义监听音频和视频帧到达的回调通知,包括音频首帧到达回调、视频首帧到达回调、视频首帧渲染回调。
相关 API 请参考 callExperimentalAPI
媒体播放器新增 [loadResourceWithPosition] 接口,支持加载媒体资源时指定开始播放进度,单位为毫秒。
相关 API 请参考 ZegoMediaPlayer > loadResourceWithPosition
该功能常用于 KTV 等需要混流对齐的场景,当拉流端播放时,通过 [setPlayStreamsAlignmentProperty] 接口控制播放的实时音视频流是否需要精准对齐。若需要,则拉取的所有流中包含精准对齐参数的会进行对齐;若不需要,则所有流都不对齐。
相关 API 请参考 setPlayStreamsAlignmentProperty
通过该功能可以判断一定时间内是否有人对着麦克风说话,用于检测采集后或音频前处理后的音频数据是人声还是噪声。
相关 API 请参考 startAudioVADStableStateMonitor, stopAudioVADStableStateMonitor, onAudioVADStateUpdate
注意:如需使用该功能,请联系 ZEGO 技术支持。
支持生成 Token 的密钥,实现 ServerSecret 平滑迁移能力。通过后台配置同时启用两个 ServerSecret,当其中一个 ServerSecret 暴露的情况下,可以平滑迁移到另一个 ServerSecret。
注意:如需使用Token 加入黑名单的功能,请联系 ZEGO 技术支持。
Token 支持加入黑名单:为防止旧 Token 释放后攻击新 Token,新增支持将 Token 加入黑名单。Token 黑名单,是指该 Token 在有效期内的 AppID 下无法使用。
Token 支持通过流 ID 鉴权:为防止通过鉴权后,使用相同 Token 推其他的流,新增支持生成绑定流 ID 的 Token。
为确保客户端下麦成功,服务端新增批量禁止 RTC 推流和批量恢复 RTC 推流能力的 API。
调用批量禁止 RTC 推流接口,可以批量禁止指定流 ID 推送到 RTC 服务,禁止推流操作会向正在推流的客户端和正在拉流的客户端发送推流被禁止的通知。调用批量恢复 RTC 推流接口,可批量恢复被禁止推往 RTC 媒体服务的流 ID。
相关 API 请参考 批量禁止 RTC 推流 / 批量恢复 RTC 推流
改进优化
2.10.0 至 2.13.1 版本的处理逻辑为:1. 自身必须既推流又拉流,才会收到自身的网络质量回调。2. 当拉一条流时,推流端有拉流且推流端在自己所在房间内,才会收到该用户的网络质量。
2.14.0 及以上版本的处理逻辑为:1. 自身只要推流或拉流,就会收到自身的网络质量回调。2. 当拉一条流时,推流端在自己所在房间内,就会收到该用户的网络质量。
相关 API 请参考 onNetworkQuality
2.14.0 之前版本默认最大推流通道数量为 2 路,如需支持更多则需要 ZEGO 技术支持特殊编包。为了配合实时信令功能,该版本默认最大推流数新增至 4 路。
相关 API 请参考 startPublishingStream
完成了对全量 API 接口与错误码的注释优化, API 注释中新增了“支持版本”、“详情描述”、“业务场景”、“调用时机”、“使用限制”、“注意事项”等信息,便于开发者更清晰的了解 API 的功能。错误码新增了“可能原因”和“处理建议”,帮助开发者更好的定位和解决问题。
为了降低开发者对环境的理解成本,ZEGO 已统一环境概念,从该版本开始,废弃了测试环境,统一使用正式环境。在 2.14.0 版本之前已接入过 SDK 的开发者,可以参考 测试环境废弃说明 进行 SDK 升级及代码调整。
混流转推地址长度限制由 512 字节扩展到 1024 字节。
废弃删除
为了降低开发者对环境的理解,废弃了测试环境,统一使用环境。在 2.14.0 及以上版本废弃了原有的 [createEngine] 接口,请使用不带 [isTestEnv] 参数的同名接口代替。
发布日期: 2021-10-15
问题修复
发布日期: 2021-10-15
新增功能
电音音效指的是可以让人说话、唱歌的声音,经过处理后带有电音的效果。该功能常用于KTV、语聊房场景。
在 [createEngine] 初始化 SDK 之前,调用 [setElectronicEffects] 接口可以开启电音音效,并可根据需要设置不同模式的电音调式以及对应调式的起始音高。未调用此接口时,默认关闭电音音效。
开发者也可以通过 [setVoiceChangerPreset] 接口预设常见的电音音效,目前支持预设 C 大调电音音效、A 小调电音音效、和声小调电音音效。
相关 API 请参考 setElectronicEffects
注意:使用此功能需要升级 SDK 并联系 ZEGO 技术支持配置。
不同的业务场景,对用户登录房间、推流等权限有时效限制,可以通过 Token 来实现。
当 Token 过期后,服务端会主动将用户的权限进行回收,客户端的用户会被踢出房间并停止推流。该机制可以使用户权限管理更安全,常用于 KTV、语聊房场景。
相关 API 请参考 renewToken, onRoomTokenWillExpire
直播使用混流时,可以在混流输出画面上实时更新水印,以达到实时更新混流的时候同步刷新水印。该功能常用于在线教育场景,例如上课时在混流画面上标注每条输入流对应的老师名字或者班级名字。
[ZegoMixerTask] 的混流输入列表 [ZegoMixerInput] 中新增 [label] 字段,可设置混流输入视频画面上的相关文字水印信息,进行混流的每一条流,只支持一个水印。
相关 API 请参考 startMixerTask
在进行混流时,可以对每一条流进行渲染模式的设置。当混流输入流的分辨率比例与对应输入流在混流输出画面上的布局比例不一致时,可以按照不同的业务场景,选择不同的渲染模式。
[ZegoMixerTask] 的混流输入列表 [ZegoMixerInput] 中新增 [renderMode] 字段,可设置混流输入视频画面的渲染模式,支持“填充模式”和“适应模式”。
相关 API 请参考 startMixerTask
改进优化
推流端,配置混流时可以指定某些流进行精准对齐。
相关 API 请参考 setStreamAlignmentProperty
调用 [startPublishingStream] 接口且将 [ZegoPublisherConfig] 中的 [forceSynchronousNetworkTime] 值设置为 1,则 SDK 内部会等到 NTP 网络时间同步完成后再推流,此时再调用 [setStreamAlignmentProperty] 接口开启混流精准对齐功能。
相关 API 请参考 startPublishingStream, setStreamAlignmentProperty, onNetworkTimeSynchronized
问题修复
废弃删除
因为在回调里增加了 timestamp 采集时间戳,在 2.13.0 及以上版本废弃 [onProcessCapturedAudioData] 回调,使用带 timestamp
参数的同名回调代替。
相关 API 请参考 onProcessCapturedAudioData
因为在回调里增加了 timestamp 采集时间戳,在 2.13.0 及以上版本废弃 [onProcessRemoteAudioData] 回调,使用带 timestamp
参数的同名回调代替。
相关 API 请参考 onProcessRemoteAudioData
因为在回调里增加了 timestamp 采集时间戳,在 2.13.0 及以上版本废弃 [onProcessPlaybackAudioData] 回调,使用带 timestamp
参数的同名回调代替。
相关 API 请参考 onProcessPlaybackAudioData
发布日期: 2021-09-09
新增功能
支持获取和修改混音后将要播放的音频数据。在初始化 SDK 之后,[startPublishingStream]、 [startPlayingStream]、 [startPreview]、 [createMediaPlayer] 和 [createAudioEffectPlayer] 之前,调用 [enableCustomAudioPlaybackProcessing] 接口可以开启自定义混音后处理功能,通过 [setCustomAudioProcessHandler] 可以设置自定义音频处理回调。
相关 API 请参考 enableCustomAudioPlaybackProcessing, setCustomAudioProcessHandler, onProcessPlaybackAudioData
与远端用户连麦成功后,当远端扬声器设备状态发生变更时,例如开/关扬声器,可以通过 [onRemoteSpeakerStateUpdate] 回调监听。
相关 API 请参考 onRemoteSpeakerStateUpdate
在加载资源完成后,调用 [setPlaySpeed] 接口可以设置媒体播放器的视频播放倍速,支持 0.5 ~ 2.0 倍,默认为 1.0,即正常速度。
相关 API 请参考 ZegoMediaPlayer > setPlaySpeed
调用 [getCurrentAudioDevice] 接口,可以获取当前使用的音频设备信息,包括设备 ID 和设备名称,减少开发者的开发量。
相关 API 请参考 getCurrentAudioDevice
使用混流功能时,支持通过 [ZegoMixerInput] 中的 [audioDirection] 参数设置每路音频流的空间音频效果。
相关 API 请参考 startMixerTask
改进优化
优化了耳返逻辑,使耳返的延迟缩短至 50+ ms。
广播消息和弹幕消息从此版本开始,支持发送长度更大的消息(默认限制为 1 KB),如有需要请联系 ZEGO 技术支持配置。
发布日期: 2021-08-27
新增功能
新增范围语音功能模块,可提供范围语音、3D音效、小队语音等功能。适用于吃鸡类游戏、元宇宙类场景。
范围语音:房间内的收听者对音频的接收距离有范围限制,若发声者与自己的距离超过该范围,则无法听到声音。为保证语音清晰,附近超过 20 人发声时,只能听到离自己最近的 20 个发声者的声音。
3D音效:声音有 3D 空间感且按距离衰减。
小队语音:玩家可以选择加入小队,并支持在房间内自由切换“全世界”模式和“仅小队”模式。
相关 API 请参考 createRangeAudio, destroyRangeAudio, setEventHandler, setAudioReceiveRange, updateSelfPosition, updateAudioSource, enableSpatializer, enableMicrophone, enableSpeaker, setRangeAudioMode, setTeamID
改进优化
发布日期: 2021-08-20
问题修复
相关 API 请参考 loginRoom
发布日期: 2021-08-10
新增功能
SDK 可以指定房间,由 ZEGO 实时音视频服务器自动将房间内的所有音频流进行混流(目前只支持混音频流),常用于纯语聊场景。该功能相对手动混流降低了开发者接入的复杂程度,不需要管理指定房间音频流的生命周期。
相关 API 请参考 startAutoMixerTask, stopAutoMixerTask
在混流任务对象 [ZegoMixerTask] 中新增 [setBackgroundColor] 用于设置混流背景色。
相关 API 请参考 startMixerTask
开发者在监听声浪回调时,往往只关注人声部分,可调用 [startSoundLevelMonitor] 接口,传入 [ZegoSoundLevelConfig],开启 VAD 人声检测。SDK 在本地采集声浪回调 [onCapturedSoundLevelInfoUpdate]、远端音频声浪回调 [onRemoteSoundLevelInfoUpdate] 中也新增是否包含人声检测的参数。
相关 API 请参考 startSoundLevelMonitor, onCapturedSoundLevelInfoUpdate, onRemoteSoundLevelInfoUpdate
当开发者已经将播放数据写入内存后,可直接使用媒体播放器进行播放,无需再写成文件进行播放。
相关 API 请参考 ZegoMediaPlayer > loadResourceFromMediaData
改进优化
在使用多个视频或音频设备时,可以通过 [deviceID] 参数精确分辨出报错的设备,更高效地排查问题。
在开发者需要支持超过 12 路拉流时,需要联系 ZEGO 技术支持设置。
问题修复
废弃删除
参数定义不准确,在 2.10.0 及以上版本废弃 [onNetworkQuality] 回调,使用带 ZegoStreamQualityLevel
枚举的同名回调代替。
相关 API 请参考 onNetworkQuality
发布日期: 2021-07-13
问题修复
发布日期: 2021-07-09
新增功能
新增本地和远端用户的上下行网络质量回调 [onNetworkQuality],默认每两秒回调一次本地和每个拉取的远端用户的网络状况(包括未知、优秀、良好、中等、较差、网络断线)。当开发者希望分析链路上的网络情况,或想要了解本地和远端用户的网络状况时可以使用该功能。
相关 API 请参考 onNetworkQuality
在进行多端同步行为或耗时统计时,需要网络时间同步。SDK 新增获取 NTP 时间功能,可通过 [getNetworkTimeInfo] 接口获取 NTP 时间戳。使用该功能前请先联系 ZEGO 技术支持。
相关 API 请参考 getNetworkTimeInfo
基于 ZEGO 服务器的 NTP 时间,在混流时自动对齐各路流的播放时间。使用该功能前请先联系 ZEGO 技术支持。
改进优化
同一个用户可以同时加入多个房间,并同时在多个房间内(目前默认最多同时加入 5 个房间)推流、拉流、发送实时消息和接收消息回调。本功能可以隔离多个房间的消息及回调,实现更灵活的连麦业务。ZEGO 推荐用于跨房间连麦和在线教育的超级小班场景。
需要在初始化 SDK 之前,调用 [ZegoRoomMode] 设置多房间模式,然后调用 [loginRoom] 接口登录多房间。
相关 API 请参考 setRoomMode, loginRoom
开发者不需要填写 roomID 就可以调用 [logoutRoom] 接口退出当前所在的房间。若使用了多房间功能,则调用该接口会退出所有房间。
相关 API 请参考 logoutRoom
拉流质量回调中新增 audioCumulativeBreakCount、audioCumulativeBreakTime、audioCumulativeBreakRate 等参数,提供了更多拉流卡顿的细化数据。
相关 API 请参考 onPlayerQualityUpdate
调用 [startNetworkSpeedTest] 接口开启网络测速时,支持设置回调周期(默认 3000 ms)。
相关 API 请参考 startNetworkSpeedTest
问题修复
废弃删除
为了更完善多房间功能,去除旧有主从房间概念,在 2.9.0 及以上版本废弃了 [loginMultiRoom] 接口。若需实现新的多房间功能,请先在引擎初始化之前调用 [setRoomMode] 函数设置多房间模式,再使用 [loginRoom] 登录多房间,如果调用 [loginRoom] 函数登录多房间,请确保传入相同的用户信息。
相关 API 请参考 setRoomMode, loginRoom
发布日期: 2021-06-11
新增功能
用户权限控制指的是用户登录房间,或是在房间内进行推/拉流等操作时,ZEGO 服务端根据用户登录时携带的 Token 参数,判断用户是否有对应的权限,避免因权限控制缺失或操作不当引发的风险问题。 目前仅支持用户登录房间和用户房间内推流两个权限的校验。
相关 API 请参考 loginRoom, renewToken, onRoomTokenWillExpire
空间音频能够感知空间内 360° 的声音位置。开发者可以通过空间音频功能在音视频房间内营造更逼真的“座位”效果,用户可以通过空间音频感知声音的来源方向,还原线下场景。适用于语聊房、剧本杀和线上会议等场景。
相关 API 请参考 enablePlayStreamVirtualStereo
改进优化
问题修复
发布日期: 2021-04-29
新增功能
ZEGO 通过此 API 提供 RTC 业务中的部分技术预览或特别定制功能,需要获取该功能的使用方法或其详情可咨询 ZEGO 技术支持。
相关 API 请参考 callExperimentalAPI
废弃删除
在 2.7.0 及以上版本废弃 [enableAudioDataCallback] 接口,请使用 [startAudioDataObserver] 接口代替。
相关 API 请参考 startAudioDataObserver
发布日期: 2021-04-15
新增功能
在混流时,开发者通过设定拉流端需要突出的目标流,实现在多人同时说话的嘈杂环境下,突出特定用户的语音。例如在会议场景下,可以保障重点人物发言的声音。在调用 [startMixerTask] 接口开启混流时,首先将传入的 [ZegoMixerAudioConfig] 混流音频配置参数中的 [mixMode] 设置为 [focused],同时在需要突出发言的流中,配置 [ZegoMixerInput] 的 [isAudioFocus] 为 [true],即可指定该流为焦点语音流。
相关 API 请参考 startMixerTask
问题修复
发布日期: 2021-04-01
新增功能
开发者可根据实际需要在加载资源前,通过 [setNetWorkResourceMaxCache] 接口设置媒体播放器网络资源的最大缓存时长和最大缓存数据大小(两者不能同时为 0),可通过 [getNetWorkResourceCache] 接口获取当前网络资源缓存队列中缓存数据可播放的时长和大小。
相关 API 请参考 ZegoMediaPlayer > setNetWorkResourceMaxCache, ZegoMediaPlayer > getNetWorkResourceCache
当网络状态较差且媒体播放器将缓存的网络资源都播放完时,就会停止播放。只有当缓存的网络资源大于 SDK 设置的阈值时(默认值为 5000 ms,有效值为大于等于 1000 ms),媒体播放器才会在原来暂停的位置自动恢复播放。
相关 API 请参考 ZegoMediaPlayer > setNetWorkBufferThreshold
发布日期: 2021-03-18
新增功能
可根据需要对音频输入/输出设备静音或取消静音。
相关 API 请参考 muteAudioDevice, isAudioDeviceMuted
可以监控音频输入/输出设备的音量。
相关 API 请参考 startAudioDeviceVolumeMonitor, stopAudioDeviceVolumeMonitor
可根据需要设置系统声卡音量,有效范围为 [0, 200], 默认为 100。
相关 API 请参考 setMixSystemPlayoutVolume
可根据需要设置和获取音频编码类型、码率,音频声道的组合值。
相关 API 请参考 setAudioConfig, getAudioConfig
当通过 [enableTrafficControl] 接口开启了指定推流通道的流量控制后,可通过 [setTrafficControlFocusOn] 接口控制是否因为远端网络状况差而启动流量控制。
相关 API 请参考 setTrafficControlFocusOn
普通 seek 指定的时间戳可能是非 I 帧,进而返回指定时间戳前后的 I 帧,不是很精确。而精准 seek 当指定的时间戳不是 I 帧时,会通过指定时间戳前后的 I 帧去解指定时间戳的那帧数据。
相关 API 请参考 ZegoMediaPlayer > enableAccurateSeek
当需要同时停止拉流中所有流的音频数据时,可以使用此功能。
相关 API 请参考 muteAllPlayStreamAudio
改进优化
问题修复
发布日期: 2021-03-05
问题修复
发布日期: 2021-03-04
新增功能
当开发者需要自定义日志文件大小和路径时,可调用 [setLogConfig] 接口来完成配置,且必须在调用 [createEngine] 之前设置才能生效。若在 [createEngine] 之后设置,则在 [destroyEngine] 后的下一次 [createEngine] 时生效。一旦调用了 [setLogConfig] 接口,在 [destroyEngine] 之前,即 engine 的整个生命周期里,旧的通过 [setEngineConfig] 设置日志大小和路径的方式将无效。建议一旦使用该接口,就始终只通过其完成设置日志路径和大小的需求。
相关 API 请参考 setLogConfig
设置 [setApiCalledCallback] 后,可以通过 [onApiCalledResult] 回调获取到 ZEGO SDK 方法执行结果的详细信息。
相关 API 请参考 setApiCalledCallback
通过 [setAudioRouteToSpeaker] 可以设置音频路由到扬声器,当选择不使用内置扬声器播放声音时,即设为 [false] 时,SDK 会根据系统调度选择当前优先级最高的音频输出设备播放声音。
相关 API 请参考 setAudioRouteToSpeaker
本端用户可控制所有音频流的播放音量。
相关 API 请参考 setAllPlayStreamVolume
在推拉流之前通过网络探测定位一些可能存在的网络问题。
相关 API 请参考 startNetworkProbe, stopNetworkProbe
改进优化
问题修复
废弃删除
相关 API 请参考 setLogConfig
通过设置 [key] 为 [set_verbose],[value] 为 [true] 或 [false] 来开关控制台打印功能。
相关 API 请参考 setEngineConfig
因为命名规范问题,为了体现接口本身能够明确描述音频路由的概念,避免对开发者造成误解,因此在 2.3.0 及以上版本废弃 [setBuiltInSpeakerOn] 接口,请使用 [setAudioRouteToSpeaker] 来实现原来的功能
相关 API 请参考 setAudioRouteToSpeaker
发布日期: 2021-02-04
问题修复
相关 API 请参考 sendCustomAudioCaptureAACData, sendCustomAudioCapturePCMData
发布日期: 2021-01-28
新增功能
多个用户在房间内进行音视频通信,每一次音视频通信都会有唯一的 RoomSessionID (当用户收到 [onRoomStateUpdate] 回调时,可通过回调中的 [extendedData] 参数获取 RoomSessionID),标识房间内首个用户发起音视频通信到最后一个用户结束通信的持续通信。可用于通话质量评分、通话问题诊断等场景中。
相关 API 请参考 onRoomStateUpdate
使用媒体播放器播放媒体文件,当媒体播放器解析到媒体文件中含有 SEI 时,将触发 [onMediaPlayerRecvSEI] 回调。
在 [ZegoMixerTask] 中添加 [advancedConfig] 参数以支持混流高级配置。如需使用,请联系 ZEGO 技术支持。
相关 API 请参考 startMixerTask
新增棱镜相关质量上报,方便开发者及时发现问题、定位问题、解决问题,更好、更全面地提升用户体验。
改进优化
发布日期: 2021-01-21
问题修复
发布日期: 2021-01-14
新增功能
请从开发者中心 下载 SDK 包 选择下载 XCFramework。
该功能用于指定播放缓存自适应调整的区间范围,开发者可根据场景进行设置。
相关 API 请参考 setPlayStreamBufferIntervalRange
问题修复
发布日期: 2021-01-07
问题修复
发布日期: 2020-12-31
新增功能
低延迟直播专注于提供稳定可靠的直播服务,相比于标准视频直播产品,音画延迟更低,同步性更强,弱网抗性更好,能为用户带来毫秒级的直播体验。通常用于教育大班课、秀场直播、电商直播、一起看、在线拍卖等场景。详情请参考:低延迟直播。
相关 API 请参考 startPlayingStream
改进优化
问题修复
废弃删除
新增了一个带 [callback] 参数的销毁引擎接口,若开发者有切换多个音视频 SDK 的需求,则可以通过收到回调时认为 ZEGO SDK 对设备硬件资源的占用已释放完成。若无监听必要,对 [callback] 参数传 null 即可,详情请参考 接口变更说明。
相关 API 请参考 destroyEngine
旧回调命名与实际功能不符,因此删除改名,详情请参考 接口变更说明。
相关 API 请参考 onPlaybackAudioData
旧接口命名风格和语义不清晰,[muteSpeaker] 使用 Speaker 的定义与 Microphone 对应,详情请参考 接口变更说明。
相关 API 请参考 muteSpeaker
媒体播放器的生命周期跟随引擎,故变更为 ZegoExpressEngine 类的同名实例方法,详情请参考 接口变更说明。
相关 API 请参考 createMediaPlayer
引擎提供了分别获取播放器推流音量和本地播放音量的功能,更加精准的获取音量,故废弃原来的统一获取接口,详情请参考 接口变更说明。
相关 API 请参考 ZegoMediaPlayer > setPublishVolume, ZegoMediaPlayer > setPlayVolume
发布日期: 2020-12-24
问题修复
发布日期: 2020-12-17
新增功能
该功能支持上行/下行网络测速,可用于检测网络环境是否适合推/拉指定码率的流。调用 [startNetworkSpeedTest] 接口开启该功能,配置 [ZegoNetworkSpeedTestConfig] 参数以控制测速过程,测速结果将通过 [onNetworkSpeedTestQualityUpdate] 回调通知。
相关 API 请参考 startNetworkSpeedTest, stopNetworkSpeedTest, onNetworkSpeedTestQualityUpdate
当设备的网络模式改变时,例如从 WiFi 切换到 5G,或断网等情况时,将会抛出此回调。
相关 API 请参考 onNetworkModeChanged
问题修复
相关 API 请参考 startRecordingCapturedData, stopRecordingCapturedData
发布日期: 2020-12-10
改进优化
登录房间后,如果退出或切换房间,且传入的 RoomID 为空或者 RoomID 不存在,则抛出 1002002 错误码。
相关 API 请参考 loginRoom, logoutRoom, switchRoom
问题修复
相关 API 请参考 ZegoAudioEffectPlayer > seekTo
发布日期: 2020-12-03
新增功能
调用 [createEngine] 接口创建引擎后可以启动性能监控,并支持设置监控回调间隔(默认为 2s),一般可用于对比推拉流前后的内存增长情况。
相关 API 请参考 startPerformanceMonitor, stopPerformanceMonitor
支持使用 AES-128/192/256 对流媒体数据加密。
相关 API 请参考 setPublishStreamEncryptionKey, setPlayStreamDecryptionKey
该时间戳差值小于 0 表示视频超前音频的毫秒数, 大于 0 表示视频滞后音频的毫秒数, 等于 0 表示无差别。当绝对值小于 200,可基本认为音画同步,当绝对值连续 10 秒大于 200 可以认为异常。
相关 API 请参考 onPlayerQualityUpdate
改进优化
相关 API 请参考 loginRoom
相关 API 请参考 sendBroadcastMessage
相关 API 请参考 startRecordingCapturedData
如需使用,请联系 ZEGO 技术支持。
相关 API 请参考 ZegoMediaPlayer > loadResource
发布日期: 2020-11-24
问题修复
发布日期: 2020-11-19
新增功能
通过混响高级参数可以根据需要调节更精细的混响效果,并在原有预设混响中新增了录音室、KTV、摇滚、演唱会等效果,在预设变声中新增了磁性男和清新女音效,增加实时语音趣味性,能够适应更多的场景。
相关 API 请参考 setReverbAdvancedParam, setReverbPreset, setVoiceChangerPreset
通过设置 SEI 类型,使开发者使用其他解码器解码时能够正确解析出 SEI。
相关 API 请参考 setSEIConfig
相关 API 请参考 onRoomStreamUpdate
相关 API 请参考 onPlayerAudioData
问题修复
相关 API 请参考 mutePlayStreamAudio
废弃删除
为了支持更多混响参数,设置更加丰富的混响效果,在 1.18.0 及以上版本废弃 [setReverbParam] 接口,请使用带 ZegoReverbAdvancedParam
类型参数的 [setReverbAdvancedParam] 接口代替,详情请参考 接口变更说明。
相关 API 请参考 setReverbAdvancedParam
在 1.18.0 及以上版本废弃 [onRoomStreamUpdate] 回调,请使用带 extendedData
扩展信息参数的同名回调代替,extendedData
用于标识流更新附带的消息,如流删除原因等,故对旧接口进行废弃。
相关 API 请参考 onRoomStreamUpdate
发布日期: 2020-11-05
改进优化
相关 API 请参考 loginRoom, sendBroadcastMessage, sendBarrageMessage, sendCustomCommand
问题修复
相关 API 请参考 sendSEI
发布日期: 2020-10-22
新增功能
新增外国人、擎天柱、机器人、空灵 4 种变声效果,轻松创建特色音效,使用户的声音更加妙趣横生。在语音场景中,营造好友语音之间的搞怪气氛,增强娱乐性。
相关 API 请参考 setVoiceChangerPreset
用户可以根据需要设置混响回声参数,最多允许设置 7 次回声 (delay),并支持单独设置每个回声的延迟、衰减,以及整体的输入输出增益值。也可以搭配变声、混响以实现自定义各式各样的声音效果。
相关 API 请参考 setReverbEchoParam
通过改变用户的音调,使输出的声音在感官上与原始声音不同,实现男声变女生等多种效果。
相关 API 请参考 ZegoMediaPlayer > setVoiceChangerParam
该功能可用于抑制敲击键盘、桌子等瞬态噪声。
相关 API 请参考 enableTransientANS
当媒体文件中包含多个音轨时(例如原声和伴奏),支持切换音轨进行播放。
相关 API 请参考 ZegoMediaPlayer > setAudioTrackIndex
改进优化
相关 API 请参考 onPlayerQualityUpdate
问题修复
废弃删除
param
参数的预设枚举构造函数,该函数仅用于微调设置 pitch
值,如需使用预设枚举来设置变声,请使用新增的 [setVoiceChangerPreset] 函数。相关 API 请参考 setVoiceChangerPreset, setVoiceChangerParam
param
参数的预设枚举构造函数,该函数仅用于微调设置具体的混响参数值,如需使用预设枚举来设置混响,请使用新增的 [setReverbPreset] 函数。相关 API 请参考 setReverbPreset, setReverbAdvancedParam
发布日期: 2020-10-15
改进优化
问题修复
发布日期: 2020-09-24
新增功能
音效是指为了增强真实感或者烘托场景氛围播放的简短效果音,例如:在直播期间播放掌声、礼物音效、提示音等;在游戏中,播放子弹声、碰撞打击声。
音效播放器支持音效播放(可以多音效重叠播放)、播放控制(如暂停播放、音量调节、设置播放进度)、预加载音效等功能。
相关 API 请参考 createAudioEffectPlayer, destroyAudioEffectPlayer
支持通过 setAudioDeviceVolume 接口设置音频设备(扬声器或麦克风)的采集音量后再推拉流,但由于系统限制可能导致此接口调用失败,推荐直接使用 setCaptureVolume 和 setPlayVolume 接口来调节推拉流音量。
相关 API 请参考 setAudioDeviceVolume, getAudioDeviceVolume, setCaptureVolume, setPlayVolume
问题修复
相关 API 请参考 onRoomStreamExtraInfoUpdate
发布日期: 2020-09-17
问题修复
相关 API 请参考 onRoomUserUpdate
发布日期: 2020-09-10
新增功能
允许单独设置和获取媒体播放器的本地播放音量和推流音量。
相关 API 请参考 ZegoMediaPlayer > setPublishVolume, ZegoMediaPlayer > setPlayVolume
双声道即两个声音通道,听到声音时可以根据左耳和右耳对声音相位差来判断声源的具体位置。当开发者开启双声道采集后,使用专门的双声道采集设备,可以采集到双声道的音频数据并进行推流(推流需同时通过 setAudioConfig
接口开启双声道音频编码功能)。
相关 API 请参考 setAudioCaptureStereoMode, setAudioConfig
开发者可自行控制声浪/音频频谱监控的回调间隔,默认为 100 ms,取值范围为 [100, 3000]。
相关 API 请参考 startSoundLevelMonitor, startAudioSpectrumMonitor
切换房间时允许对新房间的属性进行配置,如登录鉴权等。
相关 API 请参考 switchRoom
废弃删除
onRemoteAudioData
, 请使用 onPlaybackAudioData
代替ZegoAudioDataCallbackBitMaskRemote
, 请使用 ZegoAudioDataCallbackBitMaskPlayback
代替发布日期: 2020-08-27
新增功能
该功能支持用户切换房间,调用 switchRoom 接口后停止上一个房间的推拉流并进入新房间,切换房间成功会收到新房间登录成功的回调。与之前通过调用登出原房间和加入新房间两个接口实现的方法相比,更易用也更高效。
相关 API 请参考 switchRoom
改进优化
当用户进入房间,房间内有流且带有附加信息时,onRoomStreamExtraInfoUpdate 将会回调,因此开发者只需要关心此回调即可处理流附加信息的逻辑。
相关 API 请参考 onRoomStreamExtraInfoUpdate
问题修复
相关 API 请参考 onPlayerRecvSEI
currentProgress
getter 得到的数值有误的问题。发布日期: 2020-08-13
新增功能
该功能支持同一用户可以同时加入多个房间,目前可进入的总房间数最多为两个。用户加入房间后,只能在主房间中推流,但可以在所有房间中拉流,并且可以正常接收每个房间的信令和回调。该功能通常用于“超级小班”等场景,若需要开启,请联系 ZEGO 技术支持。
相关 API 请参考 [loginMultiRoom]
该功能可以设置一个以房间为单位的附加消息,该消息跟随整个房间的生命周期,每个登录到房间的用户都能够同步消息。开发者可用于实现各种业务逻辑,如房间公告等等。目前房间附加消息只允许设置一个键值对,且 key 最大长度为 10 字节,value 最大长度为 100 字节。
相关 API 请参考 setRoomExtraInfo
允许开发者在采集音频数据后,或者拉取远端音频数据渲染前,对音频数据进行自定义处理。该功能通常用于 “变声”、“美声” 等场景。
相关 API 请参考 enableCustomAudioCaptureProcessing, enableCustomAudioRemoteProcessing
改进优化
推流采集音量与拉流播放音量范围由 0 ~ 100 扩大至 0 ~ 200,默认值为 100。
相关 API 请参考 setCaptureVolume, setPlayVolume
发布日期: 2020-08-06
问题修复
超过最大房间登录数量
错误码的问题。发布日期: 2020-07-30
新增功能
支持调整 10 个频带的增益值,从而达到调整音色的目的。
相关 API 请参考 setAudioEqualizerGain
发布日期: 2020-07-23
问题修复
AudioDataCallback
可能不回调的问题。destroyEngine
时个别功能组件销毁失败的问题。发布日期: 2020-07-15
改进优化
broadcast message
和房间弹幕消息 barrage message
。发布日期: 2020-06-30
新增功能
开发者基于此可实现一些音频前处理效果。
相关 API 请参考 enableVirtualStereo, setVoiceChangerParam, setReverbAdvancedParam
开发者可将音视频流录制成本地文件,便于日后作回放等用途。
相关 API 请参考 startRecordingCapturedData, stopRecordingCapturedData
开发者通过监听音频数据回调获取 PCM 数据后可作进一步用途,如对接第三方音频鉴黄、字幕生成等功能。
相关 API 请参考 [enableAudioDataCallback]
Medium
中等模式。相关 API 请参考 setANSMode
开发者可通过此功能自行采集音频数据发送给 SDK,并且自行获取远端拉流的音频数据来处理或播放。
相关 API 请参考 enableCustomAudioIO
发布日期: 2020-06-20
问题修复
onMixerSoundLevelUpdate
回调的问题。发布日期: 2020-06-17
问题修复
onAudioMixingCopyData
回调数据的拷贝和越界问题。发布日期: 2020-06-15
新增功能
enableMixSystemPlayout
(仅支持 macOS/Windows)。enableHeadphoneMonitor
接口,支持耳返功能。问题修复
setEventHandler
无法设置为空的问题。destroyEngine
之后将不再回调的问题。发布日期: 2020-06-11
问题修复
advancedConfig
含有特殊字符时设置失败的问题。发布日期: 2020-05-31
新增功能
getAudioConfig
和 getVideoConfig
,方便开发者随时获取和管理当前音视频质量参数。isMuteMicrophone
和 isMuteSpeaker
,方便开发者管理音频设备的状态。问题修复
废弃删除
发布日期: 2020-05-18
问题修复
setEngineConfig
显式设置日志路径不生效的问题。发布日期: 2020-05-15
新增功能
1000008
。再次调用 setEventHandler
更改 Event Handler 前需要显式置空。
发布日期: 2020-04-30
新增功能
onRoomOnlineUserCountUpdate
;开发者基于此回调可以实时监听当前房间人数的变更情况,并以 UI 形式向用户展示。问题修复
发布日期: 2020-04-15
新增功能
onPublisherQualityUpdate
回调新增几个质量属性,包括 totalSendBytes
(已发送的总字节数)、audioSendBytes
(已发送的音频字节数)、videoSendBytes
(已发送的视频字节数)。开发者可以根据这些属性进行推流数据的统计。onPlayerQualityUpdate
回调新增几个质量属性,包括 totalRecvBytes
(已接收的总字节数)、audioRecvBytes
(已接收的音频字节数)、videoRecvBytes
(已接收的视频字节数)、peerToPeerDelay
(端到端延迟)、peerToPeePacketLostRate
(端到端丢包率)。开发者可以根据这些属性进行拉流数据和拉流延迟的统计。改进优化
发布日期: 2020-03-31
改进优化
问题修复
发布日期: 2020-03-19
问题修复
发布日期: 2020-03-14
新增功能
开发者在调用 createEngine
时,可选择应用场景,SDK 会针对实时通讯场景和直播场景进行最优预配置。
当开发者需要实现一路流推摄像头,另一路流推如屏幕采集等输入源时,可使用推辅流功能。该功能可用于实现教学、会议等场景。
开发者可通过调用 enableTrafficControl
选择流控的自适应属性,包括:自适应分辨率、自适应码率、自适应帧率。
开发者可通过指定具体 CDN 的 URL(或使用Zego后台配置),直接将音视频流推送到 CDN,需在推流前设置。
相关 API 请参考 enablePublishDirectToCDN
startPlayingStream
增加一个重载 API ,实现进阶拉流功能。开发者可通过设置拉流CDN配置,直接通过 URL 进行拉流。当推流方使用了直推或转推 CDN 功能的情况下,拉流方需要使用 URL 进行拉流。当推流方开启了分层编码功能后,拉流方可通过设置 videoLayer 为 base 以拉取低分辨率图层。
当开发者需要让拉混流的观众知道当前每条流的声浪状态时,可在发起混流时调用 enableSoundLevel
开启 sound level,且在每条输入流配置中标记一个唯一的音浪ID,则拉流方可以通过监听 onMixerSoundLevelUpdate
获取每条流的音浪通知。
当开发者需要在超过 500 人的房间中发送一些业务不可靠的消息时(如弹幕消息,房间每位观众不一定都必须收到每一条信息),可使用房间弹幕消息功能。
相关 API 请参考 sendBarrageMessage
改进优化
destroyEngine
接口,增加同名但带一个 callback 参数的 destroyEngine
接口。当开发者销毁 SDK 且收到回调时,则可认为 SDK 内部占用资源已释放,此时开发者可进行多家 SDK 的切换。
发布日期: 2020-01-17
问题修复
发布日期: 2019-12-27
新增功能
setAudioConfig
接口,可选择配置推流前音频参数(音频编码类型/音频码率/声道数)发布日期: 2019-12-13
新增功能
改进优化
发布日期: 2019-11-27
新增功能
发布日期: 2019-11-11
新增功能
问题修复
发布日期: 2019-11-01
新增功能
联系我们
文档反馈