目的
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 MainActivity extends UnityPlayerActivity {//1、注意修改集成的类,改成UnityPlayerActivity
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
getInstall();//个性化安装
OpenInstall.getWakeUp(getIntent(), wakeUpAdapter);//获取唤醒参数
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
OpenInstall.getWakeUp(intent, wakeUpAdapter);
}
AppWakeUpAdapter wakeUpAdapter =new AppWakeUpAdapter() {
@Override
public void onWakeUp(final AppData appData) {
//获取渠道数据
String channelCode = appData.getChannel();
//获取绑定数据
String bindData = appData.getData();
//回调数据 控件对象名称,脚本方法,返回的数据
UnityPlayer.UnitySendMessage("Main Camera","wakeup","data="+bindData+";channelCode="+channelCode);
}
};
/**
* 在APP需要个性化安装参数时(由web网页中传递过来的,如邀请码、游戏房间号等自定义参数)
* 调用OpenInstall.getInstall方法,在回调中获取参数(可重复获取)
* 适用于免填邀请码安装,自动加好友,渠道统计等安装来源追踪的解决方案
*/
public static void getInstall() {
//获取OpenInstall数据,去掉外层的if判断就可以重复多次调用,推荐每次需要的时候调用,而不是自己保存数据
OpenInstall.getInstall(new AppInstallListener() {
@Override
public void onInstallFinish(AppData appData, Error error) {
Log.d("OpenInstall ", "InstallFinish");
if (error == null) {
//根据自己的业务处理返回的数据
String data = appData.getData();
String channelCode = appData.getChannel();
//回调数据 对象名称,脚本方法,返回的数据
UnityPlayer.UnitySendMessage("Main Camera","install","data="+data+";channelCode="+channelCode);
}else {
Log.e("MainActivity", "errorMsg : " + error.toString());
}
}
});
}
public static void reportEffectPoint(String effectName,int effectID){
OpenInstall.reportEffectPoint(effectName,effectID);
}
public static void reportRegister(){
OpenInstall.reportRegister();
}
@Override
protected void onDestroy() {
super.onDestroy();
wakeUpAdapter =null;
}
}
4.自定义Application类 APP继承Application并初始化
5. 修改AndroidManifest.xml
在AndroidManifest.xml中添加权限声明,设置AppKey,配置scheme
在AndroidManifest.xml中的application标签中添加 android:name=".App"指定自定义的Application类,以便程序启动的时候初始化自定义Application类,而不是系统默认的Application类
6. 修改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中使用
Unity中调用
Unity新建一个工程,设置jdk,安卓的SDK。
然后在Assets目录下新建我们需要的目录,Assets\Plugins\Android,并把AndroidManifest.xml放到里面。
然后在Assets目录下新建我们需要的目录,Assets\Plugins\Android\libs,并把aar包下的classes.jar和openinstall_vx.x.x.jar放到里面。
Unity调用android方法
新建脚本AndroidNative.cs调用android方法(反射机制获取android方法)
根据自己的业务需求调用方法,如
public class Main : MonoBehaviour {
public Text txtWakeup;
public Text txtInstall;
AndroidJavaClass jc;
AndroidJavaObject jo;
void Start()
{
txtWakeup = GameObject.Find("Canvas/txtWakeup").GetComponent();
txtInstall = GameObject.Find("Canvas/txtInstall").GetComponent();
jc =new AndroidJavaClass("com.unity3d.player.UnityPlayer");
jo = jc.GetStatic("currentActivity");
jo.CallStatic("getInstall");
txtWakeup.text ="唤醒参数";
txtInstall.text ="安装参数";
Button register = GameObject.Find("Register").GetComponent();
Button effect = GameObject.Find("Effect").GetComponent();
//注册按钮的点击事件
register.onClick.AddListener(delegate () {
this.Btn_Register();
});
//注册按钮的点击事件
effect.onClick.AddListener(delegate () {
this.Btn_Effect();
});
}
void Btn_Register()
{
jo.CallStatic("reportRegister"); //上报注册统计
}
void Btn_Effect()
{
jo.CallStatic("reportEffectPoint", "effect_test",100); //上报效果点
}
//接收Android回调的数据 wakeup方法
void wakeup(string str){
txtWakeup.text = str;
}
//接收Android回调的数据,install方法
void install(string str){
txtInstall.text = str;
}
}
打包上传安装包到openinstall后台测试:
上传apk安装包后,可先使用openinstall提供的在线测试功能,确保app安装后能正确还原输入的动态参数,能正常的拉起App。
注意:拿到openinstall回调数据后,具体的业务还根据自身的处理!
demo下载地址:https://github.com/AnneCR/unity-openinstall/tree/master