Notification Category: ما هي، ما الفئات الموجودة وكيف تعمل في iOS

ما هي Notification Category في iOS؟

Notification Category هي ميزة في iOS (منذ الإصدار 8.0) تتيح للمطورين تصنيف الإشعارات الفورية وإضافة إجراءات تفاعلية إليها. عندما يتلقى المستخدم إشعارًا ويضغط بقوة (3D Touch) أو يقوم بالضغط المطول، تظهر أزرار محددة بواسطة الفئة. هذا يجعل الإشعارات تفاعلية ويسمح للمستخدمين باتخاذ إجراء دون فتح التطبيق.

يتم تسجيل فئة باستخدام كائن UNNotificationCategory، الذي يحتوي على معرّف ومصفوفة من الإجراءات ومعلمات عرض اختيارية. يستخدم النظام معرّف الفئة من حمولة APNS للعثور على الفئة المسجلة وعرض الأزرار المقابلة.

على عكس Android Notification Channel، لا تدير iOS Category الأهمية أو الصوت أو الاهتزاز. غرضها الوحيد هو توفير إمكانيات تفاعلية للإشعارات: أزرار الرد والتأكيد والإلغاء أو إدخال النص.

هل الفئات إلزامية؟

الفئات ليست إلزامية لعرض الإشعارات الفورية على iOS. سيظهر الإشعار على أي حال — مع أزرار إذا تم تسجيل فئة، أو بدونها. الفئات مطلوبة فقط لإضافة التفاعل إلى الإشعارات.

كيف تعمل فئات الإشعارات؟

تتكون آلية الفئات من أربع مراحل: تسجيل الفئة على العميل، إرسال حمولة APNS مع الفئة، تعرف النظام على الفئة، ومعالجة إجراء المستخدم.

• التسجيل — ينشئ التطبيق UNNotificationCategory مع مصفوفة من الإجراءات ويسجلها في UNUserNotificationCenter
• الإرسال — يدرج الخادم مفتاح category في حمولة APNS بقيمة تطابق معرّف الفئة
• العرض — يعرض iOS الإشعار وعند الضغط مع الاستمرار يظهر الأزرار المرتبطة بالفئة
• المعالجة — ينقر المستخدم على زر، مما يؤدي إلى تشغيل UNUserNotificationCenterDelegate.didReceive response

يمكن أن تكون الإجراءات في الفئة من نوعين: foreground (تفتح التطبيق) و background (تُنفذ في الخلفية). للإجراءات الخلفية، يحصل التطبيق على وقت محدود (حوالي 30 ثانية) للمعالجة في UNNotificationActionHandler.

خيارات عند تسجيل فئة

يدعم UNNotificationCategory عدة خيارات عبر معامل options: customDismissAction — تلقي حدث عند التمرير للإزالة، allowInCarPlay — عرض الإجراءات في CarPlay، hiddenPreviewsBodyPlaceholder — نص placeholder مخصص للمعاينات المخفية.

UNNotificationAction: أنواع الإجراءات

يوفر iOS نوعين من الإجراءات لفئات الإشعارات. لكل نوع غرضه الخاص وطريقته في التفاعل مع المستخدم.

UNTextInputAction هي ميزة فريدة في iOS. عندما ينقر المستخدم على زر «رد»، يعرض النظام حقل نص حيث يكتب المستخدم رده. يتم تمرير النص المُدخل إلى المفوض مع معرّف الإجراء. هذا يتيح تنفيذ ردود سريعة دون فتح التطبيق.

خيارات الإجراء: options.authenticationRequired — يتطلب فتح قفل الجهاز، options.destructive — يبرز الزر باللون الأحمر (للإجراءات الخطرة)، options.foreground — يفتح التطبيق بعد النقر.

إعداد فئة في كود iOS

يتم تسجيل الفئات عند تشغيل التطبيق، عادةً في طريقة didFinishLaunchingWithOptions. يتم التسجيل من خلال UNUserNotificationCenter، بعد طلب إذن الإشعارات. يمكن تحديث الفئات في كل تشغيل — يتم استبدال الإصدارات القديمة بأخرى جديدة.

import UserNotifications

class AppDelegate: UIResponder, UIApplicationDelegate {

    func registerNotificationCategories() {
        let replyAction = UNTextInputNotificationAction(
            identifier: "reply",
            title: "رد",
            options: [.foreground],
            textInputButtonTitle: "إرسال",
            textInputPlaceholder: "أدخل رسالة..."
        )

        let deleteAction = UNNotificationAction(
            identifier: "delete",
            title: "حذف",
            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
    }
}

بعد تسجيل الفئة، أي إشعار يحتوي على category = «message» في حمولة APNS سيعرض زري «رد» و «حذف». تحدث معالجة النقرات في userNotificationCenter:didReceive response، حيث يحدد actionIdentifier أي زر تم الضغط عليه.

معالجة النقر في المفوض

عندما ينقر المستخدم على زر فئة، يستدعي iOS UNUserNotificationCenterDelegate مع كائن UNNotificationResponse. يحتوي response.actionIdentifier على معرّف الزر الذي تم النقر عليه، ويحتوي response.notification.request.content.userInfo على البيانات المخصصة من الحمولة.

الاختلافات عن قنوات Android

غالبًا ما يخلط المطورون الملمون بقنوات الإشعارات في Android بينها وبين فئات الإشعارات في iOS. على الرغم من الاسم المشابه، فإن هذه الآليات تحل مهام مختلفة وتعمل بشكل مختلف.

• الغرض — قنوات Android تدير أهمية الإشعارات وظهورها؛ فئات iOS تدير الإجراءات التفاعلية
• الإلزامية — قناة Android إلزامية لعرض الإشعار؛ فئة iOS اختيارية
• تحكم المستخدم — مستخدمو Android يهيئون القنوات في إعدادات النظام؛ فئات iOS غير مرئية للمستخدم مباشرة
• التجميع — يمكن تجميع قنوات Android في ChannelGroups؛ فئات iOS لا تُجمّع

يمكن لكلتا المنصتين الجمع بين الآليتين: في Android، يمكن أن ينتمي الإشعار إلى قناة مع إجراءات من NotificationCompat، بينما في iOS، تُكمل الفئة القنوات، التي تسمى في iOS thread-id وتُستخدم لتجميع الإشعارات في مركز الإشعارات.

حمولة APNS مع فئة

لكي يظهر الإشعار مع أزرار الفئة، يجب على الخادم تضمين مفتاح category في حمولة APNS. بدون هذا المفتاح، لن يعرف النظام أي فئة يطبقها على الإشعار.

{
    "aps": {
        "alert": {
            "title": "رسالة جديدة",
            "body": "آنا: مرحباً! كيف حالك؟"
        },
        "category": "message",
        "thread-id": "chat_123",
        "badge": 5,
        "sound": "default"
    }
}

يجب أن يتطابق مفتاح category تمامًا مع المعرّف المسجل عبر setNotificationCategories على العميل. حالة الأحرف مهمة — «message» و «Message» تعتبران فئتين مختلفتين. إذا لم يتم العثور على الفئة، يظهر الإشعار بدون أزرار، بدون أخطاء في السجلات.

معالجة الفئات غير المعروفة

إذا أرسل الخادم إشعارًا بفئة غير مسجلة على العميل، يتجاهل iOS الفئة ويعرض الإشعار بدون أزرار. لا يتم تسجيل الخطأ، ولا يعلم التطبيق بعدم التطابق. يُوصى بمزامنة قائمة الفئات بين الخادم والعميل.

أنماط تصميم الفئات

عند تصميم فئات الإشعارات في iOS، اتبع مبدأ فئة واحدة — سيناريو واحد. يجب أن تتوافق كل فئة مع نوع محدد من التفاعل: الرد على رسالة، تأكيد إجراء، رفض طلب. لا تخلط سيناريوهات مختلفة في فئة واحدة.

استخدم UNTextInputAction للسيناريوهات التي يحتاج فيها المستخدم إلى إدخال نص دون فتح التطبيق: ردود المراسلة، التعليقات، الملاحظات السريعة. تزيد إجراءات النص من التفاعل — يقوم المستخدم بإجراء ذي معنى بنقرتين بدلاً من 5+ داخل التطبيق.

للإجراءات الخطرة (حذف، حظر)، استخدم الخيار destructive. سيميز iOS هذه الأزرار باللون الأحمر، محذرًا المستخدم من عدم رجعة الإجراء. للإجراءات التي تتطلب فتح قفل الجهاز (عرض بيانات شخصية)، حدد authenticationRequired.

اختبر الفئات على أجهزة مختلفة: على iPhone مع 3D Touch، على iPhone بدون 3D Touch (الضغط المطول)، على iPad وعلى Mac. قد يختلف سلوك الفئات قليلاً عبر منصات Apple المختلفة. انتبه بشكل خاص لـ CarPlay: تظهر أزرار الفئات على شاشة السيارة ويجب تصميمها بأقل قدر من النص لسلامة السائق.