实现美颜

SDK 2.0.0。类名：FBEngine。没有单例。鉴权：授权与许可。枚举：参数枚举。

Flutter 只设置美颜参数。实时视频帧不进 Dart。第三方 RTC 在原生 GL 线程喂纹理 — 见第三方对接。

添加插件

dependencies:
  facebetter_flutter: ^2.0.0

import 'package:facebetter_flutter/facebetter_flutter.dart';

日志

必须在 FBEngine.create 之前调用：

FBEngine.setLogConfig(
  console: true,
  file: false,
  level: FBLogLevel.info,
  fileName: '',
);

创建

提供 appId + appKey，或 licenseToken（许可证 token、{token} JSON，或原生离线 .lic）。两者都有时优先 token。

final engine = await FBEngine.create(FBEngineConfig(
  appId: '...',
  appKey: '...',
  // licenseToken: '...',
  enableLandmarks: false,
  externalContext: true,
  resourcePath: null,
));

字段	默认	说明
`appId` / `appKey`	—	在线鉴权
`licenseToken`	—	token / `{token}` JSON / `.lic` 全文
`enableLandmarks`	`false`	引擎级开关，创建后不能改。Flutter 没有关键点回调，请保持 `false`
`externalContext`	`true`	接第三方实时前处理用 `true`；静图文件接口用 `false`
`resourcePath`	插件自动	Android AAR 内 `resource.fbd` / iOS framework 内文件

FBEngine.version 读取原生 SDK 版本字符串。

皮肤、美型、美妆

强度 setter 是同步的，可以直接写在 Slider.onChanged 里。皮肤 [0.0, 1.0]：

engine.setSmoothing(0.8);
engine.setSmoothingStyle(FBSmoothingStyle.natural);
engine.setWhitening(0.5);
engine.setWhiteningStyle(FBWhiteningStyle.coldWhite);
engine.setSharpening(0.3);
engine.setRosiness(0.2);
engine.setBeautySkinOnly(true);

美型 [-1.0, 1.0]：

engine.setReshape(FBReshape.faceThin, 0.3);
engine.setReshape(FBReshape.eyeSize, 0.2);

美体 [0.0, 1.0]。先登记 resource_body.fbd。见参数枚举与可选资源包：

await engine.addResourcePack(path: '/path/to/resource_body.fbd');
engine.setBodyReshape(FBBodyReshape.waistSlim, 0.4);
engine.setBodyReshape(FBBodyReshape.legStretch, 0.3);
engine.setBodyReshape(FBBodyReshape.torsoLong, 0.3);

美妆（强度 + 风格/色号）。完整枚举：参数枚举。

engine.setLipstick(0.4);
engine.setLipstickColor(FBLipstickColor.rouge);
engine.setBlush(0.3);
engine.setBlushStyle(FBBlushStyle.sunKissed);
engine.setBlushColor(FBBlushColor.coralPink);
engine.setContour(0.4);
engine.setContourStyle(FBContourStyle.natural);
engine.setEyeShadow(0.35);
engine.setEyeShadowStyle(FBEyeShadowStyle.soft);
engine.setEyeShadowColor(FBEyeShadowColor.plum);
engine.setEyeLiner(0.3);
engine.setEyebrow(0.3);
engine.setEyelash(0.3);
engine.setPupil(0.4);

滤镜、贴纸、虚拟背景

传路径或 Uint8List 字节，不能同时传。这些接口返回 Future（读文件 + 上传 GPU）。

await engine.setFilter(path: '/path/to/filter.fbd');
// await engine.setFilter(data: bytes);
engine.setFilterIntensity(0.8);
engine.clearFilter();

await engine.setSticker(path: '/path/to/sticker.fbd');
engine.clearSticker();

await engine.addResourcePack(path: '/path/to/resource_3d.fbd');
await engine.set3DSticker(path: '/path/to/oculos.fbd');
engine.clear3DSticker();

engine.setVirtualBackgroundBlur(0.6);
await engine.setVirtualBackground(path: '/path/to/bg.jpg');
engine.clearVirtualBackground();

3D 贴纸需要可选包 resource_3d.fbd（不在插件内）。见可选资源包。色度键（同步），与原生一致：

engine.setChromaKey(FBChromaKeyColor.green);
engine.setChromaKeySimilarity(0.4);
engine.setChromaKeySmoothness(0.2);
engine.setChromaKeyDesaturation(0.3);
engine.clearChromaKey();

色度键只提供遮罩；填充仍是虚化或背景图。

事件与统计

engine.events.listen((FBEngineEvent e) {
  switch (e.eventCode) {
    case FBEngineEventCode.licenseValidationSuccess:
    case FBEngineEventCode.engineInitializationComplete:
      break;
    case FBEngineEventCode.licenseValidationFailed:
    case FBEngineEventCode.engineInitializationFailed:
      debugPrint(e.message);
  }
});

final FBStats s = engine.stats;
// s.fps, s.avgProcessTimeMs, s.sessionTimeSeconds

静图

使用另一台引擎，且 externalContext: false。不要在实时前处理引擎上调用这些接口，也不要从 Dart 逐帧处理会议 / 推流视频。

final photoEngine = await FBEngine.create(const FBEngineConfig(
  appId: '...',
  appKey: '...',
  externalContext: false,
));

await photoEngine.processFile(input: srcPath, output: dstPath, quality: 90);

final FBBitmap bmp = await photoEngine.processImageBytes(jpegBytes);
final FBBitmap fromFile = await photoEngine.processImageFile(srcPath);
final ui.Image image = await photoEngine.processImageToUiImage(jpegBytes);

photoEngine.dispose();

FBBitmap.pixels 为 RGBA8888（stride == width * 4）。

错误

setter 与异步任务失败时抛 FBException，错误码为 0、-1 … -8。见 API 参考。

释放

先停对方自定义前处理，再：

engine.dispose();

产品介绍

Android

iOS

macOS

Windows

Linux

Web

Flutter

添加插件

日志

创建

皮肤、美型、美妆

滤镜、贴纸、虚拟背景

事件与统计

静图

错误

释放

相关文档

​添加插件

​日志

​创建

​皮肤、美型、美妆

​滤镜、贴纸、虚拟背景

​事件与统计

​静图

​错误

​释放

​相关文档

添加插件

日志

创建

皮肤、美型、美妆

滤镜、贴纸、虚拟背景

事件与统计

静图

错误

释放

相关文档