移行ガイド | SDK 2.0

Web SDK v2 から

変更	アクション
partnerId が初期化から削除されました	clientIdのみを渡します。認証を通じてパートナー構成を解決します。
features.loadingScreen が削除されました	カスタムのロード画面オプションと削除されたタイプを削除します。
デフォルトのホスト型オリジンは vton.spreeai.com になりました	承認された環境で、明示的な baseURL オーバーライドと CSP フレームソースルールを確認してください。
ダイアログのレイアウトが変更されました	カスタムダイアログの CSS、モバイルの全画面動作、スクロール/フォーカスの処理を再確認します。

現在の初期化

TypeScript

import { init } from "@spreeai/web-sdk";
const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
    features: { tryOnButton: { text: "Try it on you" } },
  });
}

レガシー v1 から

シングルを交換する tryOnButton() 1人で電話する init() 電話と 1 つ以上 sdk.renderTryOnButton() 呼び出します。古い単一衣類の入力を次のように置き換えます。 garments。のカート処理を更新します garments 単一の衣服ではなく配列。

移行チェックリスト

インストールされたパッケージ、動作することがわかっているホストされたビルド、および承認された構成を記録します。
v3.0.0 を固定し、更新された統合をステージングでコンパイルします。
認証、単一の衣服、バリエーションのマッチング、および衣装のフォールバックを確認します。
サポートされている場合のみ、サイズの表示、推奨サイズ、カートの処理をテストします。
走る生産チェックリストデスクトップでもモバイルでも。
承認されたプロセスを通じてプロモーションを行います。既知の動作パッケージと構成をロールバックに利用できるようにしておきます。

ロールバック

認証、製品適格性、または購入動作が後退した場合は、ロールアウトを停止し、最後に検証された互換性のあるパッケージと構成を復元します。再現ステップと相関 ID を保存します。デプロイの成功だけに依存するのではなく、復元されたエクスペリエンスを確認します。

出典参照