SDK 버전 2.0.0 이상에서의 마이그레이션 방법

버전 2.0.0 내의 구조 변경

요청 메서드와 클래스가 정적 메서드와 클래스로 대체되었습니다.
프로젝트 ID는 메서드에 매개 변수로 전달되지 않습니다. SDK는 프로젝트 설정에 지정된 값을 사용합니다.
사용자의 인증 토큰은 메서드에 매개 변수로 전달되지 않으며 콜백 함수에 의해 반환되지 않습니다. SDK는 사용자의 이전 인증을 기반으로 토큰을 결정하며 이 토큰을 카탈로그 가져오기, 구매하기 및 인벤토리 표시하기 메서드에 전달합니다.
모바일 장치에 대한 정보를 결정하는 논리가 SDK에 추가되었습니다. 데이터는 DeviceInfo 구조로 캡슐화됩니다.

변경 사항의 전체 목록은 сhangelog에서 확인하세요.

XsollaAuth.Instance 호출을 XsollaAuth로 대체합니다.
인증 메서드를 호출할 때 사용되는 onSuccess 콜백 메서드의 서명을 변경합니다. Action<string>을 Action으로 대체합니다.
RefreshOAuthToken 메서드를 호출할 때 refreshToken 매개 변수 전달을 제거합니다.
GetUserInfo 메서드를 호출할 때 token 매개 변수 전달을 제거합니다.
메서드를 호출할 때 XsollaAuth.Instace.OAuthLogout에 대한 호출을 XsollaAuth.Logout으로 바꾸고 token 매개 변수의 전달을 제거합니다.
AuthViaDeviceID 메서드를 호출할 때 deviceType, deviceId, device 매개 변수 전달을 제거합니다. 모바일 장치 정보를 결정하는 로직을 제거합니다.
Register 메서드를 호출할 때 사용되는 onSuccess 콜백 메서드의 서명을 변경합니다. Action<int>, Action, Action<LoginUrlResponse>을 Action<LoginLink>으로 대체합니다.
SignIn 메서드를 호출할 때 rememberMe 매개 변수 전달을 제거합니다.
StartAuthByEmail 및 StartAuthByPhoneNumber 메서드를 호출할 때 사용되는 onSuccess 콜백 메서드의 서명을 변경합니다. Action<string>을 Action<OperationId>으로 대체합니다.

XsollaOrders.Instance 호출을 XsollaOrders로 대체합니다.
OpenPurchaseUI 메서드 호출 코드를 변경합니다. 결제 토큰을 paymentToken 매개 변수로 전달합니다(purhaseData 매개 변수가 paymentToken로 대체됨).
OpenPurchaseUI 메서드를 호출할 때 사용되는 onBrowserClosed 콜백 메서드의 서명을 변경합니다. Action<bool>을 Action<BrowserCloseInfo>으로 대체합니다.
클래스 메서드를 호출할 때 projectId 매개 변수 전달을 제거합니다.

Token.Instance 호출을 XsollaToken으로 대체합니다.
Token.Instance.GetSteamUserID 호출을 SteamUItils.GetSteamUserId로 대체합니다.
액세스 및 새로 고침 토큰의 값을 가져오려면 코드를 수정합니다. XsollaToken.AccessToken 및 XsollaToken.RefreshToken 속성을 사용합니다.

AndroidSDKSocialAuthHelper 및 IosSDKSocialAuthHelper 클래스의 사용을 XsollaAuth.AuthViaSocialNetwork 호출로 대체합니다.
AndroidSDKPaymentsHelper 및 IosSDKPaymentsHelper 클래스의 사용을 XsollaWebBrowser.OpenPurchaseUI 호출로 대체합니다.

프로젝트에서 코드 스니펫 또는 데모 장면 UI를 사용하는 경우 데모 프로젝트 패키지에 SDK 파일이 이미 포함되어 있으므로 데모 프로젝트 패키지를 다운로드하십시오. Unity 프로젝트에 데모 프로젝트를 포함시킨 경우 SDK를 마이그레이션할 필요가 없습니다.

패키지 압축을 해제합니다.
Unity 에디터에서 메인 메뉴에 있는 Assets > Import Package > Custom Package로 가서 SDK 또는 데모 패키지를 선택합니다.
종속성 경고 윈도우에서 Install/Upgrade(을)를 클릭합니다. 그 결과 Import Unity Package 확인된 파일 목록이 있는 윈도우가 열리고 설치 준비가 됩니다. 목록에는 변경되지 않은 파일, 추가되는 파일 및 대체되는 파일이 표시됩니다.
Import(을)를 클릭합니다.
애플리케이션을 테스트하고 필요에 따라 프로젝트 코드를 변경합니다.

의견을 보내 주셔서 감사드립니다!

메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

마지막 업데이트: 2025년 10월 31일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

콘텐츠