facebetter_flutter 1.4.4
facebetter_flutter: ^1.4.4 copied to clipboard
Real-time beauty effect engine for Flutter. Supports smoothing, whitening, face reshape, makeup, filters, stickers, chroma key, and virtual background on iOS and Android.
Facebetter Flutter SDK #
Real-time beauty effect engine for Flutter. Supports smoothing, whitening, face reshape, makeup, filters, stickers, chroma key, and virtual background on iOS and Android.
Requirements #
- Flutter >= 3.10.0
- Dart >= 3.0.0
- iOS 12.0+
- Android minSdkVersion 21+
Installation #
Add to your pubspec.yaml:
dependencies:
facebetter_flutter: ^1.4.4
Quick Start #
import 'package:facebetter_flutter/facebetter_flutter.dart';
// Initialize engine
await FBBeautyEffectEngine.init(
FBEngineConfig(appId: 'your_app_id', appKey: 'your_app_key'),
);
// Get singleton instance
final engine = FBBeautyEffectEngine.sharedInstance;
// Set beauty parameters
await engine.setBasicParam(FBBasicParam.smoothing, 0.8);
await engine.setBasicParam(FBBasicParam.whitening, 0.6);
await engine.setReshapeParam(FBReshapeParam.faceThin, 0.3);
await engine.setMakeupParam(FBMakeupParam.lipstick, 0.5);
// Process an image
final inputFrame = FBImageFrame(
width: 1080, height: 1920, stride: 4320,
data: rgbaBytes, format: FBImageFormat.rgba,
);
final outputFrame = await engine.processImage(inputFrame);
// Release
await engine.release();
API Reference #
Engine Lifecycle #
| Method | Description |
|---|---|
FBBeautyEffectEngine.init(config) |
Initialize the engine |
FBBeautyEffectEngine.sharedInstance |
Get the singleton instance |
engine.release() |
Release the engine |
Beauty Parameters #
| Method | Parameters |
|---|---|
setBasicParam(param, value) |
smoothing, sharpening, whitening, rosiness |
setReshapeParam(param, value) |
faceThin, faceVShape, eyeSize, noseSlim, ... |
setMakeupParam(param, value) |
lipstick, blush |
Filters & Stickers #
| Method | Description |
|---|---|
setFilter(filterId) |
Apply a filter |
setFilterIntensity(intensity) |
Set filter intensity [0.0, 1.0] |
setSticker(stickerId) |
Apply a sticker |
registerFilter(id, path) |
Register a filter from .fbd file |
registerSticker(id, path) |
Register a sticker from .fbd file |
Image Processing #
| Method | Description |
|---|---|
processImage(frame) |
Process an image frame |
processImageFile(input, output) |
Process an image file |
Native Engine Access #
For integration with streaming SDKs (e.g., TRTC), access the native engine instance:
iOS (Swift):
let engine = FacebetterPlugin.sharedInstance().engine
Android (Kotlin):
val engine = FacebetterPlugin.sharedInstance?.getEngine()
License #
This SDK requires a valid license. Contact PixPark for licensing.