跳转到主要内容
SDK 2.0.0。头文件位于 facebetter/*.h。美妆 / 美型枚举见 参数枚举。鉴权见 授权与许可。
Windows 通过 C++ 库接入(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。
resource_path 必须是 resource.fbd 文件,不能是目录。相对路径相对进程工作目录解析。生产环境建议用绝对路径。

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. 滤镜、贴纸与虚拟背景

传入 文件路径 或 编码后的字节。
LUT / 贴纸纹理在下一次 ProcessImage(当前 GL 线程)时创建。3D 贴纸见 可选资源包。

5. 回调与统计


6. 处理图像

在 ImageFrame::type 上设置 FrameType::Video(实时,默认)或 FrameType::Image(单张照片)。
从文件(照片模式):
引擎会尽量保持输入 / 输出格式一致(RGBA 进 RGBA 出,I420 进 I420 出)。需要其他布局时用 Convert(Format::BGRA)。

上传到 OpenGL(预览)

将 facebetter.dll 放在可执行文件同目录(Demo 的 CMake 构建后会自动复制)。

7. 最小示例

使用完毕后释放 shared_ptr(engine.reset())。BeautyEffectEngine 不是单例。 接入 TRTC / 声网 / LiveKit:见 第三方对接。

相关文档

第三方对接

TRTC / 声网 / LiveKit

API 参考

全部 C++ 方法与类型

错误处理

返回码与 DLL 问题

最佳实践

性能与线程