推送MobPush-API说明

1. 消息监听接口

MobPushReceiver:消息监听接口(包含接收自定义消息、通知消息、通知栏点击事件、别名和标签变更操作等)

MobPush.addPushReceiver(MobPushReceiver

receiver): 设置消息监听

MobPush.removePushReceiver(MobPushReceiver

receiver): 移除消息监听

2. 推送开关控制接口

MobPush.stopPush():停止推送(停止后将不会收到推送消息,仅可通过restartPush重新打开)

MobPush.restartPush():重新打开推送服务

MobPush.isPushStopped():判断推送服务是否已经停止

3. 推送选项接口

MobPush.setSilenceTime(int

startHour, int startMinute, int endHour, int endMinute): 设置通知静音时段(开始时间小时和分钟、结束时间小时和分钟)

MobPush.setCustomNotification(MobPushCustomNotification

customNotification): 设置自定义通知样式

4. 业务接口

MobPush.getRegistrationId(MobPushCallback<String>

callback):获取注册id(可与用户id绑定,实现向指定用户推送消息)

别名操作:(同时只能设置一个别名,可用来标识一个用户)

MobPush.setAlias(String

alias):设置别名

MobPush.getAlias():获取当前设置的别名

MobPush.deleteAlias():删除别名

标签操作:(同时可设置多个标签,可用于多用户订阅标签的方式,批量推送消息)

MobPush.addTags(String[]

tags):添加标签

MobPush.getTags():获取所有已添加的标签

MobPush.deleteTags(String[]

tags):删除标签

MobPush.cleanTags():清除所有已添加的标签

MobPushCustomeMessage:自定义消息实体类

MobPushNotifyMessage:通知消息实体类

5. 本地通知

MobPush.addLocalNotification(MobPushLocalNotification

notification):添加本地通知

MobPush.removeLocalNotification(int

notificationId):移除本地通知

MobPush.clearLocalNotifications():清空本地通知

MobPushLocalNotification:本地通知消息实体类,继承MobPushNotifyMessage

6. API错误码

API返回的错误码说明如下:(详见MobPushErrorCode.java说明)

-1  网络请求失败

-2  请求错误

功能自定义和扩展

前言:此功能仅仅是针对push的一些使用场景而进行自定义设定。比如,通知被点击的时候:

方式一、通过界面uri进行link跳转

首先现在Manifest文件中进行目标Activity的uri设置,如下:

activity

    android:name=".LinkActivity">

    <intent-filter>

        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />

        <data

            android:host="com.mob.mobpush.link"

            android:scheme="mlink" />

    </intent-filter>

</activity>

在Mob后台进行推送时,通过scheme://host的格式,例如mlink://com.mob.mobpush.link,如下位置填入:


配置好之后,推送就App就可以接收到推送直接打开指定的Activity界面了。

方式二、当app显示在前台的时候,会触发MobPushReceiver的onNotifyMessageOpenedReceive方法,MobPushNotifyMessage参数则是回调的通知详情,可以根据回调参数进行处理(不建议使用,当进程被杀掉的情况下,启动应用后可能无法执行到回调方法,因为此时可能还执行到未添加监听的代码);

方式三、不管app进程是否被杀掉,当点击通知后拉起应用的启动页面,会触发启动Activity的OnCreate或OnNewIntent方法,通过getIntent方法拿到回传的Intent,遍历getExtras,可以拿到通知详情(建议使用);

根据方式二,MobPush以两个场景为例子:

场景一、通过扩展参数实现页面的自定义跳转:

//自定义扩展字段的key,下发通知的时候,在扩展字段使用这个key

private final static String MOB_PUSH_DEMO_INTENT = "intent";


protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

dealPushResponse(getIntent());

}


protected void onNewIntent(Intent intent) {

dealPushResponse(intent);

//需要调用setIntent方法,不然后面获取到的getIntent都是上一次传的数据

setIntent(intent);

}



//OnCreate和OnNewIntent方法都要同时处理这个逻辑

private void dealPushResponse(Intent intent) {

   Bundle bundle = null;

   if (intent != null) {

      bundle = intent.getExtras();

      if (bundle != null) {

         Set<String> keySet = bundle.keySet();

         for (String key : keySet) {

            if (key.equals("msg")) {

               MobPushNotifyMessage notifyMessage = (MobPushNotifyMessage) bundle.get(key);

               HashMap<String, String> params = notifyMessage.getExtrasMap();

               if(params != null && params.containsKey(MOB_PUSH_DEMO_INTENT)){

                  //此处跳转到指定页面

                  openPage(params);

               }

            }

         }

      }

   }

}


private void openPage(HashMap<String, String> params){

Intent intent = new Intent(this, JumpActivity.class);

intent.putExtra("key1", "value1");

intent.putExtra("key2", "value2");

intent.putExtra("key3", "value3");

//如上Intent,在intent.toURI();之后得到的String,如下所示,可利用这个方法识别Intent传的参数,

//下发的参数可以按照下面的格式传,客户端接收后再转成Intent,若添加action等其他参数,可自行打印看Srting结构体;

//#Intent;component=com.mob.demo.mobpush/.JumpActivity;S.key1=value1;S.key2=value2;S.key3=value3;end


String uri;

if(!TextUtils.isEmpty(params.get(MOB_PUSH_DEMO_INTENT))) {

uri = params.get(MOB_PUSH_DEMO_INTENT);

try {

startActivity(Intent.parseUri(uri, 0));

} catch (Throwable t){

t.printStackTrace();

}

}

}


场景二、通过扩展参数实现web界面的跳转:

代码同场景一一样,跳转页面的方法改成跳转webview页面就可以,通过参数识别,拿到需要跳转的Url链接

private final static String MOB_PUSH_DEMO_URL = "url";


//OnCreate和OnNewIntent方法都要同时处理这个逻辑

private void dealPushResponse(Intent intent) {

   Bundle bundle = null;

   if (intent != null) {

      bundle = intent.getExtras();

      if (bundle != null) {

         Set<String> keySet = bundle.keySet();

         for (String key : keySet) {

            if (key.equals("msg")) {

               MobPushNotifyMessage notifyMessage = (MobPushNotifyMessage) bundle.get(key);

               HashMap<String, String> params = notifyMessage.getExtrasMap();

               if(params != null && params.containsKey(MOB_PUSH_DEMO_URL)){

                  //此处跳转到webview页面

                  openUrl(params);

               }

            }

         }

      }

   }

}


private void openUrl(HashMap<String, String> params){

   String url;

   if(!TextUtils.isEmpty(params.get(MOB_PUSH_DEMO_URL))) {

      url = params.get(MOB_PUSH_DEMO_URL);

   } else {

      url = "http://m.mob.com";

   }

   if(!url.startsWith("http://") && !url.startsWith("https://")){

      url = "http://" + url;

   }

   System.out.println("url:" + url);

   //以下代码为开发者自定义跳转webview页面,粘贴使用会找不到相关类

   WebViewPage webViewPage = new WebViewPage();

   webViewPage.setJumpUrl(url);

   webViewPage.show(this, null);

}


上面两个场景的使用示例代码,可以参考官方demo

https://github.com/MobClub/MobPush-for-Android

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,907评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,987评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,298评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,586评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,633评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,488评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,275评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,176评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,619评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,819评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,932评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,655评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,265评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,871评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,994评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,095评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,884评论 2 354

推荐阅读更多精彩内容