Preguntas frecuentes

​

Integración

​

La creación del motor devuelve nil

• Confirma que está configurado licenseToken o appId + appKey. El token gana si ambos están presentes.
• Vincula el Bundle ID de Mac (herramientas CLI: nombre del proceso).
• La autenticación en línea necesita Outgoing Connections en el App Sandbox y una ruta a /facebetter/v2/auth.
• Activa logs antes de createEngineWithConfig: y observa los eventos 1 / 101.
• CocoaPods: pod 'Facebetter', '2.0.0'. Abre el .xcworkspace.

​

Faltan headers o clases

• Importa #import <Facebetter/FBBeautyEffectEngine.h>.
• .framework manual: Embed & Sign.
• Sandbox de CocoaPods en Xcode 15+: pon ENABLE_USER_SCRIPT_SANDBOXING en No.

​

Errores de enlace en runtime / dyld

• Arquitecturas: x86_64 y arm64.
• Deployment target macOS 10.15+.

​

Autenticación

​

licenseToken frente a appId / appKey

​

Evento 1 o 101

​

Belleza

​

El efecto es demasiado débil o demasiado fuerte

• Piel / maquillaje / filtro: [0.0, 1.0].
• Remodelado: [-1.0, 1.0] con setReshape:intensity:.
• Intensidad 0 desactiva ese efecto.
• Solo piel: setBeautySkinOnly:.

​

Filtros, stickers, fondo virtual

[engine setFilter:fbdPath];
[engine setFilterIntensity:0.8f];
[engine clearFilter];
[engine setSticker:fbdPath];
[engine clearSticker];

[engine setVirtualBackgroundBlur:0.6f];
[engine setVirtualBackground:imagePath];
[engine setVirtualBackgroundWithData:imageData];
[engine clearVirtualBackground];
[engine setChromaKey:FBChromaKeyColor_Green];
[engine clearChromaKey];

​

Procesamiento

​

processImage: devuelve nil

​

Tipo de fotograma

​

Conversión de formato

FBImageFrame *rgba = [frame convert:FBImageFormatRGBA];
const uint8_t *data = [rgba data];

​

NSImage

FBImageFrame *frame = [FBImageFrame createWithNSImage:nsImage];
frame.type = FBFrameTypeImage;
FBImageFrame *out = [engine processImage:frame];

​

Cámara

1. AVCaptureVideoDataOutput → CVPixelBuffer.
2. createWithNV12:... o createWithBGRA:....
3. type = FBFrameTypeVideo, opcionalmente setMirror:@"horizontal".
4. Muestra [output data] o [output texture] en una vista AppKit / OpenGL.

​

Rendimiento

• FBFrameTypeVideo para directo; observa getStats.
• Un motor, cola serial.
• Pausa la captura cuando la ventana esté minimizada.

​

Logging

[FBBeautyEffectEngine setLogConfig:logConfig];  // before createEngineWithConfig:

​

Versión

• macOS 10.15+, x86_64 + arm64.
• CocoaPods: pod 'Facebetter', '2.0.0'.
• Universal Binary: confirma que el xcframework contiene ambos slices (lipo -info).

​

Sandbox y App Store

• Red saliente para autenticación en línea.
• NSCameraUsageDescription para la cámara.
• Bookmarks con ámbito de seguridad para archivos seleccionados por el usuario.
• No uses APIs privadas; mantén el motor fuera del hilo principal para vídeo en directo.