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..<news.count {
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