Skip to main content
SDK 2.0.0. Detalles de autenticación: Autenticación y licencia.

Valores de retorno

La mayoría de los setters devuelven int: BeautyEffectEngine::Create() devuelve std::shared_ptr; el fallo es nullptr. ProcessImage puede devolver nullptr si falla.

Eventos del motor

Registra on_engine_event después de Create. Códigos: La cadena message aporta detalle extra en los fallos.

Fallos habituales

1. Create devuelve nullptr

Causas habituales:
  • resource_path es un directorio, falta o no es el archivo resource.fbd
  • app_id + app_key no válido / inactivo, o license_token incorrecto
  • Falta facebetter.dll o no coincide con facebetter.lib
  • La autenticación en línea no puede alcanzar /facebetter/v2/auth
Activa logs antes de Create:

2. No se encuentra facebetter.dll

Windows muestra un diálogo si la DLL no está en la ruta del loader.
O recompila para que CMake la copie junto al ejecutable.

3. ProcessImage devuelve nullptr

Revisa el fotograma de entrada, el puntero del motor y los logs (-7 proceso / -8 OOM en setters).

4. Los efectos se ven igual

2.0 no usa SetBeautyTypeEnabled. Los efectos están desactivados con intensidad 0. El remodelado / maquillaje también necesitan un rostro detectado.

5. OpenGL / visualización

GLFW o gladLoadGLLoader pueden fallar con drivers antiguos, VMs o Remote Desktop sin GPU.
Si tu app ya posee el contexto GL, configura EngineConfig::external_context = true y llama a ProcessImage en ese hilo.

Logs de depuración

El archivo se escribe relativo al directorio de trabajo actual, salvo que pases un file_name absoluto.