setFaceShapeBeautyOptions abstract method

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

设置美型效果选项并指定媒体源。

调用该方法可对人脸各部位进行修饰，使用预设的参数一次性实现瘦脸、大眼、瘦鼻等微整形效果，支持微调整体的修饰力度。 美型属于增值服务，计费方式详见计费策略。 在 Android 平台上，该方法仅适用于 Android 4.4 及以上版本。 该方法依赖于视频增强动态库 libagora_clear_vision_extension.dll ，如果删除该动态库会导致无法正常开启该功能。 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。

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

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

Implementation

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