Implementar belleza

Esta página corresponde al SDK 2.0.0. Autenticación: Autenticación y licencia. Enumeraciones de maquillaje / remodelado: Enumeraciones de parámetros.

Añadir la dependencia del SDK

Método A: CocoaPods (recomendado)

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

pod install

Error de compilación en Xcode 15+Si usas Xcode 15 o posterior, puedes encontrarte con un error Sandbox: rsync.samba deny(1). Lo provoca User Script Sandboxing.Solución:

Selecciona tu Project en Xcode.
Abre Build Settings.
Busca ENABLE_USER_SCRIPT_SANDBOXING.
Cambia el valor de Yes a No.

Método B: Framework manual

Descarga el SDK desde Descargas, copia Facebetter.framework al proyecto y incrusta la biblioteca dinámica con Embed & Sign.

Permisos

Las apps Mac en sandbox que usan appId / appKey en línea deben permitir red saliente:

Cámara (opcional): NSCameraUsageDescription en Info.plist.

Importar

#import <Facebetter/FBBeautyEffectEngine.h>

Los tipos de AppKit (NSImage) requieren #import <AppKit/AppKit.h> (en macOS suele llegar por el prefix header o el header del motor).

Configuración de logs

El logging está desactivado por defecto. Llama a setLogConfig: antes de crear el motor.

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];

Crear el motor

Vincula el Bundle ID de macOS y luego pasa licenseToken o appId + appKey. Consulta Obtener AppID y AppKey y Autenticación y licencia. Prioridad: si licenseToken no está vacío (cadena del token de licencia, JSON {token} o contenido de .lic), el SDK lo valida en local. En caso contrario 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: devuelve una instancia, no un singleton. Las herramientas de línea de comandos sin Bundle ID deben vincular el nombre del proceso en la consola.

Belleza de piel

La intensidad suele ser [0.0, 1.0]. Enumeraciones de estilo: Enumeraciones 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];

Remodelado facial

El rango de setReshape:intensity: es [-1.0, 1.0]. 0 desactiva. Parámetros: FBReshape_FaceThin … FBReshape_BrowThickness (0–25). Significados: Enumeraciones de parámetros.

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

Remodelado corporal

El rango de setBodyReshape:intensity: es [0.0, 1.0]. 0 desactiva. Registra resource_body.fbd con addResourcePack: primero. Parámetros: FBBodyReshape_BodySlim … FBBodyReshape_TorsoLong (0–8). Consulta Enumeraciones de parámetros y Paquetes de recursos opcionales.

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];

Maquillaje

Intensidad, forma y color son llamadas separadas. Estilos completos: Enumeraciones 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];

Fondo virtual

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

El croma solo sustituye la máscara. El relleno sigue siendo desenfoque o imagen de reemplazo.

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

Filtros y stickers

Pasa una ruta de archivo .fbd o bytes en memoria. No hay interfaz de registro por ID.

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];

Los stickers 3D necesitan el paquete opcional resource_3d.fbd (no está en el framework). Consulta Paquetes de recursos opcionales:

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 y estadísticas

FBEngineCallbacks *callbacks = [[FBEngineCallbacks alloc] init];
callbacks.onEngineEvent = ^(FBEngineEventCode code, NSString * _Nullable message) {
  // 0 license OK, 1 license failed, 100 init complete, 101 init failed
  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);

Procesar imágenes

FBImageFrame admite I420, NV12, NV21, RGB, RGBA, BGR, BGRA, archivo, textura y NSImage.

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

Configura primero type y luego llama a processImage: (no hay un argumento de modo extra). El formato de salida coincide con el de entrada.

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

FBFrameTypeVideo es para flujos en tiempo real; FBFrameTypeImage para estáticos y 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 y los stride correspondientes.

Textura externa

Crea el motor en el hilo OpenGL y configura externalContext = YES. Las texturas de entrada y salida deben compartir ese 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: Integración con terceros.

Ciclo de vida

Mantén el motor con una referencia strong del NSViewController. Detén la captura cuando desaparezca la vista o se minimice la ventana. Pon el motor a nil al terminar la sesión.

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

Introducción

Android

iOS

macOS

Windows

Linux

Web

Flutter

Añadir la dependencia del SDK

Método A: CocoaPods (recomendado)

Método B: Framework manual

Permisos

Importar

Configuración de logs

Crear el motor

Belleza de piel

Remodelado facial

Remodelado corporal

Maquillaje

Fondo virtual

Filtros y stickers

Callbacks y estadísticas

Procesar imágenes

Textura externa

Ciclo de vida

Relacionado

​Añadir la dependencia del SDK

​Método A: CocoaPods (recomendado)

​Método B: Framework manual

​Permisos

​Importar

​Configuración de logs

​Crear el motor

​Belleza de piel

​Remodelado facial

​Remodelado corporal

​Maquillaje

​Fondo virtual

​Filtros y stickers

​Callbacks y estadísticas

​Procesar imágenes

​Textura externa

​Ciclo de vida

​Relacionado

Añadir la dependencia del SDK

Método A: CocoaPods (recomendado)

Método B: Framework manual

Permisos

Importar

Configuración de logs

Crear el motor

Belleza de piel

Remodelado facial

Remodelado corporal

Maquillaje

Fondo virtual

Filtros y stickers

Callbacks y estadísticas

Procesar imágenes

Textura externa

Ciclo de vida

Relacionado