【极光推送】给指定用户发送消息

前言

如果你还没有搭建极光推送服务器,建议你根据情况,先从服务器搭建开始。

前文标题:

《【极光推送】jpush服务端开发详尽过程》

链接:

http://ningmengjiabing.blog.163.com/blog/static/20484719820163194218972/

如果你已经完成推送服务器的搭建,最后在验证推送功能时,返回的options大致格式应该如下所示:

{"sendno":1525934458,"apns_production":false}

出现这个东东的原因:

1.我们并未在极光推送(https://www.jpush.cn)的控制台为Android以及iOS应用进行应用登记信息。

正文

一、 控制台操作

1.在控制台登记相关应用配置信息。

二、客户端集成

1.客户端上需要增加Android版本或是iOS版本的SDK。下载地址:https://www.jpush.cn/common/products。位置如下图所示:

1.你可以在极光推送官方文档中,找到相关平台的SDK集成方式,链接为:http://docs.jpush.io/

2.具体的SDK集成方式再次不做赘述,因为笔者不是专业的移动开发人士,甚至连服务器开发也是临时凑热闹搭把手而已。

三、客户端开发

想要实现给指定人群推送消息的功能,首先要对推送人群方式进行一个简单的了解。深入的内容可以参考社区中极光推送博客的《推送人群的选择 – 技术篇》文章,地址是http://blog.jpush.cn/push_audience_tech/ 

这里只是对具体场景应用简单描述,设计一下。

我们的消息分为三类,一类是通知消息,给所有人。另一类是具体的工作安排,给某一部门的人。还有一类是具体的个人消息,如给领导发请假通知等。所以我们最终决定使用的方式包括一下方式:

1) 广播:顾名思义就是给所有人群发消息

2) 别名(alias):给指定id的终端设备发送消息。别名需要客户端进行设置。

3) 标签(tag):分组发送消息,理解起来应该类似于微信建了一个群聊的赶脚。标签需要客户端进行设置。

客户端开发步骤简述

1.集成SDK(之前已经完成)

2.启动后,到服务器上注册,并获取注册ID(RegistrationID)

3.调用Method - setAliasAndTags (with Callback)函数完成别名和标签的设置。

注1:这里,我们应用的别名就是员工ID,标签就是部门ID。以此来进行分类推送

注2:具体的参数定义可参照官方文档《别名与标签API》一文。链接地址为:http://docs.jpush.cn/pages/viewpage.action?pageId=557241

注3:只有call back返回0时才设置成功,其他结果均会让服务器返回1011错误。

四、服务端开发

1.设置推送平台

setPlatform(Platform.all()) //设置所有平台

setPlatform(Platform.android())//设置android

setPlatform(Platform.android_ios())//设置Android和iOS

setPlatform(Platform.ios())//设置iOS

2.设置受众(收到推送消息的人群)

setAudience(Audience.all())设置所有受众

setAudience(Audience.tag("tag1","tag2"))//设置tag为tag1,tag2的受众,群发

setAudience(AudienceTarget.alias("alias1", "alias2")) //设置别名alias为alias1,alias2的受众,单发

注1: 更多的发送方式,可以到官网上去找文档,可以这是多个条件混合发送。由于本项目中没有那么复杂的应用需求,所以此处省略不提。

3.设置通知方式

setNotification(Notification.alert(ALERT)) //设置通用通知,以alert方式提醒

setNotification(Notification.android(ALERT, TITLE, null))//增加标题

setNotification(Notification.newBuilder()

.addPlatformNotification(IosNotification.newBuilder()

.setAlert(ALERT)

.setBadge(5)

.setSound("happy")

.addExtra("from", "JPush")

.build())

.build())//不管什么东西,iOS的总要复杂一些。

注1: 可以不设置通知方式,让其使用默认的通知方式进行消息推送

4.设置通知内容

setMessage(Message.content(MSG_CONTENT))//MSG_CONTENT中就是通知内容。

5.设置控制选项

setOptions(M\options(sendno, time_to_live, override_msg_id, apns_production,big_push_duration))

当前包含如下几个可选项:

sendnoint可选推送序号纯粹用来作为API调用标识,API返回时被原样返回,以方便API调用方匹配请求与返回。

time_to_liveint可选离线消息保留时长推送当前用户不在线时,为该用户保留多长时间的离线消息,以便其上线时再次推送。默认86400(1天),最长10天。设置为0表示不保留离线消息,只有推送当前在线的用户可以收到。

override_msg_idlong可选要覆盖的消息ID如果当前的推送要覆盖之前的一条推送,这里填写前一条推送的msg_id就会产生覆盖效果,即:1)该msg_id离线收到的消息是覆盖后的内容;2)即使该msg_id Android端用户已经收到,如果通知栏还未清除,则新的消息内容会覆盖之前这条通知;覆盖功能起作用的时限是:1天。 如果在覆盖指定时限内该msg_id不存在,则返回1003错误,提示不是一次有效的消息覆盖操作,当前的消息不会被推送。

apns_productionboolean可选APNs是否生产环境True表示推送生产环境,False表示要推送开发环境; 如果不指定则为推送生产环境。

注:JPush官方API LIbrary (SDK)默认设置为推送 “开发环境”。

big_push_durationint可选定速推送时长(分钟)又名缓慢推送,把原本尽可能快的推送速度,降低下来,在给定的n分钟内,均匀地向这次推送的目标用户推送。最大值为1440。未设置则不是定速推送。

6.开始推送

sendPush(PushPayload类型参数)

7.获取返回结果

PushResult类型参数,可以回去到返回值。结果大致格式如下:

{"msg_id":3270259240,"sendno":34919015}

8. 附上两段分标签以及分别名推送的函数代码

//description:自定义推送函数--分组推送

//createTime: 04-21

//author: xk

public static PushPayload buildPushObject_android_and_iosByTag(String tag,String title,String content) {

return PushPayload.newBuilder()

.setPlatform(Platform.android_ios())

.setAudience(Audience.tag(tag))

.setNotification(Notification.newBuilder()

.setAlert(content)

.addPlatformNotification(AndroidNotification.newBuilder()

.setTitle(title).build())

.addPlatformNotification(IosNotification.newBuilder()

.incrBadge(1)

.addExtra(title, content).build())

.build())

.build();

}

//description:自定义推送函数--按别名推送

//createTime: 04-21

//author: xk

public static PushPayload buildPushObject_android_and_iosByAlias(String alias,String title,String content) {

return PushPayload.newBuilder()

.setPlatform(Platform.android_ios())

.setAudience(Audience.alias(alias))

.setNotification(Notification.newBuilder()

.setAlert(content)

.addPlatformNotification(AndroidNotification.newBuilder()

.setTitle(title).build())

.addPlatformNotification(IosNotification.newBuilder()

.incrBadge(1)

.addExtra(title, content).build())

.build())

.build();

}

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

推荐阅读更多精彩内容