Notification Content Extension — esensi, UI khusus dan konfigurasi di iOS

Apa itu Notification Content Extension

Notification Content Extension — adalah ekstensi aplikasi yang mengganti tampilan notifikasi push di iOS. Alih-alih banner standar dengan judul, badan pesan, dan tombol, dapat ditampilkan antarmuka yang sepenuhnya dirancang di Interface Builder atau secara pemrograman melalui UIKit atau SwiftUI.

Tidak seperti Notification Service Extension, yang mengubah konten sebelum ditampilkan, Content Extension hanya bertanggung jawab atas presentasi visual. Ekstensi menerima notifikasi yang sudah jadi setelah semua modifikasi dan memutuskan bagaimana menampilkannya. Ini adalah perbedaan utama antara kedua jenis ekstensi notifikasi.

Ekstensi diaktifkan ketika pengguna melakukan gerakan perluasan — menggulir notifikasi ke bawah atau mengekliknya (tergantung model perangkat). iOS memulai proses ekstensi, membuat pengontrol dari nib atau storyboard yang ditentukan, dan mengirimkan notifikasi melalui UNNotificationContentExtension.

Membuat antarmuka notifikasi khusus

Pengembangan dimulai dengan menambahkan target baru di Xcode dengan template Notification Content Extension. Xcode membuat file MainInterface.storyboard dan kelas yang mewarisi UIViewController, mengimplementasikan protokol UNNotificationContentExtension.

Ukuran dan batasan antarmuka

Tinggi maksimum area khusus — 320 poin di iPhone (untuk model dengan layar besar) dan 352 poin di iPad. Konten yang melampaui batas ini akan terpotong. Untuk adaptasi ke berbagai ukuran, disarankan menggunakan Auto Layout dan UIScrollView untuk konten yang dapat digulir. Lebar selalu sama dengan lebar notifikasi dan berubah secara otomatis saat perangkat diputar.

Apple Human Interface Guidelines memperingatkan: antarmuka notifikasi harus ringkas dan hanya berisi satu elemen utama — gambar, pemutar, peta, atau formulir masukan cepat. Banyak elemen interaktif membebani pengguna dan mempersulit interaksi.

Komunikasi dengan aplikasi utama

App Group — satu-satunya mekanisme pertukaran data antara ekstensi dan aplikasi utama. Melalui direktori bersama App Group, gambar cache, token, dan pengaturan dapat ditransfer. Panggilan API langsung ke aplikasi utama atau akses ke UserDefaults-nya tidak tersedia karena isolasi proses.

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()
        }
    }
}

Protokol UNNotificationContentExtension

UNNotificationContentExtension — protokol utama yang mendefinisikan siklus hidup notifikasi khusus. Protokol ini menyediakan metode untuk menerima konten, memproses tindakan, dan mengelola antarmuka.

Metode didReceive:with:

didReceive(_:with:) dipanggil saat menerima notifikasi. Ekstensi menerima objek UNNotification dan UNNotificationContentExtensionMediaPlayPauseButtonType untuk mengelola pemutar media. Dalam metode ini, antarmuka harus dikonfigurasi — memuat gambar, menginisialisasi pemutar, atau menampilkan data. Sistem memanggil metode ini setiap kali notifikasi diperbarui secara real-time.

Penting untuk diingat bahwa ekstensi memiliki waktu terbatas untuk eksekusi — sekitar 30 detik untuk siklus tampilan penuh. Jika antarmuka tidak siap dalam waktu ini, iOS akan menampilkan notifikasi sistem. Untuk sumber daya berat — memuat gambar dari jaringan, mendekode video — disarankan menggunakan operasi asinkron dengan caching awal melalui App Group.

Mengelola pemutar media

Protokol ini mencakup metode opsional untuk tombol play/pause: mediaPlay, mediaPause, dan mediaPlayPauseButtonType. Jika notifikasi berisi konten audio atau video, ekstensi dapat menampilkan pemutar bawaan dengan elemen kontrol sistem. iOS secara otomatis menambahkan tombol putar di sudut kanan atas ekstensi saat mengembalikan jenis tombol yang sesuai.

Lampiran media dan pemrosesannya

UNNotificationAttachment — objek yang berisi data media yang dilampirkan ke notifikasi. Gambar, file audio, dan video ditambahkan pada tahap pembuatan notifikasi di server atau di Notification Service Extension melalui UNNotificationAttachment.

Format yang didukung

Untuk gambar: JPEG, PNG, GIF, HEIF. Untuk audio: MP3, AAC, ALAC, WAV. Untuk video: MPEG-4, H.264, HEVC. Ukuran maksimum setiap lampiran — 50 MB, hingga 4 lampiran per notifikasi. Sistem secara otomatis mengunduh lampiran di latar belakang sebelum menampilkan notifikasi dan menyediakan akses ekstensi ke URL lokal melalui sumber daya security-scoped.

Menurut Apple, ekstensi tidak boleh memuat media secara mandiri — UNNotificationAttachment sudah berisi URL lokal setelah pengunduhan selesai oleh sistem. Namun, jika lampiran tidak diunduh tepat waktu (misalnya, saat koneksi buruk), ekstensi dapat menampilkan placeholder atau teks alternatif.

Bekerja dengan sumber daya security-scoped

Setiap UNNotificationAttachment menyediakan security-scoped URL, yang harus diakses ekstensi melalui startAccessingSecurityScopedResource() dan dibebaskan melalui stopAccessingSecurityScopedResource(). Metode ini harus dipanggil berpasangan — jika tidak, sumber daya tidak akan dibebaskan dan menyebabkan kebocoran hak akses.

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)

Notifikasi interaktif dan tindakan

Notification Content Extension mendukung tindakan interaktif khusus — tombol yang ditampilkan di bawah konten notifikasi. Tindakan didaftarkan saat membuat kategori notifikasi melalui UNNotificationCategory dan dapat bersifat destruktif, teks, atau latar belakang.

Jenis tindakan

UNNotificationAction — tindakan sederhana dengan judul dan flag destruktif opsional. UNTextInputNotificationAction — tindakan dengan bidang masukan teks, misalnya untuk balasan cepat ke pesan. Kedua jenis mendukung opsi UNNotificationActionOptions.authenticationRequired — persyaratan untuk membuka kunci perangkat sebelum eksekusi.

Ekstensi menerima tindakan yang dipilih melalui metode didReceive(_:withCompletionHandler:), di mana objek UNNotificationResponse dengan pengidentifikasi tindakan dan teks opsional diteruskan. Ekstensi dapat memproses respons secara mandiri atau meneruskannya ke aplikasi utama melalui wadah bersama App Group.

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