Skip to main content
SDK 2.0.0. Detalhes de autenticação: Autenticação e licença.

Valores de retorno

A maioria dos setters retorna int: BeautyEffectEngine::Create() retorna std::shared_ptr; a falha é nullptr. ProcessImage pode retornar nullptr em caso de falha.

Eventos do mecanismo

Registre on_engine_event após Create. Códigos: A string message tem detalhes extras nas falhas.

Falhas comuns

1. Create retorna nullptr

Causas típicas:
  • resource_path é um diretório, está ausente ou não é o arquivo resource.fbd
  • app_id + app_key inválidos / inativos, ou license_token ruim
  • facebetter.dll ausente ou incompatível com facebetter.lib
  • A autenticação online não alcança /facebetter/v2/auth
Ative os logs antes de Create:

2. facebetter.dll não encontrado

O Windows mostra um diálogo se a DLL não estiver no loader path.
Ou reconstrua para o CMake copiá-la para ao lado do executável.

3. ProcessImage retorna nullptr

Verifique o quadro de entrada, o ponteiro do mecanismo e os logs (-7 processamento / -8 OOM nos setters).

4. Os efeitos parecem inalterados

O 2.0 não usa SetBeautyTypeEnabled. Os efeitos ficam desligados na intensidade 0. Remodelagem / maquiagem também precisam de um rosto detectado.

5. OpenGL / display

GLFW ou gladLoadGLLoader podem falhar em drivers desatualizados, VMs ou Remote Desktop sem GPU.
Se o seu app já é dono do contexto GL, defina EngineConfig::external_context = true e chame ProcessImage nesse thread.

Logs de debug

O arquivo é gravado em relação ao diretório de trabalho atual, a menos que você passe um file_name absoluto.