您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS 10 進階遠端推送:UNNotificationServiceExtension 實作教學

編輯:iOS 開發基礎

本文屬於系列文章的最後一篇,建議先讀過前面兩篇(基礎篇、高階篇)再往下看,內容會比較順。這次終於有完整的 Demo 了。

本文會講解客製化程度更高的遠端通知,包含多媒體遠端推送,以及 UNNotificationServiceExtension、UNNotificationContentExtension、UNNotificationAction 這幾個相關類別。讀完之後,即使不敢說把 iOS 遠端推送摸透,至少能動手做不少擴充。

一、UNNotificationServiceExtension

1.1 它解決了什麼問題

UNNotificationServiceExtension 是 iOS 10 才有的新特性。先看這張流程圖:

原本 APNs 推下來的訊息會直接送到使用者手上,現在中間多了一段 Service Extension 的處理環節(當然也可以選擇不處理)。透過它,你可以在通知真正顯示之前對內容做任何客製加工,最後呈現更豐富的通知樣貌。若網路太差或附件太大,在時限內沒能處理完,系統會退回顯示原始通知內容。

那麼它的價值在哪裡?大致可以歸納為兩點:

  • 安全性
    從 iOS 9 開始,Apple 大力推廣 HTTPS,可見其對安全的重視。以往不論是走第三方服務還是系統預設的通知處理,只要有人在中間攔截封包,推送內容就會赤裸裸地暴露。有人會說「我可以加密啊」,但加密之後通知欄要怎麼顯示呢?总不能把遠端推送全部改成本地通知吧。UNNotificationServiceExtension 正好補上了這一塊:在通知送達後的 30 秒內,你可以完成解密,再把結果呈現到通知欄。

  • 內容更豐富
    過去的通知樣式單薄,很容易被各種推播洗版淹沒。搭配 iOS 10 新增的附件通知與 Service Extension,就能給出視覺上更吸引人的內容——例如影片的某一幀畫面,或是依伺服器給的 imageURL 搭配小圖。據統計,多數使用者其實並沒有關閉通知,這個入口的價值依然可觀,用得好能帶來不少想像空間。

1.2 如何建立 Target

注意: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,最後一段取自你建立擴充時設定的名稱。其他細節可以自行確認。

1.3 實際使用與 Demo

以下是改寫通知內容的方法:

- (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 的內容。

覺得有幫助的話,歡迎關注;轉載請註明出處。

本文轉自徐不同的簡書。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved