FAQ

​

연동

​

엔진 생성이 nil을 반환함

• licenseToken 또는 appId + appKey가 설정되어 있는지 확인하세요. 둘 다 있으면 토큰이 우선합니다.
• Mac Bundle ID를 바인딩하세요(CLI 도구: 프로세스 이름).
• 온라인 인증에는 App Sandbox의 Outgoing Connections와 /facebetter/v2/auth 경로가 필요합니다.
• createEngineWithConfig: 전에 로그를 켜고 이벤트 1 / 101을 확인하세요.
• CocoaPods: pod 'Facebetter', '2.0.0'. .xcworkspace를 여세요.

​

헤더 또는 클래스가 없음

• #import <Facebetter/FBBeautyEffectEngine.h>를 임포트하세요.
• 수동 .framework: Embed & Sign.
• Xcode 15+ CocoaPods 샌드박스: ENABLE_USER_SCRIPT_SANDBOXING을 No로 설정하세요.

​

런타임 링크 / dyld 오류

• 아키텍처: x86_64와 arm64.
• 배포 타깃 macOS 10.15+.

​

인증

​

licenseToken vs appId / appKey

​

이벤트 1 또는 101

​

뷰티

​

효과가 너무 약하거나 너무 강함

• 피부 / 메이크업 / 필터: [0.0, 1.0].
• 리셰이프: setReshape:intensity:로 [-1.0, 1.0].
• 강도 0은 해당 효과를 끕니다.
• 피부만: setBeautySkinOnly:.

​

필터, 스티커, 가상 배경

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

​

처리

​

processImage:가 nil을 반환함

​

프레임 유형

​

형식 변환

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

​

카메라

1. AVCaptureVideoDataOutput → CVPixelBuffer.
2. createWithNV12:... 또는 createWithBGRA:....
3. type = FBFrameTypeVideo, 선택적으로 setMirror:@"horizontal".
4. AppKit / OpenGL 뷰에서 [output data] 또는 [output texture]를 표시합니다.

​

성능

• 라이브에는 FBFrameTypeVideo를 사용하고 getStats를 확인하세요.
• 엔진은 하나, 직렬 큐입니다.
• 창이 최소화되면 캡처를 일시 중지하세요.

​

로깅

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

​

버전

• macOS 10.15+, x86_64 + arm64.
• CocoaPods: pod 'Facebetter', '2.0.0'.
• Universal Binary: xcframework에 두 슬라이스가 있는지 확인하세요(lipo -info).

​

샌드박스와 App Store

• 온라인 인증을 위한 아웃바운드 네트워크.
• 카메라용 NSCameraUsageDescription.
• 사용자가 선택한 파일에는 security-scoped bookmark.
• 프라이빗 API를 사용하지 마세요. 라이브 비디오는 메인 스레드에서 엔진을 돌리지 마세요.