unity集成openinstall流程

涯柔
734 阅读4分钟

目的

1、Unity集成openinstall sdk？

最近在使用一个叫openinstall的SDK，通过它实现免填邀请码的功能，集成到unity游戏开发中。对App安装流程的优化，尤其是免填写邀请码安装，App推广的有奖邀请活动更大程度的达到推广爆炸式的效果。

在分享链接自定义各种动态参数（如推广渠道号，邀请码，游戏房间号，用户id等等）。通过在分享链接url中附带app邀请人的用户id，就可达到免填邀请码的效果;或者app通过在url中附带游戏房间号实现直达游戏房间也可建立上下级关系；unity开发中免不了邀请用户获得奖励；新老用户直达游戏场景；从各种浏览器一键拉起游戏场景等等；

那么如何在unity集成openinstall呢？话不多说，上图吧~ 哈哈

2、注册/登录openinstall开发者平台http://developer.openinstall.io/并创建应用

先在AndroidStudio中工作

  1. 新建工程

    只需要注意，AndroidStudio（以下简称AS）中新建项目的包名和Unity发布安卓时候设置的包名要一致。

2.导入jar包

  将Unity路径下的接口classes.jar导入到AS的libs目录下，然后sync一下项目。接口包所在地：(E:\ProgramFiles\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jar)

同样的,到openinstall官网去下载openinstall_vx.x.x.jar放到AS的libs目录下，sync一下项目

3.编写MainActivity代码

编写MainActivity继承自UnityPlayerActivity

public class MainActivityextends UnityPlayerActivity {//1、注意修改集成的类，改成UnityPlayerActivity

@Override

protected void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    //setContentView(R.layout.activity_main);  //2、去掉这一行

    OpenInstall.getWakeUp(getIntent(), wakeUpAdapter);//获取唤醒参数

    getInstall();//个性化安装

}

@Override

protected void onNewIntent(Intent intent) {

    super.onNewIntent(intent);

    // 此处要调用，否则App在后台运行时，会无法截获

    OpenInstall.getWakeUp(getIntent(), wakeUpAdapter);

}

@Override

protected void onDestroy() {

    super.onDestroy();

    wakeUpAdapter =null;

}


/**
 * 在APP需要个性化安装参数时（由web网页中传递过来的，如邀请码、游戏房间号等自定义参数）
 * 调用OpenInstall.getInstall方法，在回调中获取参数（可重复获取）
 * 适用于免填邀请码安装，自动加好友，渠道统计等安装来源追踪的解决方案
 */
private void getInstall() {
    final SharedPreferences sp = getSharedPreferences("unitydemo", MODE_PRIVATE);
    boolean isInstall = sp.getBoolean("unityFirst", true);
    //是否需要多次调用getInstall获取参数
    Log.d("openinstall", "getInstall");
    //获取OpenInstall数据，去掉外层的if判断就可以重复多次调用，推荐每次需要的时候调用，而不是自己保存数据
    if (isInstall) {
        OpenInstall.getInstall(new AppInstallListener() {
            @Override
            public void onInstallFinish(AppData appData, Error error) {
                Log.d("OpenInstall ", "InstallFinish");
                if (error == null) {
                    //根据自己的业务处理返回的数据
                    // 此处保存到本地，方便给unity调用
                    sp.edit().putString("unityinstall", appData.toString()).apply();
                    //使用数据后，不想再调用，将unityFirst设置为false
                    sp.edit().putBoolean("unityFirst", false).apply();
                    Toast.makeText(MainActivity.this, "getInstall:" + appData.toString(), Toast.LENGTH_SHORT).show();
                    Log.d("getInstall:", "" + appData.toString());
                } else {
                    Log.e("MainActivity", "errorMsg : " + error.toString());
                }
            }
        });
    }
}

AppWakeUpAdapter wakeUpAdapter = new AppWakeUpAdapter() { @Override public void onWakeUp(final AppData appData) { //获取渠道数据 String channelCode = appData.getChannel(); //获取绑定数据 String bindData = appData.getData(); Log.d("OpenInstall", "getWakeUp : wakeupData = " + appData.toString());

        //根据自己的业务处理返回的数据
        // 此处保存到本地，方便给unity调用
        final SharedPreferences sp = getSharedPreferences("unitydemo", MODE_PRIVATE);
        sp.edit().putString("unitywakeup", appData.toString()).apply();
    }
};

/** * 添加一个方法用于给unity调用 */ public String ShowWakeup() { final SharedPreferences sp = getSharedPreferences("unitydemo", MODE_PRIVATE); return sp.getString("unitywakeup", null); }

public String ShowInstall() {
    final SharedPreferences sp = getSharedPreferences("unitydemo", MODE_PRIVATE);
    return sp.getString("unityinstall", null);
}

public void reportRegister() {
    /*
    如需统计每个渠道的注册量（对评估渠道质量很重要），
    可根据自身的业务规则，在确保用户完成app注册的情况下，调用OpenInstall.reportRegister()上报注册量。
    */
    OpenInstall.reportRegister();
    Log.d("Openinstall ", "success");

}

4.自定义Application类 APP继承Application并初始化

  1. 修改AndroidManifest.xml

在AndroidManifest.xml中添加权限声明，设置AppKey，配置scheme

配置AndroidManifest.xml 在AndroidManifest.xml中的application标签中添加 android:name=".App"指定自定义的Application类，以便程序启动的时候初始化自定义Application类，而不是系统默认的Application类

自定义APP 6. 修改build.gradle

修改build.gradle 7.生产arr包

Build->Build APK成功会在app\build\outputs\aar目录下出现一个app-debug.aar包(此处是debug包),然后用解压软件打开这个包，删掉libs下的classes.jar(没错，就是之前重unity中拷过来的) 因为unity打包时会重新把自带的classes.jar打进去，如果不删掉它会打包报错，冲突然后这就是最终需要的aar包，把aar包解压缩，看到classes.jar(此处的classes.jar是项目build出来的，不等同于AS中libs文件中的classes.jar)，把aar包下的classes.jar和AndroidManifest.xml都放在一个地方等待在unity中使用

成功导出arr包并解压出classes.jar
Unity中调用

Unity新建一个工程，设置jdk，安卓的SDK。

设置SDK，JDK 然后在Assets目录下新建我们需要的目录，Assets\Plugins\Android，并把AndroidManifest.xml放到里面。

导入AndroidManifest.xml
然后在Assets目录下新建我们需要的目录，Assets\Plugins\Android\libs，并把aar包下的classes.jar和openinstall_vx.x.x.jar放到里面。

放置jar Unity调用android方法

新建脚本AndroidNative.cs调用android方法（反射机制获取android方法）

根据自己的业务需求调用方法，如

AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");

AndroidJavaObject jo = jc.GetStatic("currentActivity"); string data =jo.Call("ShowWakeup"); 打包上传安装包到openinstall后台测试：

上传安装包 上传apk安装包后，可先使用openinstall提供的在线测试功能，确保app安装后能正确还原输入的动态参数，能正常的拉起App。

测试 注意:拿到openinstall回调数据后，具体的业务可具体处理！

avatar
文章
阅读
粉丝