SDK 2.0.0. Same C++ API as Windows (
facebetter namespace). Enums: Parameter enums. Auth: Auth & License.libfacebetter.so plus facebetter/*.h. This guide follows the C++ desktop demo (demo/cpp). To compile the SDK itself, use ./scripts/build_linux.sh or CMake in build/linux.
Include headers
CMake linkage
LD_LIBRARY_PATH, copy libfacebetter.so next to the binary, or install with ldconfig.
Integration flow
0 turns an effect off.
1. Configure logging (optional)
Call beforeCreate.
2. Create the engine
Desktop must setresource_path to the resource.fbd file.
Auth priority: non-empty license_token (token / {token} JSON / .lic) wins; otherwise app_id + app_key online v2.
3. Set beauty parameters
Skin / makeup / body reshape[0.0, 1.0]. Face reshape [-1.0, 1.0]. Body reshape needs resource_body.fbd. Full enums: Parameter enums. Packs: Optional resource packs.
4. Filters, stickers, and virtual background
Pass a path or bytes.5. Callbacks and stats
6. Process frames
SetImageFrame::type.
OpenGL preview
cfg.external_context = true and call ProcessImage on that thread.
7. Minimal loop
engine.reset(). The engine is not a singleton.
For TRTC / Agora / LiveKit: Third-party Integration.
Related
Third-party Integration
TRTC / Agora / LiveKit
API reference
C++ methods and Linux notes
Error handling
Return codes and .so / DISPLAY issues
Best practices
Performance and rpath

