适用于Unity的SDK / 如何迁移到SDK 2.0.0及更高版本
  返回文档

适用于Unity的SDK

如何迁移到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方法时传递deviceTypedeviceIddevice参数。移除了确定移动设备信息的逻辑。
  • 更改了调用Register方法时使用的onSuccess回调方法的签名。Action<int>, Action, Action<LoginUrlResponse>替换为Action<LoginLink>
  • 移除了调用SignIn方法时传递rememberMe参数。
  • 更改了调用StartAuthByEmailStartAuthByPhoneNumber方法时使用的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.AccessTokenXsollaToken.RefreshToken属性。

升级工具类

  • AndroidSDKSocialAuthHelperIosSDKSocialAuthHelper类的使用替换为XsollaAuth.AuthViaSocialNetwork调用。
  • AndroidSDKPaymentsHelperIosSDKPaymentsHelper类的使用替换为XsollaWebBrowser.OpenPurchaseUI调用。

替换包

  1. 打开您的Unity项目。
  2. 删除Xsolla文件夹。
  3. 下载SDK演示项目包。
注:
如果项目中使用了代码片段或演示场景UI,请下载演示项目包,因为其中已经包含SDK文件。如果Unity项目中包含了演示项目,则无需再集成SDK。
  1. 解压缩资源包。
  2. 在Unity编辑器的主菜单中前往Assets > Import Package > Custom Package,然后选中SDK或演示项目包。
  3. 在依赖项警告窗口中,单击Install/Upgrade。随后将打开Import Unity Package窗口,其中勾选了一列准备安装的文件。通过文件列表可看出哪些文件保持不变,哪些文件是新增文件及被替换的文件。
  4. 单击Import
  5. 测试您的应用程序并必要时对项目代码进行更改。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!
上次更新时间: 2024年1月22日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!