如何迁移到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。