Implementar beleza

SDK 2.0.0. Os headers ficam em facebetter/*.h. Enums de maquiagem / remodelagem / estilo: Enums de parâmetros. Autenticação: Autenticação e licença.

No Windows, o Facebetter é uma biblioteca C++ (facebetter.lib + facebetter.dll). Este guia segue o demo desktop C++ (demo/cpp).

Incluir headers

#include <facebetter/beauty_effect_engine.h>
#include <facebetter/beauty_params.h>
#include <facebetter/image_frame.h>
#include <facebetter/type_defines.h>

using namespace facebetter;
using namespace facebetter::beauty_params;

Fluxo de integração

SetLogConfig → Create(EngineConfig) → set effects → ProcessImage → render

Não há um passo de habilitar tipo. Definir uma intensidade acima de 0 liga esse efeito.

1. Configurar logging (opcional)

Chame isto antes de Create para capturar os logs de inicialização.

LogConfig log_cfg;
log_cfg.console_enabled = true;
log_cfg.file_enabled = false;
log_cfg.level = LogLevel::Info;
BeautyEffectEngine::SetLogConfig(log_cfg);

Níveis (baixo → alto): Trace / Debug / Info / Warn / Error / Critical.

2. Criar o mecanismo

O desktop precisa definir resource_path como o arquivo resource.fbd. Prioridade de autenticação: se license_token não estiver vazio, o SDK valida esse token (string do token de licença, JSON {token} ou .lic offline) e não chama a rede com app_id / app_key. Caso contrário, usa app_id + app_key contra /facebetter/v2/auth.

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path = "resource/resource.fbd";  // path to the .fbd file
cfg.external_context = false;                 // SDK-managed OpenGL context

// Optional: token takes priority when non-empty
// cfg.license_token = "/* license token, {token} JSON, or .lic contents */";

std::shared_ptr<BeautyEffectEngine> engine = BeautyEffectEngine::Create(cfg);
if (!engine) {
    // Check resource_path, license_token / app_id+app_key, and logs
    return -1;
}

resource_path precisa ser o arquivo resource.fbd, não uma pasta. Caminhos relativos são resolvidos a partir do diretório de trabalho do processo. Prefira um caminho absoluto em produção.

3. Definir parâmetros de beleza

As intensidades de pele / maquiagem / remodelagem corporal são [0.0, 1.0]. 0 desliga. A remodelagem facial é [-1.0, 1.0]. Listas completas de enums: Enums de parâmetros.

Pele

engine->SetSmoothing(0.5f);
engine->SetSmoothingStyle(SmoothingStyle::Natural);
engine->SetWhitening(0.3f);
engine->SetWhiteningStyle(WhiteningStyle::ColdWhite);
engine->SetSharpening(0.2f);
engine->SetRosiness(0.2f);
engine->SetBeautySkinOnly(true);  // beauty only on detected skin

Remodelagem facial

engine->SetReshape(Reshape::FaceThin, 0.4f);
engine->SetReshape(Reshape::EyeSize, 0.3f);
engine->SetReshape(Reshape::Chin, -0.2f);  // negative = opposite direction

Remodelagem corporal

Faixa [0.0, 1.0]. 0 desliga. Coloque resource_body.fbd ao lado de resource.fbd ou chame AddResourcePack. Veja Enums de parâmetros e Pacotes de recursos opcionais.

engine->AddResourcePack("resource/resource_body.fbd");  // or place it next to resource.fbd
engine->SetBodyReshape(BodyReshape::WaistSlim, 0.4f);
engine->SetBodyReshape(BodyReshape::LegStretch, 0.3f);
engine->SetBodyReshape(BodyReshape::TorsoLong, 0.3f);

Maquiagem

Intensidade, formato e cor são setters separados. Batom é só cor; pupila é só cor; contorno é só estilo.

engine->SetLipstick(0.6f);
engine->SetLipstickColor(LipstickColor::Rouge);

engine->SetBlush(0.4f);
engine->SetBlushStyle(BlushStyle::SunKissed);
engine->SetBlushColor(BlushColor::CoralPink);

engine->SetContour(0.5f);
engine->SetContourStyle(ContourStyle::Natural);

engine->SetEyeShadow(0.4f);
engine->SetEyeShadowStyle(EyeShadowStyle::Soft);
engine->SetEyeShadowColor(EyeShadowColor::Plum);

O mesmo padrão para delineador, sobrancelha, cílios e pupila (SetEyeLiner / SetEyebrow / SetEyelash / SetPupil mais Style / Color quando aplicável).

4. Filtros, adesivos e fundo virtual

Passe um caminho de arquivo ou bytes codificados.

engine->SetFilter("assets/filters/natural.fbd");
engine->SetFilterIntensity(0.8f);
engine->ClearFilter();

engine->SetSticker("assets/stickers/face/black_glass.fbd");
engine->ClearSticker();

engine->AddResourcePack("resource/resource_3d.fbd");  // or place it next to resource.fbd
engine->Set3DSticker("assets/stickers/3d/oculos.fbd");
engine->Clear3DSticker();

engine->SetVirtualBackgroundBlur(0.6f);           // [0, 1]; 0 clears fill
engine->SetVirtualBackground("assets/background.jpg");
engine->ClearVirtualBackground();

engine->SetChromaKey(ChromaKeyColor::Green);
engine->SetChromaKeySimilarity(0.4f);
engine->SetChromaKeySmoothness(0.1f);
engine->SetChromaKeyDesaturation(0.2f);
engine->ClearChromaKey();  // back to portrait segmentation

As texturas LUT / adesivo são criadas na próxima chamada de ProcessImage (o thread GL ativo). Para adesivos 3D, veja Pacotes de recursos opcionais.

5. Callbacks e estatísticas

EngineCallbacks cbs;
cbs.on_engine_event = [](int code, const std::string& message) {
    // 0 license OK, 1 license failed, 100 init complete, 101 init failed
    printf("[event] %d %s\n", code, message.c_str());
};
cbs.on_face_landmarks = [](const std::vector<FaceDetectionResult>& faces) {
    printf("faces=%zu\n", faces.size());
};
engine->SetCallbacks(cbs);

EngineStats stats = engine->GetStats();
printf("fps=%.1f avg=%.2fms session=%.1fs\n",
       stats.fps, stats.avg_process_time_ms, stats.session_time_s);

6. Processar quadros

Defina ImageFrame::type como FrameType::Video (tempo real, padrão) ou FrameType::Image (foto única).

auto input = ImageFrame::CreateWithRGBA(rgba_data, width, height, stride);
input->type = FrameType::Video;

auto output = engine->ProcessImage(input);
if (output && output->Data()) {
    const uint8_t* p = output->Data();
    int w = output->Width();
    int h = output->Height();
}

Arquivo (modo foto):

auto input = ImageFrame::CreateWithFile("input.jpg");
input->type = FrameType::Image;
auto output = engine->ProcessImage(input);
output->ToFile("output.jpg", 95);

O mecanismo mantém o formato de saída alinhado com a entrada quando possível (RGBA in → RGBA out, I420 in → I420 out). Use Convert(Format::BGRA) se precisar de outro layout.

Enviar para OpenGL (prévia)

GLuint tex = 0;
glGenTextures(1, &tex);
glBindTexture(GL_TEXTURE_2D, tex);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);

glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA,
             output->Width(), output->Height(),
             0, GL_RGBA, GL_UNSIGNED_BYTE, output->Data());

Mantenha facebetter.dll ao lado do executável (o CMake do demo a copia após o build).

7. Loop mínimo

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

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path = "resource/resource.fbd";
auto engine = BeautyEffectEngine::Create(cfg);
if (!engine) return -1;

engine->SetSmoothing(0.5f);
engine->SetReshape(Reshape::FaceThin, 0.3f);
engine->SetLipstick(0.5f);
engine->SetLipstickColor(LipstickColor::Rouge);

auto input = ImageFrame::CreateWithRGBA(rgba, width, height, stride);
input->type = FrameType::Video;
auto output = engine->ProcessImage(input);

Quando terminar, solte o shared_ptr (engine.reset()). BeautyEffectEngine não é um singleton. Para TRTC / Agora / LiveKit: Integração com terceiros.

Relacionado

Integração com terceiros

TRTC / Agora / LiveKit

Referência da API

Todos os métodos e tipos C++

Tratamento de erros

Códigos de retorno e problemas de DLL no Windows

Práticas recomendadas

Desempenho e threading

Introdução

Android

iOS

macOS

Windows

Linux

Web

Flutter

Incluir headers

Fluxo de integração

1. Configurar logging (opcional)

2. Criar o mecanismo

3. Definir parâmetros de beleza

Pele

Remodelagem facial

Remodelagem corporal

Maquiagem

4. Filtros, adesivos e fundo virtual

5. Callbacks e estatísticas

6. Processar quadros

Enviar para OpenGL (prévia)

7. Loop mínimo

Relacionado

Integração com terceiros

Referência da API

Tratamento de erros

Práticas recomendadas

​Incluir headers

​Fluxo de integração

​1. Configurar logging (opcional)

​2. Criar o mecanismo

​3. Definir parâmetros de beleza

​Pele

​Remodelagem facial

​Remodelagem corporal

​Maquiagem

​4. Filtros, adesivos e fundo virtual

​5. Callbacks e estatísticas

​6. Processar quadros

​Enviar para OpenGL (prévia)

​7. Loop mínimo

​Relacionado

Integração com terceiros

Referência da API

Tratamento de erros

Práticas recomendadas

Incluir headers

Fluxo de integração

1. Configurar logging (opcional)

2. Criar o mecanismo

3. Definir parâmetros de beleza

Pele

Remodelagem facial

Remodelagem corporal

Maquiagem

4. Filtros, adesivos e fundo virtual

5. Callbacks e estatísticas

6. Processar quadros

Enviar para OpenGL (prévia)

7. Loop mínimo

Relacionado