iOS10通知适配开发指南-移动研发平台-阿里云

1. iOS 10通知简介

iOS 10系统对推送通知做了较大增强，远程推送通知相关主要体现在以下几点：

统一通知相关的API和Framework；
通知注册和回调接口修改；
通知内容更丰富，支持富媒体（图片、音频、视频等）推送；
通知详情自定义UI；

总的来说，iOS 10提供了更简洁易用的通知相关接口，提高了处理通知的自由度。

说明

阿里云移动推送对iOS 10通知相关feature配置，通过OpenAPI高级推送接口配置，请参考OpenAPI推送高级接口。阅读本文档时，可参照iOS推送Demo中iOS 10通知相关的代码进行学习和试用。

2. Framework依赖

UserNotifications.framework，iOS 10通知相关类和接口都包含在内；
引用如下：

#import <UserNotifications/UserNotifications.h>

3. 通知字段

原本iOS通知仅支持设置通知内容，可通过OpenAPI的Summary字段设置，参考推送高级接口相关字段，老版本服务端推送通知payload字段如下：

{
    "aps": {
        "alert": {
        "your notification body",
        },
        "badge": 1,
        "sound": "default",
    },
    "key1":"value1",
    "key2":"value2"
}

iOS 10通知支持设置标题(title)、副标题(subtitle)、内容(body)、通知扩展字段(mutable-content)、通知类别(category)，服务端配置参考上述的OpenAPI推送高级接口，当前服务端推送通知payload字段参考如下：

{
    "aps": {
        "alert": {
            "title": "title",
            "subtitle": "subtitle",
            "body": "body"
        },
        "badge": 1,
        "sound": "default",
        "category": "test_category",
        "mutable-content": 1
    },
    "key1":"value1",
    "key2":"value2"
}

重要

使用OpenAPI推送时，若没有进行iOS 10通知相关配置，通知payload保持老版本不变，已经保证对老版本payload兼容性；若进行iOS 10通知相关配置，请确保客户端业务逻辑对payload相关字段处理的兼容性。

iOS 10设备收到通知效果如下，其中标题为”aliyun”，副标题为”push”，内容为”haha”。title设置后，iOS 10+系统显示title如下；【iOS 8.2 <= iOS系统 < iOS 10】，通知应用名称会显示该标题。

4. 通知中心

4.1 简介

基于UNUserNotificationCenter对象进行通知的调度和管理通知相关的行为，具体如下：
- 为通知的提醒、声音和角标请求授权；
- 声明通知类别和可执行动作；
- 管理通知的弹出；
- 管理通知在设备通知中心的展示；
- 获取App通知相关的配置。

通知中心对象获取方式如下：

UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];

4.2 请求授权并向APNs注册

App使用推送功能前，需要向用户请求推送功能授权，如下所示；
第一次调用requestAuthorizationWithOptions请求授权时，App会弹出如下图所示的授权框，注意App卸载重装前该授权框仅弹出一次，若用户点击“不允许”，需要引导用户到“设置”中打开，推送功能才能正常使用。

requestAuthorizationWithOptions回调中可捕获用户是否点击授权，在成功授权回调中调用registerForRemoteNotifications，向APNs注册获取设备的deviceToken，App再次启动时虽然不会弹出授权框，但推送授权请求可获取App推送配置，可触发成功/失败授权回调。
APNs注册成功/失败回调保持不变，在成功回调中调用阿里云推送SDK接口，将deviceToken上报到阿里云推送服务器。
主动调用getNotificationSettingsWithCompletionHandler接口，回调中可获取App推送授权状态。

UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
if (systemVersionNum >= 10.0) {
    center = [UNUserNotificationCenter currentNotificationCenter];
    [center requestAuthorizationWithOptions:UNAuthorizationOptionAlert | UNAuthorizationOptionBadge | UNAuthorizationOptionSound completionHandler:^(BOOL granted, NSError * _Nullable error) {
        if (granted) {
            // granted
            NSLog(@"User authored notification.");
            dispatch_async(dispatch_get_main_queue(), ^{
                [application registerForRemoteNotifications];
            };
        } else {
            // not granted
            NSLog(@"User denied notification.");
        }
    }];
}

/*
 *  APNs注册成功回调，将返回的deviceToken上传到CloudPush服务器
 */
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    NSLog(@"Upload deviceToken to CloudPush server.");
    [CloudPushSDK registerDevice:deviceToken withCallback:^(CloudPushCallbackResult *res) {
        if (res.success) {
            NSLog(@"Register deviceToken success, deviceToken: %@", [CloudPushSDK getApnsDeviceToken]);
        } else {
            NSLog(@"Register deviceToken failed, error: %@", res.error);
        }
    }];
}

/*
 *  APNs注册失败回调
 */
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
    NSLog(@"Get deviceToken failed, error: %@", error);
}

// 主动获取设备通知是否授权(iOS 10+)
- (void)getNotificationSettingStatus {
    [center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
        if (settings.authorizationStatus == UNAuthorizationStatusAuthorized) {
            NSLog(@"User authed.");
        } else {
            NSLog(@"User denied.");
        }
    }];
}

4.3 Action和Category

iOS 8以上支持，此处仅讲述iOS 10系统的实现方式。
通知支持设置Action点击动作，即在通知上添加按钮，点击按钮可触发回调以此做出不同的逻辑处理；
通知支持Category分类，可将Action和Category进行关联，Category和第6节（通知详情自定义UI）相关。
下面代码自定义id为action1和action2的通知动作，创建id为test_category的通知类别后，将两个Action关联到该category，最后注册category到通知中心。
使用OpenAPI推送通知时，调用setiOSNotificationCategory()接口，可指定通知的类别；创建的test_category类别的通知弹出时如下图所示，test1和test2按钮分别对应id为action1和action2的通知Action；
【注意】Category注册到通知中心需要在推送前完成。

/**
 *  创建并注册通知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资源。

6. 通知详情自定义UI

除了Notification Service Extension，另一个通知相关的Extension为内容扩展Content Extension，可用于自定义通知详情UI，如修改样式、颜色等。
iOS 10收到通知后，支持下拉通知（经测试iPhone 5c不支持，建议使用iPhone 6以上手机测试） or 3D touch展开通知详情，携带图片的通知详情样式默认如下图所示，内容扩展可针对通知详情进行定制。

内容扩展添加步骤：
- Xcode -> File -> New -> Target，选择Notification Content，如下图所示：
- 输入Target名，Xcode自动生成NotificationViewController头文件和源文件，MainInterface.storyboard和Info.plist，其中NotificationViewController和MainInterface.storyboard一起定义了通知详情的UI。
- Info.plist中自动生成NSExtension相关KV配置，具体含义如下所示：
  - NSExtensionAttributes
    - UNNotificationExtensionCategory，指定自定义通知详情UI适用于哪些category，可为String or Dictionary；（必需）
    - UNNotificationExtensionInitialContentSizeRatio，通知视图长宽比例；（必需）
    - UNNotificationExtensionDefaultContentHidden，原本通知内容是否隐藏，若不指定，默认为NO；（可选）
  - NSExtensionMainStoryboard，storyboard文件名，默认填充为MainInterface；（必需）
  - NSExtensionPointIdentifier，默认填充为com.apple.usernotifications.content-extension；（必需）
OpenAPI推送时，必需通过setiOSNotificationCategory接口指定通知category，只有指定的category在Info.plist的UNNotificationExtensionCategory设置，才能保证通知详情自定义UI生效。
参考iOS Demo Notification Content Extension的实现方式，进行通知详情自定义UI的设置，如下图所示，绿色的aliyun-body为自定义的展示UI，字段内容通过拷贝通知内容得来。