iOS10 User Notifications 学习笔记

Advanced Notifications

注意：此文章涉及代码内容运行环境为 iOS10 Beta1

这几天研究了一下 iOS10 的 User Notifications，相比于老的，新的通知中心增加了一些功能，比如以 Extension 形式提供给用户使用的 UNNotificationContentExtension（通知内容扩展） ；供开发者自定义通知触发条件的 UNNotificationTrigger（触发条件设定）；以及提供用户可加入 UNNotificationAttachment（通知附件） 用来预览。除此之外苹果的 PDF 上还写其它几项优势：

和功能更加相似的 API 设计
处理远程推送和本地推送处的代码位置相同
简单的代理使用模式以及更好的通知管理
当然最重要一点：通知扩展 Notification Extension

具体我会从下面几个方面介绍新通知中心的功能：

1 . UNNotificationTrigger（通知触发条件设定）
2 . UNNotificationAttachment （通知附件）
3 . UNNotificationContentExtension （通知内容扩展）
4 . UNNotificationServiceExtension （通知服务扩展）
5 . UNNotificationAction （通知响应事件）

并且在文章最后给出具体的的 Demo 供大家参考。

1. UNNotificationTrigger - 通知触发条件设定

Trigger

A UNNotificationTrigger object represents an event that triggers the delivery of a notification. This class is abstract, so you do not create instances of it directly. Instead, you create instances of a concrete subclass that define the trigger conditions you want. You then use the trigger object to create the UNNotificationRequest object needed to schedule the delivery of the notification.

Trigger 是新加入的一个功能，通过此类可设置本地通知的触发条件。UNNotificationTrigger 是通知触发条件类的基类，不应该直接使用它，而是使用下面这些子类：

UNPushNotificationTrigger

这个是苹果通知服务的 Trigger，对外没有暴露任何接口属性，不需要开发者创建，由系统创建。

UNTimeIntervalNotificationTrigger 时间触发器

通过初始化方法设置通知的timeInterval（触发间隔）和repeats（是否重复触发），若 repeats 设置为 false，通知将在 timeInterval 之后被推送。

UNCalendarNotificationTrigger 日期触发器

类似 UNTimeIntervalNotificationTrigger，也是时间触发器，只不过初始化时第一个参数为 DateComponents 类型，可设置具体的触发时间比如8:00 AM等，也可设置是否重复触发。

UNLocationNotificationTrigger 位置触发器

通过设置 CLRegion 类型参数设置位置信息，当用户处于某一区域时，自动推送通知。

使用：

初始化 UNNotificationRequest（通知请求）时传入 UNNotificationTrigger 实例，来设置推送通知触发条件：

//  通知触发条件设定为2秒触发一次
let trigger = UNTimeIntervalNotificationTrigger.init(timeInterval: 2,
                                                     repeats: true)
                                                     
//  创建通知请求，设置触发器
let request = UNNotificationRequest.init(identifier: identifier,
                                         content: content,
                                         trigger: trigger)

2. UNNotificationAttachment - 通知附件

Attachment

A UNNotificationAttachment object contains audio, image, or video content to display alongside the notification content. Your app always supplies attachments. For local notifications, the app adds attachments when creating the rest of the notification’s content. You can add attachments to a remote notification by implementing a notification service extension, as represented by the UNNotificationServiceExtension class.

推送的通知允许夹带一个附件，格式支持视频，音频，图片。

苹果的文档中对文件的类型和大小做了如下限制：

使用：

对于本地通知，创建 UNMutableNotificationContent（通知内容）时设置 attachments （附件）属性即可加入附件。
对于远程推送通知服务，需要实现 UNNotificationServiceExtension（通知服务扩展），在回调方法中处理推送内容时设置 request.content.attachments（请求内容的附件）属性，之后调用 contentHandler 方法即可。
无论是本地或者远程推送，如果没有设置 UNNotificationContentExtension （通知内容扩展），设备下拉或重压后，附件会直接出现在 Content 中。如下图：

这里需要说明的是 UNNotificationAttachment 的初始化方法：

1	func init(identifier: String, url URL: URL, options: [NSObject : AnyObject]? = [:]) throws

的第二个参数 url 指的是附件的 url，此附件必须在本地硬盘上，否则创建时可能出现异常抛出。

如果采取的是本地推送，直接读取文件的所在的位置的 URL 即可；如果是远程推送，由于 attachments 的设置是在 NotificationServiceExtension 的 Target 中，若需读取 Bundle 中的文件，记得将资源加入 NotificationServiceExtension Target 的 Copy Bundle Resource，不能直接读取 Containing App Target 中的 Bundle Resource。

3. UNNotificationContentExtension - 通知内容扩展

ContentExtension

The UNNotificationContentExtension protocol lets you present a custom interface for your app’s notifications. You adopt this protocol in custom UIViewController subclasses, using the view controller’s view to display the notification contents. You deliver your view controller class inside a Notification Content extension.

iOS User Notifications 最大的革新在于加入了以 Extension 形式提供给开发者和用户使用的 UNNotificationContentExtension，但是只有支持 3DTouch 的设备下拉或重压才能呼出…，但是明明下拉也可以呼出的控件为什么不支持无 3DTouch 的设备，苹果这盘棋下的好啊。(注：以上均为 iOS10 beta1 下的表现；据说 beta2 下不支持 3DTouch 的的设备下拉也可以使用 UNNotificationContentExtension，后续等正式版在测试吧)

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

创建好的 Extension Target 自带一个 ViewController，支持 stroyBoard 使用 autoLayout 布局，但是此 ViewController 不支持交互，加载上面的手势、button 等交互控件都将无效。若需交互，使用 UNNotificationAction （通知响应事件）提供按键或输入源，关于 UNNotificationAction 的用法之后 UNNotificationAction 小节会具体讲解。

扩展页面样式可以在 plist 中配置，提供三个 key 进行设置:

扩展配置

UNNotificationExtensionCategory: 要让通知支持内容扩展，需要将通知的 categoryIdentifier（类型标示）加入此处。
UNNotificationExtensionDefaultContentHidden: 默认内容隐藏，如果设为 YES，则最下面通知 content 部分会隐藏。

UNNotificationExtensionIntialContentSizeRation: 初始内容 Size 的比例。也可以在 viewDidLoad 中使用 self.preferredContentSize 直接设置 Size。

使用：

远程和本地通知最终都可以使用此扩展自定义 UI，只需将通知的 categoryIdentifier（类型标示）加入到 plist 中即可。

本地推送时，确保设置的 content.categoryIdentifier（通知内容类型标示）已加入 plist 中。
远程推送，需要设置 category 字段，且确保值也已加入 plist 中。

4. UNNotificationServiceExtension - 通知服务扩展

ServiceExtension

A UNNotificationServiceExtension object, the principle class for a Notification Service app extension, lets you process the payload of a remote (sometimes called push) notification before it is delivered to the user.

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

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

服务器推送信息示例：

{
  "aps" : {
    "alert" : {
      "title" : "title",
      "body" : "Your message Here"		
    },
    // 开启可变内容
    "mutable-content" : "1",			
    // category 为已添加入 UNNotificationContentExtension plist 的值时，即可支持 UNNotificationContentExtension
    "category" : "Cheer"				
  },
  // 加入自定义数据，图片 url 路径
  "imageAbsoluteString" : "http://....jpg"
}

5. UNNotificationAction 通知响应事件

A UNNotificationAction object represents a task that your app can perform in response to a notification. You can define custom different actions for each type of notification that your app supports. The action object itself contains information about how to display that action onscreen. When the user selects that action, the system forwards the action’s identifier string to your app so that you can perform the corresponding task.

UNNotificationAction 代表一个响应通知的事件。可以为每个通知设置不同的交互事件。下拉推送通知或处在锁屏界面侧滑通知时，会出现交互按键。

交互事件主要分为以下两类：

UNNotificationAction：

普通点击按键，可设置 identifier、 title 及点击后的响应，例如：foreground 前台响应，destructive 点击后销毁通知，authenticationRequired 响应前是否需要解锁。

甚至可以使用 UNNotificationAction + accessoryInputView 结合，达到加入自定义辅助输入控件的效果：

UNTextInputNotificationAction：

当然也可以直接使用系统类 UNTextInputNotificationAction 创建输入框，但是风格比较固定，比如下面这种：

所以如果想自定义风格多样化的输入框，还是需要使用 UNNotificationAction + accessoryInputView。需要说的是，如果不支持 UNNotificationServiceExtension ，则不支持自定义 accessoryInputView。大概是因为如果不支持 UNNotificationContentExtension 扩展，那么就没有可自定义 UIViewController，自然就不能加 accessoryInputView 了。

响应处理：

若处于 UNNotificationContentExtension 通知扩展界面时，点击 Comment 按键会回调 UNNotificationContentExtension 扩展接口的方法：

1 2	func didReceive(_ response: UNNotificationResponse, completionHandler completion: (UNNotificationContentExtensionResponseOption) -> Void)

如果不支持 UNNotificationContentExtension，就会是下面这种样式：

则点击 Comment 回调 UNUserNotificationCenterDelegate 中的方法：

1
2
3

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            didReceive response: UNNotificationResponse,
                            withCompletionHandler completionHandler: () -> Void) {

结束语

到这里 User Notifications 的功能就介绍的差不多了，可以看出几个核心的功能都需要 3DTouch (iOS10 Beta1 下)的支持，所以暂时在实用性方面还是比较受限制。

UNNotificationAttachment（附件）的加入给产品的带来了更多的思路，这个方向还是很值得去探索的。

如果支持 3DTouch，UNTextInputNotificationAction 对于消息评论的回复或者微博的转发都是很方便的，这些不用处在 APP 前台就能完成。

更多代码实现请查看 Demo，如发现问题，请帮忙指正，感谢阅读。（Demo运行时，请重新设置证书配置文件方可运行）

iOS10 User Notifications 学习笔记

Directory

1. UNNotificationTrigger - 通知触发条件设定

2. UNNotificationAttachment - 通知附件

3. UNNotificationContentExtension - 通知内容扩展

4. UNNotificationServiceExtension - 通知服务扩展

5. UNNotificationAction 通知响应事件

结束语