Skip to main content
SDK 2.0.0。ヘッダーは facebetter/*.h にあります。メイク / リシェイプ列挙: パラメータ列挙。認証: 認証とライセンス
Windows は C++ ライブラリ(facebetter.lib + facebetter.dll)で接続します。流れは C++ デスクトップ Demodemo/cpp)を参照してください。

ヘッダーの導入

統合の流れ

「美顔タイプを有効化」するステップはありません。強度が 0 より大きいとその効果がオンになります。

1. ログの設定(任意)

初期化ログを見るには、Create の前に呼び出す必要があります。
レベルは低い順に Trace / Debug / Info / Warn / Error / Critical です。

2. エンジンの作成

デスクトップでは 必ず resource_pathresource.fbd ファイルのパスに設定してください。 認証の優先順位: license_token が空でない場合、そのトークン(ライセンストークン、{token} JSON、またはオフライン .lic)をローカル検証し、app_id + app_key ではネット接続しません。それ以外は app_id + app_key/facebetter/v2/auth をリクエストします。
resource_pathresource.fbd ファイルである必要があります。ディレクトリにはできません。相対パスはプロセスの作業ディレクトリ基準です。本番では絶対パスを推奨します。

3. 美顔パラメータの設定

肌 / メイク / ボディリシェイプの強度は [0.0, 1.0]0 はオフです。フェイスリシェイプは [-1.0, 1.0] です。完全な列挙: パラメータ列挙

リシェイプ

ボディリシェイプ

範囲 [0.0, 1.0]0 はオフ。resource_body.fbdresource.fbd と同じ場所に置くか、AddResourcePack を呼んでください。パラメータ列挙オプションリソースパック

メイク

強度、形状、色番号は分けて設定します。口紅は色番号のみ、瞳は色番号のみ、コントアは形状のみです。
アイライナー、眉、まつ毛、瞳も同様です(SetEyeLiner / SetEyebrow / SetEyelash / SetPupil と対応する Style / Color)。

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

ファイルパス または エンコード済みバイト を渡します。
LUT / ステッカーテクスチャは次の ProcessImage(現在の GL スレッド)で作成されます。3D ステッカー: オプションリソースパック

5. コールバックと統計


6. 画像の処理

ImageFrame::typeFrameType::Video(リアルタイム、デフォルト)または FrameType::Image(1 枚の写真)を設定します。
ファイルから(写真モード):
エンジンは入力 / 出力形式をできるだけ揃えます(RGBA 入力なら RGBA 出力、I420 入力なら I420 出力)。別レイアウトが必要なときは Convert(Format::BGRA) を使います。

OpenGL へのアップロード(プレビュー)

facebetter.dll は実行ファイルと同じディレクトリに置いてください(Demo の CMake ビルド後は自動コピーされます)。

7. 最小サンプル

使い終わったら shared_ptr を解放します(engine.reset())。BeautyEffectEngineシングルトンではありません TRTC / Agora / LiveKit への接続: サードパーティ連携

関連ドキュメント

サードパーティ連携

TRTC / Agora / LiveKit

API リファレンス

すべての C++ メソッドと型

エラー処理

戻り値と DLL の問題

ベストプラクティス

パフォーマンスとスレッド