Android 手游聚合SDK小知识(一)

Android 手游聚合SDK小知识(一)
Android 手游聚合SDK小知识(二) 聚合分包

前言

回头想想，在安卓游戏SDK这个领域，我也呆了4年了，从啥都不懂的小菜鸟，逐渐靠自己不断学习，对这个行业也算有了一些理解，趁着最近有空，我想了一下，还是把最近这几年对游戏SDK聚合的一些理解分享出来给大家，希望能和大家一起进步。PS：目前我做的聚合SDK只能适用于国内，海外谷歌包用的是aab，并且海外渠道sdk资源引用时经常不使用反射，所以海外SDK目前我还没想出来如何聚合，希望有朋友能解决这个问题分享给我。

1、渠道SDK

一个游戏需要庞大的用户量，毕竟玩的人越多，越多人充值，老板就赚得越多，你的工资奖金才能越多嘛，这时候就需要接入一些第三方渠道，让他们帮你进行有偿推广，这些第三方渠道拥有大量用户，可以帮你进行迅速的起量，让大家都去玩你的游戏。

1.1、联运渠道SDK

我们可以接入一些联运SDK渠道，使用他们的渠道来帮我们推广游戏，百度、360、应用宝，Huawei、OPPO 等，包含了最核心的登陆、支付等体系。如果接入了这些渠道，就可以使用他们的SDK服务（登陆、支付等）。
当然了，使用这些联运渠道，一般情况下都是要与对方分成的，充值的时候吊起来的是对方的充值界面，先充到对方的账户上，再进行分成，一般来说分成比例从37开到19开不等。

1.2、自有SDK渠道

如同上面说的，联运SDK需要与渠道方分成，而且分成比例极高，这个时候如果老板自己有稳定的推广渠道，就可以使用自有的SDK，说白了，自有SDK和联运渠道SDK本质上没什么区别，也拥有登录、支付等一系列体系，只不过它属于发行公司内的的SDK，使用自有的SDK就可以100%收入归自己了，但是相应的，推广的成本也要自己掏，这里就不赘述了。
内部SDK可以封装在聚合SDK中，也可以单独写成一个moudle，我这里是单独写成了一个moudle，用的时候打包成aar，和聚合sdk一起给cp接入，cp接入后就可以吊起我们自有的SDK，完成登录支付等一系列操作，后续我再将包用脚本进行渠道分包。

2、游戏研发(CP)

游戏研发也就是专门开发游戏的公司，一般称为CP。

3、聚合SDK

在游戏行业中，聚合SDK可以理解为一个中间层，一个桥梁，作用是沟通游戏CP和渠道SDK。
聚合SDK = 聚合层接口 + 渠道SDK(或者是自有SDK)
使用聚合SDK，聚合层接口不变，变得是渠道SDK，可以在游戏接入一次聚合SDK后，用脚本自动反编译回编译，替换掉渠道SDK代码，实现一包多渠道，减少CP方的工作量。

图中是游戏未接入聚合SDK的情况下，调用登录逻辑。

1. 游戏客户端调用SDK客户端的登录API进行登录，SDK客户端会拉起登录界面
2. SDK客户端在登录界面输入账密或调用第三方登录
3. SDK服务端校验登录信息成功，返回userID和token给SDK客户端
4. SDK客户端通过回调将userID和token返回给游戏客户端
5. 游戏客户端获取到token和userID后，将其传给游戏服务器端
6. 游戏服务器将数据传给SDK服务器进行校验
7. 校验通过，游戏服务器将用户的账户信息返回给游戏客户端
8. 游戏客户端登录成功

上面的步骤解释了游戏和渠道SDK的交互逻辑，理论上CP是可以直接接入SDK渠道的，但是，目前有一个问题，那就是如果有多个SDK渠道怎么办，目前国内大大小小的渠道有上百个，如果要将这上百个渠道挨个接入，这里面的工作量想必巨大无比，需要占用游戏研发非常多的工作时间，那么有没有这么一种方法，游戏研发接入一遍就可以实现完成多个sdk渠道的上架呢，这时候，聚合SDK就应运而生了。
聚合SDK只有一个，游戏研发只用接入一个聚合SDK，然后剩下都交给聚合方，由聚合方进行分包上架。
下图是加入聚合SDK后的登录逻辑：

4、聚合SDK对外接口及注意事项

1、初始化
Application 的初始化，让CP使用或继承我们的Application，我们再继承渠道方的Application。
Activity中的init方法。
2、登录
统一登录接口，接收渠道方的登录回调参数，再将登录回调参数去聚合服务器校验，通过校验后，聚合服务器返回token和userID，聚合SDK再将参数传给游戏客户端，由游戏客户端和服务器完成登录校验。

    /**
     * 登录方法
     * @param activity  上下文环境
     */
    public void login(Activity activity){
        Log.v(TAG,"进入登录");
    }

3、支付
4、注销（切换账号）
5、生命周期

   /**
     * onCreate生命周期方法
     * @param activity
     */
    public void onCreate(Activity activity, Bundle savedInstanceState){
        Log.v(TAG,"进入onCreate");
        Log.v(TAG,"onCreate执行完成");
    }



    /**
     * onResume生命周期方法
     * @param activity    之前的塔防版署包这里是context
     */
    public void onResume(Activity activity){
        Log.v(TAG,"进入onResume");
        Log.v(TAG,"onResume执行完成");
    }

    /**
     * onPause生命周期方法
     * @param activity   之前的塔防版署包这里是context
     */
    public void onPause(Activity activity){
        Log.v(TAG,"进入onPause");
        Log.v(TAG,"onPause执行完成");
    }

    /**
     * onDestroy生命周期方法
     * @param context
     */
    public void onDestroy(Context context){
        Log.v(TAG,"进入onDestroy");
        Log.v(TAG,"onDestroy执行完成");
    }

    /**
     * onRestart生命周期方法
     * @param context
     */
    public void onRestart(Context context){
        Log.v(TAG,"进入onRestart");
        Log.v(TAG,"onRestart执行完成");
    }

    /**
     * onStart生命周期方法
     * @param context
     */
    public void onStart(Context context){
        Log.v(TAG,"进入onStart");
        Log.v(TAG,"onStart执行完成");
    }


    /**
     * onStop生命周期方法
     * @param context
     */
    public void onStop(Context context){
        Log.v(TAG,"进入onStop");
        Log.v(TAG,"onStop执行完成");
    }

6、退出

    /**
     * 退出游戏弹窗
     */
    public void exitGame(Context context){
    
    }

7、数据上报

1. 创建角色
2. 角色升级
3. 进入游戏
4. 选择区服
   这些场景一般是接收游戏传递过来的数据上报到渠道或聚合sdk中，用于数据统计用

                Map map = new HashMap();
                map.put("uid", "123456");   //角色id
                map.put("server_id", "310");  //区服id
                map.put("server_name", "houruoyu333");  //区服名称
                map.put("role_id", "1225883");  //角色id
                map.put("role_name ", "houruoyu");  //角色名称
                map.put("role_level", "3");   //角色等级
                map.put("game_name", "");   //游戏名称
                map.put("role_type", "战士");  //角色职业
                map.put("vip_level", "13");   //vip等级
                map.put("game_money", "999");   //玩家拥有金币数量
                map.put("create_role_time", Long.valueOf(1616136064));  //创角时间
                map.put("level_up_role_time", Long.valueOf(1616136064));  //升级时间
                map.put("has_gold", "3000");     //补充字段

8、实名认证接口

5、聚合SDK规范

1、尽量少使用第三方开源库，避免和cp引入的依赖发生冲突
2、命名规范
聚合SDK中可能会使用string、color、布局文件等资源，如果和cp或渠道sdk发生重名会很麻烦，会导致合并资源的时候发生冲突。所以一般来说，资源等命名，都需要加上自己独特的前缀，避免冲突，例如：

<string name="houruoyu_app_online">登录</string>

如果不加上 houruoyu_作为前缀的话，很容易冲突。
3、聚合SDK中使用资源索引(R.java),会导致合包的时候资源冲突，或者缺失资源等问题。
解决方法：所有涉及到R.java资源的引用，统一使用context.getResources().getIdentifier(“资源名”, “资源类型”, “包名”);
4、回调统一
建议在初始化处，统一做回调处理，例如：

    HouruoyuSDK.getInstance().init(this, new Callback(){
        @Override
        public void onInitSuccess() {
            //初始化成功
        }
        @Override
        public void onInitFailed() {
            //初始化失败
        }
        @Override
        public void onLoginSuccess(User user) {
            //登录成功
        }

        @Override
        public void onLoginFailed(String msg) {
            //登录失败
        }

        @Override
        public void onLoginCancel() {
            //登录取消
        }
         @Override
        public void exitGame() {
            //退出游戏
        }
    });