Swift - UserNotifications框架使用详解7(自定义通知详情视图)

iOS 10 中添加了两个与通知相关的 extension:Service Extension 和 Content Extension。前者我在上文中已经介绍过了,本文介绍下后者:可以用来自定义通知的详细页面视图的 Content Extension。

十五、创建 Notification Content Extension

1,操作步骤

(1)首先我们点击"File" -> "New" -> "Target...",使用 NotificationContent 的模板来创建一个 NotificationContent。

(2)使用模版创建完毕后,会自动生成如下三个文件:

(3)NotificationViewController.swift

这个是一个实现了 UNNotificationContentExtension 的 UIViewController 子类。

该 extension 中有一个必须实现的方法 didReceive(_:)。当系统需要显示自定义样式的通知详情视图时,这个方法将被调用,然后我们可以在其中配置更新我们的 UI。

默认生成的代码如下:直接将通知内容显示在 label 中。我们先不做修改。

import UIKit

import UserNotifications

import UserNotificationsUI


class NotificationViewController: UIViewController, UNNotificationContentExtension {


    @IBOutlet var label: UILabel?


    override func viewDidLoad() {

        super.viewDidLoad()

    }


    func didReceive(_ notification: UNNotification) {

        self.label?.text = notification.request.content.body

    }

}

(4)MainInterface.storyboard

这里定义了该 extension 对应的详情视图 UI。

默认生成的 UI 如下:只有一个 label 文本标签。我们先不做修改。

(5)Info.plist

这里指定了该 extension 的各种配置。我们可以通过 Info.plist 控制通知详细视图的尺寸,以及是否显示原始的通知。

要特别注意的是 UNNotificationExtensionCategory 这个 key 值,它指定这个通知样式所对应的 category 标识符。系统在接收到通知后会通过 category 标识符先查找有没有能够处理这类通知的 content extension,如果存在,那么就交给这个extension 来进行处理。

默认生成的 category 标识符是 myNotificationCategory。我们先不做修改。

2,使用样例

(1)下面代码在页面加载完毕后会自动创建个 5 秒后的推送通知。注意的是我们将通知的 categoryIdentifier 设置成上面 content extension 的 category 标识符。

import UIKit

import UserNotifications


class ViewController: UIViewController {


    override func viewDidLoad() {

        super.viewDidLoad()


        //设置推送内容

        let content = UNMutableNotificationContent()

        content.title = "hangge.com"

        content.body = "做最好的开发者知识平台"


        //设置category标识符

        content.categoryIdentifier = "myNotificationCategory"


        //设置通知触发器

        let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 5, 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)可以看到通知的详情视图已经变成我们自定义的视图了。

十六、自定义通知详情视图(并添加 UI 交互功能)

1,效果图

(1)这里我们推送一条使用自定义详情视图的通知,这个通知里其实包含了三条新闻资讯。

(2)打开通知详情时,会显示第一条资讯的标题、内容摘要、以及相关图片。下方还有三个交互按钮:

点击“换一条”按钮,这个通知视图会继续显示,不过内容会切换成下一条资讯。

点击“打开”按钮,则自动打开应用。我们可以在程序中进行下一步操作,比如打开对应的新闻详情页面。

点击”取消“按钮,则自动清除通知,且不会打开应用。

2,Notification Content Extension 配置

(1)MainInterface.storyboard

这里我们在视图上添加两个 Label 和一个 ImageView,分别用来显示新闻资讯的标题、内容摘要、以及图片。

同时还要设置好各个组件的约束,并在代码中做好 @IBOutlet 关联。

(2)NotificationViewController.swift

我们在这里对详情视图进行显示和更新操作。特别注意的是,虽然我们可以使用包括按钮在内的各种 UI 组件,但是系统不允许我们与这些 UI 进行交互。点击通知视图本身会直接将我们导航到应用中,因此我们需要通过 action 按钮的方式来对视图进行更新。

didReceive(_:completionHandler:)方法介绍:

它是 UNNotificationContentExtension 的一个可选方法,它会在用户选择了某个 action 时被调用。我们可以根据情况给 completionHandler 传递不同的值实现不同操作:

如果需要更新详情视图,可以选择传递 .doNotDismiss 来保持通知继续被显示。

如果没有继续显示的必要,传递 .dismissAndForwardAction 会打开应用,并把通知的 action 继续传递给应用的 UNUserNotificationCenterDelegate 中的 userNotificationCenter(:didReceive:withCompletionHandler)

而传递 .dismiss则直接将这个通知清除,同时也不会打开这个应用。

import UIKit

import UserNotifications

import UserNotificationsUI


//资讯条目

struct NewsItem {

    let title: String

    let abstract: String

    let url: URL

}


class NotificationViewController: UIViewController, UNNotificationContentExtension {


    //显示资讯标题

    @IBOutlet var titleLabel: UILabel!


    //显示资讯内容摘要

    @IBOutlet weak var abstractLabel: UILabel!


    //显示资讯图片

    @IBOutlet weak var imageView: UIImageView!


    //当前显示的资讯索引

    private var index: Int = 0


    //所有资讯条目

    var items: [NewsItem] = []


    override func viewDidLoad() {

        super.viewDidLoad()

    }


    //收到通知

    func didReceive(_ notification: UNNotification) {

        //处理资讯条目

        let content = notification.request.content

        if let news = content.userInfo["news"] as? [[String: String]] {

            for i in 0..

                let title = news[i]["title"] ?? ""

                let abstract = news[i]["abstract"] ?? ""

                let url = content.attachments[i].url

                let presentItem = NewsItem(title: title, abstract: abstract, url: url)

                self.items.append(presentItem)

            }

        }


        //显示第一条资讯

        updateNews(index: 0)

    }


    //更新显示的资讯内容

    private func updateNews(index: Int) {

        let item = items[index]


        //更新标题和内容摘要

        self.titleLabel!.text = item.title

        self.abstractLabel.text = item.abstract


        //更新图片

        if item.url.startAccessingSecurityScopedResource() {

            self.imageView.image = UIImage(contentsOfFile: item.url.path)

            item.url.stopAccessingSecurityScopedResource()

        }


        self.index = index

    }


    //Action按钮点击响应

    func didReceive(_ response: UNNotificationResponse, completionHandler completion:

        @escaping (UNNotificationContentExtensionResponseOption) -> Void) {

        if response.actionIdentifier == "change" {

            //切换下一条资讯

            let nextIndex = (index + 1) % items.count

            updateNews(index: nextIndex)

            //保持通知继续被显示

            completion(.doNotDismiss)

        } else if response.actionIdentifier == "open" {

            //取消这个通知并继续传递Action

            completion(.dismissAndForwardAction)

        } else if response.actionIdentifier == "dismiss" {

            //直接取消这个通知

            completion(.dismiss)

        } else {

            //取消这个通知并继续传递Action

            completion(.dismissAndForwardAction)

        }

    }

}

(3)extension 的 Info.plist

通知扩展对应的 category 标识符这里不做修改。主要修改下 UNNotificationExtensionInitialContentSizeRatio 这个 key 值,它是 UI 界面默认的高宽比,将其修改成 0.8,这样在界面出来的时候不会有很突兀的 frame 改变。

3,Notification Content Extension 使用

(1)AppDelegate.swift

这里要注意的是我们注册一个通知 category,里面包含三个 Action 按钮。

import UIKit

import UserNotifications


@UIApplicationMain

class AppDelegate: UIResponder, UIApplicationDelegate {


    var window: UIWindow?


    func application(_ application: UIApplication, didFinishLaunchingWithOptions

        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {


        UNUserNotificationCenter.current()

            .requestAuthorization(options: [.alert, .sound, .badge]) {

                (accepted, error) in

            if !accepted {

                print("用户不允许消息通知。")

            }

        }


        //注册category

        registerNotificationCategory()


        return true

    }


    func applicationWillResignActive(_ application: UIApplication) {

    }


    func applicationDidEnterBackground(_ application: UIApplication) {

    }


    func applicationWillEnterForeground(_ application: UIApplication) {

    }


    func applicationDidBecomeActive(_ application: UIApplication) {

    }


    func applicationWillTerminate(_ application: UIApplication) {

    }


    //注册一个category

    private func registerNotificationCategory() {

        let newsCategory: UNNotificationCategory = {

            //创建三个普通的按钮action

            let changeAction = UNNotificationAction(

                identifier: "change",

                title: "换一条",

                options: [])


            let openAction = UNNotificationAction(

                identifier: "open",

                title: "打开",

                options: [.foreground])


            //创建普通的按钮action

            let cancelAction = UNNotificationAction(

                identifier: "cancel",

                title: "取消",

                options: [.destructive])


            //创建category

            return UNNotificationCategory(identifier: "myNotificationCategory",

                                          actions: [changeAction, openAction, cancelAction],

                                          intentIdentifiers: [], options: [])

        }()


        //把category添加到通知中心

        UNUserNotificationCenter.current().setNotificationCategories([newsCategory])

    }

}

(2)ViewController.swift

我们同样是页面打开后就推送个 5 秒后的通知。注意的是这里会给通知添加附加信息(包含资讯标题和内容摘要),以及资讯使用的图片附件。

import UIKit

import UserNotifications


class ViewController: UIViewController {


    override func viewDidLoad() {

        super.viewDidLoad()


        //设置推送内容

        let content = UNMutableNotificationContent()

        content.body = "今日资讯精选【2017-12-12】"


        //设置通知category标识符

        content.categoryIdentifier = "myNotificationCategory"


        //设置通知附件图片

        let imageNames = ["image1", "image2", "image3"]

        let attachments = imageNames.flatMap { name -> UNNotificationAttachment? in

            if let imageURL = Bundle.main.url(forResource: name, withExtension: "png") {

                return try? UNNotificationAttachment(identifier: "\(name)", url: imageURL,

                                                     options: nil)

            }

            return nil

        }

        content.attachments = attachments


        //设置通知附加信息(资讯标题和内容摘要)

        content.userInfo = ["news": [

            ["title": "全国人民喜迎油价上涨",

             "abstract": "据国内多家测评机构的分析,国内成品油零售限价将迎来“两连涨”..."],

            ["title": "房价同比下降城市大幅扩容",

             "abstract": "70个大中城市中一二三线城市房价同比涨幅继续回落。这意味着,往年..."],

            ["title": "比特币市值再创新高",

             "abstract": "一项名为SegWit2X的技术取消升级,导致在本周一比特币市值蒸发多达380亿美元..."]

            ]]


        //设置通知触发器

        let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 5, 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()

    }

}

原文出自:www.hangge.com  转载请保留原文链接:https://www.hangge.com/blog/cache/detail_1855.html

你可能感兴趣的:(Swift - UserNotifications框架使用详解7(自定义通知详情视图))