集成筹备
注册账号应用MobSDK之前,须要先在MobTech官网注册开发者账号,并获取MobTech提供的AppKey和AppSecret,详情能够点击查看注册流程
下载MobPush对应的.unitypackage包
关上 Github 下载 MobPush-For-Unity 我的项目,下载实现后间接双击或者在Unity外面抉择关上 MobPush.unitypackage,导入相干资源和脚本到您的 Unity我的项目即可应用。
集成
注:MobPush For Unity我的项目对应的Android插件局部,应用的是gradle编译形式,因为gradle编译形式在Unity2017及以上版本能力很好地反对并且兼容,强烈建议宽广开发者应用Unity2017及以上的版本进行开发,Unity2017以下版本集成略微麻烦一丢丢;
所以集成外围局部分成:
(1)新版Unity集成形式(Unity2017及以上的版本)
(2)旧版Unity集成形式注意事项(应用Unity2017版本以下开发的必看)
Unity集成形式(倡议)
要害文件:mainTemplate.gradle和proguard-user.txt
1、Unity2017及以上版本,在Build Settings > Player Settings上面,有两个开关,新建我的项目的话关上这两个开关就能够在Plugins>Android生成对应的两个文件;因为这两个文件MobPush都有间接提供,只需导入.unitypackage就好,Unity检测到曾经存在这两个文件,主动会更新为勾选状态;
2、Build的时候有一个Build System选项,此选项默认抉择的Internal,切记要改成抉择外面的gradle选项(重要)
3、图中所示的mainTemplate.gradle文件,即为集成的外围文件,应用编辑器关上此文件,要点内容如下:
此处为辨别Unity5.6和Unity2017 gradle插件版本的中央,开发时用到哪个版本就应用哪个,若应用到其余Unity版本,请随便抉择一个,而后build,编译的时候会报错的,Console控制台信息报错时会提醒插件版本是多少,依据提醒批改成须要的版本就好(只批改前面的数字,比方:2.3.0或者2.1.0)
buildscript {
repositories {
// 配置Mob Maven库
maven {
url "https://mvn.mob.com/android"
}
// 配置HMS Core SDK的Maven仓地址。(集成华为厂商须要增加)
maven {
url 'https://developer.huawei.com/repo/'}
}
...
}
dependencies {
classpath 'com.android.tools.build:gradle:2.3.0'//Unity2017
//classpath 'com.android.tools.build:gradle:2.1.0'//Unity5.6
// 注册MobSDK
classpath "com.mob.sdk:MobSDK:2018.0319.1724"
}
}
此处为集成MobPush须要配置的信息
// 增加插件
apply plugin: 'com.mob.sdk'
// 在MobSDK的扩大中注册MobPush的相干信息
MobSDK {
appKey "替换为MobTech官网申请的appkey"
appSecret "替换为MobTech官网申请的appkey对应的appSecret"
MobPush {
//集成其余推送通道(可选)
devInfo {
//华为推送配置信息
HUAWEI{
appId "华为的appid"
}
//魅族推送配置信息
MEIZU{
appId "魅族的appid"
appKey "魅族的appkey"
}
//小米推送配置信息
XIAOMI{
appId "小米的appid"
appKey "小米的appkey"
}
//FCM推送通道配置
FCM{
//设置默认推送告诉显示图标
iconRes "@mipmap/ic_launcher"
}
}
}
此处为配置签名文件和签名文件的别名和明码(正式公布apk须要的签名文件),能够写绝对路径,也能够写相对路径,相对路径应用”..\”跳出一层目录,跳出多层则间断拼接
signingConfigs {
release {
keyAlias 'demokey.keystore'
keyPassword '123456'
storeFile file('F:\\Unitydemo(CJY)\\MobPushForUnity\\Assets\\Plugins\\Android\\demokey.keystore')
storePassword '123456'
}
}
此处为混同文件的配置,也就是MobPush提供的proguard-user.txt文件,此文件内容不须要更改,依照提供的即可, 如本人代码须要额定减少混同逻辑,可自行减少混同规定,如果是Unity2017以下版本,请把正文的代码调换一下即可; (minifyEnabled属性为是否开启代码混同:true为开启混同,false为敞开)
buildTypes {
release {
minifyEnabled true// 是否混同
//shrinkResources false// 是否去除有效的资源文件
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-user.txt' //Unity2017及以上
//proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-unity.txt' //Unity2017以下
signingConfig signingConfigs.release
}
debug {
minifyEnabled false
signingConfig signingConfigs.release
}
}
4、挂载MobPush.cs脚本到须要应用的场景上,此时便能够调用推送的各个接口;
旧版Unity集成形式注意事项
1、因为Unity2017以下的版本在setting上面并不反对间接生成mainTemplate.gradle和proguard-user.txt,然而能够读取到mainTemplate.gradle文件,所以mainTemplate.gradle文件能够间接应用MobPush提供的;
2、而后混同文件须要去Unity的装置目录上面的Editor\Data\PlaybackEngines\AndroidPlayer\Tools (Windows)门路上面,找到UnityProGuardTemplate.txt文件,这个文件就是Unity在编译gardle的时候主动替换的混同文件;
3、把MobPush提供的proguard-user.txt文件外面的内容复制到UnityProGuardTemplate.txt文件外面,就能够了
注:
UnityProGuardTemplate.txt是在每个用到gradle编译的Unity我的项目都会去寻找的混同文件,审慎批改留神:集成FCM除了在MobSDK.gradle中配置之外,还须要如下操作:(如果不集成FCM的配置能够跳过此步骤)
1、到官网去下载json,如下所示:https://firebase.google.com/docs/cloud-messaging/?hl=zh-cn
2、登录进入后,跳转到如下截图:
https://github.com/MobClub/Mo…
下载后,包外面如下图所示,有一个exe的工具,将下载的json放到app文件夹下,点击exe工具生成,会发现生成了一个res文件夹;
3、将生成的res文件夹放到本人的我的项目中去,如demo中所示:
设置隐衷受权回调
为保障您的App在集成MobSDK之后可能满足工信部相干合规要求,您应确保App装置首次冷启动且获得用户浏览您《隐衷政策》受权之后,调用Mob提交到的隐衷协定回传函数uploadPrivacyPermissionStatus回传隐衷协定受权后果。 反之,如果用户不批准您App《隐衷政策》受权,则不能调用uploadPrivacyPermissionStatus回传隐衷协定受权后果。 详情参考:合规指南
//隐衷受权接口调用
mobPush.updatePrivacyPermissionStatus(true);
推送接口
初始化和绑定监听 public MobPush mobPush;
void Start ()
{
mobPush = gameObject.GetComponent();//初始化MobPush
mobPush.onNotifyCallback = OnNitifyHandler;//音讯回调监听
mobPush.onTagsCallback = OnTagsHandler;//标签解决回调监听
mobPush.onAliasCallback = OnAliasHandler;//别名解决回调监听
mobPush.onDemoReqCallback = OnDemoReqHandler;//demo申请接口回调(为了不便测试,提供在客户端发送告诉的接口,仅供测试时应用)
mobPush.onRegIdCallback = OnRegIdHandler;//获取注册ID异步监听回调接口
}
void OnNitifyHandler (int action, Hashtable resulte)
{
Debug.Log ("OnNitifyHandler");
if (action == ResponseState.CoutomMessage)
{
Debug.Log ("CoutomMessage:" + MiniJSON.jsonEncode(resulte));
}
else if (action == ResponseState.MessageRecvice)
{
Debug.Log ("MessageRecvice:" + MiniJSON.jsonEncode(resulte));
}
else if (action == ResponseState.MessageOpened)
{
Debug.Log ("MessageOpened:" + MiniJSON.jsonEncode(resulte));
}
}
void OnTagsHandler (int action, string[] tags, int operation, int errorCode)
{
Debug.Log ("OnTagsHandler action:" + action + " tags:" + String.Join (",", tags) + " operation:" + operation + "errorCode:" + errorCode);
}
void OnAliasHandler (int action, string alias, int operation, int errorCode)
{
Debug.Log ("OnAliasHandler action:" + action + " alias:" + alias + " operation:" + operation + "errorCode:" + errorCode);
}
void OnRegIdHandler (string regId)
{
Debug.Log ("OnRegIdHandler-regId:" + regId);
}
void OnDemoReqHandler (bool isSuccess)
{
Debug.Log ("OnDemoReqHandler:" + isSuccess);
}
其它各种接口阐明: 发送本地告诉,自定义本地告诉款式
LocalNotifyStyle style = new
LocalNotifyStyle ();
style.setContent ("Text");
style.setTitle ("title");
#if UNITY_ANDROID
Hashtable extras = new Hashtable ();
extras["key1"] = "value1";
extras["key2"] = "value1";
style.setExtras (extras);
#endif
mobPush.setMobPushLocalNotification (style);
自定义告诉栏款式
CustomNotifyStyle style = new CustomNotifyStyle ();
#if UNITY_IPHONE
style.setType(CustomNotifyStyle.AuthorizationType.Badge | CustomNotifyStyle.AuthorizationType.Sound | CustomNotifyStyle.AuthorizationType.Alert);
#elif UNITY_ANDROID
style.setContent ("Content");
style.setTitle ("Title");
style.setTickerText ("TickerText");
#endif
mobPush.setCustomNotification(style);
获取注册ID (getRegistrationId)mobPush.getRegistrationId();
增加标签 (addTags)
String[] tags = { "tags1", "tags2", "tags3" };
mobPush.addTags(tags);
获取标签 (getTags)mobPush.getTags();
删除标签 (deleteTags)
String[] tags = { "tags1", "tags2", "tags3" };
mobPush.deleteTags(tags);
革除全副标签 (cleanAllTags )mobPush.cleanAllTags();
增加别名 (addAlias)mobPush.addAlias("alias");
获取别名 (getAlias)mobPush.getAlias();
革除全副别名 (cleanAllAlias)
`mobPush.cleanAllAlias();
`
进行告诉服务 (stopPush)mobPush.stopPush();
重启告诉服务 (restartPush)mobPush.restartPush();
判断告诉是否被进行,返回值:bool类型(isPushStopped)mobPush.isPushStopped();
点击告诉后是否关上利用首页,默认为关上
mobPush.setClickNotificationToLaunchPage(false);
**增加混同配置
为了避免二次混同MobPush,须要在我的项目混同文件中增加:
`-keep class com.mob.{*;}
-dontwarn com.mob.**`
如果同时集成了华为、小米、魅族等渠道推送,同时也须要在我的项目中增加防二次混同配置:
-keep class com.huawei.**{*;}
-keep class com.meizu.**{*;}
-keep class com.xiaomi.**{*;}
-keep class android.os.SystemProperties
发表回复