setRoomScenario method

Future<void> setRoomScenario(
  1. ZegoScenario scenario
)

设置房间场景。

支持版本:3.0.0 及以上。 详情描述:开发者可设置房间的使用场景,SDK 会针对不同的场景采取不同的优化策略,以便获取更优的效果;此函数的作用与 createEngineprofile 配置中的 scenario 参数完全一致。 业务场景:此函数适用于多种音视频业务场景的 App,例如有 1v1 音视频通话场景和秀场直播场景;通过此函数可以实现在不销毁引擎 destroyEngine 的前提下切换场景。 调用时机:必须在调用 createEngine 之后且调用 loginRoom 之前设置。 使用限制:一旦登录了房间就不再允许修改房间场景,若需要修改场景需要先退出房间,若登录了多个房间则需要退出所有房间后才能修改。 注意事项:

  1. 同一个房间内的用户建议使用同一种房间场景以获得最佳效果。
  2. 设置场景会影响音视频码率、帧率、分辨率、编码类型、音频设备模式、路由、流控、3A、耳返等音视频配置,若开发者有特殊需求可以在设置房间场景后再调用其他各种 API 来设置上述配置。
  3. 调用此函数将覆盖 createEngine 时指定的场景或上一次调用此函数设置的场景。
  4. 调用此函数将覆盖你通过 setVideoConfig, setAudioConfig 等 API 设置的音视频相关配置,因此建议先第一时间设置场景再通过其他 API 调整音视频配置。
  • scenario 房间场景。

Implementation

Future<void> setRoomScenario(ZegoScenario scenario) async {
  return await ZegoExpressImpl.instance.setRoomScenario(scenario);
}