本文屬於系列文章的最後一篇,建議先讀過前面兩篇(基礎篇、高階篇)再往下看,內容會比較順。這次終於有完整的 Demo 了。
本文會講解客製化程度更高的遠端通知,包含多媒體遠端推送,以及
UNNotificationServiceExtension、UNNotificationContentExtension、UNNotificationAction這幾個相關類別。讀完之後,即使不敢說把 iOS 遠端推送摸透,至少能動手做不少擴充。
UNNotificationServiceExtension 是 iOS 10 才有的新特性。先看這張流程圖:

原本 APNs 推下來的訊息會直接送到使用者手上,現在中間多了一段 Service Extension 的處理環節(當然也可以選擇不處理)。透過它,你可以在通知真正顯示之前對內容做任何客製加工,最後呈現更豐富的通知樣貌。若網路太差或附件太大,在時限內沒能處理完,系統會退回顯示原始通知內容。
那麼它的價值在哪裡?大致可以歸納為兩點:
安全性
從 iOS 9 開始,Apple 大力推廣 HTTPS,可見其對安全的重視。以往不論是走第三方服務還是系統預設的通知處理,只要有人在中間攔截封包,推送內容就會赤裸裸地暴露。有人會說「我可以加密啊」,但加密之後通知欄要怎麼顯示呢?总不能把遠端推送全部改成本地通知吧。UNNotificationServiceExtension 正好補上了這一塊:在通知送達後的 30 秒內,你可以完成解密,再把結果呈現到通知欄。
內容更豐富
過去的通知樣式單薄,很容易被各種推播洗版淹沒。搭配 iOS 10 新增的附件通知與 Service Extension,就能給出視覺上更吸引人的內容——例如影片的某一幀畫面,或是依伺服器給的 imageURL 搭配小圖。據統計,多數使用者其實並沒有關閉通知,這個入口的價值依然可觀,用得好能帶來不少想像空間。
注意:Service Extension 不是靠新增一個類別來啟用的,你必須建立一個新的 Target。這個 Target 自帶模板,其中兩個方法由系統呼叫:
// 覆寫此方法以改寫通知內容,也可以在此下載附件
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request
withContentHandler:(void (^)(UNNotificationContent *contentToDeliver))contentHandler;
// 若處理時間過長,系統會直接把收到的 APNs 內容顯示出來
- (void)serviceExtensionTimeWillExpire;建立步驟如下:
新增 Target

選擇對應的模版:

接著命名、下一步即可完成。此時專案結構中會多出一個資料夾。


會多出像 myTest 這樣的目錄。

請特別留意 Bundle ID:它由主工程的 Bundle ID 加上副檔名組成,系統已經幫你填好,不要自行修改。舉例來說,若工程 Bundle ID 是 coderxu.pushDemo,則擴充的 Bundle ID 就是 coderxu.pushDemo.mytest,最後一段取自你建立擴充時設定的名稱。其他細節可以自行確認。
以下是改寫通知內容的方法:
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request
withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
self.contentHandler = contentHandler;
// 複製收到的通知,開始處理
self.bestAttemptContent = [request.content mutableCopy];
// 在這裡改寫通知內容
self.bestAttemptContent.title = [NSString stringWithFormat:@"%@ [modified]", self.bestAttemptContent.title];
self.bestAttemptContent.title = @"我是標題";
self.bestAttemptContent.subtitle = @"我是子標題";
self.bestAttemptContent.body = @"來自徐不同";
// 附件
NSDictionary *dict = self.bestAttemptContent.userInfo;
NSDictionary *notiDict = dict[@"aps"];
NSString *imgUrl = [NSString stringWithFormat:@"%@", notiDict[@"imageAbsoluteString"]];
if (!imgUrl.length) {
self.contentHandler(self.bestAttemptContent);
return;
}
[self loadAttachmentForUrlString:imgUrl withType:@"png" completionHandle:^(UNNotificationAttachment *attach) {
if (attach) {
self.bestAttemptContent.attachments = [NSArray arrayWithObject:attach];
}
self.contentHandler(self.bestAttemptContent);
}];
}下載附件的方法:
- (void)loadAttachmentForUrlString:(NSString *)urlStr
withType:(NSString *)type
completionHandle:(void(^)(UNNotificationAttachment *attach))completionHandler {
__block UNNotificationAttachment *attachment = nil;
NSURL *attachmentURL = [NSURL URLWithString:urlStr];
NSString *fileExt = [self fileExtensionForMediaType:type];
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
[[session downloadTaskWithURL:attachmentURL completionHandler:^(NSURL *temporaryFileLocation, NSURLResponse *response, NSError *error) {
if (error != nil) {
NSLog(@"%@", error.localizedDescription);
} else {
NSFileManager *fileManager = [NSFileManager defaultManager];
NSURL *localURL = [NSURL fileURLWithPath:[temporaryFileLocation.path stringByAppendingString:fileExt]];
[fileManager moveItemAtURL:temporaryFileLocation toURL:localURL error:&error];
NSError *attachmentError = nil;
attachment = [UNNotificationAttachment attachmentWithIdentifier:@"" URL:localURL options:nil error:&attachmentError];
if (attachmentError) {
NSLog(@"%@", attachmentError.localizedDescription);
}
}
completionHandler(attachment);
}] resume];
}判斷檔案類型的方法:
- (NSString *)fileExtensionForMediaType:(NSString *)type {
NSString *ext = type;
if ([type isEqualToString:@"image"]) {
ext = @"jpg";
}
if ([type isEqualToString:@"video"]) {
ext = @"mp4";
}
if ([type isEqualToString:@"audio"]) {
ext = @"mp3";
}
return [@"." stringByAppendingString:ext];
}第一段負責通知內容重組:有附件 URL 就下載,沒有就直接顯示。第二段用系統 API 下載圖片、存檔、取得檔案路徑,再建立通知附件(附件的 URL 必須是 file:// 開頭的本地路徑,也就是一定要先下載完)。第三段則是判斷副檔名,方便前端處理。範例中的類型是寫死的,因為只測試了一張圖;實務上更好的做法是讓伺服器在推送內容中直接帶上附件類型。
強烈建議:處理推送內容時,讓伺服器一併帶上檔案類型。
1. 為什麼在擴充類別中用系統 API 下載,而不是 AFNetworking?
嘗試導入 AFN 時一直遇到編譯錯誤,無論是用 CocoaPods 引入、手動拖曳(不勾選 Target)、手動拖曳(勾選 Target),都會報錯;若改用通知回調方式下載,又存在速度慢、執行緒不確定的問題。最後選擇 NSURLSession 的 block 回調方式。
部分錯誤畫面如下(可略過):



2. 為什麼調試通知擴充時,中斷點完全沒反應?
因為你運行的 Target 不對。正確做法是切換到主程式的 Target:

選擇你的主程式 Target:

這時候再下中斷點就能正常命中了。
最後附上推送內容格式:
{
"aps": {
"alert": "This is some fancy message.",
"badge": 1,
"sound": "default",
"mutable-content": "1",
"imageAbsoluteString": "https://upload.univs.cn/2012/0104/1325645511371.jpg"
}
}請務必確保有 "mutable-content": "1",並且一定要包含 alert 欄位,否則攔截通知可能會失敗(Apple 官方文件有提到)。此外你也可以加入自訂欄位,例如圖片網址與圖片類型,其餘就留給大家自行摸索。
成功推送後的顯示效果:

後續會再補充 UNNotificationContentExtension 與 UNNotificationAction 的內容。
覺得有幫助的話,歡迎關注;轉載請註明出處。
本文轉自徐不同的簡書。