<pre>上一篇中讲到Message中的一些特性，本次主要讲下Notification的特性</pre>
iOS10相对于之前的版本，主要是开发者可以使用Extension的形式修改和展示内容，主要是<code>UNNotificationServiceExtension</code>和<code>UNNotificationContentExtension</code>。同时也添加了其他方面的支持，例如<code>UNNotificationTrigger</code>、<code>UNNotificationAttachment</code>、<code>UNNotificationAction</code>。本次讲的主要有以下几点:
- UNNotificationTrigger（通知触发条件设定）
- UNNotificationAttachment （通知附件）
- UNNotificationContentExtension （通知内容扩展）
- UNNotificationServiceExtension （通知服务扩展）
- UNNotificationAction （通知响应事件）
1、UNNotificationTrigger（通知触发条件设定）
主要是针对本地通知触发时机的设置，可以使用下面方式设置:
- UNPushNotificationTrigger:这个是苹果通知服务的 Trigger，对外没有暴露任何接口属性，不需要开发者创建，由系统创建。
- UNTimeIntervalNotificationTrigger(时间触发器):通过初始化方法设置通知的timeInterval（触发间隔）
和repeats（是否重复触发），若 repeats 设置为 false，通知将在 timeInterval 之后被推送。 - UNCalendarNotificationTrigger(日期触发器):类似 UNTimeIntervalNotificationTrigger，也是时间触发器，只不过初始化时第一个参数为 DateComponents类型，可设置具体的触发时间比如8:00 AM等，也可设置是否重复触发。
- UNLocationNotificationTrigger(位置触发器):通过设置 CLRegion类型参数设置位置信息，当用户处于某一区域时，自动推送通知。
使用:
//设置Notification内容
UNMutableNotificationContent* content = [[UNMutableNotificationContent alloc] init];
content.title = [NSString localizedUserNotificationStringForKey:@"title!" arguments:nil];
content.body = [NSString localizedUserNotificationStringForKey:@"body" arguments:nil];
content.subtitle = [NSString localizedUserNotificationStringForKey:@"subtitle" arguments:nil];
content.sound = [UNNotificationSound defaultSound];
//初始化时间触发器
UNTimeIntervalNotificationTrigger* trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:10 repeats:NO];
UNNotificationRequest* request = [UNNotificationRequest requestWithIdentifier:@"Identifier"
content:content
trigger:trigger];
// 请求计划推送
[[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
if(error)
{
NSLog(@"%@",error);
}
}];
2、UNNotificationAttachment（通知附件）
苹果所支持的推送附件类型包含视频，音频，图片，苹果的文档中对文件的类型和大小做了如下限制：传送门
使用说明：
- 本地通知：
设置<code>UNMutableNotificationContent</code>如下属性
@property (NS_NONATOMIC_IOSONLY, copy) NSArray <UNNotificationAttachment *> *attachments```
- 远程通知:
通过URL地址下载资源，然后将资源设置到
request.content.attachments中示例代码:
- (void)handlerImageWith:(NSString *)attachUrl{
[self downloadFileAndSave:[NSURL URLWithString:attachUrl] handler:^(NSURL *localUrl) {
if (localUrl){
UNNotificationAttachment *attachment = [UNNotificationAttachment attachmentWithIdentifier:@"image_download" URL:localUrl options:nil error:nil];
self.bestAttemptContent.attachments = @[attachment];
}
self.contentHandler(self.bestAttemptContent);
}];
}
- (void)downloadFileAndSave:(NSURL *)url handler:(void (^)(NSURL *))handler{
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithURL:url
completionHandler:^(NSURL * _Nullable location,
NSURLResponse * _Nullable response,
NSError * _Nullable error) {
NSURL *localURL = nil;
if(!error){
NSString *caches = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
// response.suggestedFilename ： 建议使用的文件名，一般跟服务器端的文件名一致
NSString *file = [caches stringByAppendingPathComponent:response.suggestedFilename];
// 将临时文件剪切或者复制Caches文件夹
NSFileManager *mgr = [NSFileManager defaultManager];
// AtPath : 剪切前的文件路径
// ToPath : 剪切后的文件路径
[mgr moveItemAtPath:location.path toPath:file error:nil];
if (file && ![file isEqualToString: @""])
{
localURL = [NSURL URLWithString:[@"file://" stringByAppendingString:file]];
}
}
handler(localURL);
}];
[downloadTask resume];
}
注意事项:
- UNNotificationContent 的 attachments虽然是一个数组，但是系统只会展示第一个 attachment 对象的内容。不过你依然可以发送多个 attachments，然后在要展示的时候再重新安排它们的顺序，以显示最符合情景的图片或者视频。另外，你也可能会在自定义通知展示 UI 时用到多个 attachment。
- 在当前 beta (iOS 10 beta 4) 中，serviceExtensionTimeWillExpire被调用之前，你有 30 秒时间来处理和更改通知内容。对于一般的图片来说，这个时间是足够的。但是如果你推送的是体积较大的视频内容，用户又恰巧处在糟糕的网络环境的话，很有可能无法及时下载完成。
- 如果你想在远程推送来的通知中显示应用 bundle 内的资源的话，要注意 extension 的 bundle 和 app main bundle 并不是一回事儿。你可以选择将图片资源放到 extension bundle 中，也可以选择放在 main bundle 里。总之，你需要保证能够获取到正确的，并且你具有读取权限的 url。关于从 extension 中访问 main bundle，可以参看这篇回答。
- 系统在创建 attachement 时会根据提供的 url 后缀确定文件类型，如果没有后缀，或者后缀无法不正确的话，你可以在创建时通过 UNNotificationAttachmentOptionsTypeHintKey
来指定资源类型。 - 如果使用的图片和视频文件不在你的 bundle 内部，它们将被移动到系统的负责通知的文件夹下，然后在当通知被移除后删除。如果媒体文件在 bundle 内部，它们将被复制到通知文件夹下。每个应用能使用的媒体文件的文件大小总和是有限制，超过限制后创建 attachment 时将抛出异常。可能的所有错误可以在 UNError中找到。
- 你可以访问一个已经创建的 attachment 的内容，但是要注意权限问题。可以使用 startAccessingSecurityScopedResource来暂时获取以创建的 attachment 的访问权限。比如：
if(notification.request.content.attachments && notification.request.content.attachments.count > 0){
NSURL *imageUrl = notification.request.content.attachments[0].URL;
if([imageUrl startAccessingSecurityScopedResource]){
NSData *imageData = [NSData dataWithContentsOfURL:imageUrl];
UIImage *image = [[UIImage alloc] initWithData:imageData];
self.imageView.image = image;
[imageUrl stopAccessingSecurityScopedResource];
}
}
3、UNNotificationContentExtension（通知内容扩展）
通知内容扩展需要新建一个 UNNotificationContentExtension Target，之后只需在 viewcontroller 的中实现相应的接口，即可以对 app 的通知页面进行自定义扩展，扩展主要用于自定义 UI。扩展页面样式可以在 plist 中配置，字段说明如下:
- UNNotificationExtensionCategory: 要让通知支持内容扩展，需要将通知的 categoryIdentifier（类型标示） 加入此处。
- UNNotificationExtensionDefaultContentHidden: 默认内容隐藏，如果设为 YES，则最下面通知 content 部分会隐藏。
- UNNotificationExtensionIntialContentSizeRation: 初始内容 Size 的比例。也可以在 viewDidLoad 中使用 self.preferredContentSize 直接设置 Size。
使用说明:
远程和本地通知最终都可以使用此扩展自定义 UI，只需将通知的 categoryIdentifier（类型标示） 加入到 plist 中即可。
- 本地推送时，确保设置的 content.categoryIdentifier（通知内容类型标示） 已加入 plist 中。
- 远程推送，需要设置 category 字段，且确保值也已加入 plist 中。
4、UNNotificationServiceExtension （通知服务扩展）
UNNotificationServiceExtension 提供在远程推送将要被 push 出来前，处理推送显示内容的机会。此时可以对通知的 request.content 进行内容添加，如添加附件，userInfo 等。服务器推送实例:
{
"aps" : {
"alert" : {
"title" : "title",
"body" : "Your message Here"
},
// 开启可变内容
"mutable-content" : "1",
// 加入自定义数据，图片 url 路径
"image":"http://....jpg"
}
}
示例代码:
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
self.contentHandler = contentHandler;
self.bestAttemptContent = [request.content mutableCopy];
NSDictionary *apsDic = [request.content.userInfo objectForKey:@"aps"];
NSString *attachUrl = [apsDic objectForKey:@"image"];
if(attachUrl){
[self handlerImageWith:attachUrl];
}
}
5、UNNotificationAction（通知响应事件）
代表一个响应通知的事件。可以为每个通知设置不同的交互事件。下拉推送通知或处在锁屏界面侧滑通知时，会出现交互按键。
交互事件主要分为以下两类：
-
UNNotificationAction：
普通点击按键，可设置 identifier、 title 及 点击后的响应，例如：foreground 前台响应，destructive 点击后销毁通知，authenticationRequired 响应前是否需要解锁。甚至可以使用 UNNotificationAction + accessoryInputView 结合，达到加入自定义辅助输入控件的效果 -
UNTextInputNotificationAction：
当然也可以直接使用系统类 UNTextInputNotificationAction 创建输入框，但是风格比较固定。
示例代码：
- (void)registerNotificationCategory{
UNTextInputNotificationAction *inputAction = [UNTextInputNotificationAction actionWithIdentifier:@"action_reply" title:@"回复" options:UNNotificationActionOptionForeground];
UNNotificationAction *cancelAction = [UNNotificationAction actionWithIdentifier:@"action_cancel" title:@"取消" options:UNNotificationActionOptionDestructive];
UNNotificationCategory *saySomething = [UNNotificationCategory categoryWithIdentifier:saySomethingCategory actions:@[inputAction,cancelAction] intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:[NSSet setWithObject:saySomething]];
}
响应处理：
- 若处于 UNNotificationContentExtension 通知扩展界面时，点击 【回复】按键会回调 UNNotificationContentExtension 扩展接口的方法：
// If implemented, the method will be called when the user taps on one
// of the notification actions. The completion handler can be called
// after handling the action to dismiss the notification and forward the
// action to the app if necessary.
- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response completionHandler:(void (^)(UNNotificationContentExtensionResponseOption option))completion;{
}
- 如果不支持 UNNotificationContentExtension则点击【回复】回调 UNUserNotificationCenterDelegate 中的方法:
// The method will be called on the delegate when the user responded to the notification by opening the application, dismissing the notification or choosing a UNNotificationAction. The delegate must be set before the application returns from applicationDidFinishLaunching:.
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler{
}
补充：iOS10中可以在前台中收到通知了，需要添加一下代码:
\\ notificationHandler实现UNUserNotificationCenterDelegate
[[UNUserNotificationCenter currentNotificationCenter] setDelegate:self.notificationHandler];
