Rich Notification: cosa sono, contenuti multimediali e creazione di notifiche

Cosa sono le Rich Notification

Rich Notification è una notifica push iOS che contiene non solo testo, ma anche allegati multimediali, elementi interattivi e un'interfaccia personalizzata. Il termine “rich” (ricco) riflette la capacità di includere immagini, video, audio, pulsanti di azione e input di testo in una notifica, trasformando un semplice avviso in un elemento interattivo completo.

Evoluzione delle notifiche in iOS

Apple ha introdotto il supporto per Rich Notification in iOS 10 insieme al framework UserNotifications. Prima di ciò, le notifiche push potevano contenere solo testo, suono e un badge. iOS 10 ha introdotto UNNotificationServiceExtension e UNNotificationContentExtension, che hanno aperto la possibilità di modificare il contenuto e creare interfacce personalizzate. Le versioni successive hanno aggiunto il supporto per SwiftUI in Content Extension, GIF animate e un migliore ridimensionamento dei media.

Vantaggi rispetto alle notifiche standard

Rich Notification aumenta significativamente il coinvolgimento degli utenti. Studi Apple mostrano che le notifiche con immagini ricevono 30–40% in più di interazioni rispetto a quelle solo di testo. Un'immagine del prodotto, un'anteprima video o un pulsante di risposta rapida consentono all'utente di prendere una decisione direttamente dalla notifica senza aprire l'app. Questo accorcia il percorso verso l'azione desiderata e migliora l'esperienza utente.

Tipi di allegati multimediali e loro formati

UNNotificationAttachment supporta tre categorie di media: immagini, video e audio. Ogni tipo ha le proprie limitazioni di formato, dimensione e durata. Il sistema ridimensiona automaticamente le immagini per adattarle alle dimensioni della notifica e limita la durata del video a 30 secondi per ottimizzare le prestazioni.

Immagini e GIF animate

Le immagini vengono automaticamente ritagliate e ridimensionate dal sistema per la visualizzazione in viste di notifica compatte ed estese. Le GIF animate sono supportate a partire da iOS 12 e vengono riprodotte automaticamente alla visualizzazione della notifica. La dimensione dell'immagine consigliata è 1024x1024 pixel, che garantisce una visualizzazione nitida su tutti i dispositivi, incluso iPad con schermo grande.

Allegati video e audio

Il video in Rich Notification viene riprodotto senza audio per impostazione predefinita — l'utente può attivare l'audio tramite il pulsante del lettore. La durata massima del video è di 30 secondi, dopo i quali la riproduzione si arresta. Gli allegati audio possono essere utilizzati per messaggi vocali o anteprime sonore e vengono riprodotti toccando la notifica in vista estesa.

Pulsanti interattivi e azioni

Le azioni interattive consentono all'utente di eseguire operazioni direttamente dalla notifica senza aprire l'app. Le azioni vengono registrate tramite UNNotificationCategory e UNNotificationAction all'avvio dell'app. Ogni azione può essere in background (senza aprire l'app) o in primo piano (apre l'app per completare l'operazione).

UNNotificationAction e UNTextInputNotificationAction

UNNotificationAction rappresenta un pulsante con un titolo e modificatori opzionali come requiresAuthentication (richiede Face ID/Touch ID) o destructive (evidenziato in rosso). UNTextInputNotificationAction estende questa funzionalità aggiungendo un campo di input di testo — ideale per risposte rapide a messaggi o commenti. Le azioni vengono visualizzate premendo a lungo sulla notifica o scorrendo verso il basso.

Registrazione di categorie e azioni

Le categorie di notifica collegano il tipo di contenuto a un insieme di azioni disponibili. Il processo di registrazione viene eseguito in AppDelegate all'avvio dell'app tramite UNUserNotificationCenter.current().setNotificationCategories. La categoria viene specificata sul server nel campo category del payload JSON e il sistema applica automaticamente l'insieme di azioni corrispondente alla notifica.

Gestione dei tocchi sulle azioni

Quando l'utente tocca un pulsante o invia testo, il sistema chiama il delegato UNUserNotificationCenterDelegate con il metodo didReceive response. UNNotificationResponse contiene l'identificatore dell'azione e il testo inserito (per UNTextInputNotificationAction). Sulla base di queste informazioni, l'app esegue la logica di business corrispondente: invia un messaggio, conferma un'azione o apre una schermata specifica.

Implementazione di Rich Notification in Swift

Esaminiamo l'intero ciclo di creazione di Rich Notification: dalla registrazione delle categorie in AppDelegate all'elaborazione in Service Extension e alla visualizzazione. AppDelegate registra la categoria con i pulsanti, il server invia una notifica con un URL dell'immagine, Service Extension scarica il contenuto multimediale e Content Extension mostra un'interfaccia personalizzata con pulsanti.

// AppDelegate — registrazione di categorie e azioni
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
    [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {

    let replyAction = UNTextInputNotificationAction(
        identifier: "reply",
        title: "Rispondi",
        options: [.authenticationRequired])

    let likeAction = UNNotificationAction(
        identifier: "like",
        title: "Mi piace",
        options: [])

    let category = UNNotificationCategory(
        identifier: "social_post",
        actions: [replyAction, likeAction],
        intentIdentifiers: [],
        options: [])

    UNUserNotificationCenter.current()
        .setNotificationCategories([category])
    return true
}

Service Extension per caricare immagini

Dopo aver ricevuto una notifica push con la categoria “social_post” e un URL dell'immagine in un campo personalizzato, viene attivata Service Extension. L'estensione scarica l'immagine dalla rete, crea un UNNotificationAttachment con un identificatore univoco e lo aggiunge al contenuto. È importante verificare la dimensione del file scaricato — se supera 10 MB, l'allegato non verrà creato e il sistema mostrerà la notifica senza contenuti multimediali.

class NotificationService: UNNotificationServiceExtension {

    override func didReceive(
        _ request: UNNotificationRequest,
        withContentHandler contentHandler:
        @escaping (UNNotificationContent) -> Void
    ) {
        let content = (request.content.mutableCopy()
            as! UNMutableNotificationContent)
        guard let urlString = content.userInfo["media-url"]
            as? String,
            let url = URL(string: urlString)
        else { contentHandler(request.content); return }

        URLSession.shared.downloadTask(with: url) {
            location, _, _ in
            guard let location = location else {
                contentHandler(content); return }
            let attachment = try! UNNotificationAttachment(
                identifier: "media", url: location,
                options: [UNNotificationAttachmentOptionsTypeHintKey:
                    "jpg"])
            content.attachments = [attachment]
            contentHandler(content)
        }.resume()
    }
}

Test di Rich Notification

Per testare Rich Notification senza server, utilizza il simulatore iOS e invia push tramite terminale con xcrun simctl push. Nel payload, assicurati di specificare mutable-content: 1 per attivare Service Extension e la categoria per visualizzare le azioni. Il comando invia un push da un file JSON direttamente al simulatore selezionato, consentendo iterazioni rapide senza configurare infrastruttura server.

Content Extension e interfaccia personalizzata

UNNotificationContentExtension consente di sostituire completamente l'interfaccia di notifica standard con una vista UIKit o SwiftUI personalizzata. L'estensione viene attivata quando l'utente espande la notifica (force touch o scorrimento verso il basso) e può contenere pulsanti, cursori, animazioni e qualsiasi altro componente dell'interfaccia. La dimensione dell'interfaccia si adatta al contenuto utilizzando Auto Layout.

Storyboard e SwiftUI in Content Extension

Content Extension si basa su uno storyboard con un controller di vista che eredita da UIViewController. SwiftUI View viene integrata tramite UIHostingController a partire da iOS 16, consentendo approcci moderni alla costruzione dell'interfaccia. Per la compatibilità con iOS 14–15, si consiglia di utilizzare UIKit con file xib. L'interfaccia riceve il contenuto modificato da Service Extension tramite UNNotificationContent.

Gestione delle azioni utente

Content Extension implementa il protocollo UNNotificationContentExtension con il metodo didReceive response. UNNotificationResponse contiene informazioni sul pulsante premuto o sul testo inserito. L'estensione può aggiornare l'interfaccia senza chiudere la notifica o chiamare il completion handler per chiuderla. Ciò consente di creare scenari di interazione rapida, come un “mi piace” con feedback visivo direttamente nella notifica.

Raccomandazioni di design

Apple raccomanda di mantenere Content Extension conciso e funzionale, evitando elementi eccessivi. L'altezza massima della notifica espansa è di circa 400 punti, dopo i quali il contenuto scorre. Utilizza caratteri e spaziature del sistema per coerenza con altre notifiche. Testa su diverse dimensioni dello schermo per assicurarti che l'interfaccia venga visualizzata correttamente sia su iPhone che su iPad.