Notification Content Extension — essentie, aangepaste UI en configuratie in iOS

Wat is Notification Content Extension

Notification Content Extension — is een app-extensie die de weergave van pushmeldingen op iOS overschrijft. In plaats van een standaard banner met titel, berichttekst en knoppen kan een interface worden getoond die volledig is ontworpen in Interface Builder of programmatisch via UIKit of SwiftUI.

In tegenstelling tot Notification Service Extension, die de inhoud wijzigt vóór weergave, is Content Extension alleen verantwoordelijk voor de visuele presentatie. De extensie ontvangt de kant-en-klare melding na alle wijzigingen en beslist hoe deze weer te geven. Dit is het belangrijkste verschil tussen de twee typen meldingsextensies.

De extensie wordt geactiveerd wanneer de gebruiker een uitbreidingsgebaar uitvoert — de melding naar beneden scrollt of erop klikt (afhankelijk van het apparaatmodel). iOS start het extensieproces, maakt de controller van de opgegeven nib of storyboard en geeft de melding door via UNNotificationContentExtension.

Een aangepaste meldingsinterface maken

De ontwikkeling begint met het toevoegen van een nieuw target in Xcode met de sjabloon Notification Content Extension. Xcode maakt het bestand MainInterface.storyboard en een klasse die overerft van UIViewController, die het protocol UNNotificationContentExtension implementeert.

Grootte en beperkingen van de interface

Maximale hoogte van het aangepaste gebied — 320 punten op iPhone (voor modellen met groot scherm) en 352 punten op iPad. Inhoud die buiten deze grenzen valt, wordt afgesneden. Voor aanpassing aan verschillende formaten wordt aanbevolen Auto Layout en UIScrollView te gebruiken voor scrollbare inhoud. De breedte is altijd gelijk aan de breedte van de melding en verandert automatisch bij rotatie van het apparaat.

Apple Human Interface Guidelines waarschuwen: de meldingsinterface moet beknopt zijn en slechts één hoofdelement bevatten — een afbeelding, speler, kaart of snel invoerformulier. Meerdere interactieve elementen overbelasten de gebruiker en bemoeilijken de interactie.

Communicatie met de hoofdapp

App Group — het enige mechanisme voor gegevensuitwisseling tussen de extensie en de hoofdapp. Via de gedeelde App Group-directory kunnen gecachte afbeeldingen, tokens en instellingen worden doorgegeven. Directe API-aanroepen van de hoofdapp of toegang tot de UserDefaults zijn niet beschikbaar vanwege processisolatie.

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

Protocol UNNotificationContentExtension

UNNotificationContentExtension — het hoofdprotocol dat de levenscyclus van een aangepaste melding definieert. Het protocol biedt methoden voor het ontvangen van inhoud, verwerken van acties en beheren van de interface.

Methode didReceive:with:

didReceive(_:with:) wordt aangeroepen bij ontvangst van een melding. De extensie ontvangt een UNNotification-object en UNNotificationContentExtensionMediaPlayPauseButtonType voor het beheren van de mediaspeler. In deze methode moet de interface worden geconfigureerd — afbeelding laden, speler initialiseren of gegevens weergeven. Het systeem roept deze methode elke keer aan wanneer de melding in realtime wordt bijgewerkt.

Het is belangrijk om in gedachten te houden dat de extensie beperkte tijd heeft voor uitvoering — ongeveer 30 seconden voor een volledige weergavecyclus. Als de interface niet binnen deze tijd gereed is, toont iOS een systeemmelding. Voor zware bronnen — laden van afbeeldingen via het netwerk, decoderen van video — wordt aanbevolen asynchrone bewerkingen te gebruiken met vooraf cachen via App Group.

Mediaspeler beheren

Het protocol bevat optionele methoden voor play/pause-knoppen: mediaPlay, mediaPause en mediaPlayPauseButtonType. Als de melding audio- of video-inhoud bevat, kan de extensie een ingebouwde speler met een systeembedieningselement tonen. iOS voegt automatisch een afspeelknop toe in de rechterbovenhoek van de extensie wanneer het juiste knoptype wordt geretourneerd.

Media-bijlagen en hun verwerking

UNNotificationAttachment — het object dat de media-gegevens bevat die aan de melding zijn gekoppeld. Afbeeldingen, audiobestanden en video worden toegevoegd in de fase van het aanmaken van de melding op de server of in Notification Service Extension via UNNotificationAttachment.

Ondersteunde formaten

Voor afbeeldingen: JPEG, PNG, GIF, HEIF. Voor audio: MP3, AAC, ALAC, WAV. Voor video: MPEG-4, H.264, HEVC. Maximale grootte van elke bijlage — 50 MB, tot 4 bijlagen per melding. Het systeem downloadt bijlagen automatisch op de achtergrond vóór weergave van de melding en biedt de extensie toegang tot lokale URL's via security-scoped bronnen.

Volgens Apple mag de extensie media niet zelfstandig laden — UNNotificationAttachment bevat al een lokale URL na voltooiing van de download door het systeem. Als de bijlage echter niet op tijd is gedownload (bijvoorbeeld bij slechte verbinding), kan de extensie een placeholder of alternatieve tekst weergeven.

Werken met security-scoped bronnen

Elke UNNotificationAttachment biedt een security-scoped URL, waartoe de extensie toegang moet krijgen via startAccessingSecurityScopedResource() en moet vrijgeven via stopAccessingSecurityScopedResource(). Deze methoden moeten in paren worden aangeroepen — anders wordt de bron niet vrijgemaakt en veroorzaakt dit een lekkage van toegangsrechten.

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)

Interactieve meldingen en acties

Notification Content Extension ondersteunt aangepaste interactieve acties — knoppen die onder de meldingsinhoud worden weergegeven. Acties worden geregistreerd bij het aanmaken van de meldingscategorie via UNNotificationCategory en kunnen destructief, tekstueel of achtergrond zijn.

Soorten acties

UNNotificationAction — een eenvoudige actie met een titel en optionele destructieve vlag. UNTextInputNotificationAction — een actie met een tekstinvoerveld, bijvoorbeeld voor snel antwoord op een bericht. Beide typen ondersteunen de optie UNNotificationActionOptions.authenticationRequired — vereiste om het apparaat te ontgrendelen vóór uitvoering.

De extensie ontvangt de geselecteerde actie via de methode didReceive(_:withCompletionHandler:), waarbij een UNNotificationResponse-object met de actie-ID en optionele tekst wordt doorgegeven. De extensie kan het antwoord zelfstandig verwerken of doorgeven aan de hoofdapp via de gedeelde App Group-container.

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