版本記錄
| 版本號(hào) | 時(shí)間 |
|---|---|
| V1.0 | 2018.07.15 |
前言
我們做APP很多時(shí)候都需要推送功能座每，以直播為例，如果你關(guān)注的主播開播了，那么就需要向關(guān)注這個(gè)主播的人發(fā)送開播通知既棺，提醒用戶去看播讽挟，這個(gè)只是一個(gè)小的方面，具體應(yīng)用根據(jù)公司的業(yè)務(wù)邏輯而定丸冕。前面已經(jīng)花了很多篇幅介紹了極光推送，其實(shí)極光推送無非就是將我們客戶端和服務(wù)端做的很多東西封裝了一下薛窥，節(jié)省了我們很多處理邏輯和流程胖烛，這一篇開始，我們就利用系統(tǒng)的原生推送類結(jié)合工程實(shí)踐說一下系統(tǒng)推送的集成诅迷，希望我的講解能讓大家很清楚的理解它佩番。感興趣的可以看上面幾篇。
1. 系統(tǒng)推送的集成（一） —— 基本集成流程（一）
2. 系統(tǒng)推送的集成（二） —— 推送遇到的幾個(gè)坑之BadDeviceToken問題（一）
3. 系統(tǒng)推送的集成（三） —— 本地和遠(yuǎn)程通知編程指南之你的App的通知 - 本地和遠(yuǎn)程通知概覽（一）
4. 系統(tǒng)推送的集成（四） —— 本地和遠(yuǎn)程通知編程指南之你的App的通知 - 管理您的應(yīng)用程序的通知支持（二）
5. 系統(tǒng)推送的集成（五） —— 本地和遠(yuǎn)程通知編程指南之你的App的通知 - 調(diào)度和處理本地通知（三）
6. 系統(tǒng)推送的集成（六） —— 本地和遠(yuǎn)程通知編程指南之你的App的通知 - 配置遠(yuǎn)程通知支持（四）
7. 系統(tǒng)推送的集成（七） —— 本地和遠(yuǎn)程通知編程指南之你的App的通知 - 修改和顯示通知（五）
8. 系統(tǒng)推送的集成（八） —— 本地和遠(yuǎn)程通知編程指南之蘋果推送通知服務(wù)APNs - APNs概覽（一）
9. 系統(tǒng)推送的集成（九） —— 本地和遠(yuǎn)程通知編程指南之蘋果推送通知服務(wù)APNs - 創(chuàng)建遠(yuǎn)程通知Payload（二）
10. 系統(tǒng)推送的集成（十） —— 本地和遠(yuǎn)程通知編程指南之蘋果推送通知服務(wù)APNs - 與APNs通信（三）
11. 系統(tǒng)推送的集成（十一） —— 本地和遠(yuǎn)程通知編程指南之蘋果推送通知服務(wù)APNs - Payload Key參考（四）
12. 系統(tǒng)推送的集成（十二） —— 本地和遠(yuǎn)程通知編程指南之Legacy信息 - 二進(jìn)制Provider API（一）
Legacy Notification Format - Legacy通知格式
新開發(fā)應(yīng)使用現(xiàn)代格式連接到APNs罢杉，如 Communicating with APNs中所述趟畏。
這些格式不包括優(yōu)先權(quán); 假設(shè)優(yōu)先級(jí)為10。
圖B-1顯示了這種格式滩租。
legacy格式中的第一個(gè)字節(jié)是命令值0（零）赋秀。 其他字段與增強(qiáng)格式相同。 Listing B-1給出了一個(gè)函數(shù)示例律想，該函數(shù)使用legacy通知格式通過二進(jìn)制接口向APNs發(fā)送遠(yuǎn)程通知猎莲。 該示例假設(shè)先前SSL連接到gateway.push.apple.com（或gateway.sandbox.push.apple.com）和對(duì)等交換驗(yàn)證。
// Listing B-1 Sending a notification in the legacy format via the binary interface
static bool sendPayload(SSL *sslPtr, char *deviceTokenBinary, char *payloadBuff, size_t payloadLength)
{
bool rtn = false;
if (sslPtr && deviceTokenBinary && payloadBuff && payloadLength)
{
uint8_t command = 0; /* command number */
char binaryMessageBuff[sizeof(uint8_t) + sizeof(uint16_t) +
DEVICE_BINARY_SIZE + sizeof(uint16_t) + MAXPAYLOAD_SIZE];
/* message format is, |COMMAND|TOKENLEN|TOKEN|PAYLOADLEN|PAYLOAD| */
char *binaryMessagePt = binaryMessageBuff;
uint16_t networkOrderTokenLength = htons(DEVICE_BINARY_SIZE);
uint16_t networkOrderPayloadLength = htons(payloadLength);
/* command */
*binaryMessagePt++ = command;
/* token length network order */
memcpy(binaryMessagePt, &networkOrderTokenLength, sizeof(uint16_t));
binaryMessagePt += sizeof(uint16_t);
/* device token */
memcpy(binaryMessagePt, deviceTokenBinary, DEVICE_BINARY_SIZE);
binaryMessagePt += DEVICE_BINARY_SIZE;
/* payload length network order */
memcpy(binaryMessagePt, &networkOrderPayloadLength, sizeof(uint16_t));
binaryMessagePt += sizeof(uint16_t);
/* payload */
memcpy(binaryMessagePt, payloadBuff, payloadLength);
binaryMessagePt += payloadLength;
if (SSL_write(sslPtr, binaryMessageBuff, (binaryMessagePt - binaryMessageBuff)) > 0)
rtn = true;
}
return rtn;
}
Enhanced Notification Format - 增強(qiáng)的通知格式
增強(qiáng)格式與legacy格式相比有幾處改進(jìn)：
Error response - 錯(cuò)誤響應(yīng)技即。使用
legacy格式著洼，如果您發(fā)送以某種方式格式錯(cuò)誤的通知數(shù)據(jù)包 - 例如，有效負(fù)載超出規(guī)定的限制 - APNs通過切斷連接進(jìn)行響應(yīng)而叼。它沒有說明它拒絕通知的原因身笤。增強(qiáng)格式允許提供者使用任意標(biāo)識(shí)符標(biāo)記通知。如果存在錯(cuò)誤葵陵，APNs將返回將錯(cuò)誤代碼與標(biāo)識(shí)符相關(guān)聯(lián)的數(shù)據(jù)包液荸。此響應(yīng)使provider能夠定位并更正格式錯(cuò)誤的通知。Notification expiration - 通知到期埃难。 APNs具有存儲(chǔ)轉(zhuǎn)發(fā)功能莹弊，可將最新通知發(fā)送到設(shè)備上的應(yīng)用程序。如果設(shè)備在交付時(shí)處于脫機(jī)狀態(tài)涡尘，則APNs會(huì)在設(shè)備下次聯(lián)機(jī)時(shí)發(fā)送通知忍弛。使用
legacy格式，無論通知的相關(guān)性如何考抄，都會(huì)發(fā)送通知细疚。換句話說，通知隨著時(shí)間的推移會(huì)變得“陳舊”川梅。增強(qiáng)格式包括指示通知有效期的到期值疯兼。當(dāng)此期限到期時(shí)然遏，APNs會(huì)在存儲(chǔ)轉(zhuǎn)發(fā)中丟棄通知。
圖B-2描述了通知數(shù)據(jù)包的格式吧彪。
通知格式中的第一個(gè)字節(jié)是命令值1待侵，其余字段如下：
Identifier - 標(biāo)識(shí)符 - 標(biāo)識(shí)此通知的任意值。 如果APNs無法解釋通知姨裸，則在錯(cuò)誤響應(yīng)數(shù)據(jù)包中返回相同的標(biāo)識(shí)符秧倾。
Expiry - 到期 - 以秒（UTC）表示的固定UNIX紀(jì)元日期，用于標(biāo)識(shí)通知何時(shí)不再有效且可以丟棄傀缩。 到期值使用網(wǎng)絡(luò)字節(jié)順序（大端）那先。 如果到期值非零，則APNs嘗試至少傳遞一次通知赡艰。 指定零以請(qǐng)求APNs根本不存儲(chǔ)通知售淡。
Token length - 令牌長度 - 設(shè)備令牌網(wǎng)絡(luò)順序的長度（即大端）
Device token - 設(shè)備令牌 - 二進(jìn)制形式的設(shè)備令牌。
Payload length - 有效負(fù)載長度 - 網(wǎng)絡(luò)順序中有效負(fù)載的長度（即大端）慷垮。 有效負(fù)載不得超過256個(gè)字節(jié)揖闸，且不得以空值終止。
Payload - 有效負(fù)載 - 通知負(fù)載换帜。
Listing B-2在將其發(fā)送到APNs之前以增強(qiáng)格式組成遠(yuǎn)程通知楔壤。 它假設(shè)優(yōu)先SSL連接到gateway.push.apple.com（或gateway.sandbox.push.apple.com）和對(duì)等交換驗(yàn)證。
// Listing B-2 Sending a notification in the enhanced format via the binary interface
static bool sendPayload(SSL *sslPtr, char *deviceTokenBinary, char *payloadBuff, size_t payloadLength)
{
bool rtn = false;
if (sslPtr && deviceTokenBinary && payloadBuff && payloadLength)
{
uint8_t command = 1; /* command number */
char binaryMessageBuff[sizeof(uint8_t) + sizeof(uint32_t) + sizeof(uint32_t) + sizeof(uint16_t) +
DEVICE_BINARY_SIZE + sizeof(uint16_t) + MAXPAYLOAD_SIZE];
/* message format is, |COMMAND|ID|EXPIRY|TOKENLEN|TOKEN|PAYLOADLEN|PAYLOAD| */
char *binaryMessagePt = binaryMessageBuff;
uint32_t whicheverOrderIWantToGetBackInAErrorResponse_ID = 1234;
uint32_t networkOrderExpiryEpochUTC = htonl(time(NULL)+86400); // expire message if not delivered in 1 day
uint16_t networkOrderTokenLength = htons(DEVICE_BINARY_SIZE);
uint16_t networkOrderPayloadLength = htons(payloadLength);
/* command */
*binaryMessagePt++ = command;
/* provider preference ordered ID */
memcpy(binaryMessagePt, &whicheverOrderIWantToGetBackInAErrorResponse_ID, sizeof(uint32_t));
binaryMessagePt += sizeof(uint32_t);
/* expiry date network order */
memcpy(binaryMessagePt, &networkOrderExpiryEpochUTC, sizeof(uint32_t));
binaryMessagePt += sizeof(uint32_t);
/* token length network order */
memcpy(binaryMessagePt, &networkOrderTokenLength, sizeof(uint16_t));
binaryMessagePt += sizeof(uint16_t);
/* device token */
memcpy(binaryMessagePt, deviceTokenBinary, DEVICE_BINARY_SIZE);
binaryMessagePt += DEVICE_BINARY_SIZE;
/* payload length network order */
memcpy(binaryMessagePt, &networkOrderPayloadLength, sizeof(uint16_t));
binaryMessagePt += sizeof(uint16_t);
/* payload */
memcpy(binaryMessagePt, payloadBuff, payloadLength);
binaryMessagePt += payloadLength;
if (SSL_write(sslPtr, binaryMessageBuff, (binaryMessagePt - binaryMessageBuff)) > 0)
rtn = true;
}
return rtn;
}
后記
本篇主要講述了Legacy通知格式惯驼，感興趣的給個(gè)贊或者關(guān)注~~~~
