提交工单
咨询集成、功能及报价等问题
低照度增强,指在环境光较暗的情况下,摄像头采集到的画面亮度不满足看清通话方人脸、或无法进行人脸识别等业务需求时,对画面亮度进行增强的功能。
ZEGO 提供两种低照度增强的方式:
方式 1:通过开启自适应帧率,在设定的帧率范围内动态降低采集帧率,以延长每一帧的画面曝光时间,达到增强采集到的画面亮度的效果。 例如:开发者开启并设置自适应帧率范围为 [10,25]。环境光照充足的时候,采集帧率依然是 25 帧,环境光照度较低的时候,采集帧率会在 [10,25] 之间动态调整,以延长每一帧的曝光时间增强采集画面的亮度。
方式 2:通过算法对采集到的画面亮度进行增强:
两种处理方式可以独立使用,也可以同时使用,均兼容美颜功能。
增强前 | 增强后 |
---|---|
![]() |
![]() |
在使用低照度增强功能之前,请确保:
初始化和登录房间的具体流程,请参考实现视频通话文档中的 “3.1 创建引擎”及“3.2 登录房间”。
RTC SDK 支持不同的算法低照度增强模式:
枚举值 | 说明 |
---|---|
ZegoLowlightEnhancementMode.OFF | 关闭低照度增强功能,采集画面亮度不变。 |
ZegoLowlightEnhancementMode.ON | 开启低照度增强功能,采集画面亮度增强。 |
ZegoLowlightEnhancementMode.AUTO | 自动低照度增强功能,采集画面亮度增强值随环境亮度动态调整。 |
以开启自动低照度增强功能为例:
engine.setLowlightEnhancement(ZegoLowlightEnhancementMode.AUTO,ZegoPublishChannel.MAIN);
当环境光照度较低,且摄像头采集帧率过高时,每一帧画面的曝光时间不足,可能导致采集的视频画面偏暗,此时可以通过 enableCameraAdaptiveFPS 开启摄像头自适应帧率。SDK 会根据设置的帧率范围匹配摄像头支持的采集帧率范围,在此范围内,根据环境亮度动态调整摄像头采集帧率,提升设置的帧率过高时的画面亮度。
int minCamFPS = getIntent().getIntExtra("camMinFPS", 0);//设置最小帧率
int maxCamFPS = getIntent().getIntExtra("camMaxFPS", 0);//设置最大帧率
engine.enableCameraAdaptiveFPS(true, minCamFPS, maxCamFPS, ZegoPublishChannel.MAIN);
开启预览后,可以设置不同的低照度增强模式,并实时体验效果。
ZegoCanvas previewCanvas = new ZegoCanvas(preview);
engine.startPreview(previewCanvas);
当预览效果达到预期后,可以开始推流,推流画面效果将与预览效果一致。
engine.startPublishingStream("STREAM_ID");
联系我们
文档反馈