集成准备
注册账号使用 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/MobPush-For-Unity
下载后，包里面如下图所示，有一个 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);#endifmobPush.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
复制代码
评论