[iOS] 通知詳解: iOS 10 UserNotifications -- 自定義通知UI

通知相關(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 ,只不過這次選擇Notification content extension

下一步,為這個(gè)Target起一個(gè)名字,完成即可!

可以看到多了下面幾個(gè)文件:


這里的NotificationViewController就是我們編寫自定義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),用來處理自定義UI的內(nèi)容
public func didReceive(_ notification: UNNotification)
// 選擇實(shí)現(xiàn),用來處理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)通知來的時(shí)候,布局自定義的UI內(nèi)容以及相關(guān)的處理邏輯的地方;
第二個(gè)方法,當(dāng)前發(fā)送的通知帶有快捷操作action的時(shí)候(UNNotificationAction),來處理相關(guān)的點(diǎn)擊事件。

因?yàn)槲覀冏远x的任何View都是無法交互的,只能借助添加的action來處理相關(guān)的事件。

綁定 Category

Notification content extension添加完成后,在通知界面是看不到我們自定義的UI的,還需要綁定相關(guān)的 Category,即在創(chuàng)建通知的時(shí)候,我們添加的UNNotificationCategory,如果沒有需要交互的action,可以傳個(gè)空數(shù)組:

let category = UNNotificationCategory(identifier: "categoryidentifier", actions: [], intentIdentifiers: [], options: UNNotificationCategoryOptions.customDismissAction)
        UNUserNotificationCenter.current().setNotificationCategories(Set.init([category]))

然后在該擴(kuò)展下的Info.plist中添加該Categoryidentifier,對(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)容,并且攜帶來一個(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"
        
    }
}

彈框和鎖屏頁顯示的內(nèi)容和之前一樣,打開通知或者下拉彈框,就會(huì)看到我們自定義的頁面了:

比較丑的那部分就是我們自定義的UI了,可以看到真的很丑,大小還不合適,而且和系統(tǒng)默認(rèn)的也重復(fù)的。

如果我們想要隱藏系統(tǒng)默認(rèn)的內(nèi)容頁面,也就是下面的那部分,頭是隱藏不了的;只需要在Info.plist里添加字段UNNotificationExtensionDefaultContentHidden,bool類型并設(shè)置其值為YES;

關(guān)于頁面太大的問題,有的說通過修改其寬高比UNNotificationExtensionInitialContentSizeRatio的值,如果你的UI是固定的,可以通過適配大部分屏幕后,通過修改此值來得到合適的寬高比視圖,但其值也是需要各種嘗試的。
另外也可以使用autolayout,如果是在storyboard里添加的實(shí)圖,順便添加相應(yīng)的約束即可;然后重新發(fā)送消息,大概就是這個(gè)樣子:

這樣,通知頁面會(huì)先顯示一個(gè)大的頁面,然后再resize到約束后的頁面大小,這樣就會(huì)一個(gè)縮放的動(dòng)畫,這是因?yàn)樵谕ㄖ磳⒄故镜臅r(shí)候,系統(tǒng)還沒有調(diào)用我們的約束代碼,也就是約束還沒有起效,所以會(huì)有個(gè)resize的動(dòng)畫過渡。
為解決這個(gè)問題,只能在自定義UI的時(shí)候配合UNNotificationExtensionInitialContentSizeRatio設(shè)置合適頁面大小,即采用固定的樣式來展示通知內(nèi)容。

顯示附加包(attachment)的內(nèi)容

如果我們的通知是攜帶附加包的,例如一張圖片,添加自定義的UI后,打開通知或者下拉彈框會(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()
            }
        }

這里需要說一下startAccessingSecurityScopedResourcestopAccessingSecurityScopedResource方法:
因?yàn)?strong>attachment是由系統(tǒng)單獨(dú)管理的,所以這里我們在使用attachment之前,需要告訴iOS系統(tǒng),我們需要使用它,并且在使用完畢之后告訴系統(tǒng)我們使用完畢了。對(duì)應(yīng)上述代碼就是startAccessingSecurityScopedResource()和stopAccessingSecurityScopedResource()的操作。當(dāng)我們獲取到了attachment的使用權(quán)之后,我們就可以使用那個(gè)文件獲取我們想要的信息了。

再去發(fā)送上面的Payload,打開后就是這樣了:

意思是那么個(gè)意思,但是加載的圖片好像不太完整,上面我們是從attachment里面獲取的,目前不清楚出現(xiàn)這個(gè)情況的原因,可能原數(shù)據(jù)被壓縮了導(dǎo)致數(shù)據(jù)不全。所以,我們可以從發(fā)送的Payload中來獲取數(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),接下來該如何處理該通知
optional public func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void)

UNNotificationContentExtensionResponseOption 是一個(gè)枚舉,他有三個(gè)值:

@available(iOS 10.0, *)
public enum UNNotificationContentExtensionResponseOption : UInt {

    // 通知頁面不會(huì)消失,例如更新UI,顯示出來
    case doNotDismiss
// 關(guān)閉當(dāng)前通知頁面
    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]))

這里,我們需要這樣來處理接收到的反饋:

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)容,顯示出來
                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)容整體過了一遍,雖然感覺上還是有些邏輯混亂,基本上能夠體現(xiàn)通知的一些使用方法。
參考文章
iOS10-UserNotifications
WWDC2016 Session筆記 - iOS 10 推送Notification新特性

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容