PushKit — ما هو، إطار عمل إشعارات الدفع لـ VoIP

ما هو PushKit وكيف يعمل؟

PushKit هو إطار عمل من Apple طرح في iOS 8 يوفر آلية توصيل إشعارات الدفع بأولوية مضمونة عبر اتصال ثابت بخوادم APNs. على عكس الإشعارات العادية التي تمر عبر قناة APNs واحدة وقد تتأخر، تستخدم إشعارات PushKit تدفقاً مخصصًا بأولوية أعلى، مما يضمن توصيلًا في الوقت الفعلي تقريبًا.

تقنيًا، يعمل PushKit عبر اتصال TCP ثابت بين الجهاز وخوادم الدفع لدى Apple. عندما يرسل الخادم إشعارًا VoIP، يقوم الاتصال بتوصيله فورًا إلى الجهاز، والذي يوقظ التطبيق ويستدعي مفوض PKPushRegistry. لا حاجة لكون التطبيق في حالة نشطة — يستطيع PushKit إيقاظه من الخلفية، الحالة المنتهية، أو حتى بعد إعادة تشغيل الجهاز.

وفقًا لبحث من Microsoft Research (2024) حول زمن استجابة إشعارات الدفع على المنصات المتنقلة، يبلغ وقت الاستجابة الوسطي لإشعارات PushKit 120–350 ملي ثانية، بينما تظهر إشعارات APNs القياسية وسطيًا من 1–5 ثوانٍ. يُفسر الفرق بحجم أساسي بواسطة قناة TCP المخصصة والمعالجة ذات الأولوية في جانب Apple.

ما أنواع الإشعارات التي يدعمها PushKit؟

يدعم PushKit أربعة أنواع: VoIP (للمكالمات)، Complication (لبيانات واجهات الساعة)، FileProvider (لمزامنة الملفات)، و PushToTalk (لوظائف اللاسلكي). منذ iOS 13، يبقى نوع VoIP فقط متاحًا على نطاق واسع للمطورين الخارجيين. لدى Complication و FileProvider تطبيقات متخصصة ومقتصرة على النظم البيئية لدى Apple.

PushKit مقابل APNs: الاختلافات الرئيسية

APNs (Apple Push Notification service) هو خدمة عالمية لتوصيل إشعارات الدفع تعمل من خلال قناة واحدة لجميع التطبيقات. قد تقوم Apple بتخزين إشعارات APNs مؤقتًا، أو تجميعها، أو حتى تجاهلها عندما تكون القناة مزدحمة. في المقابل، يستخدم PushKit اتصالاً مخصصًا لكل نوع إشعار، وتضمن Apple توصيل كل دفعة VoIP دون تخزين مؤقت.

يظهر الفرق في السيناريوهات الحاسمة للوقت: قد تصل مكالمة واردة من خلال APNs بتأخير من 10–30 ثانية أو قد لا تصل بالمرة إذا كان الجهاز في وضع توفير الطاقة. PushKit يوصل نفس الإشعار في 100–500 ملي ثانية بغض النظر عن حالة الجهاز، لأن قناة TCP الخاصة به تظل نشطة بواسطة النظام بأولوية.

مقارنة الخصائص

معمارية PushKit: PKPushRegistry و PKPushPayload

تتبنى معمارية PushKit حول PKPushRegistry — كائن يسجل التطبيق لاستلام إشعارات من نوع معين. يقوم التطبيق بإنشاء مثال PKPushRegistry، وتحديد النوع المطلوب (على سبيل المثال، PKPushTypeVoIP)، وتعيين مفوض. بعد التسجيل، يحافظ النظام تلقائيًا على الاتصال مع APNs ويوصل إشعارات الدفع عبر المفوض.

يتم تمثيل كل إشعار بواسطة كائن PKPushPayload، الذي يحتوي على dictionaryPayload ببيانات من الخادم. حجم الحمولة محدود بـ 5 كيلوبايت، وهو ما يكفي لنقل بيانات المكالمة: معرف المتصل، نوع المكالمة (صوت/فيديو)، اسم الجهة المتصلة ورمز الجلسة. يتم نقل تدفق الوسائط بشكل منفصل عبر WebRTC أو بروتوكول آخر فوري.

تسجيل PKPushRegistry

import PushKit

class PushKitManager: NSObject {
    private let pushRegistry = PKPushRegistry(queue: .main)
    
    func configure() {
        pushRegistry.delegate = self
        pushRegistry.desiredPushTypes = [.voIP]
    }
}

استلام ومعالجة إشعارات الدفع

PushKit يستدعي طريقة المفوض عند استلام إشعار. في هذه اللحظة، يجب على التطبيق استخراج البيانات من dictionaryPayload وعرض المكالمة فورًا عبر CallKit، وإلا قد ينهي النظام المهمة خلفية. توصي Apple بإكمال المعالجة خلال 30 ثانية، ولكن لمكالمات VoIP من الأساسي عرض شاشة المكالمة خلال الثانية الأولى.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didReceiveIncomingPushWith payload: PKPushPayload,
        for type: PKPushType
    ) {
        guard let caller =
            payload.dictionaryPayload["caller"] as? String
        else { return }
        
        CallKitManager.shared.reportIncomingCall(
            uuid: UUID(),
            handle: caller
        )
    }
}

قيود iOS 13 وقواعد استخدام PushKit

مع إصدار iOS 13، قدمت Apple قيودًا صارمة على استخدام PushKit. كان المطورون يستخدمون VoIP push على نطاق واسع كآلية خفية لتحديثات التطبيقات خلفية — فالإيقاظ عبر PushKit يسمح بتحميل المحتوى ومزامنة البيانات وتحديث الواجهة دون إذن صريح من المستخدم. اعتبرت Apple هذا انتهاكًا لمفهوم توفير الطاقة وقيدت PushKit لفقط إشارة المكالمات الواردة.

الآن يجب أن يؤدي كل إشعار PushKit فورًا إلى عرض مكالمة واردة عبر CallKit. إذا اكتشف النظام أن PushKit يستخدم لأغراض أخرى — على سبيل المثال، المزامنة خلفية أو تحديثات المحتوى دون عرض مكالمة — قد يتم رفض التطبيق أثناء المراجعة أو تعطيله من خدمة PushKit. قامت Apple أيضًا بإزالة القدرة على استخدام PushKit لتحديثات البيانات خلفية بدءًا من iOS 13.

توصيات Apple لاستخدام PushKit (iOS 13+)

• يجب أن يستدعي كل إشعار VoIP reportNewIncomingCall خلال 5 ثوانٍ من استلام الدفعة
• لا تستخدم PushKit للإشعارات الدورية، مزامنة المحتوى، أو تحديث الرموز — لذلك يوجد background fetch
• يجب على الخادم إرسال دفعة فقط عند وجود مكالمة واردة فعلية، ليس للإيقاظ الأولي
• عند استلام دفعة دون مكالمة لاحقة، سيظهر مكالمة فاتة في الأخيرة — وهذا يربك المستخدم

دمج PushKit في Swift

يتضمن الدمج الكامل لـ PushKit التسجيل، الحصول على رمز الدفع، ومعالجة الإشعارات الواردة. PushKit يطلب الإذن تلقائيًا لإرسال الإشعارات — لا حاجة لاستدعاء إضافي UNUserNotificationCenter لـ PushKit نفسه، ولكن قد تكون ضرورية للإشعارات المحلية للتطبيق. بعد التسجيل، يستدعي النظام pushRegistry:didUpdatePushCredentials لتوصيل رمز الدفع، والذي يجب إرساله إلى الخادم.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didUpdate pushCredentials: PKPushCredentials,
        for type: PKPushType
    ) {
        let token = pushCredentials.token
            .map { String(format: "%02x", $0) }
            .joined()
        sendTokenToServer(token)
    }
    
    func pushRegistry(
        _ registry: PKPushRegistry,
        didInvalidatePushTokenFor type: PKPushType
    ) {
        print("Push token invalidated for type: \(type.rawValue)")
    }
}

إرسال إشعارات الدفع من الخادم

يرسل الخادم إشعار PushKit عبر APNs مع push-type = voip والرأس apns-push-type: voip. على عكس APNs العادية، يستخدم VoIP push شهادة خاصة به ولا يتطلب تكوين topic. يجب أن يحتوي الحمول على بيانات أدنى لتحديد المكالمة.

// مثال على حمولة دفع VoIP
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

تشخيص وتصحيح أخطاء إشعارات PushKit

تصحيح أخطاء PushKit أكثر تعقيدًا من APNs القياسية لأن PushKit لا يعمل على محاكي iOS. تحتاج إلى iPhone أو iPad فعلي للتشخيص. أول علامة على التشغيل الصحيح هي استدعاء pushRegistry:didUpdatePushCredentials عند البدء وظهور رمز دفع بتنسيق محدد (64 حرفًا سداسي عشريًا لـ VoIP). إذا لم يتم استدعاء المفوض، تحقق من التصاريح (entitlements) لتطبيقك.

مشكلة شائعة أخرى هي عدم توصيل PushKit للإشعارات بعد تحديث التطبيق. يحدث هذا إذا تغير رمز الدفع ولكن الخادم يستمر في استخدام القديم. الحل هو إرسال الرمز الجديد إلى الخادم عند بدء التطبيق وإزالة الرموز غير الصالحة عند استدعاء pushRegistry:didInvalidatePushTokenForType. توصي Apple أيضًا بتنفيذ آلية احتياطية عبر APNs العادية.

المشاكل الشائعة وحلولها