Appearance
接入流程
WARNING
请在接入聚合SDK前，认真阅读本文档。 本文档对聚合SDK中需要接入的API以及容易遗漏的点，做了梳理。
开发要求
接入聚合SDK和接入一个普通渠道SDK的流程是类似的， 主要包含如下功能模块。 其中必选的功能模块，游戏层必须接入：
客户端
| 功能名称 | 必选/可选/无需开发 | 描述 | 接入耗时（小时） |
|---|---|---|---|
| 初始化 | SDK初始化，游戏层在初始化完成后，才能调用后续其他接口 | 0.5~1 | |
| 登录 | 母包测试时，展示的是测试渠道的登录UI；通过打包工具分包后，展示的是实际渠道SDK的登录UI | 0.5~1 | |
| 角色信息上报 | 游戏需要在玩家创建角色、进入游戏和角色等级升级时，调用角色信息上报接口，否则部分渠道会审核失败 | 0.5~1 | |
| 支付 | 母包测试时，展示的是测试渠道的模拟支付，无需实际支付金额，只模拟整个支付流程；通过打包工具分包后，展示的是实际渠道SDK的支付UI，需要实际充值才能到账 | 1~2 | |
| 退出确认弹窗 | 在玩家按手机返回键或点击游戏内【退出游戏】按钮后，需要调用聚合SDK的退出接口，实际打包后， 调用的是渠道SDK的退出接口，会弹出渠道SDK提供的退出确认弹窗，玩家同意后，才会退出游戏 | 0.5 | |
| 实名认证 | 无需开发 | 聚合SDK中，就每个渠道的实名认证做了统一接入，没有接入的，聚合SDK内部做了自动化处理，无需游戏层单独开发账号实名认证功能 | 0 |
| 防沉迷 | 无需开发 | 聚合SDK中，一般渠道SDK都自带了防沉迷功能，没有带防沉迷功能的，聚合SDK内部做了自动化处理，无需游戏层单独开发未成年防沉迷功能 | 0 |
| 隐私弹窗 | 无需开发 | 聚合SDK中，开发了内置了启动隐私弹窗，如果游戏层没有自己的隐私弹窗，可以不用开发， 在打包工具中配置隐私弹窗开关和协议URL地址即可 | 0 |
| 广告变现 | 可选 | 对于休闲游戏需要通过广告进行变现的，可以接入聚合广告API，在游戏中展示广告。然后需要在聚合SDK后台-》广告管理中，为每个渠道配置广告平台。一般不同渠道对广告平台有自己的要求，比如上架OPPO，需要用OPPO广告；上架华为，需要用华为广告等 | 1~2 |
| 统计埋点 | 可选 | 聚合SDK中，接入了不少统计SDK和买量上报SDK，比如头条、腾讯、快手、热云等，如果游戏层需要这些功能，可以在打包工具插件配置中，开启对应插件并配置参数。 游戏层需要接入买量统计API | 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、 退出确认弹窗审核点
游戏在手机返回键的事件监听中，需要调用聚合SDK的退出游戏接口。 实际打包后， 会调用渠道SDK的退出游戏接口， 会弹出渠道SDK提供的退出确认对话框。 没有这个会导致很多渠道审核失败。
- 6、 隐私合规审核点
Android平台， 为了保证游戏引擎启动之前，玩家就已经同意了隐私协议。 一般要将隐私弹窗作为启动Activity，当玩家同意后， 再跳转到游戏主Activity。
游戏需要严格按照U8SDK的隐私合规指南中的建议， 在游戏隐私内容中，附加U8SDK相关SDK产品的隐私协议声明和链接：
U8SDK
涉及个人信息：无
使用目的：无
使用场景：无
公司主体名称：上海丞诺网络科技有限公司
收集方式：无
官网链接：https://www.u8sdk.com
隐私政策：http://www.u8sdk.com/privacy/xsdk_privacy.html
U8官网SDK（XSDK）
涉及个人信息：系统版本、AndroidID、 IMEI、 OAID、 IDFA、设备型号、分辨率、陀螺仪传感器、手机号（仅玩家用手机号注册账号时获取）、实名信息（玩家主动提交）、付费记录（玩家付费后记录用于核查支付是否正常）、社交账号（玩家主动绑定）
使用目的：用于识别设备信息以及判断设备是否为模拟器，以及玩家手机号、社交账号登录等功能
使用场景：用户进入游戏以及登录XSDK时使用
公司主体名称：上海丞诺网络科技有限公司
收集方式：SDK采集
官网链接：https://www.u8sdk.com
隐私政策：http://www.u8sdk.com/privacy/xsdk_privacy.html
U8聚合广告SDK（U8Ad）
涉及个人信息：无
使用目的：无
使用场景：无
公司主体名称：上海丞诺网络科技有限公司
收集方式：SDK采集
官网链接：https://www.u8sdk.com
隐私政策：http://www.u8sdk.com/privacy/xsdk_privacy.html
如果游戏层没有自己的隐私协议处理，或者不合规范，也可以在U8聚合SDK打包工具中，开启隐私协议弹窗并配置隐私协议URL：
