推送是手機app不可或缺的一樣功能,這次由於公司專案需要研究了一下。由於推送一般寫於服務端,所以對於不會Android的javaweb程式設計師要寫出一個完整的demo是一件很頭痛的事情。所以我就在這裡從頭到尾寫一個例子以示參考。由於我也不明白Android 只是因為專案需要百度了一個demo,當中有很多不足的地方忘各位大神指正。
一、首先簡單的介紹一下什麼是極光推送
①為什麼需要推送:為了解決資料同步的問題,在手機平台上,常用的方法有2種。一種是定時去伺服器上查詢數據,也叫Polling,還有一種手機跟伺服器之間維護一個 TCP 長連接,當伺服器有數據時,即時推送到客戶端,也就是我們說的 Push。由於做推送在行動網路下維持長連接有一定的技術難度,而且當用戶量上去的時候,需要很多伺服器來維持長連接,成本也是很大的。因此我們需要一個第三方的jar包來支援我們的推播服務。如果想了解更多內容可參考極光推播官方文件。
②極光推送的通俗解答:就是把需要推送的內容透過呼叫jpush的api的傳送到極光推送的伺服器上,極光推送的伺服器根據我們推送過去的內容選擇推送到具體的app。
二、原始碼
服務端程式碼:
安卓用戶端程式碼:
安卓環境為:ADT+SDK+ eclipse
ADT下載:
SDK下載:
所需JDK的環境安裝就不一一敘述了。
註:程式碼可直接匯入只需要改幾個地方後面會闡述。首先教大家搭下安卓環境先確保程式碼能導入成功
三、操作步驟
#① 安裝外掛程式
##
# ②安裝sdk
#此步驟完成後頁面會切換到Android的開發介面,頁面會多兩個東西
選擇你要安裝的一般選擇Tools裡面的和Android你所需要的版本,然後帶你安裝,我這裡已經沒有選,所以示灰色的。
註:關於安裝很慢或安裝失敗
有兩種方法:① 使用FQ軟體 我使用的藍色燈######② 使用設定鏡像伺服器 如圖:####################### ###### ③接著導入安卓工程(服務端的工程就不敘述怎麼導入了)###### 在工程列表的空白處右鍵--選擇import--然後操作如圖########### #### ###### 然後是運行安卓程式(最好是插上數據線--打開手機的usb調試--然後程式運行的時候回下到手機上)######具體的可以百度下。 ###### ######四、極光推送的使用(肯定要到官網註冊一個帳號)######具體使用請百度,或參照官網,以下是主要截圖##### ###########appkey和master secret 後面會用到######五、修改Android設定文件,將appkey改成你所新增的應用程式的appkey######## ######## ######六、服務端程式碼展示,程式碼都有註解就不一一解釋了######只用的到這三個程式碼##### #APPKET和MASTERSECRET 改成你在極光開發者服務增加的應用時所生產的字串############### ####1 package com.uxun.serviceImpl; 2 3 import com.uxun.service.JPushService; 4 5 import cn.jiguang.common.resp.APIConnectionException; 6 import cn.jiguang.common.resp.APIRequestException; 7 import cn.jpush.api.JPushClient; 8 import cn.jpush.api.push.PushResult; 9 import cn.jpush.api.push.model.Platform; 10 import cn.jpush.api.push.model.PushPayload; 11 import cn.jpush.api.push.model.audience.Audience; 12 import cn.jpush.api.push.model.notification.AndroidNotification; 13 import cn.jpush.api.push.model.notification.IosNotification; 14 import cn.jpush.api.push.model.notification.Notification; 15 16 public class JPushServiceImpl implements JPushService { 17 18 private final static String APPKET = "44262636e2afd75d9b9f7932"; 19 20 private final static String MASTERSECRET = "ae5c0ab5f093b2aba1f8ce25"; 21 22 private static JPushClient jPushClient = new JPushClient(MASTERSECRET, APPKET);//通知默认保留24小时。 23 24 @Override 25 public int sendToRegistrationId(String registrationId, String notification_alert, String notification_title, 26 String extrasparam) { 27 int result = 0; 28 try { 29 PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithRegistrationId(registrationId, 30 notification_alert, notification_title, extrasparam); 31 System.out.println(pushPayload); 32 PushResult pushResult=jPushClient.sendPush(pushPayload); //发送推送对象 33 //System.out.println(pushResult); 34 if(pushResult.getResponseCode() == 200) { //状态码等于200 为成功 35 result=1; 36 } 37 } catch (APIConnectionException e) { 38 e.printStackTrace(); 39 } catch (APIRequestException e) { 40 e.printStackTrace(); 41 } 42 43 return result; 44 } 45 46 @Override 47 public int sendToAll(String notification_alert, String notification_title, String extrasparam) { 48 int result = 0; 49 try { 50 PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithAll(notification_alert, 51 notification_title, extrasparam); 52 System.out.println(pushPayload); 53 PushResult pushResult=jPushClient.sendPush(pushPayload); //发送推送对象 54 //System.out.println(pushResult); 55 if(pushResult.getResponseCode() == 200) { //状态码等于200 为成功 56 result=1; 57 } 58 } catch (APIConnectionException e) { 59 e.printStackTrace(); 60 } catch (APIRequestException e) { 61 e.printStackTrace(); 62 } 63 64 return result; 65 } 66 67 @Override 68 public int sendToAllIos(String notification_alert, String notification_title, String extrasparam) { 69 70 int result = 0; 71 try { 72 PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithIos(notification_alert, 73 notification_title, extrasparam); 74 System.out.println(pushPayload); 75 PushResult pushResult=jPushClient.sendPush(pushPayload); //发送推送对象 76 //System.out.println(pushResult); 77 if(pushResult.getResponseCode() == 200) { //状态码等于200 为成功 78 result=1; 79 } 80 } catch (APIConnectionException e) { 81 e.printStackTrace(); 82 } catch (APIRequestException e) { 83 e.printStackTrace(); 84 } 85 86 return result; 87 } 88 89 @Override 90 public int sendToAllAndroid(String notification_alert, String notification_title, String extrasparam) { 91 92 int result = 0; 93 try { 94 PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithAndroid(notification_alert, 95 notification_title, extrasparam); 96 System.out.println(pushPayload); 97 PushResult pushResult=jPushClient.sendPush(pushPayload); //发送推送对象 98 //System.out.println(pushResult); 99 if(pushResult.getResponseCode() == 200) { //状态码等于200 为成功100 result=1;101 }102 } catch (APIConnectionException e) {103 e.printStackTrace();104 } catch (APIRequestException e) {105 e.printStackTrace();106 }107 108 return result;109 }110 111 /**112 * 建立以唯一设备标识符推送的对象113 * @param registrationId 唯一设备标识114 * @param notification_alert 通知内容115 * @param notification_title 通知标题116 * @param extrasparam 扩展字段117 * @return 返回推送对象118 */119 private static PushPayload buildPushObjectWithRegistrationId(String registrationId, String notification_alert, String notification_title,120 String extrasparam) {121 return PushPayload.newBuilder()122 //指定要推送的平台,all代表当前应用配置了的所有平台,也可以传android等具体平台123 .setPlatform(Platform.all())124 //指定推送的接收对象,all代表所有人,也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id125 .setAudience(Audience.registrationId(registrationId))126 //jpush的通知,android的由jpush直接下发,iOS的由apns服务器下发,Winphone的由mpns下发127 .setNotification(Notification.newBuilder()128 //指定当前推送的android通知129 .addPlatformNotification(AndroidNotification.newBuilder()130 .setAlert(notification_alert) //设置通知内容(必填)131 .setTitle(notification_title) //设置通知标题(可选)132 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)133 .addExtra("androidNotification extras key",extrasparam)134 .build())135 136 //指定当前推送的iOS通知137 .addPlatformNotification(IosNotification.newBuilder()138 //传一个IosAlert对象,指定apns title、title、subtitle等139 .setAlert(notification_alert)140 //直接传alert141 //此项是指定此推送的badge(应用角标)自动加1142 .incrBadge(1)143 //此字段的值default表示系统默认声音;传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒,144 // 如果系统没有此音频则以系统默认声音提醒;此字段如果传空字符串,iOS9及以上的系统是无声音提醒,以下的系统是默认声音145 .setSound("sound.caf")146 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)147 .addExtra("iosNotification extras key",extrasparam)148 //此项说明此推送是一个background推送,想了解background看:http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification149 //取消此注释,消息推送时ios将无法在锁屏情况接收150 // .setContentAvailable(true)151 .build())152 153 //指定当前推送的winPhone通知154 /*.addPlatformNotification(WinphoneNotification.newBuilder()155 .setAlert(notification_alert)156 //.setTitle("")) //设置通知标题(可选)此标题将取代显示app名称的地方157 .build())*/158 .build())159 .build();160 }161 162 /**163 * 建立推送所有用户的推送对象164 * @param notification_alert 通知内容165 * @param notification_title 通知标题166 * @param extrasparam 扩展字段167 * @return 返回推送对象168 */169 private static PushPayload buildPushObjectWithAll(String notification_alert,170 String notification_title, String extrasparam) {171 return PushPayload.newBuilder()172 //指定要推送的平台,all代表当前应用配置了的所有平台,也可以传android等具体平台173 .setPlatform(Platform.all())174 //指定推送的接收对象,all代表所有人,也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id175 .setAudience(Audience.all())176 //jpush的通知,android的由jpush直接下发,iOS的由apns服务器下发,Winphone的由mpns下发177 .setNotification(Notification.newBuilder()178 //指定当前推送的android通知179 .addPlatformNotification(AndroidNotification.newBuilder()180 .setAlert(notification_alert) //设置通知内容(必填)181 .setTitle(notification_title) //设置通知标题(可选)182 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)183 .addExtra("androidNotification extras key",extrasparam)184 .build())185 186 //指定当前推送的iOS通知187 .addPlatformNotification(IosNotification.newBuilder()188 //传一个IosAlert对象,指定apns title、title、subtitle等189 .setAlert(notification_alert)190 //直接传alert191 //此项是指定此推送的badge(应用角标)自动加1192 .incrBadge(1)193 //此字段的值default表示系统默认声音;传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒,194 // 如果系统没有此音频则以系统默认声音提醒;此字段如果传空字符串,iOS9及以上的系统是无声音提醒,以下的系统是默认声音195 .setSound("sound.caf")196 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)197 .addExtra("iosNotification extras key",extrasparam)198 //此项说明此推送是一个background推送,想了解background看:http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification199 //取消此注释,消息推送时ios将无法在锁屏情况接收200 // .setContentAvailable(true)201 .build())202 203 //指定当前推送的winPhone通知204 /*.addPlatformNotification(WinphoneNotification.newBuilder()205 .setAlert(notification_alert)206 //.setTitle("")) //设置通知标题(可选)此标题将取代显示app名称的地方207 .build())*/208 .build())209 .build();210 }211 212 /**213 * 建立推送所有ios用户的推送对象214 * @param notification_alert 通知内容215 * @param notification_title 通知标题216 * @param extrasparam 扩展字段217 * @return 返回推送对象218 */219 private static PushPayload buildPushObjectWithIos(String notification_alert,220 String notification_title, String extrasparam) {221 return PushPayload.newBuilder()222 //指定要推送的平台,all代表当前应用配置了的所有平台,也可以传android等具体平台223 .setPlatform(Platform.ios())224 //指定推送的接收对象,all代表所有人,也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id225 .setAudience(Audience.all())226 //jpush的通知,android的由jpush直接下发,iOS的由apns服务器下发,Winphone的由mpns下发227 .setNotification(Notification.newBuilder()228 229 //指定当前推送的iOS通知230 .addPlatformNotification(IosNotification.newBuilder()231 //传一个IosAlert对象,指定apns title、title、subtitle等232 .setAlert(notification_alert)233 //直接传alert234 //此项是指定此推送的badge(应用角标)自动加1235 .incrBadge(1)236 //此字段的值default表示系统默认声音;传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒,237 // 如果系统没有此音频则以系统默认声音提醒;此字段如果传空字符串,iOS9及以上的系统是无声音提醒,以下的系统是默认声音238 .setSound("sound.caf")239 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)240 .addExtra("iosNotification extras key",extrasparam)241 //此项说明此推送是一个background推送,想了解background看:http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification242 //取消此注释,消息推送时ios将无法在锁屏情况接收243 // .setContentAvailable(true)244 .build())245 .build())246 .build();247 }248 249 /**250 * 建立推送所有安卓用户的推送对象251 * @param notification_alert 通知内容252 * @param notification_title 通知标题253 * @param extrasparam 扩展字段254 * @return 返回推送对象255 */256 private static PushPayload buildPushObjectWithAndroid(String notification_alert,257 String notification_title, String extrasparam) {258 return PushPayload.newBuilder()259 //指定要推送的平台,all代表当前应用配置了的所有平台,也可以传android等具体平台260 .setPlatform(Platform.android())261 //指定推送的接收对象,all代表所有人,也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id262 .setAudience(Audience.all())263 //jpush的通知,android的由jpush直接下发,iOS的由apns服务器下发,Winphone的由mpns下发264 .setNotification(Notification.newBuilder()265 //指定当前推送的android通知266 .addPlatformNotification(AndroidNotification.newBuilder()267 .setAlert(notification_alert) //设置通知内容(必填)268 .setTitle(notification_title) //设置通知标题(可选)269 //此字段为透传字段,不会显示在通知栏。用户可以通过此字段来做一些定制需求,如特定的key传要指定跳转的页面(value)270 .addExtra("androidNotification extras key",extrasparam)271 .build())272 .build())273 .build();274 }275 276 277 278 }
#
執行服務端程式碼後手機會受到以下通知:
其實就是服務端透過唯一辨識的appkey和master secret將通知傳送到極光伺服器,伺服器再轉送至對應的app(上面app的設定檔裡也設定了appkey)
具體操作就是這麼多,可能不是很詳細,但是操作步驟實在太多,就不一一截圖了,這裡只給大部分的具體方向。
以上是關於極光推送Jpush的實例講解的詳細內容。更多資訊請關注PHP中文網其他相關文章!