Skip to main content
SDK 2.0.0。認証: 認証とライセンス

戻り値

ほとんどの setter は int を返します。 BeautyEffectEngine::Create()std::shared_ptr を返し、失敗時は nullptr です。ProcessImage 失敗も空ポインタを返すことがあります。

エンジンイベント

Create のあと on_engine_event を登録します。 失敗時、message に詳細があります。

よくある失敗

1. Createnullptr を返す

よくある原因:
  • resource_path がディレクトリ、パス誤り、または resource.fbd ファイルではない
  • app_id + app_key が無効、または license_token が誤り
  • facebetter.dll がない、または facebetter.lib と一致しない
  • /facebetter/v2/auth に到達できない
必ず Createにログを開きます。

2. facebetter.dll が見つからない

DLL が読み込みパスにない場合、Windows はダイアログを出します。
または再ビルドして、CMake が実行ファイルの隣へコピーするようにします。

3. ProcessImagenullptr を返す

入力フレーム、エンジンポインタ、ログ(setter の -7 処理失敗 / -8 メモリ不足)を確認します。

4. 効果が変わって見えない

2.0 には SetBeautyTypeEnabled はありません。強度 0 はオフです。リシェイプ / メイクには顔検出も必要です。

5. OpenGL / 表示

ドライバが古い、VM、GPU のないリモートデスクトップでは GLFW / gladLoadGLLoader が失敗することがあります。
アプリがすでに GL コンテキストを持っている場合は EngineConfig::external_context = true を設定し、そのスレッドで ProcessImage を呼び出します。

デバッグログ

絶対パスを使わない場合、ログファイルは現在の作業ディレクトリ相対で書き込まれます。