Skip to content

接入流程

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。 参考如下:

隐私协议弹窗

版权所有© 2021-2030 上海丞诺网络科技有限公司