int,请与 ErrorCode 比较。构造引擎和 processImage 还可能抛异常或返回 null。
ErrorCode
-1 表示参数无效。-2 表示引擎未初始化。构造引擎
new BeautyEffectEngine(context, config) 在以下情况抛出 IllegalArgumentException:
context或config为nullconfig.isValid()为false(没有licenseToken,且缺少appId/appKey)
null。
鉴权排查见 授权认证。务必在构造 之前 打开日志,见 实现美颜。
processImage
- 输入为
null或type为null→IllegalArgumentException - 引擎已
release()→ 返回null(不抛异常) - 在
finally中同时release()输入和输出
convert / toBitmap,额外产生的帧也要释放。
滤镜、贴纸、虚拟背景
空路径或空byte[] 返回 ErrorCode.INVALID_ARGUMENT。文件不存在通常返回 ErrorCode.IO。
processImage。setter 成功并不代表纹理已上传;请结合后续 processImage 结果和 SDK 日志判断。
日志配置
setLogConfig 在 config 或 level 为 null 时抛异常。开启文件日志前请先创建父目录。
内存不足
ErrorCode.OUT_OF_MEMORY 或 OutOfMemoryError 通常是帧未释放、分辨率过高,或堆 / Direct Buffer 堆积。
- 相机 / 打包像素使用
ByteBuffer.allocateDirect - 释放每一个
ImageFrame(含convert结果) - 实时预览使用
FrameType.VIDEO - 不要每帧都
new一个引擎

