功能总览
ZEGO SDK 拥有全面覆盖全球重点区域的网络节点，提供丰富的 API，为多端提供清晰稳定的实时语音视频云服务。
API 返回的错误码请参考：https://doc-zh.zego.im/article/4378。
以下为基本的 API 简要介绍。
初始化相关的前置功能
| 方法名 | 描述 |
|---|---|
| createEngineWithProfile:eventHandler: | 创建 ZegoExpressEngine 单例对象并初始化 SDK。 |
| destroyEngine: | 销毁 ZegoExpressEngine 单例对象并反初始化 SDK。 |
| sharedEngine | 获取引擎单例对象。 |
| setEngineConfig: | 设置引擎进阶配置。 |
| setLogConfig: | 设置日志配置。 |
| setLocalProxyConfig:enable: | 设置本地代理配置 |
| setCloudProxyConfig:token:enable: | 设置云代理配置 |
| setLicense: | 设置 License 鉴权。 |
| setRoomMode: | 设置房间模式。 |
| setGeoFence:area: | 设置地理围栏。 |
| getVersion | 获取 SDK 版本号。 |
| setApiCalledCallback: | 设置方法执行结果回调。 |
| isFeatureSupported: | 查询当前 SDK 是否支持指定的功能特性。 |
| setEventHandler: | 设置事件通知回调。 |
| setRoomScenario: | 设置房间场景。 |
| uploadLog | 上传日志到 ZEGO 服务器。 |
| uploadLog: | 上传日志到 ZEGO 服务器，带回调。 |
| submitLog | 上传日志到 ZEGO 服务器。 |
| enableDebugAssistant: | 开启调试助手。注意，请勿在线上版本开启此功能！仅在开发阶段使用！ |
| callExperimentalAPI: | 调用实验性 API。 |
| onDebugError:funcName:info: | 调试错误信息回调。 |
| onApiCalledResult:funcName:info: | 方法执行结果回调。 |
| onEngineStateUpdate: | 音视频引擎状态更新的回调通知。 |
| onRecvExperimentalAPI: | 实验性 API 回调。 |
| onFatalError: | 发生致命性错误的回调通知，SDK功能无法正常使用。 |
房间功能
| 方法名 | 描述 |
|---|---|
| loginRoom:user: | 登录房间，推拉流前必须登录房间。 |
| loginRoom:user:config: | 使用配置进阶属性的方式登录房间，推拉流前必须登录房间。 |
| loginRoom:user:config:callback: | 使用带配置进阶属性的方式登录房间，通过回调参数返回登录结果，推拉流前必须登录房间。 |
| logoutRoom | 退出房间。 |
| logoutRoomWithCallback: | 退出房间，带回调。 |
| logoutRoom: | 退出指定房间 ID 的房间。 |
| logoutRoomWithCallback:callback: | 退出指定房间 ID 的房间，并带有回调。 |
| switchRoom:toRoomID: | 切换房间。 |
| switchRoom:toRoomID:config: | 使用配置进阶属性的方式切换房间。 |
| renewToken: | 更新 token 鉴权信息。 |
| setRoomExtraInfo:forKey:roomID:callback: | 设置房间附加消息。 |
| getRoomStreamList:streamListType: | 获取房间内流列表。 |
| onRoomStateUpdate:errorCode:extendedData:roomID: | 房间状态变化通知。 |
| onRoomStateChanged:errorCode:extendedData:roomID: | 房间状态变化通知，包含具体的状态变化原因。 |
| onRoomUserUpdate:userList:roomID: | 房间内其他用户增加或减少的回调通知。 |
| onRoomOnlineUserCountUpdate:roomID: | 房间内当前在线用户数量回调。 |
| onRoomStreamUpdate:streamList:extendedData:roomID: | 相同房间内其他用户推的流增加或减少的通知。 |
| onRoomStreamExtraInfoUpdate:roomID: | 房间内流附加信息更新通知。 |
| onRoomExtraInfoUpdate:roomID: | 房间附加信息更新通知。 |
| onRoomTokenWillExpire:roomID: | 房间 Token 鉴权将要过期的回调通知。 |
推流功能
拉流功能
信令消息功能
| 方法名 | 描述 |
|---|---|
| createRealTimeSequentialDataManager: | 创建实时有序数据管理器对象 |
| destroyRealTimeSequentialDataManager: | 销毁实时有序数据管理器对象 |
| setEventHandler: | 设置实时有序数据管理器回调 |
| startBroadcasting: | 开始广播实时有序数据流。 |
| stopBroadcasting: | 停止广播实时有序数据流 |
| sendRealTimeSequentialData:streamID:callback: | 在广播中的流 ID 上发送实时有序数据 |
| startSubscribing: | 开始订阅实时有序数据流。 |
| stopSubscribing: | 停止订阅实时有序数据流。 |
| getIndex | 获取实时有序数据管理器索引。 |
| manager:receiveRealTimeSequentialData | 收到实时有序数据回调 |
| sendBroadcastMessage:roomID:callback: | 发送房间广播消息。 |
| sendBarrageMessage:roomID:callback: | 发送房间弹幕消息。 |
| sendCustomCommand:callback: | 发送自定义信令。 |
| sendTransparentMessage:roomID:callback: | 发送透传消息。 |
| onRecvRoomTransparentMessage:roomID: | 接收房间透传消息。 |
| onIMRecvBroadcastMessage:roomID: | 接收房间广播消息通知。 |
| onIMRecvBarrageMessage:roomID: | 接收房间弹幕消息通知。 |
| onIMRecvCustomCommand:fromUser:roomID: | 接收自定义信令通知。 |
混流功能
| 方法名 | 描述 |
|---|---|
| startMixerTask:callback: | 开始混流任务。 |
| stopMixerTask:callback: | 停止混流任务。 |
| startAutoMixerTask:callback: | 开始自动混流任务 |
| stopAutoMixerTask:callback: | 停止自动混流任务 |
| onMixerRelayCDNStateUpdate:taskID: | 混流转推 CDN 状态更新通知。 |
| onMixerSoundLevelUpdate: | 混流中的每条单流的声浪更新通知。 |
| onAutoMixerSoundLevelUpdate: | 自动混流中的每条单流的声浪更新通知 |
音视频前处理
| 方法名 | 描述 |
|---|---|
| enableAEC: | 是否开启回声消除。 |
| enableHeadphoneAEC: | 是否在使用耳机时开启回声消除。 |
| setAECMode: | 设置回声消除模式 |
| enableAGC: | 开/关自动增益控制 |
| enableANS: | 开/关噪声抑制 |
| enableTransientANS: | 开/关瞬态噪声抑制 |
| setANSMode: | 设置音频噪声抑制模式 |
| enableSpeechEnhance:level: | 开启或关闭人声增强。 |
| enableAudioMixing: | 开/关混音功能 |
| setAudioMixingHandler: | 设置混音回调 |
| muteLocalAudioMixing: | 静音或恢复本地播放混音声音。 |
| setAudioMixingVolume: | 设置混音音量（同时设置本地和远端的音量） |
| setAudioMixingVolume:type: | 设置混音音量（可分别设置本地、远端的音量） |
| startEffectsEnv | 开启 Effects 美颜环境。 |
| stopEffectsEnv | 关闭 Effects 美颜环境。 |
| enableEffectsBeauty: | 开启或关闭美颜效果。 |
| setEffectsBeautyParam: | 设置美颜效果参数。 |
| setAudioEqualizerGain:bandGain: | 设置音效均衡器（EQ）。 |
| setVoiceChangerPreset: | 通过预设枚举设置变声。 |
| setVoiceChangerParam: | 设置变声的具体参数。 |
| setReverbPreset: | 通过预设枚举设置混响。 |
| setReverbAdvancedParam: | 设置混响的具体参数。 |
| setReverbEchoParam: | 设置混响回声效果的具体参数。 |
| enableVirtualStereo:angle: | 开启或关闭推流时的虚拟立体声效果。 |
| enablePlayStreamVirtualStereo:angle:streamID: | 开启或关闭拉流时的虚拟立体声效果。 |
| setElectronicEffects:mode:tonal: | 开启或关闭电音效果。 |
| enableColorEnhancement:params:channel: | 开启色彩增强。 |
| onAudioMixingCopyData: | 混音数据回调。 |
媒体播放器功能
音效播放器功能
| 方法名 | 描述 |
|---|---|
| createAudioEffectPlayer | 创建音效播放器实例对象。 |
| destroyAudioEffectPlayer: | 销毁音效播放器实例对象。 |
| setEventHandler: | 设置音效播放器回调。 |
| start:path:config: | 开始播放音效。 |
| stop: | 停止播放音效。 |
| pause: | 暂停播放音效。 |
| resume: | 恢复播放音效。 |
| stopAll | 停止播放所有音效。 |
| pauseAll | 暂停播放所有音效。 |
| resumeAll | 恢复播放所有音效。 |
| seekTo: | 设置播放进度。 |
| setVolume:audioEffectID: | 设置单个音效的播放音量，会同时设置本地播放音量和推流音量。 |
| setPlayVolume:audioEffectID: | 设置单个音效的本地播放音量。 |
| setPublishVolume:audioEffectID: | 设置单个音效的推流音量。 |
| setVolumeAll: | 设置所有音效的播放音量，会同时设置本地播放音量和推流音量。 |
| setPlayVolumeAll: | 设置所有音效的本地播放音量。 |
| setPublishVolumeAll: | 设置所有音效的推流音量。 |
| setPlaySpeed:audioEffectID: | 设置指定音效的播放速度，会同时设置本地播放速度和推流速度（不支持单独设置）。 |
| getTotalDuration | 获取指定音效资源的总长度。 |
| getCurrentProgress: | 获取当前播放进度。 |
| loadResource:audioEffectID:callback: | 加载音效资源。 |
| unloadResource: | 卸载音效资源。 |
| updatePosition:position: | 更新音效播放器(音频源)位置。 |
| getIndex | 获取音效播放器索引。 |
| audioEffectPlayer:audioEffectID:playStateUpdate | 音效播放状态回调。 |
录制功能
| 方法名 | 描述 |
|---|---|
| startRecordingCapturedData:channel: | 开始本地录制，直接将音视频数据录制到本地文件。 |
| stopRecordingCapturedData: | 结束录制本端音频或音视频。 |
| setDataRecordEventHandler: | 设置数据录制事件回调。 |
| onCapturedDataRecordStateUpdate:errorCode:config:channel: | 本地录制的状态更新回调，当录制过程状态变化时触发。 |
| onCapturedDataRecordProgressUpdate:config:channel: | 录制进度更新回调。 |
设备管理
自定义视频采集和渲染
自定义音频采集和渲染
媒体推流器
| 方法名 | 描述 |
|---|---|
| createMediaDataPublisher: | 创建媒体数据推流器实例对象 |
| destroyMediaDataPublisher: | 销毁媒体数据推流器实例对象。 |
| setEventHandler: | 设置媒体推流器的事件回调。 |
| addMediaFilePath:isClear: | 添加媒体文件到推流队列中。目前仅支持 mp4 / m4a / aac 文件，且需要做特殊转换。 |
| reset | 清除此媒体推流器中的所有状态，以便下次推流时重新开始。 |
| setVideoSendDelayTime: | 设置推迟视频播放时间。 |
| seekTo: | 指定当前视频文件推流发送的时间起始点。 |
| getTotalDuration | 获取当前文件的总时长。 |
| getCurrentDuration | 获取当前文件的播放进度。 |
| getIndex | 获取媒体推流器的推流通道号。 |
| mediaDataPublisher | 媒体推流器打开媒体文件的事件回调。 |
| mediaDataPublisher:fileClose | 媒体推流器关闭媒体文件的事件回调 |
| mediaDataPublisher | 媒体推流器开始读取到了媒体文件数据的事件回调。 |
| mediaDataPublisher | 媒体推流器已完成一个文件推流的回调。 |
实用工具
| 方法名 | 描述 |
|---|---|
| startPerformanceMonitor: | 启动系统性能监控。 |
| stopPerformanceMonitor | 停止系统性能监控。 |
| startNetworkProbe:callback: | 启动网络探测。 |
| stopNetworkProbe | 停止网络探测。 |
| testNetworkConnectivity: | 测试网络连通性 |
| startNetworkSpeedTest: | 启动网络测速。 |
| startNetworkSpeedTest:interval: | 启动网络测速，支持设置测速周期。 |
| stopNetworkSpeedTest | 停止网络测速。 |
| getNetworkTimeInfo | 获取同步网络时间信息。 |
| startDumpData: | 转储音视频数据。 |
| stopDumpData | 停止转储数据 |
| uploadDumpData | 上传转储数据到 ZEGO 服务端 |
| removeDumpData | 删除转储数据。 |
| onPerformanceStatusUpdate: | 系统性能监控回调。 |
| onNetworkModeChanged: | 网络模式变更回调。 |
| onNetworkSpeedTestError:type: | 网络测速异常回调。 |
| onNetworkSpeedTestQualityUpdate:type: | 网络测速质量回调。 |
| onNetworkQuality:upstreamQuality:downstreamQuality: | 房间内正在推流的用户的网络质量回调。 |
| onRtcStats: | RTC 网络统计信息回调。 |
| onNetworkTimeSynchronized | 网络时间同步成功的回调 |
| onRequestDumpData | 请求转储数据的回调。 |
| onRequestUploadDumpData:takePhoto: | 请求转储数据的回调。 |
| onStartDumpData: | 开始转储数据时的回调。 |
| onStopDumpData:dumpDir: | 停止转储数据时的回调。 |
| onUploadDumpData: | 上传转储数据完成后的回调。 |
范围语音
| 方法名 | 描述 |
|---|---|
| createRangeAudio | 创建范围语音实例对象。 |
| destroyRangeAudio: | 销毁范围语音实例对象。 |
| setEventHandler: | 设置范围语音回调。 |
| setAudioReceiveRange: | 设置音频接收距离的最大范围。 |
| setAudioReceiveRangeWithParam: | 设置音频接收范围的配置。 |
| setPositionUpdateFrequency: | 设置SDK内部实时更新位置的频率 |
| setRangeAudioVolume: | 设置范围语音音量 |
| setStreamVocalRange:vocalRange: | 设置流的发声范围 |
| setStreamVocalRangeWithParam:param: | 设置流的发声范围 |
| updateStreamPosition:position: | 更新流的位置 |
| updateSelfPosition:axisForward:axisRight:axisUp: | 更新自身的位置和朝向。 |
| updateAudioSource:position: | 添加或更新音源位置信息。 |
| enableSpatializer: | 开启或关闭 3D 音效。 |
| enableMicrophone: | 开启或关闭麦克风。 |
| enableSpeaker: | 开启或关闭扬声器。 |
| setRangeAudioMode: | 设置范围语音模式。 |
| setRangeAudioCustomMode:listenMode: | 设置范围语音的高阶自定义模式。 |
| setTeamID: | 设置队伍 ID |
| muteUser:mute: | 是否可接收指定用户音频数据。 |
| rangeAudio:microphoneStateUpdate | 范围语音麦克风使用状态回调。 |
版权音乐
范围场景
屏幕共享
废弃接口列表
| 方法名 | 描述 |
|---|---|
| setPlayStreamBufferIntervalRange:streamID: | 【已废弃】设置拉流播放缓存自适应调整的区间范围。 |
| enableBeautify: | 【已废弃】开/关美颜，为主推流通道设置。此函数在 2.16.0 版本及以上已废弃，请使用 [enableEffectsBeauty] 函数代替。 |
| enableBeautify:channel: | 【已废弃】开/关美颜，为任意推流通道设置。此函数在 2.16.0 版本及以上已废弃，请使用 [enableEffectsBeauty] 函数代替。 |
| setBeautifyOption: | 【已废弃】设置美颜参数。此函数在 2.16.0 版本及以上已废弃，请使用 [setEffectsBeautyParam] 函数代替。 |
| setBeautifyOption:channel: | 【已废弃】设置美颜参数。此函数在 2.16.0 版本及以上已废弃，请使用 [setEffectsBeautyParam] 函数代替。 |
| createEngineWithAppID:appSign:isTestEnv:scenario:eventHandler: | 【已废弃】创建 ZegoExpressEngine 单例对象并初始化 SDK。此函数在 2.14.0 版本及以上已废弃，请使用不带 [isTestEnv] 参数的同名函数代替。请参考 测试环境废弃说明 |
| requestSong:callback: | 【已废弃】点歌。此函数在 3.0.2 版本及以上已废弃，请使用 [requestResource] 函数代替。 |
| requestAccompaniment:callback: | 【已废弃】点伴奏。此函数在 3.0.2 版本及以上已废弃，请使用 [requestResource] 函数代替。 |
| requestAccompanimentClip:callback: | 【已废弃】点伴奏高潮片段。此函数在 3.0.2 版本及以上已废弃，请使用 [requestResource] 函数代替。 |
| getMusicByToken:callback: | 【已废弃】获取歌曲或伴奏。此函数在 3.0.2 版本及以上已废弃，请使用 [getSharedResource] 函数代替。 |
| getLrcLyric:callback: | 【已废弃】获取 lrc 格式歌词。此函数在 3.2.1 版本及以上已废弃，请使用带 [vendorID] 参数的同名函数代替。 |
| queryCache:type: | 【已废弃】查询资源是否有缓存。此函数在 3.2.1 版本及以上已废弃，请使用带 [vendorID] 参数的同名函数代替。 |
| queryCache:type:vendorID: | 【已废弃】查询资源是否有缓存。此函数在 3.9.0 版本及以上已废弃，请使用带 [config] 参数的同名函数代替。 |
| setVoiceChangerParam:audioChannel: | 【已废弃】设置变声的具体参数 |