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)取消未发送的通知

//根据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

你可能感兴趣的:(Swift - UserNotifications框架使用详解4(通知的处理、回调、应用内展示))