推送监听接口
增加推送监听
性能阐明
- 增加推送监听,音讯下发到设施,可依据推送监听进行业务逻辑操作
- 自定义音讯达到(透传音讯)、告诉音讯达到、告诉栏音讯点击、增删别名、增删标签事件。
参数阐明
参数
类型
形容
mobPushReceiver
MobPushReceiver
注册推送监听
示例代码
/** * import com.mob.pushsdk.MobPushReceiver; */public static void addPushReceiver(MobPushReceiver mobPushReceiver)MobPushReceiver mobPushReceiver = new MobPushReceiver() { @Override public void onCustomMessageReceive(Context context, MobPushCustomMessage message) { //接管到自定义音讯(透传音讯) message.getMessageId();//获取工作ID message.getContent();//获取推送内容 ... } @Override public void onNotifyMessageReceive(Context context, MobPushNotifyMessage message) { //告诉音讯达到 message.getMobNotifyId();//获取音讯ID message.getMessageId();//获取工作ID message.getTitle();//获取推送题目 message.getContent();//获取推送内容 ... } @Override public void onNotifyMessageOpenedReceive(Context context, MobPushNotifyMessage message) { //告诉被点击事件 message.getMobNotifyId();//获取音讯ID message.getMessageId();//获取工作ID message.getTitle();//获取推送题目 message.getContent();//获取推送内容 ... } @Override public void onTagsCallback(Context context, String[] tags, int operation, int errorCode) { //标签操作回调 //tags 已增加的标签汇合 //operation 0:获取标签 1:设置标签 2:删除标签 //errorCode 0:操作胜利 其它:操作失败 ... } @Override public void onAliasCallback(Context context, String alias, int operation, int errorCode) { //别名操作回调 //alias 对应的别名 //operation 0:获取别名 1:设置别名 2:删除别名 //errorCode 0:操作胜利 其它:操作失败 ... } };MobPush.addPushReceiver(mobPushReceiver);
登记推送监听
性能阐明
- 登记推送监听,在利用销毁时调用登记函数,登记已增加过的推送监听。
参数阐明
参数
类型
形容
mobPushReceiver
MobPushReceiver
登记推送监听
示例代码
/** * import com.mob.pushsdk.MobPushReceiver; */public static void removePushReceiver(MobPushReceiver mobPushReceiver)MobPush.removePushReceiver(mobPushReceiver);
推送服务接口
获取RegistrationId
性能阐明
- RegistrationId是MobPush SDK初始化胜利后,MobPush给每个设施调配的惟一标识(同一个手机不同App的RegistrationId不同),开发者能够通过指定RegistrationId给繁多设施发送推送。
参数阐明
参数
类型
形容
callback
MobPushCallback
获取惟一标识RegistrationId
示例代码
/** * com.mob.pushsdk.MobPushCallback */public static void getRegistrationId(MobPushCallback callback)MobPush.getRegistrationId(new MobPushCallback<String>() { @Override public void onCallback(String registrationId) { ... }});
获取TCP状态
性能阐明
- 获取TCP状态 ,判断TCP状态是否失常。
参数阐明
参数
类型
形容
callback
MobPushCallback
获取TCP连贯状态:true 在线;false 不在线
示例代码
/** * com.mob.pushsdk.MobPushCallback */public static void checkTcpStatus(MobPushCallback callback)MobPush.checkTcpStatus(new MobPushCallback<Boolean>() { @Override public void onCallback(Boolean aBoolean) { ... } });
推送服务状态
性能阐明
- 查看推送服务是否停止使用。
参数阐明
参数
类型
形容
callback
MobPushCallback
获取推送服务状态:true是已进行;false是未进行
示例代码
/** * com.mob.pushsdk.MobPushCallback */public static void isPushStopped(MobPushCallback callback)MobPush.isPushStopped(new MobPushCallback<Boolean>() { @Override public void onCallback(Boolean isStopped) { ... } });
进行推送服务
性能阐明
- 进行推送服务,调用后设施不能够接管推送音讯。
示例代码
/** * com.mob.pushsdk.MobPush */public static void stopPush()MobPush.stopPush();
重启推送服务
性能阐明
- 推送服务是进行状态,能够应用重启接口复原推送服务,能够失常接管推送音讯。
示例代码
/** * com.mob.pushsdk.MobPush */public static void restartPush()MobPush.restartPush();
别名接口
设置别名 API
性能阐明
- 设置别名;别名是惟一的,与RegistrationId为一对一关系。如屡次调用,会以最初一次设置为准,进行笼罩;可在推送监听API中的onAliasCallback回调函数查看状态是否设置胜利。
- 别名反对:字母(辨别大小写)、数字、下划线、汉字、特殊字符@!#$&*+=.|。
参数阐明
参数
类型
形容
alias
String
须要设置的别名
示例代码
/** * com.mob.pushsdk.MobPush */public static void setAlias(String alias)MobPush.setAlias("别名");
获取别名
性能阐明
- 获取别名;调用该函数后,可在推送监听API中的onAliasCallback回调函数中查看RegistrationId对应的别名。
示例代码
/** * com.mob.pushsdk.MobPush */public static void getAlias()MobPush.getAlias();
删除别名
性能阐明
- 删除别名;调用该函数后,可在推送监听API中的onAliasCallback回调函数查看状态是否设置删除别名胜利。
示例代码
/** * com.mob.pushsdk.MobPush */public static void deleteAlias()MobPush.deleteAlias();
标签接口
增加标签
性能阐明
- 增加标签;标签能够增加多个,每次调用都会在原来的根底上进行追加。可在推送监听API中的onTagsCallback回调函数查看状态是否增加胜利。
- 标签反对:字母(辨别大小写)、数字、下划线、汉字、特殊字符@!#$&*+=.|。
参数阐明
参数
类型
形容
tags
String[]
须要增加的标签
示例代码
/** * com.mob.pushsdk.MobPush */public static void addTags(String[] tags)MobPush.addTags(new String[]{"标签1", "标签2"});
获取标签
性能阐明
- 获取标签;调用该函数后,可在推送监听API中的onTagsCallback回调函数中查看RegistrationId对应的所有标签。
示例代码
/** * com.mob.pushsdk.MobPush */public static void getTags()MobPush.getTags();
删除标签
性能阐明
- 删除标签;调用该函数后,可在推送监听API中的onTagsCallback回调函数查看状态是否删除标签胜利。
参数阐明
参数
类型
形容
tags
String[]
须要删除的标签
- String[] tags标签数组
示例代码
/** * com.mob.pushsdk.MobPush */public static void deleteTags(String[] tags)MobPush.deleteTags(new String[]{"删除标签1", "删除标签2"});
清空标签
性能阐明
- 清空标签;调用该函数后,可在推送监听API中的onTagsCallback回调函数查看状态是否清空标签胜利。
示例代码
/** * com.mob.pushsdk.MobPush */public static void cleanTags()MobPush.cleanTags();
本地告诉接口
发送本地告诉
性能阐明
- 发送本地告诉。不通过服务器推送,客户端被动发送告诉。
参数阐明
参数
类型
形容
localNotification
MobPushLocalNotification
本地告诉对象
callback
MobPushCallback
本地告诉回调
示例代码
/** * com.mob.pushsdk.MobPush */public static boolean addLocalNotification(MobPushLocalNotification localNotification, MobPushCallback callback)MobPushLocalNotification localNotification = new MobPushLocalNotification();localNotification.setTitle("本地告诉题目");localNotification.setContent("本地告诉内容");localNotification.setNotificationId(123);...MobPush.addLocalNotification(localNotification, new MobPushCallback<Boolean>() { @Override public void onCallback(Boolean aBoolean) { //true胜利;false失败 ... } });
移除本地告诉
性能阐明
- 针对曾经发送的本地告诉音讯进行移除。
参数阐明
参数
类型
形容
lnotificationId
MobPushLocalNotification
本地告诉对象
callback
MobPushCallback
本地告诉回调
示例代码
/** * com.mob.pushsdk.MobPush */public static boolean removeLocalNotification(int lnotificationId, MobPushCallback callback)MobPushLocalNotification localNotification = new MobPushLocalNotification();localNotification.setNotificationId(123);...int lnotificationId = localNotification.getNotificationId();MobPush.removeLocalNotification(lnotificationId, new MobPushCallback<Boolean>() { @Override public void onCallback(Boolean aBoolean) { //true胜利;false失败 ... } });
清空本地告诉
性能阐明
- 清空本地告诉。
参数阐明
参数
类型
形容
callback
MobPushCallback
本地告诉回调
示例代码
/** * com.mob.pushsdk.MobPush.class */ public static boolean clearLocalNotifications(MobPushCallback callback)MobPush.clearLocalNotifications(new MobPushCallback<Boolean>() { @Override public void onCallback(Boolean aBoolean) { //true胜利;false失败 ... } });
角标接口
设置是否显示角标
性能阐明
- 设置是否显示角标,用于接管告诉时显示角标数量。
参数阐明
参数
类型
形容
isShowBadge
Boolean
状态:true显示;false不显示;默认:true
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void setShowBadge(Boolean isShowBadge)MobPush.setShowBadge(true);
设置显示角标数
性能阐明
- 设置显示的角标数,用户可依据本人的逻辑进行设置。反对角标性能可参考:Android常见问题文档
参数阐明
参数
类型
形容
counts
int
角标数
/** * com.mob.pushsdk.MobPush.class */public static void setBadgeCounts(int counts)
示例代码
MobPush.setBadgeCounts(0);
告诉栏接口
设置显示告诉的最大条数
性能阐明
- 针对告诉栏显示的告诉最大条数进行设置,设置值须要大于0,默认最大是5条。
参数阐明
参数
类型
形容
count
int
告诉栏最大显示告诉条数
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void setNotificationMaxCount(int count)MobPush.setNotificationMaxCount(count)
获取显示告诉的最大条数
性能阐明
- 获取告诉栏显示的告诉最大条数,默认最大是5条。
参数阐明
参数
类型
形容
callback
MobPushCallback
告诉栏最大显示告诉条数回调
示例代码
/** * com.mob.pushsdk.MobPush.class */public static int getNotificationMaxCount(MobPushCallback callback)MobPush.getNotificationMaxCount(new MobPushCallback<Integer>() { @Override public void onCallback(Integer integer) { //显示告诉最大条数 ... } });
告诉权限接口
关上告诉轮询开关
性能阐明
- MobPush只会在初始化的时候更新记录的告诉权限状态。如须要实时更新,可调用该办法。
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void startNotificationMonitor()MobPush.startNotificationMonitor();
敞开告诉轮询开关
性能阐明
- 敞开告诉权限轮询开关。
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void stopNotificationMonitor()MobPush.stopNotificationMonitor();
其它接口
统计厂商点击数(重要)
性能阐明
- 统计厂商通道下发告诉的点击数,如不设置,无奈精确统计到厂商通道下发告诉的点击数,倡议加上。不设置仅影响厂商通道的点击数,不影响MobPush通道点击数统计。
参数阐明
参数
类型
形容
intent
Intent
取得启动以后流动时的Intent内容
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void notificationClickAck(Intent intent)MobPush.notificationClickAck(getIntent());
设置区域
反对版本
- 反对3.x版本
性能阐明
- 客户端默认是国内版,如有需要可设置海内区域域名。
参数阐明
参数
类型
形容
domainAbroad
int
国内区域:0,海内区域:1
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void setDomainAbroad(int domainAbroad)MobPush.setDomainAbroad(1);
点击告诉是否启动主页
性能阐明
- 设置点击告诉是否启动主页。默认为启动。
参数阐明
参数
类型
形容
isLaunch
Boolean
状态:true是启动;false是不启动
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void setClickNotificationToLaunchMainActivity(Boolean isLaunch)MobPush.setClickNotificationToLaunchMainActivity(true);
设置告诉勿扰静音
性能阐明
- 设置静音时段。几点几分开始到几点几分完结,这段时间属于静音时间段,接管到推送时,揭示类型属于静音状态。
参数阐明
参数
类型
形容
startHour
int
开始静音工夫(时)
startMinute
int
开始静音工夫(分)
endHour
int
完结静音工夫(时)
endMinute
int
完结静音工夫(分)
示例代码
/** * com.mob.pushsdk.MobPush.class */public static void setSilenceTime(int startHour, int startMinute, int endHour, int endMinute)MobPush.setSilenceTime(20, 0, 0, 0);//设置静音时间段早晨20:00到00:00
性能自定义和扩大
具体可参考上面文档:
MobPush 指定页面跳转最佳实现
安卓推送音讯数据解析举荐实现
备注:官网下载Demo