Notification Category: nədir, hansı kateqoriyalar var və iOS-da necə işləyir

iOS-da Notification Category nədir?

Notification Category — iOS-un (8.0 versiyasından) tərtibatçıya push bildirişlərini təsnif etməyə və onlara interaktiv hərəkətlər əlavə etməyə imkan verən funksiyadır. İstifadəçi bildiriş aldıqda və ona güclə (3D Touch) basdıqda və ya uzun basdıqda, kateqoriya tərəfindən müəyyən edilmiş düymələr görünür.

Kateqoriya UNNotificationCategory obyekti vasitəsilə qeydiyyatdan keçirilir, hansı ki identifikator, hərəkətlər massivi və isteğe bağlı göstərmə parametrlərini ehtiva edir. Sistem, APNS yükündən kateqoriya identifikatorundan istifadə edərək qeydiyyatdan keçmiş kateqoriyanı axtarır və müvafiq hərəkətləri göstərir.

Android Notification Channel-dən fərqli olaraq, iOS Category vaciblik, səs və ya vibrasiyanı idarə etmir. Onun yeganə vəzifəsi bildiriş üçün interaktiv imkanlar təmin etməkdir: cavab, təsdiq, ləğv və ya mətn daxil etmə düymələri.

Kateqoriyaların məcburiliyi

Kateqoriyalar iOS-da push bildirişlərinin göstərilməsi üçün məcburi deyil. Bildiriş hər halda görünəcək — kateqoriya qeydiyyatdan keçibsə düymələrlə, keçməyibsə düymələrsiz. Kateqoriyalar yalnız bildirişlərə interaktivlik əlavə etmək üçün lazımdır.

Bildiriş kateqoriyaları necə işləyir?

Kateqoriya mexanizmi dörd mərhələdən ibarətdir: kateqoriyanın müştəri tərəfdə qeydiyyatı, APNS yükünün kateqoriya ilə göndərilməsi, kateqoriyanın sistem tərəfindən tanınması və istifadəçi hərəkətinin emalı.

• Qeydiyyat — tətbiq UNNotificationCategory-ni hərəkətlər massivi ilə yaradır və UNUserNotificationCenter-də qeydiyyatdan keçirir
• Göndərmə — server APNS yükünə kateqoriya identifikatoru ilə uyğun gələn category açarını daxil edir
• Göstərmə — iOS bildirişi göstərir və force touch zamanı kateqoriyaya aid düymələri nümayiş etdirir
• Emal — istifadəçi düyməni basır, UNUserNotificationCenterDelegate.didReceive response işə düşür

Kateqoriyadakı hərəkətlər iki tip ola bilər: foreground (tətbiqi açır) və background (fon icra olunur). Fon hərəkətləri üçün tətbiq UNNotificationActionHandler-də emal üçün məhdud vaxt (təxminən 30 saniyə) alır.

Kateqoriyanın qeydiyyatı zamanı seçimlər

UNNotificationCategory options parametri vasitəsilə bir neçə seçimi dəstəkləyir: customDismissAction — bildirişi sürüşdürərkən hadisəni almaq, allowInCarPlay — CarPlay-də hərəkətləri göstərmək, hiddenPreviewsBodyPlaceholder — gizli ön baxışlar üçün fərdi mətn. Seçimlərin düzgün konfiqurasiyası müxtəlif Apple cihazlarında istifadəçi təcrübəsini yaxşılaşdırır.

UNNotificationAction: hərəkət növləri

iOS bildiriş kateqoriyaları üçün iki növ hərəkət təqdim edir. Hər növün öz təyinatı və istifadəçi ilə qarşılıqlı əlaqə üsulu var.

UNTextInputAction — iOS-un unikal imkanı. “Cavab ver” düyməsini basdıqda sistem istifadəçinin cavab yazması üçün mətn sahəsi göstərir. Daxil edilmiş mətn hərəkət identifikatoru ilə birlikdə delegata ötürülür. Bu, tətbiqi açmadan sürətli cavab verməyə imkan verir.

Hərəkət seçimləri: options.authenticationRequired — cihazın blokdan çıxarılmasını tələb edir, options.destructive — düyməni qırmızı rənglə vurğulayır (təhlükəli hərəkətlər üçün), options.foreground — basdıqdan sonra tətbiqi açır.

iOS kodunda kateqoriyanın konfiqurasiyası

Kateqoriyalar tətbiq işə düşəndə, adətən didFinishLaunchingWithOptions metodunda qeydiyyatdan keçirilir. Qeydiyyat UNUserNotificationCenter vasitəsilə, bildirişlərə icazə istədikdən sonra baş verir. Kateqoriyalar hər işə düşmədə yenilənə bilər — köhnə versiyalar yeniləri ilə əvəz olunur.

import UserNotifications

class AppDelegate: UIResponder, UIApplicationDelegate {

    func registerNotificationCategories() {
        let replyAction = UNTextInputNotificationAction(
            identifier: "reply",
            title: "Cavab ver",
            options: [.foreground],
            textInputButtonTitle: "Göndər",
            textInputPlaceholder: "Mesaj daxil edin..."
        )

        let deleteAction = UNNotificationAction(
            identifier: "delete",
            title: "Sil",
            options: [.destructive]
        )

        let messageCategory = UNNotificationCategory(
            identifier: "message",
            actions: [replyAction, deleteAction],
            intentIdentifiers: [],
            options: [.customDismissAction]
        )

        UNUserNotificationCenter.current()
            .setNotificationCategories([messageCategory])
    }

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        registerNotificationCategories()
        return true
    }
}

Kateqoriya qeydiyyatdan keçdikdən sonra APNS yükündə category = “message” olan hər bildiriş “Cavab ver” və “Sil” düymələrini göstərəcək. Düymə basılmalarının emalı userNotificationCenter:didReceive response-da baş verir, burada actionIdentifier hansı düymənin basıldığını müəyyən edir.

Delegatda basılmanın emalı

İstifadəçi kateqoriya düyməsini basdıqda, iOS UNUserNotificationCenterDelegate delegatını UNNotificationResponse obyekti ilə çağırır. response.actionIdentifier basılmış düymənin identifikatorunu ehtiva edir, response.notification.request.content.userInfo isə APNS yükündən fərdi məlumatları. UNTextInputAction üçün əlavə olaraq response.userText istifadəçinin daxil etdiyi mətnlə mövcuddur.

Android kanallarından fərqlər

Android Notification Channels ilə tanış olan tərtibatçılar tez-tez onları iOS Notification Categories ilə qarışdırırlar. Oxşar ada baxmayaraq, bu mexanizmlər müxtəlif vəzifələri həll edir və fərqli işləyir.

• Məqsəd — Android Channels bildirişlərin vacibliyini və görünməsini idarə edir; iOS Categories — interaktiv hərəkətləri
• Məcburilik — Android Channel bildirişin göstərilməsi üçün məcburidir; iOS Category isteğe bağlıdır
• İstifadəçi idarəsi — Android istifadəçi kanalları sistem parametrlərində konfiqurasiya edir; iOS kateqoriyaları istifadəçiyə birbaşa görünmür
• Qruplaşdırma — Android Channels qruplara birləşdirilə bilər (ChannelGroup); iOS Categories qruplaşdırılmır

Hər iki platformada mexanizmləri birləşdirmək olar: Android-də bildiriş NotificationCompat-dən hərəkətlərlə kanala aid ola bilər, iOS-da isə kateqoriya iOS-da thread-id adlanan və bildiriş mərkəzində bildirişləri qruplaşdırmaq üçün xidmət edən kanalları tamamlayır.

Kateqoriya ilə APNS yükü

Bildirişin kateqoriya düymələri ilə göstərilməsi üçün server APNS yükünə category açarını daxil etməlidir. Bu açar olmadan sistem hansı kateqoriyanı tətbiq edəcəyini bilməyəcək.

{
    "aps": {
        "alert": {
            "title": "Yeni mesaj",
            "body": "Anna: Salam! Necəsən?"
        },
        "category": "message",
        "thread-id": "chat_123",
        "badge": 5,
        "sound": "default"
    }
}

category açarı müştəri tərəfdə setNotificationCategories vasitəsilə qeydiyyatdan keçmiş identifikatorla dəqiq uyğun olmalıdır. Hərf həssaslığı var — “message” və “Message” fərqli kateqoriyalar hesab olunur. Kateqoriya tapılmazsa, bildiriş düymələr olmadan, loglarda xəta olmadan göstərilir.

Naməlum kateqoriyanın emalı

Server müştəridə qeydiyyatdan keçməmiş category ilə bildiriş göndərərsə, iOS kateqoriyanı nəzərə almır və bildirişi düymələr olmadan göstərir. Xəta qeydə alınmır və tətbiq uyğunsuzluqdan xəbərsiz qalır. Kateqoriyalar siyahısını server və müştəri arasında konfiqurasiya faylı vasitəsilə sinxronlaşdırmaq və tətbiqin hər yenilənməsində yoxlamaq tövsiyə olunur.

Kateqoriyaların dizayn nümunələri

iOS bildiriş kateqoriyalarını dizayn edərkən bir kateqoriya — bir ssenari prinsipinə əməl edin. Hər kateqoriya müəyyən bir qarşılıqlı əlaqə növünə uyğun olmalıdır: mesaja cavab, hərəkətin təsdiqi, sorğunun rədd edilməsi. Müxtəlif ssenariləri bir kateqoriyada qarışdırmayın — bu istifadəçini çaşdırır və delegatda emalı çətinləşdirir.

UNTextInputAction istifadəçinin tətbiqi açmadan mətn daxil etməli olduğu ssenarilər üçün istifadə edin: messencerlərdə cavablar, şərhlər, sürətli qeydlər. Mətn hərəkətləri cəlb olunmanı artırır — istifadəçi açıq tətbiqdə 5+ əvəzinə 2 toxunma ilə mənalı hərəkət edir.

Təhlükəli hərəkətlər (sil, blokla) üçün destructive seçimindən istifadə edin. iOS bu düymələri qırmızı rənglə vurğulayaraq istifadəçini hərəkətin geri dönməzliyi barədə xəbərdar edir. Cihazın blokdan çıxarılmasını tələb edən hərəkətlər (şəxsi məlumatlara baxmaq) üçün authenticationRequired təyin edin — sistem icradan əvvəl Face ID və ya parol tələb edəcək.

Kateqoriyaları müxtəlif cihazlarda test edin: 3D Touch olan iPhone-da, 3D Touch olmayan iPhone-da (uzun basma), iPad-də və Mac-da. Kateqoriyaların davranışı müxtəlif Apple platformalarında bir qədər fərqlənə bilər. Xüsusi diqqət — CarPlay: kateqoriya düymələri avtomobil ekranında göstərilir, lakin mətn daxil etmə mövcud deyil, buna görə UNTextInputAction CarPlay-də avtomatik gizlədilir. watchOS-da kateqoriyalar dəstəklənmir — bütün bildirişlər hərəkət düymələri olmadan göstərilir.