Implementar beleza

Esta página corresponde ao SDK 2.0.0. Autenticação: Autenticação e licença. Enums de maquiagem / remodelagem: Enums de parâmetros.

Adicionar a dependência do SDK

Método A: CocoaPods (recomendado)

target 'YourTargetName' do
  pod 'Facebetter', '2.0.0'
end

pod install

Erro de compilação no Xcode 15+Se você usa Xcode 15 ou posterior, pode encontrar o erro Sandbox: rsync.samba deny(1). Isso é causado pelo User Script Sandboxing.Solução:

Selecione o Project no Xcode.
Abra Build Settings.
Pesquise ENABLE_USER_SCRIPT_SANDBOXING.
Altere o valor de Yes para No.

Método B: Framework manual

Baixe o SDK em Downloads, copie Facebetter.framework para o projeto e incorpore a biblioteca dinâmica com Embed & Sign.

Permissões

Apps Mac no sandbox que usam appId / appKey online precisam permitir rede de saída:

Câmera (opcional): NSCameraUsageDescription no Info.plist.

Import

#import <Facebetter/FBBeautyEffectEngine.h>

Tipos AppKit (NSImage) exigem #import <AppKit/AppKit.h> (geralmente via prefix header ou o header do mecanismo no macOS).

Configuração de log

O logging vem desligado por padrão. Chame setLogConfig: antes de criar o mecanismo.

FBLogConfig *logConfig = [[FBLogConfig alloc] init];
logConfig.level = FBLogLevel_Info;
logConfig.consoleEnabled = YES;
logConfig.fileEnabled = YES;
logConfig.fileName = @"/path/in/container/facebetter.log";
[FBBeautyEffectEngine setLogConfig:logConfig];

Criar o mecanismo

Vincule o Bundle ID do macOS e, em seguida, passe licenseToken ou appId + appKey. Veja Obter AppID e AppKey e Autenticação e licença. Prioridade: se licenseToken não estiver vazio (string do token de licença, JSON {token} ou conteúdo de .lic), o SDK o valida localmente. Caso contrário, usa appId + appKey contra /facebetter/v2/auth.

FBEngineConfig *engineConfig = [[FBEngineConfig alloc] init];
engineConfig.appId = @"your appId";
engineConfig.appKey = @"your appKey";
// engineConfig.licenseToken = @"your license token";
engineConfig.externalContext = NO;

self.beautyEffectEngine = [FBBeautyEffectEngine createEngineWithConfig:engineConfig];
if (self.beautyEffectEngine == nil) {
  NSLog(@"Failed to create beauty engine");
  return;
}

createEngineWithConfig: retorna uma instância, não um singleton. Para ferramentas de linha de comando sem Bundle ID, vincule o nome do processo no Console.

Beleza da pele

A intensidade costuma ser [0.0, 1.0]. Enums de estilo: Enums de parâmetros.

[self.beautyEffectEngine setSmoothing:0.5f];
[self.beautyEffectEngine setSmoothingStyle:FBSmoothingStyle_Natural];
[self.beautyEffectEngine setWhitening:0.3f];
[self.beautyEffectEngine setWhiteningStyle:FBWhiteningStyle_ColdWhite];
[self.beautyEffectEngine setSharpening:0.2f];
[self.beautyEffectEngine setRosiness:0.15f];
[self.beautyEffectEngine setBeautySkinOnly:YES];

Remodelagem facial

A faixa de setReshape:intensity: é [-1.0, 1.0]. 0 desliga. Parâmetros: FBReshape_FaceThin … FBReshape_BrowThickness (0–25). Significados: Enums de parâmetros.

[self.beautyEffectEngine setReshape:FBReshape_FaceThin intensity:0.4f];
[self.beautyEffectEngine setReshape:FBReshape_EyeSize intensity:0.2f];

Remodelagem corporal

A faixa de setBodyReshape:intensity: é [0.0, 1.0]. 0 desliga. Registre resource_body.fbd com addResourcePack: primeiro. Parâmetros: FBBodyReshape_BodySlim … FBBodyReshape_TorsoLong (0–8). Veja Enums de parâmetros e Pacotes de recursos opcionais.

NSString *bodyPack = [[NSBundle mainBundle] pathForResource:@"resource_body" ofType:@"fbd"];
[self.beautyEffectEngine addResourcePack:bodyPack];
[self.beautyEffectEngine setBodyReshape:FBBodyReshape_WaistSlim intensity:0.4f];
[self.beautyEffectEngine setBodyReshape:FBBodyReshape_LegStretch intensity:0.3f];
[self.beautyEffectEngine setBodyReshape:FBBodyReshape_TorsoLong intensity:0.3f];

Maquiagem

Intensidade, formato e cor são chamadas separadas. Predefinições completas: Enums de parâmetros.

[self.beautyEffectEngine setLipstick:0.5f];
[self.beautyEffectEngine setLipstickColor:FBLipstickColor_Rouge];

[self.beautyEffectEngine setBlush:0.4f];
[self.beautyEffectEngine setBlushStyle:FBBlushStyle_SunKissed];
[self.beautyEffectEngine setBlushColor:FBBlushColor_CoralPink];

[self.beautyEffectEngine setContour:0.35f];
[self.beautyEffectEngine setContourStyle:FBContourStyle_Natural];

[self.beautyEffectEngine setEyeShadow:0.4f];
[self.beautyEffectEngine setEyeShadowStyle:FBEyeShadowStyle_Soft];
[self.beautyEffectEngine setEyeShadowColor:FBEyeShadowColor_Plum];

[self.beautyEffectEngine setEyeLiner:0.4f];
[self.beautyEffectEngine setEyeLinerStyle:FBEyeLinerStyle_Classic];
[self.beautyEffectEngine setEyeLinerColor:FBEyeLinerColor_Coffee];

[self.beautyEffectEngine setEyebrow:0.4f];
[self.beautyEffectEngine setEyebrowStyle:FBEyebrowStyle_Natural];
[self.beautyEffectEngine setEyebrowColor:FBEyebrowColor_DarkBrown];

[self.beautyEffectEngine setEyelash:0.4f];
[self.beautyEffectEngine setEyelashStyle:FBEyelashStyle_Classic];
[self.beautyEffectEngine setEyelashColor:FBEyelashColor_Black];

[self.beautyEffectEngine setPupil:0.4f];
[self.beautyEffectEngine setPupilColor:FBPupilColor_Hazel];

Fundo virtual

[self.beautyEffectEngine setVirtualBackgroundBlur:0.6f];
[self.beautyEffectEngine setVirtualBackground:imagePath];
[self.beautyEffectEngine setVirtualBackgroundWithData:pngOrJpegData];
[self.beautyEffectEngine clearVirtualBackground];

O chroma key substitui apenas a máscara. O preenchimento continua sendo desfoque ou a imagem de substituição.

[self.beautyEffectEngine setChromaKey:FBChromaKeyColor_Green];
[self.beautyEffectEngine setChromaKeySimilarity:0.4f];
[self.beautyEffectEngine setChromaKeySmoothness:0.3f];
[self.beautyEffectEngine setChromaKeyDesaturation:0.2f];
[self.beautyEffectEngine clearChromaKey];

Filtros e adesivos

Passe um caminho de arquivo .fbd ou bytes em memória.

NSString *filterPath = [[NSBundle mainBundle] pathForResource:@"chuxin" ofType:@"fbd"];
[self.beautyEffectEngine setFilter:filterPath];
[self.beautyEffectEngine setFilterIntensity:0.8f];
[self.beautyEffectEngine clearFilter];
[self.beautyEffectEngine setFilterWithData:filterData];

NSString *stickerPath = [[NSBundle mainBundle] pathForResource:@"cherry" ofType:@"fbd"];
[self.beautyEffectEngine setSticker:stickerPath];
[self.beautyEffectEngine clearSticker];
[self.beautyEffectEngine setStickerWithData:stickerData];

Adesivos 3D precisam do pacote opcional resource_3d.fbd (não está no framework). Veja Pacotes de recursos opcionais:

NSString *packPath = [[NSBundle mainBundle] pathForResource:@"resource_3d" ofType:@"fbd"];
[self.beautyEffectEngine addResourcePack:packPath];
NSString *sticker3dPath = [[NSBundle mainBundle] pathForResource:@"oculos" ofType:@"fbd"];
[self.beautyEffectEngine set3DSticker:sticker3dPath];
[self.beautyEffectEngine clear3DSticker];

Callbacks e estatísticas

FBEngineCallbacks *callbacks = [[FBEngineCallbacks alloc] init];
callbacks.onEngineEvent = ^(FBEngineEventCode code, NSString * _Nullable message) {
  // 0 license OK, 1 license fail, 100 init complete, 101 init fail
  NSLog(@"engine event %ld %@", (long)code, message);
};
callbacks.onFaceLandmarks = ^(NSArray<FBFaceDetectionResult *> * _Nullable results) {
  NSLog(@"faces %lu", (unsigned long)results.count);
};
[self.beautyEffectEngine setCallbacks:callbacks];

FBEngineStats *stats = [self.beautyEffectEngine getStats];
NSLog(@"fps=%.1f avg=%.2fms session=%.1fs",
      stats.fps, stats.avgProcessTimeMs, stats.sessionTimeS);

Processar imagens

FBImageFrame suporta I420, NV12, NV21, RGB, RGBA, BGR, BGRA, arquivo, textura e NSImage.

FBImageFrame *fromFile = [FBImageFrame createWithFile:@"/path/photo.png"];
FBImageFrame *fromRGBA = [FBImageFrame createWithRGBA:data width:width height:height stride:stride];
FBImageFrame *fromNSImage = [FBImageFrame createWithNSImage:nsImage];

Defina type e, em seguida, chame processImage: (sem argumento extra de modo). A saída mantém o formato de entrada.

input.type = FBFrameTypeVideo;  // or FBFrameTypeImage
FBImageFrame *output = [self.beautyEffectEngine processImage:input];

FBFrameTypeVideo é para streams ao vivo; FBFrameTypeImage é para stills e NSImage.

[input rotate:FBImageRotation90];
[input setMirror:@"horizontal"];
FBImageFrame *rgba = [output convert:FBImageFormatRGBA];
const uint8_t *bytes = [rgba data];
[output toFile:@"/path/out.jpg" quality:90];

Planos YUV: dataY, dataU, dataV, dataUV e strides correspondentes.

Textura externa

Crie o mecanismo no thread OpenGL e defina externalContext = YES. As texturas de entrada e saída precisam compartilhar esse contexto.

FBEngineConfig *config = [[FBEngineConfig alloc] init];
config.appId = @"your appId";
config.appKey = @"your appKey";
config.externalContext = YES;
self.engine = [FBBeautyEffectEngine createEngineWithConfig:config];

FBImageFrame *inputFrame = [FBImageFrame createWithTexture:textureId
                                                     width:width
                                                    height:height
                                                    stride:width * 4];
inputFrame.type = FBFrameTypeVideo;
FBImageFrame *outputFrame = [self.engine processImage:inputFrame];
GLuint outputTexture = [outputFrame texture];

Para TRTC / Agora / LiveKit: Integração com terceiros.

Ciclo de vida

Mantenha uma referência strong no NSViewController. Pare a sessão de captura quando a view desaparecer ou a janela for miniaturizada. Atribua nil ao mecanismo quando a sessão terminar.

- (void)dealloc {
  self.beautyEffectEngine = nil;
}

Introdução

Android

iOS

macOS

Windows

Linux

Web

Flutter

Adicionar a dependência do SDK

Método A: CocoaPods (recomendado)

Método B: Framework manual

Permissões

Import

Configuração de log

Criar o mecanismo

Beleza da pele

Remodelagem facial

Remodelagem corporal

Maquiagem

Fundo virtual

Filtros e adesivos

Callbacks e estatísticas

Processar imagens

Textura externa

Ciclo de vida

Relacionado

​Adicionar a dependência do SDK

​Método A: CocoaPods (recomendado)

​Método B: Framework manual

​Permissões

​Import

​Configuração de log

​Criar o mecanismo

​Beleza da pele

​Remodelagem facial

​Remodelagem corporal

​Maquiagem

​Fundo virtual

​Filtros e adesivos

​Callbacks e estatísticas

​Processar imagens

​Textura externa

​Ciclo de vida

​Relacionado

Adicionar a dependência do SDK

Método A: CocoaPods (recomendado)

Método B: Framework manual

Permissões

Import

Configuração de log

Criar o mecanismo

Beleza da pele

Remodelagem facial

Remodelagem corporal

Maquiagem

Fundo virtual

Filtros e adesivos

Callbacks e estatísticas

Processar imagens

Textura externa

Ciclo de vida

Relacionado