八、处理通知

UserNotifications 框架为我们提供了查找、更新、删除通知等相关的 API 方法。其中关键在于 request 的 identifier,即在创建时指定的通知标识符。

1,查找通知

(1)获取所有待推送的通知

1
2
3
4
5
6
UNUserNotificationCenter.current().getPendingNotificationRequests { (requests) in
    //遍历所有未推送的request
    for request in requests {
        print(request)
    }
}

目前我们只有一个未推送的通知: 

(2)获取所有已推送的通知

1
2
3
4
5
6
UNUserNotificationCenter.current().getDeliveredNotifications { (notifications) in
    //遍历所有已推送的通知
    for notification in notifications {
        print(notification)
    }
}

2,更新通知

多次推送同一标识符的通知即可进行更新。比如我们有一条标识符为“com.hangge.testNotification”的通知还未触发推送。如果创建并添加一条同样标示符的通知,那么原先的那条通知就会被替换。(而如果原先的通知已展示,则会在通知中心中更新这条通知)

1
2
3
4
5
6
7
8
9
10
11
//使用同样的请求标识符来设置一个新的通知
let requestIdentifier = "com.hangge.testNotification"
let request = UNNotificationRequest(identifier: requestIdentifier,
                                    content: content, trigger: trigger)
 
//将通知请求添加到发送中心
UNUserNotificationCenter.current().add(request) { error in
    if error == nil {
        print("Time Interval Notification scheduled: \(requestIdentifier)")
    }
}

远程推送也可以进行通知的更新:

在使用 Provider API 向 APNs 提交请求时,在 HTTP/2 的 header 中 apns-collapse-id key 的内容将被作为该推送的标识符进行使用。多次推送同一标识符的通知即可进行更新。

3,删除通知

(1)取消未发送的通知

1
2
3
4
5
6
//根据identifier来取消指定通知
let identifier = "com.hangge.testNotification"
UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: [identifier])
 
//取消全部未发送通知
UNUserNotificationCenter.current().removeAllPendingNotificationRequests()

(2)删除已发送的通知(清除通知中心里的记录)

1
2
3
4
5
6
//根据identifier来删除指定通知
let identifier = "com.hangge.testNotification"
UNUserNotificationCenter.current().removeDeliveredNotifications(withIdentifiers: [identifier])
 
//删除全部已发送通知
UNUserNotificationCenter.current().removeAllDeliveredNotifications()

远程推送无法删除已展示的通知:

现在还不能通过类似的方式,向 APNs 发送一个包含 collapse id 的 DELETE 请求来删除已经展示的推送,APNs 服务器并不接受一个 DELETE 请求。

九、应用内展示通知

默认情况下当应用处于前台时,收到的通知是不进行展示的。如果我们希望在应用内也能显示通知的话,需借助 UNUserNotificationCenterDelegate,通过该协议提供的接口方法实现应用内展示通知。

1,样例代码

我们这里在 AppDelegate 中添加相关的代理协议进行处理。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
import UIKit
import UserNotifications
 
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
     
    var window: UIWindow?
     
    let notificationHandler = NotificationHandler()
     
    func application(_ application: UIApplication, didFinishLaunchingWithOptions
        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        //请求通知权限
        UNUserNotificationCenter.current()
            .requestAuthorization(options: [.alert, .sound, .badge]) {
                (accepted, error) in
                if !accepted {
                    print("用户不允许消息通知。")
                }
        }
         
        //设置通知代理
        UNUserNotificationCenter.current().delegate = notificationHandler
         
        return true
    }
     
    func applicationWillResignActive(_ application: UIApplication) {
    }
     
    func applicationDidEnterBackground(_ application: UIApplication) {
    }
     
    func applicationWillEnterForeground(_ application: UIApplication) {
    }
     
    func applicationDidBecomeActive(_ application: UIApplication) {
    }
     
    func applicationWillTerminate(_ application: UIApplication) {
    }
}
 
class NotificationHandler: NSObject, UNUserNotificationCenterDelegate {
    //在应用内展示通知
    func userNotificationCenter(_ center: UNUserNotificationCenter,
                                willPresent notification: UNNotification,
                                withCompletionHandler completionHandler:
        @escaping (UNNotificationPresentationOptions) -> Void) {
        completionHandler([.alert, .sound])
         
        // 如果不想显示某个通知,可以直接用空 options 调用 completionHandler:
        // completionHandler([])
    }
}

2,效果图

可以看到当通知触发时,即使当前应用处于前台,收到的通知也仍然会进行展示。

目前我们只有一个未推送的通知: 

十、通知的响应回调

UNUserNotificationCenterDelegate 还有另外一个代理方法,会在用户与推送的通知进行交互时被调用。比如:用户通过点击通知打开了应用、点击或触发了某个 action。

1,样例代码

(1)我们在程序页面加载完毕后(ViewController.swift)创建一条简单的通知消息(30 秒后触发)。特别要注意的是创建的通知出了基本的标题内容外,还附上了一些额外的信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import UIKit
import UserNotifications
 
class ViewController: UIViewController {
     
    override func viewDidLoad() {
        super.viewDidLoad()
         
        //设置推送内容
        let content = UNMutableNotificationContent()
        content.title = "hangge.com"
        content.body = "做最好的开发者知识平台"
        content.userInfo = ["userName": "hangge", "articleId": 10086]
         
        //设置通知触发器
        let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 30, repeats: false)
         
        //设置请求标识符
        let requestIdentifier = "com.hangge.testNotification"
         
        //设置一个通知请求
        let request = UNNotificationRequest(identifier: requestIdentifier,
                                            content: content, trigger: trigger)
         
        //将通知请求添加到发送中心
        UNUserNotificationCenter.current().add(request) { error in
            if error == nil {
                print("Time Interval Notification scheduled: \(requestIdentifier)")
            }
        }
    }
     
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

(2)然后在 AppDelegate 中添加相关的代理协议来处理用户与通知的交互操作。当用户点击通知后,会将该通知的标题、内容以及前面附加的额外信息给打印出来。(实际应用中我们可以根据 userInfo 的内容来决定页面跳转或者是其他后续操作)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
import UIKit
import UserNotifications
 
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
     
    var window: UIWindow?
     
    let notificationHandler = NotificationHandler()
     
    func application(_ application: UIApplication, didFinishLaunchingWithOptions
        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        //请求通知权限
        UNUserNotificationCenter.current()
            .requestAuthorization(options: [.alert, .sound, .badge]) {
                (accepted, error) in
                if !accepted {
                    print("用户不允许消息通知。")
                }
        }
         
        //设置通知代理
        UNUserNotificationCenter.current().delegate = notificationHandler
         
        return true
    }
     
    func applicationWillResignActive(_ application: UIApplication) {
    }
     
    func applicationDidEnterBackground(_ application: UIApplication) {
    }
     
    func applicationWillEnterForeground(_ application: UIApplication) {
    }
     
    func applicationDidBecomeActive(_ application: UIApplication) {
    }
     
    func applicationWillTerminate(_ application: UIApplication) {
    }
}
 
class NotificationHandler: NSObject, UNUserNotificationCenterDelegate {
    //对通知进行响应(用户与通知进行交互时被调用)
    func userNotificationCenter(_ center: UNUserNotificationCenter,
                                didReceive response: UNNotificationResponse,
                                withCompletionHandler completionHandler:
        @escaping () -> Void) {
        print(response.notification.request.content.title)
        print(response.notification.request.content.body)
        //获取通知附加数据
        let userInfo = response.notification.request.content.userInfo
        print(userInfo)
        //完成了工作
        completionHandler()
    }
}

2,效果图

(1)程序打开后退出,等待 30 秒后会收到推送通知。

目前我们只有一个未推送的通知: 

(2)点击通知则自动打开程序,同时控制台中会输出该通知的标题、内容以及附加信息。

目前我们只有一个未推送的通知: