提交工单
咨询集成、功能及报价等问题
ZEGO SDK 拥有全面覆盖全球重点区域的网络节点,提供丰富的 API,为多端提供清晰稳定的实时语音视频云服务。 以下为基本 API 的简要介绍。
方法名 | 描述 |
---|---|
createEngineWithProfile | 创建 ZegoExpressEngine 单例对象并初始化 SDK。 |
destroyEngine | 销毁 ZegoExpressEngine 单例对象并反初始化 SDK。 |
setEngineConfig | 设置引擎进阶配置。 |
setLogConfig | 设置日志配置。 |
setLocalProxyConfig | 设置本地代理配置 |
setCloudProxyConfig | 设置云代理配置 |
setLicense | 设置 License 鉴权。 |
setRoomMode | 设置房间模式。 |
setGeoFence | 设置地理围栏。 |
getVersion | 获取 SDK 版本号。 |
isFeatureSupported | 查询当前 SDK 是否支持指定的功能特性。 |
setRoomScenario | 设置房间场景。 |
uploadLog | 上传日志到 ZEGO 服务器。 |
submitLog | 上传日志到 ZEGO 服务器。 |
enableDebugAssistant | 开启调试助手。注意,请勿在线上版本开启此功能!仅在开发阶段使用! |
callExperimentalAPI | 调用实验性 API。 |
onDebugError | 调试错误信息回调。 |
onApiCalledResult | 方法执行结果回调。 |
onEngineStateUpdate | 音视频引擎状态更新的回调通知。 |
onRecvExperimentalAPI | 实验性 API 回调。 |
onFatalError | 发生致命性错误的回调通知,SDK功能无法正常使用。 |
方法名 | 描述 |
---|---|
loginRoom | 使用带配置进阶属性的方式登录房间,通过回调参数返回登录结果,推拉流前必须登录房间。 |
logoutRoom | 退出指定房间 ID 的房间,并带有回调。 |
switchRoom | 使用配置进阶属性的方式切换房间。 |
renewToken | 更新 token 鉴权信息。 |
setRoomExtraInfo | 设置房间附加消息。 |
getRoomStreamList | 获取房间内流列表。 |
onRoomStateUpdate | 房间状态变化通知。 |
onRoomStateChanged | 房间状态变化通知,包含具体的状态变化原因。 |
onRoomUserUpdate | 房间内其他用户增加或减少的回调通知。 |
onRoomOnlineUserCountUpdate | 房间内当前在线用户数量回调。 |
onRoomStreamUpdate | 相同房间内其他用户推的流增加或减少的通知。 |
onRoomStreamExtraInfoUpdate | 房间内流附加信息更新通知。 |
onRoomExtraInfoUpdate | 房间附加信息更新通知。 |
onRoomTokenWillExpire | 房间 Token 鉴权将要过期的回调通知。 |
方法名 | 描述 |
---|---|
createRealTimeSequentialDataManager | 创建实时有序数据管理器对象 |
destroyRealTimeSequentialDataManager | 销毁实时有序数据管理器对象 |
startBroadcasting | 开始广播实时有序数据流。 |
stopBroadcasting | 停止广播实时有序数据流 |
sendRealTimeSequentialData | 在广播中的流 ID 上发送实时有序数据 |
startSubscribing | 开始订阅实时有序数据流。 |
stopSubscribing | 停止订阅实时有序数据流。 |
getIndex | 获取实时有序数据管理器索引。 |
onReceiveRealTimeSequentialData | 收到实时有序数据回调 |
sendBroadcastMessage | 发送房间广播消息。 |
sendBarrageMessage | 发送房间弹幕消息。 |
sendCustomCommand | 发送自定义信令。 |
sendTransparentMessage | 发送透传消息。 |
onRecvRoomTransparentMessage | 接收房间透传消息。 |
onIMRecvBroadcastMessage | 接收房间广播消息通知。 |
onIMRecvBarrageMessage | 接收房间弹幕消息通知。 |
onIMRecvCustomCommand | 接收自定义信令通知。 |
方法名 | 描述 |
---|---|
startMixerTask | 开始混流任务。 |
stopMixerTask | 停止混流任务。 |
startAutoMixerTask | 开始自动混流任务 |
stopAutoMixerTask | 停止自动混流任务 |
onMixerRelayCDNStateUpdate | 混流转推 CDN 状态更新通知。 |
onMixerSoundLevelUpdate | 混流中的每条单流的声浪更新通知。 |
onAutoMixerSoundLevelUpdate | 自动混流中的每条单流的声浪更新通知 |
方法名 | 描述 |
---|---|
enableAEC | 是否开启回声消除。 |
enableHeadphoneAEC | 是否在使用耳机时开启回声消除。 |
setAECMode | 设置回声消除模式 |
enableAGC | 开/关自动增益控制 |
enableANS | 开/关噪声抑制 |
enableTransientANS | 开/关瞬态噪声抑制 |
setANSMode | 设置音频噪声抑制模式 |
enableSpeechEnhance | 开启或关闭人声增强。 |
startEffectsEnv | 开启 Effects 美颜环境。 |
stopEffectsEnv | 关闭 Effects 美颜环境。 |
enableEffectsBeauty | 开启或关闭美颜效果。 |
setEffectsBeautyParam | 设置美颜效果参数。 |
setAudioEqualizerGain | 设置音效均衡器(EQ)。 |
setVoiceChangerPreset | 通过预设枚举设置变声。 |
setVoiceChangerParam | 设置变声的具体参数。 |
setReverbPreset | 通过预设枚举设置混响。 |
setReverbAdvancedParam | 设置混响的具体参数。 |
setReverbEchoParam | 设置混响回声效果的具体参数。 |
enableVirtualStereo | 开启或关闭推流时的虚拟立体声效果。 |
enablePlayStreamVirtualStereo | 开启或关闭拉流时的虚拟立体声效果。 |
setElectronicEffects | 开启或关闭电音效果。 |
enableColorEnhancement | 开启色彩增强。 |
方法名 | 描述 |
---|---|
createAudioEffectPlayer | 创建音效播放器实例对象。 |
destroyAudioEffectPlayer | 销毁音效播放器实例对象。 |
start | 开始播放音效。 |
stop | 停止播放音效。 |
pause | 暂停播放音效。 |
resume | 恢复播放音效。 |
stopAll | 停止播放所有音效。 |
pauseAll | 暂停播放所有音效。 |
resumeAll | 恢复播放所有音效。 |
seekTo | 设置播放进度。 |
setVolume | 设置单个音效的播放音量,会同时设置本地播放音量和推流音量。 |
setPlayVolume | 设置单个音效的本地播放音量。 |
setPublishVolume | 设置单个音效的推流音量。 |
setVolumeAll | 设置所有音效的播放音量,会同时设置本地播放音量和推流音量。 |
setPlayVolumeAll | 设置所有音效的本地播放音量。 |
setPublishVolumeAll | 设置所有音效的推流音量。 |
setPlaySpeed | 设置指定音效的播放速度,会同时设置本地播放速度和推流速度(不支持单独设置)。 |
getTotalDuration | 获取指定音效资源的总长度。 |
getCurrentProgress | 获取当前播放进度。 |
loadResource | 加载音效资源。 |
unloadResource | 卸载音效资源。 |
updatePosition | 更新音效播放器(音频源)位置。 |
getIndex | 获取音效播放器索引。 |
onAudioEffectPlayStateUpdate | 音效播放状态回调。 |
方法名 | 描述 |
---|---|
startRecordingCapturedData | 开始本地录制,直接将音视频数据录制到本地文件。 |
stopRecordingCapturedData | 结束录制本端音频或音视频。 |
onCapturedDataRecordStateUpdate | 本地录制的状态更新回调,当录制过程状态变化时触发。 |
onCapturedDataRecordProgressUpdate | 录制进度更新回调。 |
方法名 | 描述 |
---|---|
enableCustomVideoRender | 开始或停止自定义视频渲染。 |
enableCustomVideoCapture | 开始或停止自定义视频采集,支持设置其他通道的推流。 |
enableCustomVideoProcessing | 自定义视频前处理配置开关,支持指定推流通道号。 |
方法名 | 描述 |
---|---|
createMediaDataPublisher | 创建媒体数据推流器实例对象 |
destroyMediaDataPublisher | 销毁媒体数据推流器实例对象。 |
addMediaFilePath | 添加媒体文件到推流队列中。目前仅支持 mp4 / m4a / aac 文件,且需要做特殊转换。 |
reset | 清除此媒体推流器中的所有状态,以便下次推流时重新开始。 |
setVideoSendDelayTime | 设置推迟视频播放时间。 |
seekTo | 指定当前视频文件推流发送的时间起始点。 |
getTotalDuration | 获取当前文件的总时长。 |
getCurrentDuration | 获取当前文件的播放进度。 |
getIndex | 获取媒体推流器的推流通道号。 |
onMediaDataPublisherFileOpen | 媒体推流器打开媒体文件的事件回调。 |
onMediaDataPublisherFileClose | 媒体推流器关闭媒体文件的事件回调 |
onMediaDataPublisherFileDataBegin | 媒体推流器开始读取到了媒体文件数据的事件回调。 |
onMediaDataPublisherFileDataEnd | 媒体推流器已完成一个文件推流的回调。 |
方法名 | 描述 |
---|---|
startPerformanceMonitor | 启动系统性能监控。 |
stopPerformanceMonitor | 停止系统性能监控。 |
startNetworkProbe | 启动网络探测。 |
stopNetworkProbe | 停止网络探测。 |
startNetworkSpeedTest | 启动网络测速,支持设置测速周期。 |
stopNetworkSpeedTest | 停止网络测速。 |
getNetworkTimeInfo | 获取同步网络时间信息。 |
startDumpData | 转储音视频数据。 |
stopDumpData | 停止转储数据 |
uploadDumpData | 上传转储数据到 ZEGO 服务端 |
removeDumpData | 删除转储数据。 |
onPerformanceStatusUpdate | 系统性能监控回调。 |
onNetworkModeChanged | 网络模式变更回调。 |
onNetworkSpeedTestError | 网络测速异常回调。 |
onNetworkSpeedTestQualityUpdate | 网络测速质量回调。 |
onNetworkQuality | 房间内正在推流的用户的网络质量回调。 |
onNetworkTimeSynchronized | 网络时间同步成功的回调 |
onRequestDumpData | 请求转储数据的回调。 |
onRequestUploadDumpData | 请求转储数据的回调。 |
onStartDumpData | 开始转储数据时的回调。 |
onStopDumpData | 停止转储数据时的回调。 |
onUploadDumpData | 上传转储数据完成后的回调。 |
方法名 | 描述 |
---|---|
createRangeAudio | 创建范围语音实例对象。 |
destroyRangeAudio | 销毁范围语音实例对象。 |
setAudioReceiveRange | 设置音频接收范围的配置。 |
setPositionUpdateFrequency | 设置SDK内部实时更新位置的频率 |
setRangeAudioVolume | 设置范围语音音量 |
setStreamVocalRange | 设置流的发声范围 |
updateStreamPosition | 更新流的位置 |
updateSelfPosition | 更新自身的位置和朝向。 |
updateAudioSource | 添加或更新音源位置信息。 |
enableSpatializer | 开启或关闭 3D 音效。 |
enableMicrophone | 开启或关闭麦克风。 |
enableSpeaker | 开启或关闭扬声器。 |
setRangeAudioMode | 设置范围语音模式。 |
setRangeAudioCustomMode | 设置范围语音的高阶自定义模式。 |
setTeamID | 设置队伍 ID |
muteUser | 是否可接收指定用户音频数据。 |
onRangeAudioMicrophoneStateUpdate | 范围语音麦克风使用状态回调。 |
方法名 | 描述 |
---|---|
createCopyrightedMusic | 创建版权音乐实例对象。 |
destroyCopyrightedMusic | 销毁版权音乐实例对象。 |
initCopyrightedMusic | 初始化版权音乐模块。 |
getCacheSize | 获取缓存大小。 |
clearCache | 清除缓存。 |
sendExtendedRequest | 发送扩展功能请求。 |
getLrcLyric | 获取 lrc 格式歌词。 |
getLrcLyricWithConfig | 获取 lrc 格式歌词。 |
getKrcLyricByToken | 获取逐字歌词。 |
requestResource | 获取音乐资源。 |
requestResourceV2 | 获取音乐资源。 |
getSharedResource | 获取分享歌曲资源。 |
getSharedResourceV2 | 获取分享歌曲资源。 |
download | 下载音乐资源。 |
cancelDownload | 取消下载音乐资源。 |
queryCacheWithConfig | 查询资源是否有缓存。 |
queryCacheWithConfigV2 | 查询资源是否有缓存。 |
getDuration | 获取歌曲或伴奏文件的播放时长。 |
setScoringLevel | 设置打分难度级别。 |
startScore | 开始评分。 |
pauseScore | 暂停评分。 |
resumeScore | 恢复评分。 |
stopScore | 结束评分。 |
resetScore | 重置评分。 |
getPreviousScore | 获取上一句的评分。 |
getAverageScore | 获取平均评分。 |
getTotalScore | 获取总评分。 |
getFullScore | 获取满分。 |
getStandardPitch | 获取标准音高数据。 |
getCurrentPitch | 获取实时音高数据。 |
onDownloadProgressUpdate | 加载歌曲或伴奏进度回调。 |
onCurrentPitchValueUpdate | 实时音高线回调。 |
方法名 | 描述 |
---|---|
enableBeautify | 【已废弃】开/关美颜,为任意推流通道设置。此函数在 2.16.0 版本及以上已废弃,请使用 [enableEffectsBeauty] 函数代替。 |
setBeautifyOption | 【已废弃】设置美颜参数。此函数在 2.16.0 版本及以上已废弃,请使用 [setEffectsBeautyParam] 函数代替。 |
createEngine | 【已废弃】创建 ZegoExpressEngine 单例对象并初始化 SDK。此函数在 2.14.0 版本及以上已废弃,请使用不带 [isTestEnv] 参数的同名函数代替。请参考 测试环境废弃说明 |
requestSong | 【已废弃】点歌。此函数在 3.0.2 版本及以上已废弃,请使用 [requestResource] 函数代替。 |
requestAccompaniment | 【已废弃】点伴奏。此函数在 3.0.2 版本及以上已废弃,请使用 [requestResource] 函数代替。 |
requestAccompanimentClip | 【已废弃】点伴奏高潮片段。此函数在 3.0.2 版本及以上已废弃,请使用 [requestResource] 函数代替。 |
getMusicByToken | 【已废弃】获取歌曲或伴奏。此函数在 3.0.2 版本及以上已废弃,请使用 [getSharedResource] 函数代替。 |
queryCache | 【已废弃】查询资源是否有缓存。此函数在 3.9.0 版本及以上已废弃,请使用带 [config] 参数的同名函数代替。 |
setVoiceChangerParam | 【已废弃】设置变声的具体参数 |
联系我们
文档反馈