enableCameraAdaptiveFPS method
- bool enable,
- int minFPS,
- int maxFPS,
- ZegoPublishChannel channel
开启摄像头自适应帧率
支持版本:2.20.0 及以上。
详情描述:开启后,SDK 根据设置的帧率范围匹配摄像头支持的采集帧率范围,在此范围内根据环境亮度动态调整摄像头采集帧率,提升设置的帧率过高时的画面亮度。
业务场景:推流端用户设置的帧率偏高,所处环境光照较低,无法正常显示或识别主体。比如对曝光要求较高的直播场景。
调用时机:创建引擎 createEngine 后,摄像头启动前。
注意事项:当调用 setVideoConfig
设置帧率小于期望帧率最小值时,将使用 setVideoConfig
设置的帧率值。由于不同的手机厂商的硬件和算法策略不同,该接口在不同的机型或同一机型的前后摄像头上,效果存在一定差异。
相关接口:通过 setVideoConfig
可以设置摄像头采集帧率以及编码器编码帧率。
enable
是否开启摄像头自适应帧率。true 表示开启,false 表示关闭。默认关闭。minFPS
期望的最小帧率,最小值为 3,推荐 15。单位:fps。maxFPS
期望的最大帧率,推荐 25。单位:fps。channel
推流通道。
Implementation
Future<void> enableCameraAdaptiveFPS(
bool enable, int minFPS, int maxFPS, ZegoPublishChannel channel) async {
return await ZegoExpressImpl.instance
.enableCameraAdaptiveFPS(enable, minFPS, maxFPS, channel);
}