前言

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

前文标题：

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

链接：

如果你已经完成推送服务器的搭建，最后在验证推送功能时，返回的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。以此来进行分类推送

注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))

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

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

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

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

apns_production boolean 可选APNs是否生产环境True表示推送生产环境，False表示要推送开发环境； 如果不指定则为推送生产环境。

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

big_push_duration int 可选定速推送时长(分钟)又名缓慢推送，把原本尽可能快的推送速度，降低下来，在给定的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();

}