마이그레이션 가이드 | 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() 하나로 전화해 init() 통화 및 하나 이상의 sdk.renderTryOnButton() 전화. 이전 단일 의류 입력을 다음으로 대체합니다. garments. 장바구니 처리 업데이트 garments 단일 의류가 아닌 배열.

마이그레이션 체크리스트

설치된 패키지, 작동 중인 것으로 알려진 호스팅 빌드 및 승인된 구성을 기록합니다.
v3.0.0을 고정하고 스테이징에서 업데이트된 통합을 컴파일합니다.
인증, 단일 의류, 변형 매칭 및 복장 대체를 확인하세요.
테스트 사이즈 표시, 사이즈 권장 사항 및 카트 취급은 지원되는 경우에만 가능합니다.
실행 생산 체크리스트 데스크톱과 모바일에서.
승인된 프로세스를 통해 홍보하세요. 롤백에 사용할 수 있는 알려진 작동 패키지 및 구성을 유지합니다.

롤백

인증, 제품 자격 또는 구매 행동이 회귀하는 경우 출시를 중지하고 마지막으로 확인된 호환 패키지 및 구성을 복원하십시오. 재생 단계와 상관 관계 ID를 보존합니다. 성공적인 배포에만 의존하기보다는 복원된 경험을 확인하세요.

소스 참조