Skip to main content
SDK 2.0.0. Misma API C++ que Windows (namespace facebetter). Enumeraciones: Enumeraciones de parámetros. Autenticación: Autenticación y licencia.
En Linux, Facebetter es libfacebetter.so más facebetter/*.h. Esta guía sigue el demo de escritorio C++ (demo/cpp). Para compilar el propio SDK, usa ./scripts/build_linux.sh o CMake en build/linux.

Incluir headers

Enlace CMake

En runtime, configura LD_LIBRARY_PATH, copia libfacebetter.so junto al binario o instálalo con ldconfig.

Flujo de integración

No hay un paso de activar tipos. Intensidad 0 desactiva un efecto.

1. Configurar logging (opcional)

Llama antes de Create.

2. Crear el motor

En escritorio debes configurar resource_path al archivo resource.fbd. Prioridad de autenticación: un license_token no vacío (token / JSON {token} / .lic) gana; si no, app_id + app_key v2 en línea.
resource_path debe ser el archivo resource.fbd, no una carpeta. En producción prefiera una ruta absoluta.

3. Configurar parámetros de belleza

Piel / maquillaje [0.0, 1.0]. Remodelado [-1.0, 1.0]. Enumeraciones completas: Enumeraciones de parámetros.
El mismo patrón para sombra de ojos, delineador, cejas, pestañas y pupila.

4. Filtros, stickers y fondo virtual

Pasa una ruta o bytes.

5. Callbacks y estadísticas


6. Procesar fotogramas

Configura ImageFrame::type.
Foto:
El formato de salida sigue el de entrada cuando es posible. Convierte con output->Convert(Format::BGRA).

Vista previa OpenGL

Si tu app ya tiene un contexto GL actual, configura cfg.external_context = true y llama a ProcessImage en ese hilo.

7. Bucle mínimo

Libera con engine.reset(). El motor no es un singleton. Para TRTC / Agora / LiveKit: Integración con terceros.

Relacionado

Integración con terceros

TRTC / Agora / LiveKit

Referencia de la API

Métodos C++ y notas de Linux

Manejo de errores

Códigos de retorno y problemas de .so / DISPLAY

Prácticas recomendadas

Rendimiento y rpath