Quick Start

This page matches SDK 2.0.0. The engine class is FBEngine (not a singleton). Auth: Auth & License. Enums: Parameter enums.

Requirements

Flutter >= 3.24 / Dart >= 3.5
iOS 12.0+
Android minSdk 24
Native Facebetter SDK 2.0 (pulled in by the plugin)

Install

dependencies:
  facebetter_flutter: ^2.0.0

flutter pub get
cd ios && pod install && cd ..

Get the example

git clone https://github.com/pixpark/facebetter-sdk.git
cd facebetter-sdk/demo/flutter
flutter create --org net.pixpark --project-name fbexample .

The demo folder keeps app code only; flutter create generates ios/ and android/.

Bind identifiers and keys

In the Dashboard, bind:

iOS: Bundle ID (for example net.pixpark.fbexample)
Android: Application ID (for example net.pixpark.fbexample)

Copy appId / appKey, or pass a licenseToken (server-issued short-lived token, or an offline .lic obtained via sales). See Subscription and Auth & License.

Create the engine

Edit lib/main.dart. Logging must run before create:

import 'package:facebetter_flutter/facebetter_flutter.dart';

FBEngine.setLogConfig(console: true, level: FBLogLevel.info);

final engine = await FBEngine.create(FBEngineConfig(
  appId: 'your_app_id',
  appKey: 'your_app_key',
  // or licenseToken: '...',
  enableLandmarks: false,
  externalContext: true, // default; required for third-party live preprocess
  resourcePath: null,    // plugin locates resource.fbd
));

engine.setSmoothing(0.8);
engine.dispose();

externalContext: true (default) reuses the caller GL context — required for third-party live preprocess. Still-image APIs need a second engine with externalContext: false. Do not mix the two on one instance.

Run

flutter devices
flutter run -d <device-id>

Implement beauty — dedicated setters, filters, photos
Third-party Integration — native FacebetterPlugin.processTexture
API reference

Introduction

Android

iOS

macOS

Windows

Linux

Web

Flutter

Requirements

Install

Get the example

Bind identifiers and keys

Create the engine

Run

Next

​Requirements

​Install

​Get the example

​Bind identifiers and keys

​Create the engine

​Run

​Next

Requirements

Install

Get the example

Bind identifiers and keys

Create the engine

Run

Next