SDK 2.0.0。認証失敗: 認証とライセンス。
FacebetterError を投げます。数値の code は下表です。読み込み / 認証失敗の一部は文字列の code を使います。
数値エラーコード
JavaScript 層のコード(文字列)
init() / 読み込み / 認証段階で投げられます。
初期化チェックリスト
- 設定が有効: 空でない
licenseToken。 - SDK がランタイムファイルをダウンロードできる(UMD スクリプトと同じディレクトリのファイルなど)。
- ページが セキュアコンテキスト である。
- 本番では、ダッシュボードのドメインがページ origin と一致する。
- 本番フロントエンド JS に
appKeyを埋め込まない。
パラメータと処理エラー
美顔強度は[0.0, 1.0]、リシェイプは [-1.0, 1.0] である必要があります。範囲外はネイティブ呼び出しの前に FacebetterError を投げます。
エンジン未初期化、バッファ割り当て失敗、またはネイティブ処理が非 0 を返すと、processImage は例外を投げます。呼び出し前に動画の readyState と、0 でない videoWidth / videoHeight を確認してください。
フィルター / ステッカー / 背景のパスは空にできません。オフにするには clearFilter()、clearSticker()、clearVirtualBackground() を使います。
エンジンイベントと例外
init() がすでに成功して返ったあとでも、認証 / 初期化結果は onEngineEvent(EngineEventCode の 0 / 1 / 100 / 101)で届くことがあります。init() が投げなくても、LicenseValidationFailed と InitializationFailed を監視してください。

