setLowlightEnhanceOptions abstract method
Future<void>
setLowlightEnhanceOptions({
- required bool enabled,
- required LowlightEnhanceOptions options,
- MediaSourceType type = MediaSourceType.primaryCameraSource,
设置暗光增强功能。
你可以调用该方法开启暗光增强功能并设置暗光增强的效果。 该方法依赖于视频增强动态库 libagora_clear_vision_extension.dll ,如果删除该动态库会导致无法正常开启该功能。 暗光增强对设备性能有一定要求。开启暗光增强后,如果设备出现严重发烫等问题,建议你将暗光增强等级修改为消耗性能较少的等级或关闭暗光增强功能。 如果要实现优先画质 (lowLightEnhanceLevelHighQuality) 的暗光增强,需要先调用 setVideoDenoiserOptions 实现视频降噪,具体对应关系如下: 暗光增强为自动模式 (LowLightEnhanceAuto) 时,视频降噪需设置为优先画质 (videoDenoiserLevelHighQuality)、自动模式 (videoDenoiserAuto)。 暗光增强为手动模式 (LowLightEnhanceManual) 时,视频降噪需设置为优先画质 (videoDenoiserLevelHighQuality)、手动模式 (videoDenoiserManual)。
enabled是否开启暗光增强功能: true : 开启暗光增强功能。 false :(默认)关闭暗光增强功能。options暗光增强选项,用于设置暗光增强的效果。详见 LowlightEnhanceOptions 。type效果应用的媒体源类型。详见 MediaSourceType 。 在该方法中,该参数仅支持以下两种设置: 使用摄像头采集本地视频时,请保持默认值 primaryCameraSource 。 如果要使用自定义采集的视频,将该参数设置为 customVideoSource 。
Returns 方法成功调用时,无返回值;方法调用失败时,会抛出 AgoraRtcException 异常,你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
Implementation
Future<void> setLowlightEnhanceOptions(
{required bool enabled,
required LowlightEnhanceOptions options,
MediaSourceType type = MediaSourceType.primaryCameraSource});