iOS10 推送通知 UserNotifications

简介

iOS10新增了UserNotificationKit框架,整合了关于通知的方法。增加了很多新特性:

1. 推送内容更加丰富

  • 由之前的alert到现在的title、subtitle、body。
  • 为推送增加了附近,包括符合格式和大小的图片、音频、视频。

2. 方便的对推送的周期进行管理

  • 更新推送
  • 删除推送
  • 查看推送

新框架

#import <UserNotifications/UserNotifications.h>

通过UNNotificationCenter来管理本地和远程通知,包括本地通知和远程通知。

获取权限

//iOS8以下
[application registerForRemoteNotificationTypes:UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound];

//iOS8 - iOS10
[application registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeAlert | UIUserNotificationTypeSound | UIUserNotificationTypeBadge categories:nil]];

//iOS10
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options completionHandler:^(BOOL granted, NSError * _Nullable error) {

}

获取用户设置

iOS10 提供了获取用户授权相关设置信息的接口getNotificationSettingsWithCompletionHandler: , 回调带有一个UNNotificationSettings对象,它具有以下属性,可以准确获取各种授权信息

authorizationStatus
soundSetting 
badgeSetting 
alertSetting 
notificationCenterSetting 
lockScreenSetting 
carPlaySetting
alertStyle

注册APNS,获取deviceToken

iOS10, 注册APNS和获取deviceToken的方法还和之前一样

[[UIApplication sharedApplication] registerForRemoteNotifications];
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
}

- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
}

本地推送流程

  1. 设置推送内容
  2. 设置通知触发器
  3. 添加通知
  4. 管理通知

1. 设置推送内容

attachments         //附件
badge               //数字标志
title               //推送内容标题
subtitle            //推送内容子标题
body                //推送内容body
categoryIdentifier  //category标识,操作策略
launchImageName     //点击通知进入应用的启动图
sound               //声音
userInfo             //附带通知内容
UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
content.title = @"title";
content.subtitle = @"subtitle";
content.body = @"Copyright © 2016年 Hong. All rights reserved.";
content.sound = [UNNotificationSound soundNamed:@"test.caf"];

2. 设置通知触发器

有4种触发器:

  • UNPushNotificationTrigger 触发APNS服务,系统自动设置(这是区分本地通知和远程通知的标识)
  • UNTimeIntervalNotificationTrigger 一段时间后触发
  • UNCalendarNotificationTrigger 指定日期触发
  • UNLocationNotificationTrigger 根据位置触发,支持进入某地或者离开某地或者都有
//5秒后触发
UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];

//每周三,13点触发
NSDateComponents *components = [[NSDateComponents alloc] init];
components.weekday = 4; //周三
components.hour = 13; //13点
UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];

//这个点,100米范围内,进入触发。
CLLocationCoordinate2D cen = CLLocationCoordinate2DMake(39.990465,116.333386);
CLRegion *region = [[CLCircularRegion alloc] initWithCenter:cen radius:100 identifier:@"center"];
region.notifyOnEntry = YES;
region.notifyOnExit = NO;
UNLocationNotificationTrigger *trigger = [UNLocationNotificationTrigger triggerWithRegion:region repeats:YES];

3. 添加通知

需要先创建request,给request设置content和trigger,再添加到center。

UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:@"request" content:content trigger:trigger];

[[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
    NSLog(@"添加指定位置推送 :%@", error ? [NSString stringWithFormat:@"error : %@", error] : @"success");
}];

4. 管理通知

iOS10的推送都是通过center进行管理的。通过request的identifier,进行通知的查找、更新、删除。这个标识是用来区分这个通知和其他通知的。

  • 更新:center 的 addNotificationRequest:withCompletionHandler: 方法在 id 不变的情况下重新添加,就可以刷新原有的推送。
  • 删除:
removePendingNotificationRequestsWithIdentifiers:  //删除特定等待递送的通知
removeAllPendingNotificationRequests  //删除所有等待递送的通知
removeDeliveredNotificationsWithIdentifiers:  //删除特定已经递送的通知
removeAllDeliveredNotifications  //删除已经递送的通知
  • 查找:
getPendingNotificationRequestsWithCompletionHandler:  //获取所有等待递送的通知
getDeliveredNotificationsWithCompletionHandler:  //获取所有已经递送的通知

远程推送流程

  1. 注册推送,获取deviceToken
  2. 收到普通推送
  3. 收到后台推送
  4. 收到静默推送
  5. 管理通知

1. 注册推送,获取deviceToken

在AppDelegate的application:didRegisterForRemoteNotificationsWithDeviceToken:里获取注册成功的deviceToken

2. 收到普通推送

//iOS10 之前
{
"aps" : {
    "alert" : "title",
    "badge" : 1,
    "sound":"default"
        },
}

//iOS10 新增的文案多样性
{
"aps" : {
    "alert" : { 
         "title" : "title", 
         "subtitle" : "subtitle",         
         "body" : "Copyright © 2016年 Hong. All rights reserved."
                },
    "badge" : 1,
    "sound":"default"
        },
}

3. 收到后台推送

iOS7以后要想在后台做一些操作,需要在APNS增加字段:"content-available":1。并且在Background Modes中增加Remote notifications。

{
     "aps":{
         "alert":"Testing.. (34)",
         "badge":1,
         "sound":"default",
         "content-available":1
         }
}

要修改Background Modes, 可以修改info.plist中UIBackgroundModes字段, 或者在项目Target->Capabilities->Background Modes里面将Remote notifications选中。

![backgroundmodes-1.jpeg](http://upload-images.jianshu.io/upload_images/1124181-7c39e4773

backgroundmodes-2.jpeg

4e5c186.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

后台推送的回调,会调用AppDelegate的application:didReceiveRemoteNotification:fetchCompletionHandler:方法

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler
{
    [[DownloadManager sharedInstance] setCompletionBlock:^(BOOL finish, BOOL stop) {
        NSLog(@"completionblock");
        //后台处理完成
        completionHandler(UIBackgroundFetchResultNewData);
    }];
    [[DownloadManager sharedInstance] start];
}

更多后台处理可以看iOS后台下载

4. 收到静默推送

APNS去掉alert、badge、sound字段实现静默推送,增加增加字段:"content-available":1,也可以在后台做一些事情。

{
     "aps":{
         "content-available":1
         }
}

5. 管理通知

通过新的字段 apns-collapse-id

通知策略(Category+Action)

action:设置标识(identifier)、按钮标题(title)、按钮选项(options)

+ (instancetype)actionWithIdentifier:(NSString *)identifier title:(NSString *)title options:(UNNotificationActionOptions)options;
options:
UNNotificationActionOptionAuthenticationRequired  执行前需要解锁确认
UNNotificationActionOptionDestructive  显示高亮(红色)
UNNotificationActionOptionForeground  将会引起程序启动到前台

action 有2种类型:

  • UNNotificationAction 普通按钮样式
  • UNTextInputNotificationAction 输入框样式

category:设置标识(identifier)、actions、intentIdentifiers(需要填写你想要添加到哪个推送消息的 id)、策略选项(options)

+ (instancetype)categoryWithIdentifier:(NSString *)identifier actions:(NSArray<UNNotificationAction *> *)actions intentIdentifiers:(NSArray<NSString *> *)intentIdentifiers options:(UNNotificationCategoryOptions)options;
options
UNNotificationCategoryOptionNone
UNNotificationCategoryOptionCustomDismissAction  当清除当前通知时,会走center的delegate。
UNNotificationCategoryOptionAllowInCarPlay  适用于行车模式

具体使用

UNNotificationAction *action1 = [UNNotificationAction actionWithIdentifier:@"action1" title:@"需要解锁" options:UNNotificationActionOptionAuthenticationRequired];
UNNotificationAction *action2 = [UNNotificationAction actionWithIdentifier:@"action2" title:@"启动app" options:UNNotificationActionOptionForeground];
//给category设置action
UNNotificationCategory *category1 = [UNNotificationCategory categoryWithIdentifier:@"category1" actions:@[action1, action2] intentIdentifiers:@[] options:UNNotificationCategoryOptionNone];
//给通知内容设置category
content.categoryIdentifier = @"category1";

附件通知

  1. 本地推送通知增加附件,只需给content.attachments设置UNNotificationAttachment附件对象
  2. 远程推送通知增加附件,需要实现 UNNotificationServiceExtension(通知服务扩展),在回调方法中处理 推送内容时设置 request.content.attachments(请求内容的附件) 属性,之后调用 contentHandler 方法即可。

给本地推送通知增加附件

NSString *path = [[NSBundle mainBundle] pathForResource:@"IMG_0723" ofType:@"mp4"];
UNNotificationAttachment *attachment = [UNNotificationAttachment attachmentWithIdentifier:@"atta1" URL:[NSURL fileURLWithPath:path] options:nil error:&error];

content.attachments = @[attachment];

代理回调

1. UNUserNotificationCenterDelegate

通知将要显示的回调方法:应用在前台,收到通知时触发。

- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler
{
    //如果需要在应用在前台也展示通知
    completionHandler(UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
}

操作的回调方法:不管应用在前台、后台还是被手动划掉,下面三种情况将触发该方法:

  1. 点击通知进入应用
  2. 点击action
  3. 清除了category是UNNotificationCategoryOptionCustomDismissAction的通知。
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler
{
    completionHandler();
}

2. UIApplicationDelegate

收到远程推送的回调方法:APNS带有"content-available":1字段,并且应用在前台或者后台时收到远程推送,将触发该方法。(注意:应用被手动划掉将无法触发)

可以在这个方法里做一些后台操作(下载数据,更新UI等),记得修改Background Modes。

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler
{
    completionHandler(UIBackgroundFetchResultNewData);
}

问题: 应用在后台,收到本地通知的回调方法暂时未知。

UNNotificationContentExtension - 通知内容扩展

通知内容扩展需要新建一个 UNNotificationContentExtension Target,之后只需在 viewcontroller 的中实现相应的接口,即可以对 app 的通知页面进行自定义扩展,扩展主要用于自定义 UI。详情

UNNotificationServiceExtension - 通知服务扩展

unnotification-content-extension.jpg

UNNotificationServiceExtension 提供在远程推送将要被 push 出来前,处理推送显示内容的机会。此时可以对通知的 request.content 进行内容添加,如添加附件,userInfo 等。详情

通过远程推送的通知也支持 UNNotificationContentExtension,只需将 content.categoryIdentifier (通知内容类型标示) 的值设置为已经添加到 UNNotificationContentExtension plist 中的值即可。

使用UNNotificationServiceExtension,你有30秒的时间处理这个通知,可以同步下载图像和视频到本地,然后包装为一个UNNotificationAttachment扔给通知,这样就能展示用服务器获取的图像或者视频了。这里需要注意:如果数据处理失败,超时,extension会报一个崩溃信息,但是通知会用默认的形式展示出来,app不会崩溃。

结束语

本文是根据iOS10推送通知的新框架, 将本地、远程推送的完整流程写了一遍。对于UNNotificationContentExtension(通知内容扩展)和 UNNotificationServiceExtension(通知服务扩展)这两块,将会另起篇幅详细描述。

关于通知的两个扩展,这里有更详细的文章

更多代码实现请查看Demo, 如发现问题,请帮忙指正。

如果想了解iOS10之前的推送,点击这里

如果想了解更多有关后台下载的知识, 点击这里

参考

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容