Skip to main content
SDK 2.0.0。認証: 認証とライセンス。列挙の値: パラメータ列挙。

インストール

エンジンの作成

Web の EngineConfig には次のフィールドだけがあり、設定オブジェクトに appId / appKey はありません。 エンジンのランタイムファイルは init() 時に SDK が読み込みます。サイトルートに resource.fbd を置く必要はありません。任意のダウンロード進捗: init({ onProgress })。エンジンはトークンを取得しません。Web はオフライン .lic に対応していません。
読み込み / 認証ログを見るには、init() の前に setLogConfig を呼び出してください。ブラウザはファイルログに対応していません(fileEnabled は無視されます)。

美肌

強度範囲 [0.0, 1.0]。0 はオフです。
setBeautySkinOnly(true) のあと、スムージング / 美白 / シャープニング / 血色は検出された肌にのみ適用され、衣服と背景は影響を受けません。
スタイル列挙: パラメータ列挙。

リシェイプ

範囲は [-1.0, 1.0] です。0 はオフです。正負は逆方向です(例: FaceThin は瘦顔 / 頬をふっくら)。完全な一覧: パラメータ列挙。

ボディリシェイプ

範囲は [0.0, 1.0] です。0 はオフです。init() のあと resource_body.fbd を取得して addResourcePack してください。全リスト: パラメータ列挙。オプションリソースパック。

メイク

強度、形状、色を分けて設定します。強度 [0.0, 1.0]。プリセット: パラメータ列挙。

フィルターとステッカー

.fbd の URL またはメモリ上の Uint8Array を setter に直接渡します。
3D ステッカーにはオプションパック resource_3d.fbd が必要です(Web SDK には含まれません)。オプションリソースパック を参照してください。init() のあとバイトで登録します。

バーチャル背景とクロマキー

クロマキーはマスクだけを差し替えます。塗りつぶしは引き続き setVirtualBackgroundBlur または setVirtualBackground が制御します。ぼかしと背景画像は排他です。

コールバック

キーポイントが不要なら onFaceLandmarks を渡さないでください。渡すと毎フレーム顔検出が走ります。

画面の処理

processImage を優先します。同期で ImageData を返します。
input は ImageData、HTMLImageElement、HTMLCanvasElement、HTMLVideoElement、または Uint8ClampedArray(この場合は width / height が必須)です。
  • FrameType.Video — カメラ / ライブ(時間方向の平滑化あり)
  • FrameType.Image — 静止画
processTexture(textureHandle, width, height, stride, frameType, mirrorMode) はカスタム GPU テクスチャ入力向けです。この経路はミラーを適用しません。 通常の Web アプリでは processImage を使ってください。

パフォーマンス統計

破棄

ページのアンロード、または React/Vue コンポーネント破棄時に必ず呼び出してください。 TRTC / Agora / LiveKit への接続: サードパーティ連携。

関連ドキュメント