Appearance
接入流程
WARNING
注意:: 如果您同时使用了聚合SDK产品,,XSDK已经作为一个官网渠道SDK接入到聚合SDK中了。
开发要求
接入XSDK和接入一个普通渠道SDK的流程是类似的, 主要包含如下功能模块。 其中必选的功能模块,游戏层必须接入:
客户端
功能名称 | 必选/可选/无需开发 | 描述 | 接入耗时(小时) |
---|---|---|---|
初始化 | SDK初始化,游戏层在初始化完成后,才能调用后续其他接口 | 0.5~1 | |
登录 | 游戏根据运营需求,在SDK后台开启对应的登录入口 | 0.5~1 | |
切换账号/登出回调 | 玩家在SDK用户中心中点击切换账号或登出时,SDK会触发登出回调,游戏层收到该回调时,需要引导玩家返回到游戏登录界面,重新调用登录接口 | 0.5~1 | |
角色信息上报 | 游戏需要在玩家创建角色、进入游戏和角色等级升级时,调用角色信息上报接口,SDK后台可以查询角色信息 | 0.5~1 | |
支付 | SDK后台需要开启微信/支付宝支付通道,配置好参数,才能对接和测试 | 1~2 | |
生命周期函数 | 在Activity/AppDelegate中调用SDK的生命周期函数 | 0.5 | |
登出 | 可选 | 玩家在游戏内登出时,可以先调用SDK登出接口 | 0.5~1 |
实名认证 | 无需开发 | SDK后台可以进行实名认证的配置,目前政策要求,玩家注册后必须进行实名认证后才能进入游戏,请根据政策合理配置实名认证开关 | 0 |
防沉迷 | 无需开发 | SDK中已根据国家政策内置了未成年防沉迷逻辑,游戏层无需特殊处理 | 0 |
隐私弹窗 | 游戏层自行实现 | 游戏层需在玩家同意隐私协议之后,才能调用SDK的所有接口 | 0.5~1 |
统计埋点 | 可选 | SDK中,接入了不少统计SDK和买量上报SDK,比如头条、腾讯、快手、热云等,SDK内置了一些埋点上报,比如初始化、注册登录、支付等,如果游戏有特殊需求,可以调用上报接口 | 0.5~1 |
服务端
功能名称 | 必选/可选 | 描述 | 接入耗时(小时) |
---|---|---|---|
登录校验 | 客户端登录成功后,SDK会返回uid,token等参数,游戏客户端需要将这些参数,上报给游戏服务器,游戏服务器来SDK服务器验证token合法性。验证成功后,才能允许玩家进入游戏。 | 1~2 | |
支付回调通知 | 玩家支付完成后,支付平台会通知给SDK服务端。SDK服务端,会通知给游戏服务器, 游戏服务器在验证签名合法、商品金额无误、角色无误后,给玩家发货 | 1~2 |
审核要点
下面是常见的一些游戏层在首次接入过程中,容易忽视的地方。 请游戏开发者在接入SDK之前,就做到心中有数, 提前做好处理。
- 1、 游戏启动审核点
现在政策要求, 在游戏启动时, 游戏需要弹出带健康公告的闪屏(展示2~3秒)。 参考如下:
- 2、 游戏登录界面审核点
SDK的登录弹窗,是可以关闭的。 所以要求游戏在登录界面, 有类似【进入游戏】、【开始游戏】这样的按钮, 点击后,判断当前玩家的状态。 如果SDK是未登录状态,需要调用SDK登录接口,重新弹出登录界面。如果是已登录状态,则直接进入游戏。
注意
请不要在收到登录失败回调后,直接再次调用登录接口。 网络条件不好等异常情况下,可能会因此而循环调用登录接口, 影响体验。
- 3、 切换账号审核点
SDK带有自己的悬浮窗(用户中心),当玩家在渠道的用户中心中点击【切换账号】或【登出账号】时, SDK会通过切换账号或登出回调通知给游戏层。 游戏层收到登出回调时,需要引导玩家返回到游戏登录界面,重新调用登录接口,让玩家重新登录。
- 4、 角色数据上报审核点
游戏层需要在【创建角色成功】、【进入游戏后】、【角色等级升级】、【退出游戏(可选)】等时机,调用角色信息上报接口。 其中,角色ID、角色名称、服务器ID、服务器名称、角色等级等字段,一定不要漏传。
- 5、 隐私合规审核点
为了保证游戏引擎启动之前,玩家就已经同意了隐私协议。 一般要将隐私弹窗作为启动Activity,当玩家同意后, 再跳转到游戏主Activity。 参考如下: