MobPush Android 端 SDK API
推送监听接口
添加推送监听
功能说明
添加推送监听,消息下发到设备,可根据推送监听进行业务逻辑操作
自定义消息到达(透传消息)、通知消息到达、通知栏消息点击、增删别名、增删标签事件。
参数说明
示例代码
注销推送监听
功能说明
注销推送监听,在应用销毁时调用注销函数,注销已添加过的推送监听。
参数说明
示例代码
转发厂商消息
功能说明
MobPush 4.6.14+版本,对推送回调进行了整合,TCP 消息和厂商均可以在 MobPushReceiver 处理,需要注意的是,解析 intent 位置需要进行消息转发, 也可以参考最佳实践模块
参数说明
示例代码
推送服务接口
获取 RegistrationId
功能说明
RegistrationId 是 MobPush SDK 初始化成功后,MobPush 给每个设备分配的唯一标识(同一个手机不同 App 的 RegistrationId 不同),开发者可以通过指定 RegistrationId 给单一设备发送推送。
参数说明
示例代码
获取厂商 token
功能说明
厂商 token 是厂商推送 SDK 初始化成功后给设备分配的唯一标识,可通过此方法获取 token。
参数说明
示例代码
获取 TCP 状态
功能说明
获取 TCP 状态 ,判断 TCP 状态是否正常。
参数说明
示例代码
推送服务状态
功能说明
检查推送服务是否停止使用。
参数说明
示例代码
停止推送服务
功能说明
停止推送服务,调用后设备不可以接收推送消息。
示例代码
重启推送服务
功能说明
推送服务是停止状态,可以使用重启接口恢复推送服务,可以正常接收推送消息。
示例代码
别名接口
设置别名 API
功能说明
设置别名;别名是唯一的,与 RegistrationId 为一对一关系。如多次调用,会以最后一次设置为准,进行覆盖;可在推送监听 API 中的 onAliasCallback 回调函数查看状态是否设置成功。
别名支持:字母(区分大小写)、数字、下划线、汉字、特殊字符 @!#$&*+=.|。
参数说明
示例代码
获取别名
功能说明
获取别名;调用该函数后,可在推送监听 API 中的 onAliasCallback 回调函数中查看 RegistrationId 对应的别名。
示例代码
删除别名
功能说明
删除别名;调用该函数后,可在推送监听 API 中的 onAliasCallback 回调函数查看状态是否设置删除别名成功。
示例代码
标签接口
添加标签
功能说明
添加标签;标签可以添加多个,每次调用都会在原来的基础上进行追加。可在推送监听 API 中的 onTagsCallback 回调函数查看状态是否添加成功。
标签支持:字母(区分大小写)、数字、下划线、汉字、特殊字符 @!#$&*+=.|。
参数说明
示例代码
获取标签
功能说明
获取标签;调用该函数后,可在推送监听 API 中的 onTagsCallback 回调函数中查看 RegistrationId 对应的所有标签。
示例代码
删除标签
功能说明
删除标签;调用该函数后,可在推送监听 API 中的 onTagsCallback 回调函数查看状态是否删除标签成功。
参数说明
String[] tags 标签数组
示例代码
清空标签
功能说明
清空标签;调用该函数后,可在推送监听 API 中的 onTagsCallback 回调函数查看状态是否清空标签成功。
示例代码
本地通知接口
发送本地通知
功能说明
发送本地通知。不通过服务器推送,客户端主动发送通知。
参数说明
示例代码
移除本地通知
功能说明
针对已经发送的本地通知消息进行移除。
参数说明
示例代码
清空本地通知
功能说明
清空本地通知。
参数说明
示例代码
角标接口
设置是否显示角标
功能说明
设置是否显示角标,用于接收通知时显示角标数量。
参数说明
示例代码
设置显示角标数
功能说明
设置显示的角标数,用户可根据自己的逻辑进行设置。支持角标功能可参考:Android常见问题文档
参数说明
示例代码
通知栏接口
设置显示通知的最大条数
功能说明
针对通知栏显示的通知最大条数进行设置,设置值需要大于 0,默认最大是 5 条。
参数说明
示例代码
获取显示通知的最大条数
功能说明
获取通知栏显示的通知最大条数,默认最大是 5 条。
参数说明
示例代码
通知权限接口
通知权限判断接口
功能说明
判断通知权限是否打开(4.6.17 版本开始支持)
示例代码
打开通知轮询开关
功能说明
MobPush 只会在初始化的时候更新记录的通知权限状态。如需要实时更新,可调用该方法。
示例代码
关闭通知轮询开关
功能说明
关闭通知权限轮询开关。
示例代码
个性化参数接口
绑定个性化参数
功能说明
绑定个性化参数(4.6.18 版本开始支持)
个性化参数名称限制:不可为空,仅支持英文和数字,长度限制 10 个字符
个性化参数值限制:不可为空,仅支持英文和数字,长度限制 10 个字符
参数说明
示例代码
解绑个性化参数
功能说明
解绑个性化参数(4.6.18 版本开始支持)
参数说明
示例代码
清空个性化参数
功能说明
清空个性化参数(4.6.18 版本开始支持)
参数说明
示例代码
其它接口
统计厂商点击数(重要)
功能说明
统计厂商通道下发通知的点击数,如不设置,无法准确统计到厂商通道下发通知的点击数,建议加上。不设置仅影响厂商通道的点击数,不影响 MobPush 通道点击数统计。
参数说明
示例代码
设置区域
支持版本
支持 3.x 版本
功能说明
客户端默认是国内版,如有需求可设置海外区域域名。
参数说明
示例代码
点击通知是否启动主页
功能说明
设置点击通知是否启动主页。默认为启动。
参数说明
示例代码
设置通知勿扰静音
功能说明
设置静音时段。几点几分开始到几点几分结束,这段时间属于静音时间段,接收到推送时,提醒类型属于静音状态。
参数说明
示例代码
定向推送能力
MobPush 默认会为您提供定向推送能力,如您想停用此能力,可在终端用户接受隐私条款后调用如下代码进行处理:
如需恢复,则传参 1 即可:
依照不同的版本,此代码最迟可能在下次冷启动后生效
功能自定义和扩展
具体可参考下面文档:
备注:官方下载Demo
版权声明: 本文为 InfoQ 作者【MobTech袤博科技】的原创文章。
原文链接:【http://xie.infoq.cn/article/4755b063e4d5d0d8d19a8366a】。文章转载请联系作者。
评论