前言

如果你還沒(méi)有搭建極光推送服務(wù)器，建議你根據(jù)情況，先從服務(wù)器搭建開(kāi)始。

前文標(biāo)題：

《【極光推送】jpush服務(wù)端開(kāi)發(fā)詳盡過(guò)程》

鏈接：

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

如果你已經(jīng)完成推送服務(wù)器的搭建，最后在驗(yàn)證推送功能時(shí)，返回的options大致格式應(yīng)該如下所示：

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

出現(xiàn)這個(gè)東東的原因：

1.我們并未在極光推送（https://www.jpush.cn）的控制臺(tái)為Android以及iOS應(yīng)用進(jìn)行應(yīng)用登記信息。

正文

一、 控制臺(tái)操作

1.在控制臺(tái)登記相關(guān)應(yīng)用配置信息。

二、客戶端集成

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

1.你可以在極光推送官方文檔中，找到相關(guān)平臺(tái)的SDK集成方式，鏈接為：http://docs.jpush.io/

2.具體的SDK集成方式再次不做贅述，因?yàn)楣P者不是專業(yè)的移動(dòng)開(kāi)發(fā)人士，甚至連服務(wù)器開(kāi)發(fā)也是臨時(shí)湊熱鬧搭把手而已。

三、客戶端開(kāi)發(fā)

想要實(shí)現(xiàn)給指定人群推送消息的功能，首先要對(duì)推送人群方式進(jìn)行一個(gè)簡(jiǎn)單的了解。深入的內(nèi)容可以參考社區(qū)中極光推送博客的《推送人群的選擇 – 技術(shù)篇》文章，地址是http://blog.jpush.cn/push_audience_tech/?

這里只是對(duì)具體場(chǎng)景應(yīng)用簡(jiǎn)單描述，設(shè)計(jì)一下。

我們的消息分為三類，一類是通知消息，給所有人。另一類是具體的工作安排，給某一部門的人。還有一類是具體的個(gè)人消息，如給領(lǐng)導(dǎo)發(fā)請(qǐng)假通知等。所以我們最終決定使用的方式包括一下方式：

1） 廣播：顧名思義就是給所有人群發(fā)消息

2） 別名（alias）：給指定id的終端設(shè)備發(fā)送消息。別名需要客戶端進(jìn)行設(shè)置。

3） 標(biāo)簽（tag）：分組發(fā)送消息，理解起來(lái)應(yīng)該類似于微信建了一個(gè)群聊的趕腳。標(biāo)簽需要客戶端進(jìn)行設(shè)置。

客戶端開(kāi)發(fā)步驟簡(jiǎn)述

1.集成SDK（之前已經(jīng)完成）

2.啟動(dòng)后，到服務(wù)器上注冊(cè)，并獲取注冊(cè)ID（RegistrationID）

3.調(diào)用Method -?setAliasAndTags (with?Callback)函數(shù)完成別名和標(biāo)簽的設(shè)置。

注1：這里，我們應(yīng)用的別名就是員工ID，標(biāo)簽就是部門ID。以此來(lái)進(jìn)行分類推送

注2：具體的參數(shù)定義可參照官方文檔《別名與標(biāo)簽API》一文。鏈接地址為：http://docs.jpush.cn/pages/viewpage.action?pageId=557241

注3：只有call back返回0時(shí)才設(shè)置成功，其他結(jié)果均會(huì)讓服務(wù)器返回1011錯(cuò)誤。

四、服務(wù)端開(kāi)發(fā)

1.設(shè)置推送平臺(tái)

setPlatform(Platform.all()) //設(shè)置所有平臺(tái)

setPlatform(Platform.android())//設(shè)置android

setPlatform(Platform.android_ios())//設(shè)置Android和iOS

setPlatform(Platform.ios())//設(shè)置iOS

2.設(shè)置受眾（收到推送消息的人群）

setAudience(Audience.all())設(shè)置所有受眾

setAudience(Audience.tag("tag1"，"tag2"))//設(shè)置tag為tag1，tag2的受眾，群發(fā)

setAudience(AudienceTarget.alias("alias1", "alias2")) //設(shè)置別名alias為alias1，alias2的受眾，單發(fā)

注1： 更多的發(fā)送方式，可以到官網(wǎng)上去找文檔，可以這是多個(gè)條件混合發(fā)送。由于本項(xiàng)目中沒(méi)有那么復(fù)雜的應(yīng)用需求，所以此處省略不提。

3.設(shè)置通知方式

setNotification(Notification.alert(ALERT)) //設(shè)置通用通知，以alert方式提醒

setNotification(Notification.android(ALERT, TITLE, null))//增加標(biāo)題

setNotification(Notification.newBuilder()

.addPlatformNotification(IosNotification.newBuilder()

.setAlert(ALERT)

.setBadge(5)

.setSound("happy")

.addExtra("from", "JPush")

.build())

.build())//不管什么東西，iOS的總要復(fù)雜一些。

注1： 可以不設(shè)置通知方式，讓其使用默認(rèn)的通知方式進(jìn)行消息推送

4.設(shè)置通知內(nèi)容

setMessage(Message.content(MSG_CONTENT))//MSG_CONTENT中就是通知內(nèi)容。

5.設(shè)置控制選項(xiàng)

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

當(dāng)前包含如下幾個(gè)可選項(xiàng)：

sendnoint可選推送序號(hào)純粹用來(lái)作為API調(diào)用標(biāo)識(shí)，API返回時(shí)被原樣返回，以方便API調(diào)用方匹配請(qǐng)求與返回。

time_to_liveint可選離線消息保留時(shí)長(zhǎng)推送當(dāng)前用戶不在線時(shí)，為該用戶保留多長(zhǎng)時(shí)間的離線消息，以便其上線時(shí)再次推送。默認(rèn)86400（1天），最長(zhǎng)10天。設(shè)置為0表示不保留離線消息，只有推送當(dāng)前在線的用戶可以收到。

override_msg_idlong可選要覆蓋的消息ID如果當(dāng)前的推送要覆蓋之前的一條推送，這里填寫前一條推送的msg_id就會(huì)產(chǎn)生覆蓋效果，即：1）該msg_id離線收到的消息是覆蓋后的內(nèi)容；2）即使該msg_id Android端用戶已經(jīng)收到，如果通知欄還未清除，則新的消息內(nèi)容會(huì)覆蓋之前這條通知；覆蓋功能起作用的時(shí)限是：1天。 如果在覆蓋指定時(shí)限內(nèi)該msg_id不存在，則返回1003錯(cuò)誤，提示不是一次有效的消息覆蓋操作，當(dāng)前的消息不會(huì)被推送。

apns_productionboolean可選APNs是否生產(chǎn)環(huán)境True表示推送生產(chǎn)環(huán)境，F(xiàn)alse表示要推送開(kāi)發(fā)環(huán)境； 如果不指定則為推送生產(chǎn)環(huán)境。

注：JPush官方API LIbrary (SDK)默認(rèn)設(shè)置為推送 “開(kāi)發(fā)環(huán)境”。

big_push_durationint可選定速推送時(shí)長(zhǎng)（分鐘）又名緩慢推送，把原本盡可能快的推送速度，降低下來(lái)，在給定的n分鐘內(nèi)，均勻地向這次推送的目標(biāo)用戶推送。最大值為1440。未設(shè)置則不是定速推送。

6.開(kāi)始推送

sendPush(PushPayload類型參數(shù))

7.獲取返回結(jié)果

PushResult類型參數(shù)，可以回去到返回值。結(jié)果大致格式如下：

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

8. 附上兩段分標(biāo)簽以及分別名推送的函數(shù)代碼

//description：自定義推送函數(shù)--分組推送

//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：自定義推送函數(shù)--按別名推送

//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();

}