功能总览
2026-01-14
ZEGO SDK 拥有全面覆盖全球重点区域的网络节点，提供丰富的 API，为多端提供清晰稳定的实时语音视频云服务。 以下为基本 API 的简要介绍。
初始化相关的前置功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| createEngineWithProfile | 创建 ZegoExpressEngine 单例对象并初始化 SDK。 | ✔️ |
| destroyEngine | 销毁 ZegoExpressEngine 单例对象并反初始化 SDK。 | ✔️ |
| setEngineConfig | 设置引擎进阶配置。 | ✔️ |
| setRoomMode | 设置房间模式。 | ✔️ |
| setLogConfig | 自定义日志配置。（ Native 端暂不支持） | ✔️ |
| getVersion | 获取 SDK 版本号。 | ✔️ |
| uploadLog | 上传日志到 ZEGO 服务器。 | ✔️ |
| callExperimentalAPI | 调用实验性 API。 | ❌ |
| on<EventType extends keyof ZegoEventListener> | 注册事件监听 | ✔️ |
| off<EventType extends keyof ZegoEventListener> | 注销事件监听 | ✔️ |
| apiCalledResult | 方法执行结果回调。 | ✔️ |
| engineStateUpdate | 音视频引擎状态更新的回调通知。 | ✔️ |
房间功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| loginRoom | 使用带配置进阶属性的方式登录房间，通过回调参数返回登录结果，推拉流前必须登录房间。 | ✔️ |
| logoutRoom | 退出指定房间 ID 的房间，并带有回调。 | ✔️ |
| switchRoom | 使用配置进阶属性的方式切换房间。 | ❌ |
| renewToken | 更新 token 鉴权信息。 | ✔️ |
| setRoomExtraInfo | 设置房间附加消息。 | ✔️ |
| roomStateUpdate | 房间状态变化通知。 | ✔️ |
| roomStateChanged | 房间状态变化通知，包含具体的状态变化原因。 | ✔️ |
| roomUserUpdate | 房间内其他用户增加或减少的回调通知。 | ✔️ |
| roomOnlineUserCountUpdate | 房间内当前在线用户数量回调。 | ✔️ |
| roomStreamUpdate | 相同房间内其他用户推的流增加或减少的通知。 | ✔️ |
| roomStreamExtraInfoUpdate | 房间内流附加信息更新通知。 | ❌ |
| roomExtraInfoUpdate | 房间附加信息更新通知。 | ✔️ |
| roomTokenWillExpire | 房间 Token 鉴权将要过期的回调通知。 | ✔️ |
推流功能
拉流功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| startPlayingStream | 开始拉流（从 ZEGO RTC 服务器或第三方 CDN），支持多房间模式。 | ✔️ |
| stopPlayingStream | 停止拉流。 | ✔️ |
| takePlayStreamSnapshot | 拉流画面截图。 | ❌ |
| setPlayVolume | 设置拉流音量。 | ❌ |
| setAllPlayStreamVolume | 设置所有拉流音量。 | ❌ |
| setPlayStreamVideoType | 设置播放视频流类型。 | ❌ |
| setPlayStreamBufferIntervalRange | 设置拉流播放缓存自适应调整的区间范围。 | ❌ |
| setPlayStreamFocusOn | 设置拉音视频流优先级的权重。 | ❌ |
| mutePlayStreamAudio | 拉流是否可接收指定音频数据。 | ✔️ |
| mutePlayStreamVideo | 拉流是否可接收指定视频数据。 | ✔️ |
| muteAllPlayStreamAudio | 拉流是否接收所有音频数据。（当设置为true时， 调用[mutePlayStreamAudio]不会生效） | ❌ |
| muteAllPlayStreamVideo | 拉流是否可接收所有视频数据。（当设置为true时， 调用[mutePlayStreamVideo]不会生效） | ❌ |
| enableHardwareDecoder | 开/关硬件解码。 | ❌ |
| playerStateUpdate | 拉流状态变更回调。 | ✔️ |
| playerQualityUpdate | 拉流质量回调。 | ✔️ |
| playerMediaEvent | 拉流媒体事件回调。 | ❌ |
| playerRecvAudioFirstFrame | 拉流端音频接收首帧回调。 | ❌ |
| playerRecvVideoFirstFrame | 拉流端视频接收首帧回调。 | ❌ |
| playerRenderVideoFirstFrame | 拉流端渲染完视频首帧回调。 | ❌ |
| playerVideoSizeChanged | 拉流分辨率变更通知。 | ✔️ |
信令消息功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| sendBroadcastMessage | 发送房间广播消息。 | ✔️ |
| sendBarrageMessage | 发送房间弹幕消息。 | ✔️ |
| sendCustomCommand | 发送自定义信令。 | ✔️ |
| IMRecvBroadcastMessage | 接收房间广播消息通知。 | ✔️ |
| IMRecvBarrageMessage | 接收房间弹幕消息通知。 | ✔️ |
| IMRecvCustomCommand | 接收自定义信令通知。 | ✔️ |
混流功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| startMixerTask | 开始混流任务。 | ✔️ |
| stopMixerTask | 停止混流任务。 | ✔️ |
| startAutoMixerTask | 开始自动混流任务 | ✔️ |
| stopAutoMixerTask | 停止自动混流任务 | ✔️ |
| mixerRelayCDNStateUpdate | 混流转推 CDN 状态更新通知。 | ❌ |
| mixerSoundLevelUpdate | 混流中的每条单流的声浪更新通知。 | ✔️ |
| autoMixerSoundLevelUpdate | 自动混流中的每条单流的声浪更新通知。 | ✔️ |
音视频前处理
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| enableAEC | 是否开启回声消除。 | ✔️ |
| enableHeadphoneAEC | 是否在使用耳机时开启回声消除。 | ❌ |
| setAECMode | 设置回声消除模式 | ❌ |
| enableAGC | 开/关自动增益控制 | ✔️ |
| enableANS | 开/关噪声抑制 | ✔️ |
| enableTransientANS | 开/关瞬态噪声抑制 | ❌ |
| setANSMode | 设置音频噪声抑制模式 | ❌ |
| startEffectsEnv | 开启 Effects 美颜环境。 | ✔️ |
| stopEffectsEnv | 关闭 Effects 美颜环境。 | ✔️ |
| enableEffectsBeauty | 开启或关闭美颜效果。 | ✔️ |
| setEffectsBeautyParam | 设置美颜效果参数。 | ✔️ |
媒体播放器功能
音效播放器功能
暂不支持
录制功能
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| startRecordingCapturedData | 开始本地录制，直接将音视频数据录制到本地文件。 | ❌ |
| stopRecordingCapturedData | 结束录制本端音频或音视频。 | ❌ |
| capturedDataRecordStateUpdate | 本地录制的状态更新回调，当录制过程状态变化时触发。 | ❌ |
| capturedDataRecordProgressUpdate | 录制进度更新回调。 | ❌ |
设备管理
| 方法名 | 描述 | Web 端是否支持 |
|---|---|---|
| muteMicrophone | 设置是否静音（关闭麦克风）。 | ✔️ |
| isMicrophoneMuted | 检查麦克风是否设置为静音。 | ✔️ |
| muteSpeaker | 设置是否静音（关闭音频输出）。 | ❌ |
| isSpeakerMuted | 检查音频输出是否静音。 | ❌ |
| setAudioDeviceMode | 设置音频设备模式。 | ❌ |
| enableAudioCaptureDevice | 开/关音频采集设备。 | ❌ |
| getAudioRouteType | 获取当前音频路由。 | ❌ |
| setAudioRouteToSpeaker | 设置音频路由到扬声器。 | ❌ |
| enableCamera | 开/关摄像头，支持设置其他通道的推流。 | ✔️ |
| useFrontCamera | 切换前后摄像头，支持指定推流通道。 | ✔️ |
| setCameraZoomFactor | 设置摄像头变焦倍数，支持指定推流通道号。每次摄像头重新启动时，摄像头变焦倍数都将会恢复初始值 (1.0)。 | ❌ |
| getCameraMaxZoomFactor | 获取摄像头最大变焦倍数，支持指定推流通道号。 | ❌ |
| startSoundLevelMonitor | 启动声浪监控，支持开启进阶功能。 | ✔️ |
| stopSoundLevelMonitor | 停止声浪监控。 | ✔️ |
| enableHeadphoneMonitor | 开启/关闭 耳返。 | ❌ |
| setHeadphoneMonitorVolume | 设置耳返音量。 | ❌ |
| enableTorch | 开启/关闭 手电筒。 | ❌ |
| capturedSoundLevelInfoUpdate | 本地采集音频声浪回调，支持人声检测。 | ✔️ |
| remoteSoundLevelUpdate | 远端拉流音频声浪回调，支持人声检测。 | ✔️ |
| localDeviceExceptionOccurred | 本地设备异常通知。 | ✔️ |
| remoteCameraStateUpdate | 远端摄像头设备状态通知。 | ✔️ |
| remoteMicStateUpdate | 远端麦克风设备状态通知。 | ✔️ |
| remoteSpeakerStateUpdate | 远端扬声器设备状态通知。 | ❌ |
| audioRouteChange | 音频设备路由变更通知。 | ❌ |
自定义视频采集和渲染
暂不支持
自定义音频采集和渲染
暂不支持
媒体推流器
暂不支持
实用工具
暂不支持
范围语音
暂不支持
版权音乐
暂不支持
废弃接口列表
| 方法名 | 描述 |
|---|---|
| createEngine | 【已废弃】创建 ZegoExpressEngine 单例对象并初始化 SDK。此函数在 2.14.0 版本及以上已废弃，请使用不带 [isTestEnv] 参数的同名函数代替。请参考 测试环境废弃说明 |
| setVoiceChangerParam | 设置变声的具体参数 |