PushKit — шта је то, оквир push обавештења за VoIP

Шта је PushKit и како ради?

PushKit је Apple оквир, представљен у iOS 8, који пружа механизам за испоруку push обавештења са зајемченим приоритетом путем сталне везе са APNs серверима. За разлику од обичних обавештења, која пролазе кроз јединствени APNs канал и могу да касне, PushKit обавештења користе намењени ток са вишим приоритетом, што осигурава испоруку практично у реалном времену.

Технички, PushKit ради кроз сталну TCP везу између уређаја и Apple push сервера. Када сервер пошаље VoIP обавештење, веза га тренутно преноси на уређај, који буди апликацију и позива PKPushRegistry делегата. Апликација не мора да буде у активном стању — PushKit је може будити из позадине, завршеног стања, па чак након поновног покретања уређаја.

Према истраживању Microsoft Research (2024) о кашњењима push обавештења на мобилним платформама, медијана кашњења PushKit обавештења износи 120–350 мс, док стандардна APNs обавештења показују медијану од 1–5 секунди. Разлика у реду величине објашњава се управо намењеним TCP каналом и приоритетним обрадом на страни Apple-а.

Које типове обавештења PushKit подржава

PushKit подржава четири типа: VoIP (за позиве), Complication (за податке на бројчаницима watchOS), FileProvider (за синхронизацију датотека) и PushToTalk (за функцију радије). Од iOS 13, само VoIP тип остаје широко доступан за програмере трећих страна. Complication и FileProvider имају уско специјализовану примену и ограничени су на сопствене Apple екосистеме.

PushKit vs APNs: кључне разлике

APNs (Apple Push Notification service) — универзални сервис за испоруку push обавештења, који ради кроз јединствени канал за све апликације. Apple може да буферише, групише или чак одбаци APNs обавештења при преоптерећењу канала. PushKit, насупрот, користи намењену везу за сваки тип обавештења, и Apple гарантује испоруку сваког VoIP-push-а без буферизације.

Разлика се појављује у сценаријима критичним по времену: долазни позив испоручен путем APNs може да стигне са кашњењем од 10–30 секунди или да не стигне уопште ако је уређај у режиму штедње енергије. PushKit испоручује исто обавештење за 100–500 мс без обзира на стање уређаја, јер његов TCP канал систем одржава активним на приоритетни начин.

Поређење карактеристика

Архитектура PushKit-а: PKPushRegistry и PKPushPayload

Архитектура PushKit-а је изграђена око PKPushRegistry-а — објекта који региструје апликацију за примање обавештења одређеног типа. Апликација креира инстанцу PKPushRegistry, наводи жељени тип (нпр. PKPushTypeVoIP) и поставља делегата. Након регистрације, систем аутоматски одржава везу са APNs-ом и испоручује push обавештења путем делегата.

Свако обавештење је представљено објектом PKPushPayload, који садржи речник dictionaryPayload са подацима са сервера. Величина payload-а је ограничена на 5 KB, што је довољно за преношење метаподатака позива: идентификатора позиваоца, типа позива (аудио/видео), имена контакта и токена сесије. Медијски ток се преноси одвојено путем WebRTC-а или другог протокола реалног времена.

Регистрација PKPushRegistry

import PushKit

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

Примање и обрада push обавештења

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 секунди након преузимања push-а
• Не користите PushKit за пингове, синхронизацију садржаја или ажурирање токена — за то постоји background fetch
• Серверска страна треба да шаље push само при стварном долазном позиву, не за прелиминарно буђење
• При приему push-а без накнаднењег позива, корисник ће видети пропуштени позив у Recents-у — то дезоријентише

Интеграција PushKit-а у Swift-у

Пуна интеграција PushKit-а укључује регистрацију, добијање push токена и обраду долазних обавештења. PushKit самостално захтева дозволу за слање обавештења — додатно позивање UNUserNotificationCenter-а није потребно за сам PushKit, али може бити потребно за локална обавештења апликације. Након регистрације, систем позива методу pushRegistry:didUpdatePushCredentials за преношење push токена, који се мора послати на сервер.

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

Слање push обавештења са сервера

Серверска страна шаље PushKit обавештење путем APNs-а са push-type = voip и заглављем apns-push-type: voip. За разлику од обичних APNs, VoIP-push користи сопствени сертификат и не захтева конфигурисање topic-а. Payload треба да садржи минималне податке за идентификацију позива.

// Пример VoIP push payload-а
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

Дијагностика и отклањање PushKit обавештења

Отклањање PushKit-а је теже од стандардних APNs, јер PushKit не ради на iOS симулатору. За дијагностику је потребан физички iPhone или iPad. Први знак исправног рада је позивање pushRegistry:didUpdatePushCredentials при покретању и појава push токена одређеног формата (64 хекс карактера за VoIP). Ако се делегат не позива, проверите entitlements своје апликације.

Други чест проблем је да PushKit не испоручује обавештења након ажурирања апликације. До овога долази ако се push токен промијенио, али сервер наставља да користи стари. Рјешење је слање свежег токена на сервер при покретању апликације и уклањање неважећих токена при позиву pushRegistry:didInvalidatePushTokenForType. Apple такође препоручује имплементацију fallback механизма путем обичних APNs.

Типични проблеми и њихова рјешења