八、处理通知
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)取消未发送的通知
//根据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
}
}
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 秒后触发)。特别要注意的是创建的通知出了基本的标题内容外,还附上了一些额外的信息。
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
}
}
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)点击通知则自动打开程序,同时控制台中会输出该通知的标题、内容以及附加信息。
原文出自:www.hangge.com 转载请保留原文链接:https://www.hangge.com/blog/cache/detail_1846.html