迁移指南 | SDK 2.0

来自Web SDK v2

改变	行动
partnerId 从 init 中删除	仅通过clientId。通过身份验证解决合作伙伴配置。
features.loadingScreen 已移除	删除自定义加载屏幕选项和删除的类型。
默认托管源现在为 vton.spreeai.com	使用您批准的环境检查明确的 baseURL 覆盖和 CSP 框架 src 规则。
对话框布局已更改	重新检查自定义对话框 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() 与一个打电话 init() 呼叫和一个或多个 sdk.renderTryOnButton() 来电。将旧的单件服装输入替换为 garments。更新购物车处理 garments 阵列而不是单件衣服。

迁移清单

记录已安装的包、已知的工作托管构建和批准的配置。
固定 v3.0.0 并在暂存中编译更新的集成。
检查身份验证、单件服装、变体匹配和服装后备。
仅在支持的情况下测试尺码显示、尺码建议和购物车处理。
运行生产清单在桌面和移动设备上。
通过批准的流程进行推广。保留已知的工作包和配置可用于回滚。

回滚

如果身份验证、产品资格或购买行为出现问题,请停止推出并恢复上次验证的兼容包和配置。保留再现步骤和相关 ID。确认恢复的体验,而不是仅仅依赖成功的部署。

来源参考