facebetter.lib + facebetter.dll)。流程参考 C++ 桌面 Demo(demo/cpp)。
引入头文件
集成流程
0 即开启对应效果。
1. 配置日志(可选)
必须在Create 之前调用,才能看到初始化日志。
Trace / Debug / Info / Warn / Error / Critical。
2. 创建引擎
桌面端 必须 将resource_path 设为 resource.fbd 文件路径。
鉴权优先级: license_token 非空时,本地校验该 token(许可证 token、{token} JSON 或离线 .lic),不再用 app_id + app_key 联网。否则使用 app_id + app_key 请求 /facebetter/v2/auth。
3. 设置美颜参数
皮肤 / 美妆 / 美体强度为[0.0, 1.0],0 表示关闭。美型为 [-1.0, 1.0]。完整枚举见 参数枚举。
皮肤
美型
美体
范围[0.0, 1.0]。0 关闭。把 resource_body.fbd 放在 resource.fbd 同目录,或调用 AddResourcePack。见 参数枚举 与 可选资源包。
美妆
强度、形状、色号分开设置。口红只有色号;美瞳只有色号;修容只有形状。SetEyeLiner / SetEyebrow / SetEyelash / SetPupil 及对应 Style / Color)。
4. 滤镜、贴纸与虚拟背景
传入 文件路径 或 编码后的字节。ProcessImage(当前 GL 线程)时创建。3D 贴纸见 可选资源包。
5. 回调与统计
6. 处理图像
在ImageFrame::type 上设置 FrameType::Video(实时,默认)或 FrameType::Image(单张照片)。
上传到 OpenGL(预览)
facebetter.dll 放在可执行文件同目录(Demo 的 CMake 构建后会自动复制)。
7. 最小示例
shared_ptr(engine.reset())。BeautyEffectEngine 不是单例。
接入 TRTC / 声网 / LiveKit:见 第三方对接。
相关文档
第三方对接
TRTC / 声网 / LiveKit
API 参考
全部 C++ 方法与类型
错误处理
返回码与 DLL 问题
最佳实践
性能与线程

