Swift - UserNotifications框架使用详解4(通知的处理、回调、应用内展示)
八、处理通知
UserNotifications 框架为我们提供了查找、更新、删除通知等相关的 API 方法。其中关键在于 request 的 identifier,即在创建时指定的通知标识符。
1,查找通知
(1)获取所有待推送的通知
UNUserNotificationCenter.current().getPendingNotificationRequests { (requests) in //遍历所有未推送的request for request in requests { print(request) } }目前我们只有一个未推送的通知:
(2)获取所有已推送的通知
UNUserNotificationCenter.current().getDeliveredNotifications { (notifications) in //遍历所有已推送的通知 for notification in notifications { print(notification) } }
2,更新通知
多次推送同一标识符的通知即可进行更新。比如我们有一条标识符为“com.hangge.testNotification”的通知还未触发推送。如果创建并添加一条同样标示符的通知,那么原先的那条通知就会被替换。(而如果原先的通知已展示,则会在通知中心中更新这条通知)
//使用同样的请求标识符来设置一个新的通知 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)取消未发送的通知
(2)删除已发送的通知(清除通知中心里的记录)
//根据identifier来取消指定通知 let identifier = "com.hangge.testNotification" UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: [identifier]) //取消全部未发送通知 UNUserNotificationCenter.current().removeAllPendingNotificationRequests()
(2)删除已发送的通知(清除通知中心里的记录)
//根据identifier来删除指定通知 let identifier = "com.hangge.testNotification" UNUserNotificationCenter.current().removeDeliveredNotifications(withIdentifiers: [identifier]) //删除全部已发送通知 UNUserNotificationCenter.current().removeAllDeliveredNotifications()
远程推送无法删除已展示的通知:
现在还不能通过类似的方式,向 APNs 发送一个包含 collapse id 的 DELETE 请求来删除已经展示的推送,APNs 服务器并不接受一个 DELETE 请求。
九、应用内展示通知
默认情况下当应用处于前台时,收到的通知是不进行展示的。如果我们希望在应用内也能显示通知的话,需借助 UNUserNotificationCenterDelegate,通过该协议提供的接口方法实现应用内展示通知。
1,样例代码
我们这里在 AppDelegate 中添加相关的代理协议进行处理。
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 秒后触发)。特别要注意的是创建的通知出了基本的标题内容外,还附上了一些额外的信息。
(2)然后在 AppDelegate 中添加相关的代理协议来处理用户与通知的交互操作。当用户点击通知后,会将该通知的标题、内容以及前面附加的额外信息给打印出来。(实际应用中我们可以根据 userInfo 的内容来决定页面跳转或者是其他后续操作)
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 的内容来决定页面跳转或者是其他后续操作)
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)点击通知则自动打开程序,同时控制台中会输出该通知的标题、内容以及附加信息。
你写的东西真心很好啊