Skip to main content
美颜 setter 返回 int,请与 ErrorCode 比较。构造引擎和 processImage 还可能抛异常或返回 null

ErrorCode

-1 表示参数无效。-2 表示引擎未初始化。

构造引擎

new BeautyEffectEngine(context, config) 在以下情况抛出 IllegalArgumentException
  • contextconfignull
  • config.isValid()false(没有 licenseToken,且缺少 appId / appKey
构造函数 不会 返回 null
授权与资源初始化仍可能异步失败。请订阅引擎事件:
鉴权排查见 授权认证。务必在构造 之前 打开日志,见 实现美颜

processImage

  • 输入为 nulltypenullIllegalArgumentException
  • 引擎已 release() → 返回 null(不抛异常)
  • finally 中同时 release() 输入和输出
若对输出做了 convert / toBitmap,额外产生的帧也要释放。

滤镜、贴纸、虚拟背景

空路径或空 byte[] 返回 ErrorCode.INVALID_ARGUMENT。文件不存在通常返回 ErrorCode.IO
LUT / 贴纸的 GPU 上传发生在 下一次 processImage。setter 成功并不代表纹理已上传;请结合后续 processImage 结果和 SDK 日志判断。

日志配置

setLogConfigconfiglevelnull 时抛异常。开启文件日志前请先创建父目录。

内存不足

ErrorCode.OUT_OF_MEMORYOutOfMemoryError 通常是帧未释放、分辨率过高,或堆 / Direct Buffer 堆积。
  • 相机 / 打包像素使用 ByteBuffer.allocateDirect
  • 释放每一个 ImageFrame(含 convert 结果)
  • 实时预览使用 FrameType.VIDEO
  • 不要每帧都 new 一个引擎

用统计排查卡顿