Perguntas frequentes

​

Integração

​

A criação do mecanismo retorna nil

• Confirme se licenseToken ou appId + appKey está definido. O token prevalece se os dois estiverem presentes.
• Vincule o Bundle ID do Mac (ferramentas CLI: nome do processo).
• A autenticação online precisa de Outgoing Connections no App Sandbox e de um caminho até /facebetter/v2/auth.
• Ative os logs antes de createEngineWithConfig: e observe os eventos 1 / 101.
• CocoaPods: pod 'Facebetter', '2.0.0'. Abra o .xcworkspace.

​

Headers ou classes ausentes

• Importe #import <Facebetter/FBBeautyEffectEngine.h>.
• .framework manual: Embed & Sign.
• Sandbox do CocoaPods no Xcode 15+: defina ENABLE_USER_SCRIPT_SANDBOXING como No.

​

Erros de link / dyld em runtime

• Arquiteturas: x86_64 e arm64.
• Deployment target macOS 10.15+.

​

Autenticação

​

licenseToken vs appId / appKey

​

Evento 1 ou 101

​

Beleza

​

O efeito está fraco ou forte demais

• Pele / maquiagem / filtro: [0.0, 1.0].
• Remodelagem: [-1.0, 1.0] via setReshape:intensity:.
• Intensidade 0 desativa esse efeito.
• Somente pele: setBeautySkinOnly:.

​

Filtros, adesivos, fundo 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];

​

Processamento

​

processImage: retorna nil

​

Tipo de quadro

​

Conversão 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âmera

1. AVCaptureVideoDataOutput → CVPixelBuffer.
2. createWithNV12:... ou createWithBGRA:....
3. type = FBFrameTypeVideo, opcionalmente setMirror:@"horizontal".
4. Exiba [output data] ou [output texture] em uma view AppKit / OpenGL.

​

Desempenho

• FBFrameTypeVideo ao vivo; observe getStats.
• Um mecanismo, fila serial.
• Pause a captura quando a janela for miniaturizada.

​

Logs

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

​

Versão

• macOS 10.15+, x86_64 + arm64.
• CocoaPods: pod 'Facebetter', '2.0.0'.
• Universal Binary: confirme que o xcframework contém os dois slices (lipo -info).

​

Sandbox e App Store

• Rede de saída para autenticação online.
• NSCameraUsageDescription para a câmera.
• Security-scoped bookmarks para arquivos escolhidos pelo usuário.
• Não use APIs privadas; mantenha o mecanismo fora do thread principal para vídeo ao vivo.