玩轉 iOS 10 推送 —— UserNotifications Framework（中）

上一篇 我們們聊了一些：

• iOS 10 before 推送的流程
• iOS 10 beta 推送的基本使用方法
• 以及跟 iOS 10 before 推送的區別

這一篇我們們將繼續探討 iOS 10 推送，並向大家介紹一些進階的內容。

Notification Actions

在 iOS 10 中，可以允許推送新增互動操作 action，這些 action 可以使得 App 在前臺或後臺執行一些邏輯程式碼。並且在鎖屏介面通過 3d-touch 觸發。如：推出鍵盤進行快捷回覆，該功能以往只在 iMessage 中可行。
（Notification Actions 在 iOS 8 引入，快捷回覆在 iOS 9 引入，在 iOS 10 中，這些 API 被統一。）

在 iOS 10 中，這叫 category，是對推送功能的一個擴充，可以通過 3d-touch 觸發。

1. 建立 action

   • 即一項互動操作

   • title 是互動按鈕的內容

   • options 可以讓該 action 成為一條可在前臺執行的 action

   • 建立：

     UNNotificationAction *action = [UNNotificationAction actionWithIdentifier:@"reply" title:@"Reply" options:UNNotificationActionOptionNone];複製程式碼

2. 建立 category

   • 可新增多個 action 的陣列，就像圖片中一樣，有多種操作

   • 其中的 id，需要填寫你想要新增到哪個推送訊息的 id

   • 建立：

     UNNotificationCategory *category = [UNNotificationCategory categoryWithIdentifier:@"message" actions:@[action] minimalActions:@[action] intentIdentifiers:@[] options:UNNotificationCategoryOptionNone];複製程式碼

3. 把 category 新增到通知中心：

   [[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:[NSSet setWithArray:@[category]]];複製程式碼

4. 觸發方式：

   • Remote Notifications 配置 payload，指定其中 category 的值與第 2 步中 Identifier 一致：

     {
       aps : {
       alert : "Welcome to WWDC !",
       category : "message"
               }
     }複製程式碼

   • Local Notifications 只需要在建立 contnet 的時候指定 Id 即可：（content 相關內容請參照 上一篇 中的 Content 部分）

     content。categoryIdentifier = @"message";複製程式碼

     ​

Dismiss Actions

鎖屏及在通知中心收到推送，側滑，會展示 action。

只要點選 Clear 就可以將該條推送清除，並且重複的內容不會被髮送到你的其他 iOS 裝置上。

跟 Notification Actions 只有一點小區別，就是新增 action 到 category 的時候，增加一個 option 的值 UNNotificationCategoryOptionCustomDismissAction：

UNNotificationAction *clearAction = [UNNotificationAction actionWithIdentifier:@"clear" title:@"clear" options:UNNotificationActionOptionNone];

UNNotificationCategory *category = [UNNotificationCategory categoryWithIdentifier:@"clear" actions:@[clearAction] intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];//這裡增加一個 dismiss 的值複製程式碼

Response handling

使用者點選這些 actions 以後，是啟動 App、觸發鍵盤、清除通知或是有其他的響應，這些全部只需要實現協議 UNUserNotificationCenterDelegate 中的一個方法就可以控制：

@interface ClassName () <UNUserNotificationCenterDelegate>
-(void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{

}複製程式碼

其中的 response 包含以下內容：

其中的 trigger 可以用來判斷是遠端推送還是本地推送。

處理 response 舉例：

-(void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{

    NSString *categoryIdentifier = response.notification.request.content.categoryIdentifier;

    if ([categoryIdentifier isEqualToString:@"handle category"]) {//識別需要被處理的擴充

        if ([response.actionIdentifier isEqualToString:@"input text"]) {//識別使用者點選的是哪個 action

            //假設點選了輸入內容的 UNTextInputNotificationAction 把 response 強轉型別
            UNTextInputNotificationResponse *textResponse = (UNTextInputNotificationResponse*)response;
              //獲取輸入內容
            NSString *userText = textResponse.userText;
            //傳送 userText 給需要接收的方法
            [ClassName handleUserText: userText];
        }else{

        }

    }
    completionHandler();
}複製程式碼

Service Extension

---

可以在手機「接收到推送之後、展示推送之前」對推送進行處理，更改、替換原有的內容。

使用了這個玩意，你們公司原有傳送推送的 payload 可以完全不變，而在客戶端對接收到的內容（只有一條字串）進行加工，從而適配 iOS 10 的展示效果（標題+副標題+內容）。

「接收到推送之後、展示推送之前」：

• 此時，你獲得了一小段在後臺執行程式碼的時間（也可以用來幹別的壞事>。<，可以偷偷的斷點下載你們 App 的更新包）
• 而如果你更改推送內容出了錯誤，或者你呼叫什麼方法失敗了，那麼最終會正常的展示最初接收到的推送內容。

Potential uses

值得你們 App 充分發揮的是可以做以下事情：

• 端到端加密
• 給推送展示內容新增附件（比如照片、背景音樂），使得內容更加豐富，就像從推送里拉出了一個網頁有木有！

不急，我們先來介紹怎麼

新增 Service Extension

先在 Xcode 開啟你的 App 工程，File - New - Target 然後新增這個：

然後會自動建立一個 UNNotificationServiceExtension 的子類 NotificationService，通過完善這個子類，來實現你的需求。

點開 NotificationService.m 會看到 2 個方法：

- (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.contentHandler(self.bestAttemptContent);
}

- (void)serviceExtensionTimeWillExpire {
    self.contentHandler(self.bestAttemptContent);
}複製程式碼

• didReceiveNotificationRequest 讓你可以在後臺處理接收到的推送，傳遞最終的內容給 contentHandler
• serviceExtensionTimeWillExpire 在你獲得的一小段執行程式碼的時間即將結束的時候，如果仍然沒有成功的傳入內容，會走到這個方法，可以在這裡傳肯定不會出錯的內容，或者他會預設傳遞原始的推送內容

Example payload

{
  aps : {
    alert : "New Message",
    mutable-content : 1
  },
  encrypted-content : "#myencryptedcontent"
}複製程式碼

首先需要新增 mutable-content : 1，這意味著此條推送可以被 Service Extension 進行更改

同時可以附加一條 encrypted-content，可以提取該內容進行替換

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {

    //用你的重編碼方法對該內容進行更改
    NSString *decryptedBody = [DecryptClass decrypt: request.content.userInfo[@"encrypted-content"]];

    //建立新的 content 並新增修改過的 body
    UNMutableNotificationContent *newContent = [UNMutableNotificationContent new];

    newContent.body = decryptedBody;

    //回撥新的 content
    contentHandler(newContent);
}複製程式碼