よくある質問

​

統合

​

エンジン作成が nil を返す

• licenseToken または appId + appKey を設定してください。両方ある場合はトークンが優先されます。
• コンソールでアプリの Bundle ID をバインドしてください。
• オンライン認証では /facebetter/v2/auth に到達できる必要があります。
• createEngineWithConfig: の前にログを開き、イベント 1（認証失敗）と 101（初期化失敗）を確認してください。
• CocoaPods: pod 'Facebetter', '2.0.0'。.xcodeproj ではなく .xcworkspace を開いてください。

​

コンパイルでヘッダーまたはクラスが見つからない

• #import <Facebetter/FBBeautyEffectEngine.h> をインポートします。
• .framework を手動統合する場合は Embed & Sign に設定します。
• Clean Build Folder のあと再ビルドします。
• Xcode 15+ で CocoaPods スクリプトが失敗する場合、ENABLE_USER_SCRIPT_SANDBOXING を No にします。

​

実行時のリンク / dyld エラー

• アーキテクチャは arm64 である必要があります。
• デプロイターゲットは iOS 12.0+ です。
• Facebetter.framework が Embed Frameworks に入っていることを確認してください。

​

認証

​

licenseToken と appId / appKey

​

イベント 1 または 101

​

美顔

​

効果が弱すぎる、または強すぎる

• 美肌 / メイク / フィルター: [0.0, 1.0]。
• リシェイプ: setReshape:intensity: で [-1.0, 1.0]（0 はオフ）。
• 強度 0 はその項目をオフにします。
• 肌領域のみ: setBeautySkinOnly:。

​

フィルター、ステッカー、バーチャル背景

​

フィルターまたはステッカーが効かない

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

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

​

バーチャル背景

[engine setVirtualBackgroundBlur:0.6f];           // 0 クリア
[engine setVirtualBackground:imagePath];          // png/jpg
[engine setVirtualBackgroundWithData:imageData];
[engine clearVirtualBackground];

[engine setChromaKey:FBChromaKeyColor_Green];
[engine setChromaKeySimilarity:0.4f];
[engine clearChromaKey];  // ポートレートセグメンテーションに戻る。塗りつぶしは残る

​

処理

​

processImage: が nil を返す

• エンジンが nil、または初期化失敗（-2 / イベント 101）。
• フレームが無効（サイズ 0、非対応フォーマット）。
• externalContext = YES だが、現在のスレッドに GL コンテキストがない。
• 処理失敗（FBErrorCode_Process）として扱ってください。

​

フレームタイプ

​

フォーマット変換

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

​

カメラプレビュー

1. AVCaptureVideoDataOutput から CVPixelBuffer を取得します。
2. createWithNV12:... または createWithBGRA:... で FBImageFrame を作成します。
3. type = FBFrameTypeVideo を設定し、任意で setMirror:@"horizontal"。
4. processImage: のあと [output data] または [output texture] を表示します。

​

パフォーマンスとメモリ

• リアルタイムでは FBFrameTypeVideo。getStats.avgProcessTimeMs が高い場合は解像度を下げます。
• エンジンは 1 つ、シリアルキュー。メインスレッドで処理しないでください。
• ARC でフレームを解放し（frame = nil）、キャプチャバッファを再利用します。
• 毎フレーム setFilter: / setSticker: しないでください。

​

ログ

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

​

バージョン

• iOS 12.0+、arm64。
• CocoaPods: pod 'Facebetter', '2.0.0'。
• アップグレード後は pod install、Clean Build Folder を実行し、認証と processImage: を再確認してください。

​

スレッド

• デフォルトエンジン: すべての processImage: と、GL リソースに触れる setter はシリアルキューで実行します。
• externalContext = YES: GL スレッドで作成して処理します。
• UI の更新はメインキューのみです。