setRoomScenario method
- ZegoScenario scenario
设置房间场景。
支持版本:3.0.0 及以上。
详情描述:开发者可设置房间的使用场景,SDK 会针对不同的场景采取不同的优化策略,以便获取更优的效果;此函数的作用与 createEngine 的 profile
配置中的 scenario
参数完全一致。
业务场景:此函数适用于多种音视频业务场景的 App,例如有 1v1 音视频通话场景和秀场直播场景;通过此函数可以实现在不销毁引擎 destroyEngine 的前提下切换场景。
调用时机:必须在调用 createEngine 之后且调用 loginRoom
之前设置。
使用限制:一旦登录了房间就不再允许修改房间场景,若需要修改场景需要先退出房间,若登录了多个房间则需要退出所有房间后才能修改。
注意事项:
- 同一个房间内的用户建议使用同一种房间场景以获得最佳效果。
- 设置场景会影响音视频码率、帧率、分辨率、编码类型、音频设备模式、路由、流控、3A、耳返等音视频配置,若开发者有特殊需求可以在设置房间场景后再调用其他各种 API 来设置上述配置。
- 调用此函数将覆盖 createEngine 时指定的场景或上一次调用此函数设置的场景。
- 调用此函数将覆盖你通过
setVideoConfig
,setAudioConfig
等 API 设置的音视频相关配置,因此建议先第一时间设置场景再通过其他 API 调整音视频配置。
scenario
房间场景。
Implementation
Future<void> setRoomScenario(ZegoScenario scenario) async {
return await ZegoExpressImpl.instance.setRoomScenario(scenario);
}