如何迁移到SDK 2.0.0及更高版本
2.0.0版中的结构更改
- 请求方法和类替换为静态的方法和类。
- 项目ID不以参数形式传入方法。SDK使用在项目设置中指定的值。
- 用户的授权令牌不以参数形式传入方法,也不由回调函数返回。SDK根据用户之前的身份认证决定令牌并将其传入获取目录、购买和显示物品库的方法中。
- SDK新增确定移动设备信息的逻辑。该数据封装在
DeviceInfo结构中。
完整更改列表请参阅更改日志。
XsollaAuth类升级
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>。
XsollaCart类升级
XsollaCart.Instance调用替换为XsollaCart。XsollaCart.Instance.PurchaseCart调用替换为XsollaCart.CreateOrder。- 移除了调用类方法时传递
projectId参数。 - 仅对当前用户的购物车进行操作时,移除了调用类方法时传递
cartId参数。
XsollaOrders类升级
XsollaOrders.Instance调用替换为XsollaOrders。- 更改了调用
OpenPurchaseUI方法的代码。将支付令牌以paymentToken参数形式传递(purhaseData参数已替换为paymentToken)。 - 更改了调用
OpenPurchaseUI方法时使用的onBrowserClosed回调方法的签名。Action<bool>替换为Action<BrowserCloseInfo>。 - 移除了调用类方法时传递
projectId参数。
XsollaUserAccount类升级
XsollaUserAccount.Instance调用替换为XsollaUserAccount。- 移除了调用类方法时传递
token参数。
XsollaSubscriptions类升级
XsollaSubscriptions.Instance调用替换为XsollaSubscriptions。- 移除了调用类方法时传递
projectId参数。
XsollaInventory类升级
XsollaInventory.Instance调用替换为XsollaInventory。- 移除了调用类方法时传递
projectId参数。
XsollaGameKeys类升级
XsollaGameKeys.Instance调用替换为XsollaGameKeys。- 移除了调用类方法时传递
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 。 - 测试您的应用程序并必要时对项目代码进行更改。
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。