Saltar al contenido principal
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 (-6 proceso / -7 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.
  • 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.

Logs de depuración

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