通知相關(guān)系列文章
iOS10 之前通知使用介紹
[iOS] 通知詳解: UIUserNotification
iOS10 相關(guān)API
[iOS] 通知詳解:iOS 10 UserNotifications API
iOS10 本地/遠(yuǎn)程通知
[iOS] 通知詳解: iOS 10 UserNotifications
iOS10 通知附加包
[iOS] 通知詳解: iOS 10 UserNotifications -- 附加包Media Attachments
iOS10 自定義UI
[iOS] 通知詳解: iOS 10 UserNotifications -- 自定義通知UI
新建 Notification content extension
通知UI的自定義使用到了Notification content extension味混,同創(chuàng)建Notification Service Extension一樣,我們需要?jiǎng)?chuàng)建一個(gè)新的 Target 益兄,只不過(guò)這次選擇Notification content extension:
下一步买优,為這個(gè)Target起一個(gè)名字冗酿,完成即可米母!
可以看到多了下面幾個(gè)文件:
這里的NotificationViewController就是我們編寫(xiě)自定義UI邏輯的控制器下愈,他和一般的控制器一樣,MainInterface.storyboard是與其綁定的署拟,可以在此往storyboard添加控件。Info.plist為其相關(guān)的配置文件歌豺,有些操作需要在這里配置一些設(shè)置后推穷,才能看到預(yù)期的效果,下面關(guān)于此部分的所有配置类咧,都是在這里進(jìn)行的馒铃。
在NotificationViewController中,實(shí)現(xiàn)了UNNotificationContentExtension協(xié)議痕惋,他有兩個(gè)協(xié)議方法
// 必須實(shí)現(xiàn)区宇,用來(lái)處理自定義UI的內(nèi)容
public func didReceive(_ notification: UNNotification)
// 選擇實(shí)現(xiàn),用來(lái)處理action的事件
optional public func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void)
第一個(gè)是必須要實(shí)現(xiàn)的值戳,在NotificationViewController默認(rèn)已經(jīng)實(shí)現(xiàn)了议谷,主要是處理當(dāng)通知來(lái)的時(shí)候,布局自定義的UI內(nèi)容以及相關(guān)的處理邏輯的地方堕虹;
第二個(gè)方法卧晓,當(dāng)前發(fā)送的通知帶有快捷操作action的時(shí)候(UNNotificationAction),來(lái)處理相關(guān)的點(diǎn)擊事件赴捞。
因?yàn)槲覀冏远x的任何View都是無(wú)法交互的逼裆,只能借助添加的action來(lái)處理相關(guān)的事件。
綁定 Category
Notification content extension添加完成后赦政,在通知界面是看不到我們自定義的UI的胜宇,還需要綁定相關(guān)的 Category,即在創(chuàng)建通知的時(shí)候,我們添加的UNNotificationCategory桐愉,如果沒(méi)有需要交互的action封寞,可以傳個(gè)空數(shù)組:
let category = UNNotificationCategory(identifier: "categoryidentifier", actions: [], intentIdentifiers: [], options: UNNotificationCategoryOptions.customDismissAction)
UNUserNotificationCenter.current().setNotificationCategories(Set.init([category]))
然后在該擴(kuò)展下的Info.plist中添加該Category的identifier,對(duì)應(yīng)著UNNotificationExtensionCategory字段:
注意:這里的UNNotificationExtensionCategory可以修改為數(shù)組類型仅财,如果我們有多個(gè)Category公用一套UI狈究,可以將此值修改為Array類型,然后在數(shù)組里添加多個(gè) Category 的identifier盏求。
再去發(fā)送通知抖锥,注意此時(shí)的Payload中要添加category字段:
{
"aps":
{
"alert":
{
"title":"iOS10遠(yuǎn)程推送標(biāo)題",
"subtitle" : "iOS10 遠(yuǎn)程推送副標(biāo)題",
"body":"這是在iOS10以上版本的推送內(nèi)容,并且攜帶來(lái)一個(gè)圖片附件"
},
"category":"categoryidentifier",
"badge":1,
"mutable-content":1,
"sound":"default",
"image":"https://ss2.bdstatic.com/70cFvnSh_Q1YnxGkpoWK1HF6hhy/it/u=3078873712,1340878922&fm=26&gp=0.jpg"
}
}
彈框和鎖屏頁(yè)顯示的內(nèi)容和之前一樣碎罚,打開(kāi)通知或者下拉彈框磅废,就會(huì)看到我們自定義的頁(yè)面了:
比較丑的那部分就是我們自定義的UI了,可以看到真的很丑荆烈,大小還不合適拯勉,而且和系統(tǒng)默認(rèn)的也重復(fù)的。
如果我們想要隱藏系統(tǒng)默認(rèn)的內(nèi)容頁(yè)面憔购,也就是下面的那部分宫峦,頭是隱藏不了的;只需要在Info.plist里添加字段UNNotificationExtensionDefaultContentHidden玫鸟,bool類型并設(shè)置其值為YES导绷;
關(guān)于頁(yè)面太大的問(wèn)題,有的說(shuō)通過(guò)修改其寬高比UNNotificationExtensionInitialContentSizeRatio的值屎飘,如果你的UI是固定的妥曲,可以通過(guò)適配大部分屏幕后,通過(guò)修改此值來(lái)得到合適的寬高比視圖钦购,但其值也是需要各種嘗試的檐盟。
另外也可以使用autolayout,如果是在storyboard里添加的實(shí)圖押桃,順便添加相應(yīng)的約束即可葵萎;然后重新發(fā)送消息,大概就是這個(gè)樣子:
這樣怨规,通知頁(yè)面會(huì)先顯示一個(gè)大的頁(yè)面陌宿,然后再resize到約束后的頁(yè)面大小,這樣就會(huì)一個(gè)縮放的動(dòng)畫(huà)波丰,這是因?yàn)樵谕ㄖ磳⒄故镜臅r(shí)候壳坪,系統(tǒng)還沒(méi)有調(diào)用我們的約束代碼,也就是約束還沒(méi)有起效掰烟,所以會(huì)有個(gè)resize的動(dòng)畫(huà)過(guò)渡爽蝴。
為解決這個(gè)問(wèn)題沐批,只能在自定義UI的時(shí)候配合UNNotificationExtensionInitialContentSizeRatio設(shè)置合適頁(yè)面大小,即采用固定的樣式來(lái)展示通知內(nèi)容蝎亚。
顯示附加包(attachment)的內(nèi)容
如果我們的通知是攜帶附加包的九孩,例如一張圖片,添加自定義的UI后发框,打開(kāi)通知或者下拉彈框會(huì)發(fā)現(xiàn)躺彬,大圖不顯示了,我們可以把相關(guān)的內(nèi)容顯示到自定義的UI上梅惯,還是以圖片為例宪拥,在didReceive方法里添加以下獲取附加包數(shù)據(jù)的代碼:
if let att = notification.request.content.attachments.first {
if att.url.startAccessingSecurityScopedResource() {
self.coverImage.image = UIImage(contentsOfFile: att.url.path)
att.url.stopAccessingSecurityScopedResource()
}
}
這里需要說(shuō)一下startAccessingSecurityScopedResource和stopAccessingSecurityScopedResource方法:
因?yàn)?strong>attachment是由系統(tǒng)單獨(dú)管理的,所以這里我們?cè)谑褂?strong>attachment之前铣减,需要告訴iOS系統(tǒng)她君,我們需要使用它,并且在使用完畢之后告訴系統(tǒng)我們使用完畢了葫哗。對(duì)應(yīng)上述代碼就是startAccessingSecurityScopedResource()和stopAccessingSecurityScopedResource()的操作缔刹。當(dāng)我們獲取到了attachment的使用權(quán)之后,我們就可以使用那個(gè)文件獲取我們想要的信息了劣针。
再去發(fā)送上面的Payload校镐,打開(kāi)后就是這樣了:
意思是那么個(gè)意思,但是加載的圖片好像不太完整酿秸,上面我們是從attachment里面獲取的灭翔,目前不清楚出現(xiàn)這個(gè)情況的原因,可能原數(shù)據(jù)被壓縮了導(dǎo)致數(shù)據(jù)不全辣苏。所以,我們可以從發(fā)送的Payload中來(lái)獲取數(shù)據(jù):
if let aps = notification.request.content.userInfo["aps"] as? [String: Any] {
if let imagePath = aps["image"] as? String {
if let url = URL(string: imagePath) {
if let data = try? Data.init(contentsOf: url) {
self.coverImage.image = UIImage(data: data)
}
}
}
}
這樣就能正常顯示了:
處理action事件
如果我們添加的category是帶有action的,并且action的點(diǎn)擊事件要響應(yīng)到我們自定義的UI里面,例如點(diǎn)擊的時(shí)候更換一個(gè)圖片, 就需要UNNotificationContentExtension協(xié)議的另一個(gè)協(xié)議方法了:
// response:可以拿到點(diǎn)擊的action哄褒,和通知的內(nèi)容
// completion:處理完成后需要告訴系統(tǒng)稀蟋,接下來(lái)該如何處理該通知
optional public func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void)
UNNotificationContentExtensionResponseOption 是一個(gè)枚舉,他有三個(gè)值:
@available(iOS 10.0, *)
public enum UNNotificationContentExtensionResponseOption : UInt {
// 通知頁(yè)面不會(huì)消失呐赡,例如更新UI退客,顯示出來(lái)
case doNotDismiss
// 關(guān)閉當(dāng)前通知頁(yè)面
case dismiss
// 將此action事件傳遞給app,在通知中心的代理方法里繼續(xù)處理該事件
case dismissAndForwardAction
}
需要注意的是链嘀,如果實(shí)現(xiàn)了此方法萌狂,就需要對(duì)所有添加的action進(jìn)行處理,而不能只處理某個(gè)action
例如我們這樣處理點(diǎn)擊事件:
func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
// 改變標(biāo)題
self.label?.text = self.label?.text ?? "" + "點(diǎn)擊了 "
if response.actionIdentifier == "okidentifier" {
// 點(diǎn)擊了查看按鈕怀泊,這里改變了標(biāo)題的顏色
self.label?.textColor = UIColor.red
completion(.doNotDismiss)
} else if response.actionIdentifier == "cancelidentifier" {
// 點(diǎn)擊了關(guān)閉茫藏,直接關(guān)閉通知
completion(.dismiss)
} else {
// 如果還有其他的按鈕,交給app處理
completion(.dismissAndForwardAction)
}
}
然后霹琼,在創(chuàng)建通知的時(shí)候务傲,添加相應(yīng)的action:
let okAction = UNNotificationAction(identifier: "okidentifier", title: "查看", options: UNNotificationActionOptions.foreground)
let cancel = UNNotificationAction(identifier: "cancelidentifier", title: "關(guān)閉", options: UNNotificationActionOptions.destructive)
let category = UNNotificationCategory(identifier: "categoryidentifier", actions: [okAction, cancel], intentIdentifiers: [], options: UNNotificationCategoryOptions.customDismissAction)
UNUserNotificationCenter.current().setNotificationCategories(Set.init([category]))
再次發(fā)生Payload凉当,點(diǎn)擊通知的查看action,會(huì)發(fā)現(xiàn)標(biāo)題和標(biāo)題的顏色都修改了售葡。
處理快捷回復(fù)(輸入文字)
前面知道看杭,我們可以在通知中心進(jìn)行快捷回復(fù),只需要?jiǎng)?chuàng)建UNTextInputNotificationAction的action挟伙,添加到對(duì)應(yīng)的category即可:
let okAction = UNTextInputNotificationAction(identifier: "okidentifier", title: "回復(fù)", options: .foreground, textInputButtonTitle: "快捷回復(fù)", textInputPlaceholder: "請(qǐng)輸入楼雹。。尖阔。")
let cancel = UNNotificationAction(identifier: "cancelidentifier", title: "關(guān)閉", options: UNNotificationActionOptions.destructive)
let category = UNNotificationCategory(identifier: "categoryidentifier", actions: [okAction, cancel], intentIdentifiers: [], options: UNNotificationCategoryOptions.customDismissAction)
UNUserNotificationCenter.current().setNotificationCategories(Set.init([category]))
這里贮缅,我們需要這樣來(lái)處理接收到的反饋:
func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
self.label?.text = "點(diǎn)擊了 "
if response.actionIdentifier == "okidentifier" {
// 這里處理輸入框的事件
if let txRes = response as? UNTextInputNotificationResponse {
// 如果是輸入框的反饋,獲取輸入內(nèi)容诺祸,顯示出來(lái)
let text = txRes.userText
self.label?.text = text
}
// 點(diǎn)擊了查看按鈕携悯,這里改變了標(biāo)題的顏色
self.label?.textColor = UIColor.red
completion(.doNotDismiss)
} else if response.actionIdentifier == "cancelidentifier" {
// 點(diǎn)擊了關(guān)閉,直接關(guān)閉通知
completion(.dismiss)
} else {
// 如果還有其他的按鈕筷笨,交給app處理
completion(.dismissAndForwardAction)
}
}
然后在通知中心點(diǎn)擊回復(fù)按鈕的時(shí)候會(huì)彈出輸入框憔鬼,輸入結(jié)束后,通知中心即顯示了輸入的內(nèi)容:
到此胃夏,斷斷續(xù)續(xù)轴或,總算是把通知相關(guān)的內(nèi)容整體過(guò)了一遍,雖然感覺(jué)上還是有些邏輯混亂仰禀,基本上能夠體現(xiàn)通知的一些使用方法照雁。
參考文章
iOS10-UserNotifications
WWDC2016 Session筆記 - iOS 10 推送Notification新特性