Tratamento de erros

SDK 2.0.0. Detalhes de autenticação: Autenticação e licença.

Valores de retorno

A maioria dos setters retorna int:

Código	Significado
`0`	Sucesso
`-1`	Argumento inválido
`-2`	Não inicializado
`-3`	Licença
`-4`	Não suportado
`-5`	I/O
`-6`	Falha no processamento
`-7`	Sem memória

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

int ret = engine->SetSmoothing(0.5f);
if (ret != 0) {
    std::cerr << "SetSmoothing failed: " << ret << std::endl;
}

Eventos do mecanismo

Registre on_engine_event após Create. Códigos:

Código	Significado
`0`	Licença OK
`1`	Falha de licença
`100`	Init concluído
`101`	Falha de init

A string message tem detalhes extras nas falhas.

EngineCallbacks cbs;
cbs.on_engine_event = [](int code, const std::string& message) {
    if (code == 1 || code == 101) {
        std::cerr << "engine event " << code << ": " << message << std::endl;
    }
};
engine->SetCallbacks(cbs);

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:

LogConfig log_cfg;
log_cfg.console_enabled = true;
log_cfg.level = LogLevel::Debug;
BeautyEffectEngine::SetLogConfig(log_cfg);

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path =
    (std::filesystem::current_path() / "resource" / "resource.fbd").string();

auto engine = BeautyEffectEngine::Create(cfg);
if (!engine) {
    std::cerr << "Create failed — check logs, resource.fbd, and license." << std::endl;
    return -1;
}

2. `facebetter.dll` não encontrado

O Windows mostra um diálogo se a DLL não estiver no loader path.

dir build\facebetter.dll
copy sdk\lib\facebetter.dll build\

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 (-6 processamento / -7 OOM nos setters).

auto input = ImageFrame::CreateWithFile("input.jpg");
if (!input || !input->Data()) {
    std::cerr << "Failed to load input." << std::endl;
    return;
}
input->type = FrameType::Image;
auto output = engine->ProcessImage(input);
if (!output || !output->Data()) {
    std::cerr << "ProcessImage failed." << std::endl;
}

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.

engine->SetSmoothing(0.5f);
engine->SetReshape(Reshape::FaceThin, 0.3f);
engine->SetLipstick(0.5f);
input->type = FrameType::Video;

5. OpenGL / display

GLFW ou gladLoadGLLoader podem falhar em drivers desatualizados, VMs ou Remote Desktop sem GPU.

if (!glfwInit()) {
    std::cerr << "GLFW init failed." << std::endl;
    return 1;
}
glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 0);

Crie o mecanismo e processe no thread cujo contexto GL é o atual. As texturas de entrada e saída devem pertencer a esse contexto. Quadros de CPU não precisam de um contexto GL do chamador. A config não tem um flag de contexto.

Logs de debug

LogConfig log_cfg;
log_cfg.console_enabled = true;
log_cfg.file_enabled = true;
log_cfg.level = LogLevel::Debug;
log_cfg.file_name = "facebetter.log";
BeautyEffectEngine::SetLogConfig(log_cfg);

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

Introdução

Android

iOS

macOS

Windows

Linux

Web

Valores de retorno

Eventos do mecanismo

Falhas comuns

1. `Create` retorna `nullptr`

2. `facebetter.dll` não encontrado

3. `ProcessImage` retorna `nullptr`

4. Os efeitos parecem inalterados

5. OpenGL / display

Logs de debug

​Valores de retorno

​Eventos do mecanismo

​Falhas comuns

​1. Create retorna nullptr

​2. facebetter.dll não encontrado

​3. ProcessImage retorna nullptr

​4. Os efeitos parecem inalterados

​5. OpenGL / display

​Logs de debug

Valores de retorno

Eventos do mecanismo

Falhas comuns

1. `Create` retorna `nullptr`

2. `facebetter.dll` não encontrado

3. `ProcessImage` retorna `nullptr`

4. Os efeitos parecem inalterados

5. OpenGL / display

Logs de debug