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 app no console.
• A autenticação online precisa de rede até /facebetter/v2/auth.
• Ative os logs antes de createEngineWithConfig: e observe os eventos 1 (falha de licença) e 101 (falha de init).
• CocoaPods: pod 'Facebetter', '2.0.0'. Abra o .xcworkspace, não o .xcodeproj.

​

Headers ou classes ausentes

• Importe #import <Facebetter/FBBeautyEffectEngine.h>.
• Para um .framework manual, defina Embed & Sign.
• Clean Build Folder e reconstrua.
• Se os scripts do CocoaPods falharem no Xcode 15+, defina ENABLE_USER_SCRIPT_SANDBOXING como No.

​

Erros de link / dyld em runtime

• A arquitetura precisa ser arm64.
• Deployment target iOS 12.0+.
• Confirme que Facebetter.framework está em Embed Frameworks.

​

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: (0 desliga).
• Intensidade 0 desativa esse efeito.
• Somente pele: setBeautySkinOnly:.

​

Valores de enum de maquiagem / remodelagem

​

Filtros, adesivos, fundo virtual

​

O filtro ou o adesivo não faz nada

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

[engine setSticker:fbdPath];
[engine clearSticker];

​

Fundo virtual

[engine setVirtualBackgroundBlur:0.6f];           // 0 clears blur
[engine setVirtualBackground:imagePath];          // png/jpg
[engine setVirtualBackgroundWithData:imageData];
[engine clearVirtualBackground];

[engine setChromaKey:FBChromaKeyColor_Green];
[engine setChromaKeySimilarity:0.4f];
[engine clearChromaKey];  // back to portrait segmentation; fill stays

​

Processamento

​

processImage: retorna nil

• O mecanismo é nil ou o init falhou (-2 / evento 101).
• Quadro inválido (tamanho zero, formato não suportado).
• externalContext = YES mas o thread atual não tem contexto GL.
• Trate como falha de processamento (FBErrorCode_Process).

​

Tipo de quadro

​

Conversão de formato

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

​

UIImage

FBImageFrame *frame = [FBImageFrame createWithUIImage:image];
frame.type = FBFrameTypeImage;
FBImageFrame *out = [engine processImage:frame];

​

Prévia da câmera

1. Leia CVPixelBuffer de AVCaptureVideoDataOutput.
2. Monte FBImageFrame com createWithNV12:... ou createWithBGRA:....
3. Defina type = FBFrameTypeVideo, opcionalmente setMirror:@"horizontal".
4. processImage: e, em seguida, exiba [output data] ou [output texture].

​

Desempenho e memória

• Use FBFrameTypeVideo ao vivo; reduza a resolução se getStats.avgProcessTimeMs estiver alto.
• Um mecanismo, fila serial; não processe no thread principal.
• Libere os quadros com ARC (frame = nil). Reutilize buffers de captura.
• Evite setFilter: / setSticker: a cada quadro.

​

Logs

FBLogConfig *logConfig = [[FBLogConfig alloc] init];
logConfig.consoleEnabled = YES;
logConfig.fileEnabled = YES;
logConfig.level = FBLogLevel_Debug;
logConfig.fileName = logPath;
[FBBeautyEffectEngine setLogConfig:logConfig];  // before createEngineWithConfig:

​

Versão

• iOS 12.0+, arm64.
• CocoaPods: pod 'Facebetter', '2.0.0'.
• Após o upgrade: pod install, Clean Build Folder, reteste autenticação e processImage:.

​

Threads

• Mecanismo padrão: fila serial para todos os processImage: e setters que tocam recursos GL.
• externalContext = YES: criar + processar no thread GL.
• Atualize a UI apenas na fila principal.