setVideoScenario abstract method
设置视频业务场景。
成功调用该方法设置视频业务场景后,SDK 会基于指定场景启用最佳实践策略,自动调整关键性能指标,进而优化视频体验质量。 该方法需要在加入频道前调用。
scenarioType视频业务场景。详见 VideoApplicationScenarioType 。 applicationScenarioMeeting (1) 适用于会议场景。如果用户已调用 setDualStreamMode 将小流设置为始终不发送 (disableSimulcastStream),会议场景对小流的动态开关不生效。 该枚举值仅适用于主播 vs 主播场景。SDK 会针对该场景启用以下策略: 针对会议场景对小流码率要求较高的情况,自动启用多项抗弱网技术,提升小流的抗弱网能力,确保多路流订阅时接收端的流畅性。 实时监测接收端大流的订阅人数,根据订阅人数动态调节大流配置: 无人订阅大流时,会自动降低大流的码率和帧率,节省上行带宽和消耗。 有人订阅大流时,大流会重置为用户最近一次调用 setVideoEncoderConfiguration 时的 VideoEncoderConfiguration 配置。如果用户此前没有进行设置,则使用如下值: 视频分辨率:桌面端为 1280 × 720;移动端为 960 × 540 视频帧率:15 fps 码率:桌面端为 1600 Kbps;移动端为 1000 Kbps 实时监测接收端小流的订阅人数,根据订阅人数动态开启和关闭小流: 无人订阅小流时,自动关闭小流,节省上行带宽和消耗。 有人订阅小流时,开启小流并重置为用户最近一次调用 setDualStreamMode 时的 SimulcastStreamConfig 配置。如果用户此前没有进行设置,则使用如下值: 视频分辨率:480 × 272 视频帧率:15 fps 码率:500 Kbps applicationScenario1v1 (2) 适用于视频 1v1 通话场景。针对该场景低延迟、高画质的体验要求,SDK 进行了策略调优,提升了画质、首帧出图、中低端机延迟及弱网流畅度等性能表现。 applicationScenarioLiveshow (3) 适用于秀场直播场景。针对该场景对首帧出图时间和画质清晰度的高要求,SDK 进行了策略调优,例如,默认开启音视频帧加速渲染来提升首帧出图体验,无需再额外调用 enableInstantMediaRendering ,同时会默认开启 B 帧来确保较高的图像质量、提高传输效率。此外,也增强了在弱网环境和低端设备上的画质和流畅度表现。
Returns 方法成功调用时,无返回值;方法调用失败时,会抛出 AgoraRtcException 异常,你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
Implementation
Future<void> setVideoScenario(VideoApplicationScenarioType scenarioType);