Appearance
接入流程
WARNING
注意:: 接入后保证功能测试正常后,再提交上架审核。
开发要求
接入UGSDK和接入一个普通渠道SDK的流程是类似的, 主要包含如下功能模块。 其中必选的功能模块,游戏层必须接入:
客户端
| 功能名称 | 必选/可选/无需开发 | 描述 | 接入耗时(小时) |
|---|---|---|---|
| 初始化 | SDK初始化,游戏层在初始化完成后,才能调用后续其他接口 | 0.5~1 | |
| 登录 | 游戏根据运营需求,在SDK后台开启对应的登录入口 | 0.5~1 | |
| 切换账号/登出回调 | 玩家在SDK用户中心中点击切换账号或登出时,SDK会触发登出回调,游戏层收到该回调时,需要引导玩家返回到游戏登录界面,重新调用登录接口 | 0.5~1 | |
| 角色信息上报 | 游戏需要在玩家创建角色、进入游戏和角色等级升级时,调用角色信息上报接口,SDK后台可以查询角色信息 | 0.5~1 | |
| 支付 | SDK后台需要开启Google/AppStore支付通道,配置好参数,才能对接和测试 | 1~2 | |
| 生命周期函数 | 在Activity/AppDelegate中调用SDK的生命周期函数 | 0.5 | |
| 登出 | 可选 | 玩家在游戏内登出时,可以先调用SDK登出接口 | 0.5~1 |
| 用户中心 | 可选 | 打开SDK的用户中心界面 | 0.5 |
| 账号注销 | 可选 | 直接调用SDK的账号注销接口,让玩家删除账号 | 0.5 |
| 统计埋点 | 可选 | SDK中,接入了不少统计SDK和买量上报SDK,比如Appsflyer、Adjust和firebase等,SDK内置了一些埋点上报,比如初始化、注册登录、支付等,如果游戏有特殊需求,可以调用上报接口 | 0.5~1 |
服务端
| 功能名称 | 必选/可选 | 描述 | 接入耗时(小时) |
|---|---|---|---|
| 登录校验 | 客户端登录成功后,SDK会返回uid,token等参数,游戏客户端需要将这些参数,上报给游戏服务器,游戏服务器来SDK服务器验证token合法性。验证成功后,才能允许玩家进入游戏。 | 1~2 | |
| 支付回调通知 | 玩家支付完成后,支付平台会通知给SDK服务端。SDK服务端,会通知给游戏服务器, 游戏服务器在验证签名合法、商品金额无误、角色无误后,给玩家发货 | 1~2 |
上架注意点
下面是常见的一些游戏层在首次接入过程中,容易忽视的地方。 请游戏开发者在接入SDK之前,就做到心中有数, 提前做好处理。
- 1、 TargetSdkVersion
Google Play上架现在要求包体的targetSdkVersion为35+。
- 2、 iOS登录
AppStore要求如果含有第三方登录时,也必须包含Apple登录。 如果游戏开启了Google、Facebook等三方登录,iOS平台请务必将Apple登录也开启。
注意
审核时,也不要反复开关隐藏界面UI元素,否则可能会导致iOS审核失败。
- 3、 基准货币
在Google Play或AppStore后台添加商品时,基准货币无特殊需求,可以统一使用USD(和SDK后台一致)。
- 4、 角色数据上报
游戏层需要在【创建角色成功】、【进入游戏后】、【角色等级升级】、【退出游戏(可选)】等时机,调用角色信息上报接口。 其中,角色ID、角色名称、服务器ID、服务器名称、角色等级等字段,一定不要漏传。
- 5、 隐私弹窗
海外目前政策并没有强制要求游戏启动时有隐私弹窗, 直接在Google Play或AppStore后台配置隐私链接即可。 SDK后台可以将隐私弹窗关闭。