视频增强

  • HarmonyOS

更新时间不可用

setBeautyEffectOptions

设置美颜效果选项。

TypeScript
public abstract setBeautyEffectOptions(enabled:boolean,options:BeautyOptions,sourceType?:Constants.MediaSourceType):number;

开启本地美颜功能,并设置美颜效果选项。

调用时机

请在 enableVideo 或 startPreview 之后调用该方法。

调用限制

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

参数

参数名描述
options

美颜选项,详细定义见 BeautyOptions。

表格内容超出当前宽度,可横向滚动查看更多列。

是否开启美颜功能:

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

返回值

  • 0: 方法调用成功。

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

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

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