setBeautyEffectOptions abstract method

Future<void> setBeautyEffectOptions({
  1. required bool enabled,
  2. required BeautyOptions options,
  3. MediaSourceType type = MediaSourceType.primaryCameraSource,
})

设置美颜效果选项。

开启本地美颜功能,并设置美颜效果选项。 该方法依赖于视频增强动态库 libagora_clear_vision_extension.dll ,如果删除该动态库会导致无法正常开启该功能。 该功能对设备性能要求较高,调用该方法时 SDK 会自动对当前设备能力进行检查。

  • enabled 是否开启美颜功能: true : 开启美颜功能。 false :(默认)关闭美颜功能。
  • options 美颜选项,详细定义见 BeautyOptions 。
  • type 效果应用的媒体源类型。详见 MediaSourceType 。 在该方法中,该参数仅支持以下两种设置: 使用摄像头采集本地视频时,请保持默认值 primaryCameraSource 。 如果要使用自定义采集的视频,将该参数设置为 customVideoSource 。

Returns 方法成功调用时,无返回值;方法调用失败时,会抛出 AgoraRtcException 异常,你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

Future<void> setBeautyEffectOptions(
    {required bool enabled,
    required BeautyOptions options,
    MediaSourceType type = MediaSourceType.primaryCameraSource});