玩轉 iOS 10 推送 —— UserNotifications Framework(合集)

iOS 10 came

在今年 6月14號 蘋果開發者大會 WWDC 2016 以後,筆者趕忙就去 apple 的開發者網站下載了最新的 Xcode 8 beta 和 iOS 10 beta,而後在本身的手機上裝了 iOS 10 beta ,狠狠地體驗了一把。
能夠說 iOS 10 不管從界面風格,仍是 Framework 都作了不少改動。最直觀的感覺就是界面的圓角增多了,系統動畫更加多樣和流暢,系統 App 的功能也變得更豐富了。ios

而 iOS 10 裏的推送功能,也較以前更增強大,
今天咱們就來聊聊 iOS 10 裏的推送功能。數組

Notifications before iOS 10

首先咱們一塊兒簡單回顧下 iOS 10 之前的推送服務。
iOS 推送分爲 Local Notifications(本地推送) 和 Remote Notifications(遠程推送),先看 2 張圖:服務器


Local Notifications

Remote Notifications

簡單的說就是本地推送經過 App 本地定製,加入到系統的 Schedule 裏,而後在指定的時間推送指定文字。而遠程推送經過服務端向蘋果推送服務器 Apple Push Notification Service (APNs) 發送 Notification Payload,以後 APNs 再將推送下發到指定設備的 指定 App 上。
以及 iOS 7 以後在不顯式地彈窗打擾用戶的狀況下,進行的靜默推送:app


Silent Push

具體作法能夠參考 iOS 7 Background Remote Notificationide

User Notifications Framework


好,扯了這麼多,該進入今天的正題了 —— User Notifications Framework 。
首先在 AppDelegate.m 中動畫

import
#import <UserNotifications/UserNotifications.h>
註冊推送

如下分別是 iOS 10 以前和以後的註冊方式,其中的 UNAuthorizationOptions 裏還能夠找到 1 個 UNAuthorizationOptionCarPlay 的值是專爲車載系統定製的值。網站

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    //iOS 10 before
    UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeAlert | UIUserNotificationTypeBadge | UIUserNotificationTypeSound categories:nil];
    [application registerUserNotificationSettings:settings];

    //iOS 10
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    [center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert) completionHandler:^(BOOL granted, NSError * _Nullable error) {
        if (!error) {
            NSLog(@"request authorization succeeded!");
        }
    }];

    return YES;
}

  

Notification settings

以前註冊推送服務,ios 8 及以前使用了不一樣的 API,而且返回結果也不一樣。如今 apple 不只統一了這個 API,並且咱們能夠獲取到用戶更加詳細的設定了。編碼

[center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
        NSLog(@"%@",settings);
}];

  

打印得到以下信息:加密

<UNNotificationSettings: 0x16567310; 
authorizationStatus: Authorized, 
notificationCenterSetting: Enabled, 
soundSetting: Enabled, 
badgeSetting: Enabled, 
lockScreenSetting: Enabled, 
alertSetting: NotSupported,
carPlaySetting: Enabled, 
alertStyle: Banner>
Token Registration

跟以前同樣url

[[UIApplication sharedApplication] registerForRemoteNotifications];
Content

之前只能展現一條文字,如今能夠有 title 、subtitle 以及 body 了。


定製方法以下:

//Local Notification
UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
content.title = @"Introduction to Notifications";
content.subtitle = @"Session 707";
content.body = @"Woah! These new notifications look amazing! Don’t you agree?";
content.badge = @1;

//Remote Notification
{
"aps" : {
    "alert" : { 
         "title" : "Introduction to Notifications", 
         "subtitle" : "Session 707",         
         "body" : "Woah! These new notifications look amazing! Don’t you agree?"
                },
    "badge" : 1
        },
} 
Triggers

又是一個新的功能,有三種

  • UNTimeIntervalNotificationTrigger
  • UNCalendarNotificationTrigger
  • UNLocationNotificationTrigger
//2 分鐘後提醒
UNTimeIntervalNotificationTrigger *trigger1 = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:120 repeats:NO];

//每小時重複 1 次喊我喝水
UNTimeIntervalNotificationTrigger *trigger2 = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:3600 repeats:YES];

//每週一早上 8:00 提醒我給老婆作早飯
NSDateComponents *components = [[NSDateComponents alloc] init];
components.weekday = 2;
components.hour = 8;
UNCalendarNotificationTrigger *trigger3 = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];

//#import <CoreLocation/CoreLocation.h>
//一到麥當勞就喊我下車
CLRegion *region = [[CLRegion alloc] init];
UNLocationNotificationTrigger *trigger4 = [UNLocationNotificationTrigger triggerWithRegion:region repeats:NO];

  

Add Request
NSString *requestIdentifier = @"sampleRequest";
UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifier
                                                                          content:content
                                                                          trigger:trigger1];
[center addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {

}];

  

推送小結

而後整個推送的過程就變成了醬紫:

  • Local Notifications 經過定義 Content 和 Trigger 向 UNUserNotificationCenter 進行 request 這三部曲來實現。
  • Remote Notifications 則向 APNs 發送 Notification Payload 。
Notification Handling

設定了推送,而後就結束了?iOS 10 並無這麼簡單!
經過實現協議,使 App 處於前臺時捕捉並處理即將觸發的推送:

@interface AppDelegate () <UNUserNotificationCenterDelegate>

-(void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler{

    completionHandler(UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionSound);

}

  讓它只顯示 alert 和 sound ,而忽略 badge 。

Notification Management

完全掌控整個推送週期:

  • Local Notification 經過更新 request
  • Remote Notification 經過新的字段 apns-collapse-id

經過以前的 addNotificationRequest: 方法,在 id 不變的狀況下從新添加,就能夠刷新原有的推送。

NSString *requestIdentifier = @"sampleRequest";
UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifier
                                                                      content:newContent
                                                                      trigger:newTrigger1];
[center addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {

}];

  

刪除計劃的推送:

[center removePendingNotificationRequestsWithIdentifiers:@[requestIdentifier]];

  

此外 UNUserNotificationCenter.h 中還有諸如刪除全部推送、查看已經發出的推送、刪除已經發出的推送等等強大的接口。

刷新原有的推送後,在通知中心的顯示裏,也會有相應的變化,這裏注意第 2 條信息,如今比分是 1:0


比分刷新後爲 1:1,在不產生新的推送條目的狀況下位置被前置了!


試想利用這個方法,不斷的刷新推送,是否是就能夠作到讓本身 App 的推送內容始終展現在用戶手機通知中心的最頂端,力壓其他全部內容了呢?總感受有點不厚道啊~

 

Advanced Notifications


關於推送的更多相似 Media Attachments 的高級功能,咱們將在下一篇裏詳細討論。

Media Attachments

爲推送添加更多媒體附件,諸如圖片、音樂

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);
}

  

Notifications User Interface

咱們先來看一下 iOS 10 默認的推送 UI。
包括「橫幅、鎖屏、通知中心 」三處,看起來差很少的樣子。

Media Attachments

推送內容中增圖片、gif、audio、video。
在以上的三個界面均可以經過 3d-touch 觸發。
先一塊兒來看看效果。

添加方法

  1. 打開 iOS Xcode Project - File - New - Target - iOS - Notification Service Extension - Next - Product Name 填寫 yourPushNotificationService - Finish
    具體圖示方法,在《中》裏有詳細的介紹。

  2. 添加文件。把大家定製的各類 media 文件拖拽至上一步系統自動生成的 yourPushNotificationService 文件夾下,勾上 copy to items,add to targets 必定要選擇這個 Notification Service 做爲 target,以下所示。

  3. 添加代碼。在 2 中生成的 NotificationService.m 裏添加代碼:

    -(void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    
     self.contentHandler     = contentHandler;
    
     // 1.把推送內容轉爲可變類型
     self.bestAttemptContent = [request.content mutableCopy];
    
     // 2.獲取 1 中自定義的字段 value
     NSString *urlStr = [request.content.userInfo valueForKey:@"your-attachment"];
    
     // 3.將文件夾名和後綴分割
     NSArray *urls    = [urlStr componentsSeparatedByString:@"."];
    
     // 4.獲取該文件在本地存儲的 url
     NSURL *urlNative = [[NSBundle mainBundle] URLForResource:urls[0] withExtension:urls[1]];
    
     // 5.依據 url 建立 attachment
     UNNotificationAttachment *attachment = [UNNotificationAttachment attachmentWithIdentifier:urlStr URL:urlNative options:nil error:nil];
    
     // 6.賦值 @[attachment] 給可變內容
     self.bestAttemptContent.attachments = @[attachment];
    
     // 7.處理該內容
     self.contentHandler(self.bestAttemptContent);
    }
    

      

  4. 先運行你的項目 target 使之在手機上安裝,再運行 Notification Service 的 target,並選擇在你的項目上運行該 Extension。此時可進行 Notification Service 代碼的調試,即在 NotificationService.m 中打斷點能夠調試,可是在你的項目中的斷點沒法調試。

  5. 發送 payload 需依照下述格式:

    {  
       aps : { 
           alert : {...}, 
           mutable-content : 1 //必須
       }
       your-attachment : aPicture.png //必須
    }
    

      

    其中:

  6. mutable-content : 1 說明該推送在接收後可被修改,這個字段決定了系統是否會調用 Notification Service 中的方法。
  7. your-attachment:是自定義的字段,key 能夠自定義(你本身要記住),value 須要是一個完整的文件名(或 url,後續會詳細解釋),即你想要展現的文件。

  8. 手機接收後,在任一個能看到推送條目的界面對推送條目進行 3d-touch 強按均可以觸發。(須要 iPhone 6s 及之後設備 & iOS 10)

  9. 提示:各類 media 文件大小有必定限制,圖片、視頻等過大都不會被展現,Apple 的意思是:對於圖片,最大寬度也就和屏幕等寬,過大的圖片沒有意義;對於音頻、視頻等,徹底能夠提供一個短期預覽部分,更多的內容仍是須要用戶點擊推送進入 App 以後對完整的內容進行查看。但願開發者聽從這樣的邏輯進行開發。

Notification Content

iOS 10 新增的另外一項 Extension,用於徹底自定義推送展現的 UI 界面,響應 Actions 的同時刷新該 UI。簡單的說就是你能夠把須要推送的內容(好比一條完整的新聞快訊,包括多條文字+圖片的組合)所有放到一條推送裏,用戶點擊了一個 Action(如贊、踩、關注、甚至評論等),在推送裏馬上刷新 UI(如展現加星動畫、評論內容等)。

特色

  • 須要添加 Notification content extension
  • 徹底自定義 UI
  • 推送 UI 不能響應觸摸、點擊、滑動等任何手勢
  • 能夠響應 notification actions

下圖中日程表的 UI 徹底由開發者自定義,而且在點擊了 Accept 以後,UI 當即發生了變化:

添加方法

打開 iOS Xcode Project - File - New - Target - iOS - Notification Content - Next - Product Name 填寫 yourPushNotificationContent - Finish

系統會在 Xcode 工程目錄中 自動生成 yourPushNotificationContent 文件夾,而且包含四個文件NotificationViewController.hNotificationViewController.mMainInterface.storyboardInfo.plist

NotificationViewController 繼承自 UIViewController,並實現了 UNNotificationContentExtension 協議。

MainInterface.storyboard

拖拖拽拽一個 UI 就出來了 ^。^

NotificationViewController.h/m
  • 你能夠在 viewDidLoad 裏各類代碼寫你的 UI,或者使用 storyboard 拖拖拽拽就 ok
  • 在 didReceiveNotification 方法裏接收推送內容,而後各類處理邏輯、傳值、展現 UI 等等。當點擊了 actions,也會走到這裏,而且包含一個 action 的字段,判斷點擊了哪一個 action 進而相應的更新你的 UI。
Info.plist
  • 須要在這裏讓系統知道,哪一個 id 字段會觸發你這個 extension。


    高亮部分字段的值,須要跟 Notification Actions 的 category id 值同樣,這樣收到推送時,就會同時觸發 Notification content + Notification actions。

  • 同時這裏也能夠添加多個值,用於收到不一樣的推送,展現相似的 UI。
    好比接受聚會邀請和提醒聚會邀請,UI 相近,操做卻不一樣。

調試

當你各類 UI 展現後,會發現存在 2 個問題。

其一

是系統會自動展現一遍收到的推送內容,這部分極可能跟你的內容是重複的。

解決方法

在 Info.plist 中添加以下字段,而且把值設爲 YES 便可隱藏系統默認的展現。

其二

是展現內容比較少的時候,系統仍然會以最大的界面展現出來,會露出不少空白部分。

解決方法
方法一:在 viewDidLoad 中調整 self 的 size 以達到一個合適的尺寸。以下獲取了 size,並修改至一半的高度。
- (void)viewDidLoad {
    [super viewDidLoad];
    CGSize size = self.view.bounds.size;
    self.preferredContentSize = CGSizeMake(size.width, size.height/2);
}

  

效果以下所示,仔細看你會發現存在小 bug,先展現了完整的高度,而後瞬間變成一半的高度,看起來有個高度適應的動畫的樣子。致使這種結果的緣由是系統準備展現推送的時候,尚未執行到你的代碼(展現從系統層級到 App 層級的過程),這是蘋果內部的機制所致。

方法二:仍是在 Info.plist 文件添加新的字段,設置縮放比例。

這樣系統層級會預先讀取該數據,用於展現。固然有時候展現的內容不一樣,須要的高度不一樣,而這裏只能設置成惟一的固定值。不過這也是現階段蘋果所能給你提供的可行方法了。

而後最終的展現效果以下,沒有上面那個不舒服的高度調整動畫了。

小結

感受 Notification Content 的功能極其強大,有了它以後連 App 都不須要再啓動了的樣子(只要能合理的設計展現內容和操做),省去了用戶每次爲了一項簡單操做都要進行「啓動 App - 操做 - 切換到多任務界面 - 退出 App」這樣的繁瑣過程。本來用戶看到推送可能不太有意願去查看詳細內容,如今他只須要很簡單的操做就能快速的查看,推送的點開率應該會所以而大幅增長吧。究其如此便捷的緣由,Notification Service Extension 和 Notification Content 都是獨立於項目的 target,收到推送後,系統會單獨運行這兩個 target,徹底不會在此時去啓動 App 並執行 App 中大量的代碼,童鞋們在調試的時候也能夠注意這一點。

相關文章
相關標籤/搜索