iOS10通知適配__iOS SDK手冊_App SDK 手冊_移動推送-阿裏雲

/**
 *  創建並注冊通知category(iOS 10+)
 */
- (void)createCustomNotificationCategory {
    // 自定義`action1`和`action2`
    UNNotificationAction *action1 = [UNNotificationAction actionWithIdentifier:@"action1" title:@"test1" options: UNNotificationActionOptionNone];
    UNNotificationAction *action2 = [UNNotificationAction actionWithIdentifier:@"action2" title:@"test2" options: UNNotificationActionOptionNone];
    // 創建id為`test_category`的category，並注冊兩個action到category
    // UNNotificationCategoryOptionCustomDismissAction表明可以觸發通知的dismiss回調
    UNNotificationCategory *category = [UNNotificationCategory categoryWithIdentifier:@"test_category" actions:@[action1, action2] intentIdentifiers:@[] options:
                                        UNNotificationCategoryOptionCustomDismissAction];
    // 注冊category到通知中心
    [center setNotificationCategories:[NSSet setWithObjects:category, nil]];
}

4.4 通知回調

• UNUserNotificationCenterDelegate協議定義了通知相關的回調；

4.4.1 設置代理

• 若要處理通知相關回調，需要實現並指定通知中心對象UNUserNotificationCenter的代理UNUserNotificationCenterDelegate，一般是在AppDelegate中實現，如下所示：

@interface AppDelegate () <UNUserNotificationCenterDelegate>
@end
@implementation AppDelegate
...
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
center.delegate = self;
...
@end

4.4.2 回調1：App在前台收到通知

• 當App處於前台，收到通知會觸發userNotificationCenter:willPresentNotification:withCompletionHandler:回調；
• 在回調中可以處理通知相關的字段信息，回調處理結束前需要調用completionHandler(UNNotificationPresentationOptions)，UNNotificationPresentationOptions的參數含義如下：
  • UNNotificationPresentationOptionNone，通知不提醒；
  • UNNotificationPresentationOptionSound，通知聲音提醒；
  • UNNotificationPresentationOptionAlert，通知內容提醒；
  • UNNotificationPresentationOptionBadge，通知角標提醒。
• 基於此，App在前台時也可以將通知彈出。

/**
 *  處理iOS 10通知(iOS 10+)
 */
- (void)handleiOS10Notification:(UNNotification *)notification {
    UNNotificationRequest *request = notification.request;
    UNNotificationContent *content = request.content;
    NSDictionary *userInfo = content.userInfo;
    // 通知時間
    NSDate *noticeDate = notification.date;
    // 標題
    NSString *title = content.title;
    // 副標題
    NSString *subtitle = content.subtitle;
    // 內容
    NSString *body = content.body;
    // 角標
    int badge = [content.badge intValue];
    // 取得通知自定義字段內容，例：獲取key為"Extras"的內容
    NSString *extras = [userInfo valueForKey:@"Extras"];
    // 通知打開回執上報
    [CloudPushSDK handleReceiveRemoteNotification:userInfo];
    NSLog(@"Notification, date: %@, title: %@, subtitle: %@, body: %@, badge: %d, extras: %@.", noticeDate, title, subtitle, body, badge, extras);
}
/**
 *  App處於前台時收到通知(iOS 10+)
 */
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    NSLog(@"Receive a notification in foregound.");
    // 處理iOS 10通知相關字段信息
    [self handleiOS10Notification:notification];
    // 通知不彈出
    //completionHandler(UNNotificationPresentationOptionNone);
    // 通知彈出，且帶有聲音、內容和角標（App處於前台時不建議彈出通知）
    completionHandler(UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionBadge);
}

4.4.3 回調2：點擊/清除通知

• 點擊/清除通知時， 可在userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:回調裏捕獲到這些動作，根據UNNotificationResponse.actionIdentifier可對這些動作進行區分：
  • 點擊通知打開App，對應UNNotificationDefaultActionIdentifier；
  • 左滑刪除通知，對應UNNotificationDismissActionIdentifier，注冊Category時，需傳入UNNotificationCategoryOptionCustomDismissAction才可以捕獲到該動作，具體見4.3節的Category創建和注冊；
  • 點擊自定義Action，如點擊4.3節創建的id為action1和action2的Action，自定義Action點擊動作的捕獲的好處在於，即使不進入App同樣可完成某些邏輯處理。
• 【注意】兩個通知回調是不衝突的，當App處於前台時，收到通知先觸發userNotificationCenter:willPresentNotification:withCompletionHandler:回調；之後若有點擊通知動作，再觸發userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:回調。

/**
 *  觸發通知動作時回調，比如點擊、刪除通知和點擊自定義action(iOS 10+)
 */
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    NSString *userAction = response.actionIdentifier;
    // 點擊通知打開
    if ([userAction isEqualToString:UNNotificationDefaultActionIdentifier]) {
        NSLog(@"User opened the notification.");
        // 處理iOS 10通知，並上報通知打開回執
        [self handleiOS10Notification:response.notification];
    }
    // 通知dismiss，category創建時傳入UNNotificationCategoryOptionCustomDismissAction才可以觸發
    if ([userAction isEqualToString:UNNotificationDismissActionIdentifier]) {
        NSLog(@"User dismissed the notification.");
    }
    NSString *customAction1 = @"action1";
    NSString *customAction2 = @"action2";
    // 點擊用戶自定義Action1
    if ([userAction isEqualToString:customAction1]) {
        NSLog(@"User custom action1.");
    }
    // 點擊用戶自定義Action2
    if ([userAction isEqualToString:customAction2]) {
        NSLog(@"User custom action2.");
    }
    completionHandler();
}

5. 富媒體推送

• iOS 10添加了通知相關的擴展Notification Service Extension，使得通知彈出前可以對通知內容進行修改。
• iOS遠程推送過程如下圖所示，APNs推送的通知直接在設備上彈出；
• 添加Notification Service Extension後，如下圖所示，APNs推送的通知在彈出前，可先到達Extension進行處理，【注意】OpenAPI需要調用setiOSMutableContent(true)接口，這樣Extension才可生效。

• 在Service Extension後台預處理階段，可從遠程服務器下載或從本地獲取富媒體（圖片、音頻、視頻）資源，將其作為attachment添加到通知中，富媒體資源類型和大小限製如下：

• Notification Service Extension添加步驟：

  • Xcode -> File -> New -> Target，選擇Notification Service Extension，如下圖所示：
  • 輸入Target名，創建完成後在目錄下Xcode會自動生成NotificationService的模板，在didReceiveNotificationRequest回調方法中，處理通知彈出前的動作。
• 可參考iOS Demo Notification Service Extension的實現攜帶圖片的推送通知，從OpenAPI設定的自定義參數attachment字段中獲取圖片Url，或者從本地獲取圖片資源，效果如下圖所示。
• 【注意】從遠程服務器獲取富媒體資源時，同樣需遵循App Transport Security (ATS)的原則，若需要請求HTTP資源請參考ATS配置，為Service Extension Target進行配置；建議限製為請求HTTPS資源。