Saltar al contenido principal
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

  • Crea el motor y procesa en el hilo cuyo contexto GL es el actual. Las texturas de entrada y salida deben pertenecer a ese contexto. Los fotogramas de CPU no necesitan un contexto GL del llamador. La config no tiene un flag de contexto.

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