サードパーティ連携 - Facebetter Docs

SDK 2.0.0。Windows · サードパーティ連携と同じ C++ API と接続方針です。デスクトップ側は多くが I420 / YUV バッファであり、モバイルの OpenGL テクスチャコールバックではありません。このページは Linux の差分のみです。共通ヘルパー、TRTC / Agora / LiveKit の配線は Windows ページを直接参照してください（ヘッダーとライブラリパスを Linux 成果物に置き換えるだけです）。

Third-party SDK (preprocess callback)
  I420 planes
       ↓
BeautyEffectEngine
  CreateWithI420 → ProcessImage → write back to buffer

Linux の差分

項目	説明
ライブラリ	`libfacebetter.so` + `facebetter/*.h`
リンク	美顔の実装を参照。実行時は `LD_LIBRARY_PATH` / rpath に注意
GL	GL コンテキストがカレントなスレッドでエンジンを作成して処理します。入出力テクスチャはそのコンテキストに属している必要があります。CPU フレームに呼び出し側の GL コンテキストは不要です。設定にコンテキスト用のフラグはありません。
`resource_path`	`resource.fbd` ファイルを指す必要があります
コンソールバインド	パッケージ名または実行ファイル名 / プロセス名。サブスクリプションを参照

エンジン作成の例:

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path = "/opt/yourapp/resource/resource.fbd";
auto engine = BeautyEffectEngine::Create(cfg);

I420 共通処理関数とベンダーフックポイント: 完全なコピーは Windows · サードパーティ連携（ProcessI420InPlace、TRTC Buffer、Agora IVideoFrameObserver、LiveKit カスタム動画ソース）。

ベンダー早見

ベンダー	Linux の注意
TRTC	PC は Buffer / I420 のみ。Android Texture 経路を流用しない
Agora	C++ `registerVideoFrameObserver`、ReadWrite + I420 プレーナーのその場処理
LiveKit	カスタム動画ソースでフレームを送出。ヘッドレスサーバーではキャプチャと GL/ソフトウェア経路を確認

トラブルシューティング

症状	確認
`.so` が見つからない	`LD_LIBRARY_PATH`、rpath、実行ファイルと同じアーキテクチャか
`Create` 失敗	`.fbd` パス、認証、ヘッドレス環境の GL / OSMesa
その他	Windows の切り分けと同じ

関連ドキュメント