适用于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. 测试您的应用程序并必要时对项目代码进行更改。

    本文对您的有帮助吗?
    谢谢!
    我们还有其他可改进之处吗? 留言
    非常抱歉
    请说明为何本文没有帮助到您。 留言
    感谢您的反馈!
    我们会查看您的留言并运用它改进用户体验。
    为此页面评分
    为此页面评分
    我们还有其他可改进之处吗?

    不想回答

    感谢您的反馈!
    上次更新时间: 2023年6月7日

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

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