SetFaceShapeBeautyOptions

  • C#

更新时间不可用

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

C#
public abstract int SetFaceShapeBeautyOptions(bool enabled, FaceShapeBeautyOptions options, MEDIA_SOURCE_TYPE type = MEDIA_SOURCE_TYPE.PRIMARY_CAMERA_SOURCE);

调用该方法可对人脸各部位进行修饰,使用预设的参数一次性实现瘦脸、大眼、瘦鼻等微整形效果,支持微调整体的修饰力度。

危险: 美型属于增值服务,计费方式详见计费策略。

调用时机

请在 EnableVideo 之后调用该方法。

调用限制

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

参数

参数名描述
enabled

是否开启美型效果:

  • true: 开启美型功能。
  • false:(默认)关闭美型功能。
options

美型风格选项,详见 FaceShapeBeautyOptions。

type

效果应用的媒体源类型。详见 MEDIA_SOURCE_TYPE。

注意: 在该方法中,该参数仅支持以下两种设置:

  • 使用摄像头采集本地视频时,请保持默认值 PRIMARY_CAMERA_SOURCE。
  • 如果要使用自定义采集的视频,将该参数设置为 CUSTOM_VIDEO_SOURCE。
表格内容超出当前宽度,可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。

  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

    • -4:当前设备不支持该功能,可能的原因有:

      • 当前设备能力不满足美颜的使用要求,建议更换性能更高的设备。

这个页面有帮助吗?