Rich Notification: co to jest, multimedia i tworzenie powiadomień

Co to jest Rich Notification

Rich Notification to powiadomienie push iOS, które zawiera nie tylko tekst, ale także załączniki multimedialne, elementy interaktywne i spersonalizowany interfejs. Termin „rich” (bogaty) odzwierciedla możliwość dołączania do powiadomienia obrazów, wideo, audio, przycisków akcji i wprowadzania tekstu, co zmienia zwykłe powiadomienie w pełnoprawny element interaktywny.

Ewolucja powiadomień w iOS

Apple wprowadziło obsługę Rich Notification w iOS 10 wraz z frameworkiem UserNotifications. Wcześniej powiadomienia push mogły zawierać tylko tekst, dźwięk i badge. iOS 10 przedstawiło UNNotificationServiceExtension i UNNotificationContentExtension, które otworzyły możliwość modyfikacji treści i tworzenia niestandardowych interfejsów. W późniejszych wersjach dodano obsługę SwiftUI w Content Extension, animowanych GIF i ulepszone skalowanie multimediów.

Zalety w porównaniu ze standardowymi powiadomieniami

Rich Notification znacznie zwiększa zaangażowanie użytkowników. Badania Apple pokazują, że powiadomienia z obrazami otrzymują o 30–40% więcej interakcji w porównaniu z tekstowymi. Obraz produktu, podgląd wideo lub przycisk szybkiej odpowiedzi pozwalają użytkownikowi podjąć decyzję bezpośrednio z powiadomienia, bez otwierania aplikacji. Skraca to ścieżkę do docelowej akcji i poprawia doświadczenie użytkownika.

Rodzaje załączników multimedialnych i ich formaty

UNNotificationAttachment obsługuje trzy kategorie multimediów: obrazy, wideo i audio. Każdy typ ma swoje ograniczenia dotyczące formatu, rozmiaru i czasu trwania. System automatycznie skaluje obrazy do rozmiaru powiadomienia i ogranicza czas trwania wideo do 30 sekund w celu optymalizacji wydajności.

Obrazy i animowane GIF

Obrazy są automatycznie przycinane i skalowane przez system do wyświetlania w kompaktowym i rozszerzonym widoku powiadomienia. Animowane GIF są obsługiwane od iOS 12 i odtwarzają się automatycznie podczas przeglądania powiadomienia. Zalecany rozmiar obrazu to 1024x1024 piksele, co zapewnia wyraźne wyświetlanie na wszystkich urządzeniach, w tym na iPadzie z dużym ekranem.

Załączniki wideo i audio

Wideo w Rich Notification odtwarza się domyślnie bez dźwięku — użytkownik może włączyć dźwięk przez przycisk w odtwarzaczu. Maksymalny czas trwania wideo wynosi 30 sekund, po czym odtwarzanie zostaje zatrzymane. Załączniki audio mogą być używane do wiadomości głosowych lub podglądów dźwiękowych i odtwarzają się po dotknięciu powiadomienia w rozszerzonym widoku.

Przyciski interaktywne i akcje

Akcje interaktywne pozwalają użytkownikowi wykonywać operacje bezpośrednio z powiadomienia bez otwierania aplikacji. Akcje są rejestrowane przez UNNotificationCategory i UNNotificationAction podczas uruchamiania aplikacji. Każda akcja może być w tle (bez otwierania aplikacji) lub pierwszoplanowa (otwiera aplikację w celu dokończenia operacji).

UNNotificationAction i UNTextInputNotificationAction

UNNotificationAction to przycisk z tytułem i opcjonalnymi modyfikatorami, takimi jak requiresAuthentication (wymaga Face ID/Touch ID) lub destructive (podświetlony na czerwono). UNTextInputNotificationAction rozszerza tę możliwość, dodając pole tekstowe do wprowadzania — idealne do szybkiej odpowiedzi na wiadomość lub komentarz. Akcje są wyświetlane po długim naciśnięciu powiadomienia lub przesunięciu w dół.

Rejestracja kategorii i akcji

Kategorie powiadomień łączą typ treści z zestawem dostępnych akcji. Proces rejestracji odbywa się w AppDelegate podczas uruchamiania aplikacji przez UNUserNotificationCenter.current().setNotificationCategories. Kategoria jest określana na serwerze w polu category JSON payloadu, a system automatycznie stosuje odpowiedni zestaw akcji do powiadomienia.

Obsługa kliknięć akcji

Gdy użytkownik kliknie przycisk lub wyśle tekst, system wywołuje delegata UNUserNotificationCenterDelegate z metodą didReceive response. UNNotificationResponse zawiera identyfikator akcji i wprowadzony tekst (dla UNTextInputNotificationAction). Na podstawie tych informacji aplikacja wykonuje odpowiednią logikę biznesową: wysyła wiadomość, potwierdza akcję lub otwiera określony ekran.

Implementacja Rich Notification w Swift

Przeanalizujemy pełny cykl tworzenia Rich Notification: od rejestracji kategorii w AppDelegate po przetwarzanie w Service Extension i wyświetlanie. AppDelegate rejestruje kategorię z przyciskami, serwer wysyła powiadomienie z URL obrazu, Service Extension pobiera multimedia, a Content Extension wyświetla niestandardowy interfejs z przyciskami.

// AppDelegate — rejestracja kategorii i akcji
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
    [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {

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

    let likeAction = UNNotificationAction(
        identifier: "like",
        title: "Lubię to",
        options: [])

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

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

Service Extension do pobierania obrazu

Po otrzymaniu powiadomienia push z kategorią „social_post” i URL obrazu w niestandardowym polu, aktywuje się Service Extension. Rozszerzenie pobiera obraz przez sieć, tworzy UNNotificationAttachment z unikalnym identyfikatorem i dodaje go do treści. Ważne jest sprawdzenie rozmiaru pobranego pliku — jeśli przekracza 10 MB, attachment nie zostanie utworzony, a system wyświetli powiadomienie bez multimediów.

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

Testowanie Rich Notification

Do testowania Rich Notification bez serwera użyj symulatora iOS i wysyłaj push przez terminal za pomocą xcrun simctl push. W payloadzie należy określić mutable-content: 1, aby aktywować Service Extension oraz category do wyświetlania akcji. Polecenie uruchamia push z pliku JSON bezpośrednio na wybrany symulator, co pozwala na szybkie iteracje bez konfigurowania infrastruktury serwerowej.

Content Extension i niestandardowy interfejs

UNNotificationContentExtension pozwala całkowicie zastąpić standardowy interfejs powiadomienia dowolnym widokiem UIKit lub SwiftUI. Rozszerzenie aktywuje się, gdy użytkownik rozszerza powiadomienie (force touch lub przesunięcie w dół) i może zawierać przyciski, suwaki, animacje i inne komponenty UI. Rozmiar interfejsu dostosowuje się do treści za pomocą Auto Layout.

Storyboard i SwiftUI w Content Extension

Content Extension opiera się na storyboard z widokiem dziedziczącym po UIViewController. Widok SwiftUI jest integrowany przez UIHostingController od iOS 16, co pozwala na stosowanie nowoczesnych podejść do budowania interfejsu. Dla wstecznej kompatybilności z iOS 14–15 zaleca się używanie UIKit z plikami xib. Interfejs otrzymuje zmodyfikowaną treść z Service Extension przez UNNotificationContent.

Obsługa akcji użytkownika

Content Extension implementuje protokół UNNotificationContentExtension z metodą didReceive response. UNNotificationResponse zawiera informacje o klikniętym przycisku lub wprowadzonym tekście. Rozszerzenie może zaktualizować interfejs bez zamykania powiadomienia lub wywołać completion handler w celu jego zamknięcia. Pozwala to tworzyć scenariusze szybkiej interakcji, na przykład „polubienie” z wizualnym sprzężeniem zwrotnym bezpośrednio w powiadomieniu.

Zalecenia projektowe

Apple zaleca, aby Content Extension był zwięzły i funkcjonalny, unikając zbędnych elementów. Maksymalna wysokość rozszerzonego powiadomienia wynosi około 400 punktów, po czym treść jest przewijana. Używaj systemowych czcionek i odstępów dla spójności z innymi powiadomieniami. Testuj na różnych rozmiarach ekranu, aby upewnić się, że interfejs poprawnie wyświetla się zarówno na iPhone, jak i iPad.