Notification Content Extension — bản chất, giao diện tùy chỉnh và thiết lập trong iOS

Notification Content Extension là gì

Notification Content Extension — là một tiện ích mở rộng ứng dụng ghi đè hiển thị thông báo đẩy trên iOS. Thay vì biểu ngữ tiêu chuẩn với tiêu đề, nội dung tin nhắn và các nút, có thể hiển thị giao diện được phát triển hoàn toàn trong Interface Builder hoặc theo chương trình qua UIKit hoặc SwiftUI.

Không giống như Notification Service Extension, thay đổi nội dung trước khi hiển thị, Content Extension chỉ chịu trách nhiệm về trình bày trực quan. Tiện ích mở rộng nhận thông báo đã sẵn sàng sau tất cả các sửa đổi và quyết định cách hiển thị nó. Đây là sự khác biệt chính giữa hai loại tiện ích mở rộng thông báo.

Tiện ích mở rộng được kích hoạt khi người dùng thực hiện cử chỉ mở rộng — cuộn thông báo xuống hoặc nhấp vào nó (tùy thuộc vào model thiết bị). iOS khởi chạy quy trình tiện ích mở rộng, tạo bộ điều khiển từ nib hoặc storyboard được chỉ định và chuyển thông báo qua UNNotificationContentExtension.

Tạo giao diện thông báo tùy chỉnh

Phát triển bắt đầu bằng cách thêm target mới trong Xcode với mẫu Notification Content Extension. Xcode tạo tệp MainInterface.storyboard và một lớp kế thừa từ UIViewController triển khai giao thức UNNotificationContentExtension.

Kích thước và giới hạn giao diện

Chiều cao tối đa của vùng tùy chỉnh — 320 điểm trên iPhone (đối với model màn hình lớn) và 352 điểm trên iPad. Nội dung vượt quá các ranh giới này sẽ bị cắt. Để thích ứng với các kích thước khác nhau, nên sử dụng Auto Layout và UIScrollView cho nội dung có thể cuộn. Chiều rộng luôn bằng chiều rộng thông báo và tự động thay đổi khi xoay thiết bị.

Apple Human Interface Guidelines cảnh báo: giao diện thông báo phải ngắn gọn và chỉ chứa một phần tử chính — hình ảnh, trình phát, bản đồ hoặc biểu mẫu nhập nhanh. Nhiều phần tử tương tác làm quá tải người dùng và phức tạp hóa tương tác.

Kết nối với ứng dụng chính

App Group — cơ chế duy nhất để trao đổi dữ liệu giữa tiện ích mở rộng và ứng dụng chính. Thông qua thư mục dùng chung của App Group, có thể truyền hình ảnh được lưu trong bộ nhớ đệm, mã thông báo và cài đặt. Các lệnh gọi trực tiếp đến API của ứng dụng chính hoặc truy cập vào UserDefaults của nó không khả dụng do sự cô lập tiến trình.

class NotificationViewController: UIViewController {

    func didReceive(
        _ notification: UNNotification
    ) {
        guard let attachment = notification
            .request.content.attachments.first()
        else { return }
        if attachment.url.startAccessingSecurityScopedResource() {
            imageView.image = UIImage(contentsOfFile:
                attachment.url.path)
            attachment.url.stopAccessingSecurityScopedResource()
        }
    }
}

Giao thức UNNotificationContentExtension

UNNotificationContentExtension — giao thức chính xác định vòng đời của thông báo tùy chỉnh. Giao thức cung cấp các phương thức để nhận nội dung, xử lý hành động và quản lý giao diện.

Phương thức didReceive:with:

didReceive(_:with:) được gọi khi nhận được thông báo. Tiện ích mở rộng nhận đối tượng UNNotification và UNNotificationContentExtensionMediaPlayPauseButtonType để quản lý trình phát đa phương tiện. Trong phương thức này, cần thiết lập giao diện — tải hình ảnh, khởi tạo trình phát hoặc hiển thị dữ liệu. Hệ thống gọi phương thức này mỗi khi thông báo được cập nhật theo thời gian thực.

Cần lưu ý rằng tiện ích mở rộng có thời gian giới hạn để thực thi — khoảng 30 giây cho toàn bộ chu kỳ hiển thị. Nếu giao diện không được chuẩn bị trong thời gian này, iOS sẽ hiển thị thông báo hệ thống. Đối với tài nguyên nặng — tải hình ảnh từ mạng, giải mã video — nên sử dụng các hoạt động không đồng bộ với bộ nhớ đệm trước qua App Group.

Quản lý trình phát đa phương tiện

Giao thức bao gồm các phương thức tùy chọn cho nút play/pause: mediaPlay, mediaPause và mediaPlayPauseButtonType. Nếu thông báo chứa nội dung âm thanh hoặc video, tiện ích mở rộng có thể hiển thị trình phát tích hợp với phần tử điều khiển hệ thống. iOS tự động thêm nút phát ở góc trên bên phải của tiện ích mở rộng khi trả về loại nút phù hợp.

Tệp đính kèm đa phương tiện và xử lý

UNNotificationAttachment — đối tượng chứa dữ liệu đa phương tiện được đính kèm với thông báo. Hình ảnh, tệp âm thanh và video được thêm vào ở giai đoạn tạo thông báo trên máy chủ hoặc trong Notification Service Extension qua UNNotificationAttachment.

Định dạng được hỗ trợ

Đối với hình ảnh: JPEG, PNG, GIF, HEIF. Đối với âm thanh: MP3, AAC, ALAC, WAV. Đối với video: MPEG-4, H.264, HEVC. Kích thước tối đa của mỗi tệp đính kèm — 50 MB, tối đa 4 tệp đính kèm cho mỗi thông báo. Hệ thống tự động tải xuống tệp đính kèm trong nền trước khi hiển thị thông báo và cung cấp cho tiện ích mở rộng quyền truy cập vào URL cục bộ thông qua tài nguyên security-scoped.

Theo Apple, tiện ích mở rộng không nên tự tải xuống phương tiện — UNNotificationAttachment đã chứa URL cục bộ sau khi hệ thống hoàn tất tải xuống. Tuy nhiên, nếu tệp đính kèm không được tải kịp (ví dụ: do kết nối kém), tiện ích mở rộng có thể hiển thị văn bản giữ chỗ hoặc thay thế.

Làm việc với tài nguyên security-scoped

Mỗi UNNotificationAttachment cung cấp security-scoped URL mà tiện ích mở rộng phải truy cập qua startAccessingSecurityScopedResource() và giải phóng qua stopAccessingSecurityScopedResource(). Các phương thức này phải được gọi theo cặp — nếu không tài nguyên sẽ không được giải phóng và gây rò rỉ quyền truy cập.

let attachment = notification.request.content.attachments.first()
guard attachment.url.startAccessingSecurityScopedResource()
else { return }
defer { attachment.url.stopAccessingSecurityScopedResource() }
let data = try Data(contentsOf: attachment.url)
imageView.image = UIImage(data: data)

Thông báo tương tác và hành động

Notification Content Extension hỗ trợ các hành động tương tác tùy chỉnh — các nút hiển thị bên dưới nội dung thông báo. Các hành động được đăng ký khi tạo danh mục thông báo qua UNNotificationCategory và có thể là hành động phá hủy, văn bản hoặc nền.

Loại hành động

UNNotificationAction — hành động đơn giản với tiêu đề và cờ phá hủy tùy chọn. UNTextInputNotificationAction — hành động có trường nhập văn bản, ví dụ để trả lời nhanh tin nhắn. Cả hai loại đều hỗ trợ tùy chọn UNNotificationActionOptions.authenticationRequired — yêu cầu mở khóa thiết bị trước khi thực thi.

Tiện ích mở rộng nhận hành động đã chọn qua phương thức didReceive(_:withCompletionHandler:), nơi đối tượng UNNotificationResponse với mã định danh hành động và văn bản tùy chọn được truyền vào. Tiện ích mở rộng có thể tự xử lý phản hồi hoặc chuyển nó đến ứng dụng chính qua vùng chứa App Group dùng chung.

let category = UNNotificationCategory(
    identifier: "message",
    actions: [
        UNTextInputNotificationAction(
            identifier: "reply",
            title: "Reply",
            options: .authenticationRequired
        ),
        UNNotificationAction(
            identifier: "mark_read",
            title: "Mark Read",
            options: .foreground
        )
    ],
    intentIdentifiers: []
)