Skip to main content
Esta página corresponde al SDK 2.0.0. Linux y Windows comparten la misma API C++ en el namespace facebetter (facebetter/*.h).
Esta guía compila el demo de escritorio C++ de Facebetter en Linux. El demo usa GLFW + Dear ImGui + OpenGL 3: vista previa en directo a la izquierda, controles de belleza a la derecha.

Requisitos

Ubuntu / Debian

Fedora / RHEL

Paso 1: Clonar el repositorio

Paso 2: Colocar los archivos del SDK

Coloca el SDK de Linux en demo/cpp/sdk/:
En escritorio, EngineConfig::resource_path debe apuntar al archivo resource.fbd, no a un directorio. Ejemplo: demo/cpp/sdk/resource/resource.fbd.
Los paquetes del SDK están en la página de Descargas y en la Consola.
Para compilar el SDK desde el código fuente en lugar de usar un paquete precompilado:
La salida se instala en build/linux/release. Puedes copiar include/, lib/libfacebetter.so y resource.fbd a demo/cpp/sdk/ como arriba.

Paso 3: Configurar la licencia

Establece app_id / app_key (autenticación v2 en línea) o license_token antes de ejecutar. Si license_token no está vacío, tiene prioridad (cadena del token de licencia, JSON {token} o contenido de .lic sin conexión). Detalles: Autenticación y licencia.

Paso 4: Compilar el demo

CMake normalmente copia resource/resource.fbd (y demo.png si existe) a build/resource/.

Paso 5: Preparar una imagen de vista previa (opcional)

Paso 6: Ejecutar

La ventana muestra una vista previa en directo y un panel de control (piel, 26 parámetros de remodelado facial, 7 de remodelado corporal, maquillaje, filtro, sticker, fondo virtual). Haz clic en Reset All para poner las intensidades a cero.

Solución de problemas

Q: libfacebetter.so: cannot open shared object file
A: Usa LD_LIBRARY_PATH=../sdk/lib ./facebetter_demo, copia el .so junto al binario o añade la ruta con ldconfig.
Q: La creación del motor devuelve nullptr / licencia fallida
A: Apunta resource_path a resource.fbd y configura license_token o un app_id + app_key válidos. Consulta Autenticación y licencia.
Q: CMake no encuentra OpenGL
A: Instala libgl1-mesa-dev (Ubuntu) o mesa-libGL-devel (Fedora) y vuelve a ejecutar CMake.
Q: GLFW: X11: Display variable not set
A: Ejecuta dentro de una sesión gráfica, o configura DISPLAY (X11) / WAYLAND_DISPLAY (Wayland).

Siguientes pasos

Implementar belleza

Crea el motor, configura efectos y procesa fotogramas.

Referencia de la API

API C++ completa (igual que Windows) más notas de Linux.