接入 Android

前置条件

• 创建应用并下载配置文件。

  详情请参考 扫码测试适配。

• 添加小程序小游戏 SDK 前，请确保已经接入工程到 mPaaS。详情请参考 将 mPaaS 添加到您的项目中。

安装组件和依赖

申请游戏依赖的 mPaaS 内核 key

申请游戏依赖的 mPaaS 内核 key 请参考 接入 mPaaS 内核。

修改 app 下的 build.gradle

增加依赖和 configuration。

android {
    ...


    configurations {
        all*.exclude group: 'com.mpaas.mriver', module: 'mriveruc-build' // 移除
        all*.exclude module: 'nebulaucsdk-build'
    }

}

dependencies {
    ...
    implementation platform("com.mpaas.android:$mpaas_artifact:$mpaas_baseline")
    implementation 'com.mpaas.android:minigame' // 小游戏
}

初始化 mPaaS

在使用 mPaaS 框架前需要进行一些初始化操作对 Application 对象进行改造。由于是否使用热修复功能会采取不同的初始化内容，因此本文将根据是否使用热修复功能分别向您介绍相应的初始化操作。

不使用热修复功能

不使用 热修复 功能时，只需在 Application 中添加如下代码：

@Override
public void onCreate() {
    super.onCreate();
    
    MP.init(
      this,
      MPInitParam.obtain().setCallback(new MPInitParam.MPCallback() {
        @Override
        public void onInit() {
            Log.d("TAG", "mPaaS Init finish");
        }
      })
    );
}

使用热修复功能

使用 热修复 功能时，需要完成以下操作。

操作步骤

1. 使 Application 对象重新继承 QuinoxlessApplicationLike，并注意将此类防混淆。此处以 “MyApplication”为例。

    @Keep
    public class MyApplication extends QuinoxlessApplicationLike implements Application.ActivityLifecycleCallbacks {
   
     private static final String TAG = "MyApplication";
   
     @Override
     protected void attachBaseContext(Context base) {
         super.attachBaseContext(base);
   
         Log.i(TAG, "attacheBaseContext");
   
     }
   
     @Override
     public void onCreate() {
         super.onCreate();
         Log.i(TAG, "onCreate");
         registerActivityLifecycleCallbacks(this);
     }
   
     @Override
     public void onMPaaSFrameworkInitFinished() {
         LoggerFactory.getTraceLogger().info(TAG, getProcessName());
     }
   
     @Override
     public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
         Log.i(TAG, "onActivityCreated");
     }
   
     @Override
     public void onActivityStarted(Activity activity) {
   
     }
   
     @Override
     public void onActivityResumed(Activity activity) {
   
     }
   
     @Override
     public void onActivityPaused(Activity activity) {
   
     }
   
     @Override
     public void onActivityStopped(Activity activity) {
   
     }
   
     @Override
     public void onActivitySaveInstanceState(Activity activity, Bundle outState) {
   
     }
   
     @Override
     public void onActivityDestroyed(Activity activity) {
   
     }}

2. 在 AndroidManifest.xml 文件中将 Application 对象指向 mPaaS 提供的 Application 对象。 将生成的 “MyApplication” 类添加到 key 为 mpaas.quinoxless.extern.application 的 meta-data 中。示例如下：

    <application
    android:name="com.alipay.mobile.framework.quinoxless.QuinoxlessApplication" >
    <meta-data
             android:name="mpaas.quinoxless.extern.application"
             android:value="com.mpaas.demo.MyApplication"
             />
    </application>

3. 引入 Apache HTTP 客户端。

   在使用 RPC 或者热修复功能的时候，需要调用到 Apache HTTP 客户端相关的功能。只需在 AndroidManifest.xml 加入如下代码。更多信息，请参见 使用 Apache HTTP 客户端。

   <uses-library android:name="org.apache.http.legacy" android:required="false"/>

import android.app.Application;
import android.util.Log;
import com.mpaas.core.MP;
import com.mpaas.core.MPInitParam;
import com.mpaas.mas.adapter.api.MPLogger;
import com.mpaas.mriver.api.init.MriverInitParam;
import com.mpaas.mriver.nebula.api.uc.MRUCInitCallback;
import com.mpaas.mriver.nebula.api.uc.MRUCService;
import com.mpaas.mriver.xriver.XRiver;
import com.mpaas.uc.dynamic.api.MPUCDynamicInit;

public class MRiverApp extends Application implements MPInitParam.MPCallback{

    private static final String TAG = "MRiverApp";

    @Override
    public void onCreate() {
        super.onCreate();
        MP.init(this, createInitParams());
    }

    @Override
    public void onInit() {
        MPLogger.setUserId("xxxx"); // 设置userId，用来白名单灰度、IDE扫码预览使用
    }

    MPInitParam createInitParams() {
        final MriverInitParam mriverInitParam = MriverInitParam.getDefault();
        mriverInitParam.setMriverInitCallback(new MriverInitParam.MriverInitCallback() {
            @Override
            public void onInit() {
                XRiver.init();
            }

            @Override
            public void onError(Exception e) {
            }
        });
        return MPInitParam.obtain().setCallback(this).addComponentInitParam(mriverInitParam);
    }


}

//初始化完成时
Mriver.setProxy(MRGameRpcProxy.class, new MRGameRpcProxy() {
            @Override
            public boolean rpc(String s, Object o, JSONObject jsonObject, App app, Page page, int i, String s1, boolean b, BridgeCallback bridgeCallback) {
                if (!TextUtils.isEmpty(s) && s.contains("querygamedefaultad")) {
                    JSONObject data = new JSONObject();
                    data.put("success", false);
                    bridgeCallback.sendJSONResponse(data);
                }

                return true;
            }
        });

XRiver.startApp("appId"); // appId表示后台发布的游戏id

账号授权

Mriver.setProxy(RVOpenAuthProxy.class, new RVOpenAuthProxy() {
            @Override
            public void getAuthAccountInfo(Context context, List<String> list, String s, boolean b, Page page, IAuthCallback iAuthCallback) {
                // ignore
                iAuthCallback.onSuccess(BridgeResponse.SUCCESS.get());
            }

            @Override
            public void auth(Context context, Page page, String sessionId, List<String> scope, Map<String, String> map, boolean b, Bundle bundle, IAuthCallback iAuthCallback) {
                // handle authCode request
                // auth_base表示静默授权，不会弹申请窗；auth_user会弹出申请弹窗
                if (scope != null && (scope.contains("auth_user") || scope.contains("auth_base")) && page.getApp() != null) {
                    String appId = page.getApp().getAppId();
                    
                    // 从App服务端获取authCode/openId
                    String authCode = requestAuthCodeFromSuperAppServer(appId);
                    String openId = requestOpenIdFromSuperAppServer(appId);
                    
                    if (!TextUtils.isEmpty(authCode)) {
                        JSONObject jsonObject = new JSONObject();
                        jsonObject.put("authCode", authCode);
                        jsonObject.put("openId", openId); // 返回openId
                        iAuthCallback.onSuccess(jsonObject); // callback to miniprogram
                    } else {
                        iAuthCallback.onFail(-1, "auth code request err");
                    }
                }
            }

            @Override
            public boolean appxRpc(JSONObject jsonObject, BridgeCallback bridgeCallback) {
                // ignore
                bridgeCallback.sendJSONResponse(BridgeResponse.SUCCESS.get());
                return true;
            }
        });

广告

方式一

内置穿山甲模式，只需配置广告位。注册获取广告信息的接口，注入广告数据。

Mriver.setProxy(MRGameAdProxy.class, new MRGameAdProxy() {
    /**
    * appId: 小游戏id
    * adType: 广告类型： 0 激励视频广告； 1 banner广告； 2 插屏/全屏广告
    **/
    @Override
    public void getGameAdInfo(String appId, App app, int adType, GameAdInfoCallback callback) {
        Map<String, String> adInfo = new HashMap();
        if (adType == 1) {
          adInfo.put("code", "xxx"); // 添加广告位信息
        } else {
        }
        if (callback != null) {
          callback.onCallback(adInfo);
        }
    }
});

方式二

自定义广告显示。

 Mriver.setProxy(MiniAdShowProxy.class, new MiniAdShowProxy() {
            @Override
            public void showAd(String s, Page page, int i, MiniGameAdShowCallback miniGameAdShowCallback) {
                
            }
        });

数据埋点监听

初始化时设置数据埋点监听。

Mriver.setProxy(PaladinGameTracker.class, new PaladinGameTracker() {

            @Override
            public void gamePageAppear(Activity activity, String appId, String subPageToken, String channelInfo) {
                // 游戏第一次打开或者页面从后台切换到前台
                Log.i(TAG, "gamePageAppear: " + appId);
            }

            @Override
            public void gamePageDisappear(Activity activity, String appId, String subPageToken, String channelInfo) {
                // 游戏退出或者切换到后台
                Log.i(TAG, "gamePageDisappear: " + appId);
            }
        });