提交工单
咨询集成、功能及报价等问题
为方便开发者快速接入,降低开发者接入门槛,SDK 通过大量线上数据验证,沉淀出多种场景化配置方案。开发者可根据所需场景,选择对应的房间模式,SDK 将自动应用适合该场景的音视频编解码器、音视频参数、流控策略等配置,从而快速实现该场景下的最佳效果。当前支持场景包括秀场直播、KTV、标准 1v1 音视频通话、高画质 1v1 音视频通话、标准语聊房、高音质语聊房。
创建并初始化一个 ZegoExpressEngine 的实例, options
参数中的 scenario
字段需要指定一个场景,您可以根据实际音视频业务场景来选择。
const zg = new ZegoExpressEngine(appid, server, { scenario: 4 })
目前 SDK 支持下列场景:
同一个房间内的用户,建议使用同一种房间场景,以获得最佳效果。
场景(支持版本:2.21.0 及以上) | 场景值 | 场景描述 | 关键配置说明 |
---|---|---|---|
Broadcast |
8 |
直播场景,适用于秀场、游戏、电商、教育大班课等一对多直播的场景,对音画质量、流畅度、兼容性进行了优化。
注意:即便是直播场景,SDK 也没有业务上的 “角色” 之分(例如主播、观众),房间内的所有用户均可推拉流。 |
|
StandardVideoCall |
4 |
标准音视频通话场景,适用于 1 V 1 视频或语音通话场景。 |
|
HighQualityVideoCall |
5 |
高品质音视频通话场景,与 StandardVideoCall 场景类似,但该场景默认采用了比 StandardVideoCall 场景更高的视频帧率、码率、分辨率 ,适用于对画质要求较高的视频通话场景。 |
|
StandardChatroom |
6 |
标准语聊房场景,适用于多人纯语音通话。(节省流量)
注意:此场景默认不开启摄像头。 |
- |
Default |
3 |
默认(通用)场景,若上述场景枚举均不符合开发者的实际应用场景,可以使用此默认场景。 |
|
若指定场景后,开发者有对 SDK 音视频配置精细化控制的需求,可通过其他 API 进行配置,优先级高于场景化配置。
若您需要有多种音视频业务场景,例如,同时有 1v1 音视频通话场景和秀场直播场景。您可以在不创建新的引擎实例的前提下,在退出房间后,通过调用 setRoomScenario 切换场景,然后再登录其他房间。
// 退出房间后可修改初始化传入的场景值
zg.setRoomScenario(5);
联系我们
文档反馈