PushKit — τι είναι, το framework push ειδοποιήσεων για VoIP

Co je PushKit a jak funguje?

PushKit je framework Apple, představený v iOS 8, který poskytuje mechanismus doručení push oznámení s garantovanou prioritou prostřednictvím trvalého spojení se servery APNs. Na rozdíl od běžných oznámení, která procházejí jediným kanálem APNs a mohou se zpožďovat, PushKit oznámení používají vyhrazený proud s vyšší prioritou, což zajišťuje doručení prakticky v reálném čase.

Technicky PushKit funguje prostřednictvím trvalého TCP spojení mezi zařízením a push servery Apple. Když server odešle VoIP oznámení, spojení jej okamžitě předá zařízení, které probudí aplikaci a zavolá delegáta PKPushRegistry. Aplikace nemusí být v aktivním stavu — PushKit ji může probudit z pozadí, ukončeného stavu nebo dokonce po restartu zařízení.

Podle výzkumu Microsoft Research (2024) o zpožděních push oznámení na mobilních platformách je mediánní zpoždění PushKit oznámení 120–350 ms, zatímco standardní APNs oznámení vykazují medián 1–5 sekund. Rozdíl v řádu velikosti je způsoben právě vyhrazeným TCP kanálem a prioritním zpracováním na straně Apple.

Jaké typy oznámení PushKit podporuje

PushKit podporuje čtyři typy: VoIP (pro hovory), Complication (pro data na cifernících watchOS), FileProvider (pro synchronizaci souborů) a PushToTalk (pro funkci vysílačky). Od iOS 13 zůstává pouze typ VoIP široce dostupný pro externí vývojáře. Complication a FileProvider mají úzce specializované použití a jsou omezeny na vlastní ekosystémy Apple.

PushKit vs APNs: klíčové rozdíly

APNs (Apple Push Notification service) — univerzální služba doručení push oznámení, která funguje prostřednictvím jednoho kanálu pro všechny aplikace. Apple může při přetížení kanálu APNs oznámení vyrovnávat do vyrovnávací paměti, seskupovat nebo dokonce zahazovat. PushKit naproti tomu používá vyhrazené spojení pro každý typ oznámení a Apple garantuje doručení každého VoIP-push bez vyrovnávání.

Rozdíl se projevuje v časově kritických scénářích: příchozí hovor doručený prostřednictvím APNs může přijít se zpožděním 10–30 sekund nebo vůbec nepřijít, pokud je zařízení v režimu úspory energie. PushKit doručí stejné oznámení za 100–500 ms bez ohledu na stav zařízení, protože jeho TCP kanál je systémem udržován aktivní prioritním způsobem.

Porovnání charakteristik

Architektura PushKit: PKPushRegistry a PKPushPayload

Architektura PushKit je postavena kolem PKPushRegistry — objektu, který registruje aplikaci pro příjem oznámení určitého typu. Aplikace vytvoří instanci PKPushRegistry, určí požadovaný typ (např. PKPushTypeVoIP) a přiřadí delegáta. Po registraci systém automaticky udržuje spojení s APNs a doručuje push oznámení prostřednictvím delegáta.

Každé oznámení je reprezentováno objektem PKPushPayload, který obsahuje slovník dictionaryPayload s daty ze serveru. Velikost payloadu je omezena na 5 KB, což je dostatečné pro přenos metadat hovoru: identifikátor volajícího, typ hovoru (audio/video), jméno kontaktu a token relace. Mediální proud je přenášen samostatně prostřednictvím WebRTC nebo jiného protokolu reálného času.

Registrace PKPushRegistry

import PushKit

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

Příjem a zpracování push oznámení

PushKit zavolá delegátskou metodu při přijetí oznámení. V tuto chvíli musí aplikace extrahovat data z dictionaryPayload a okamžitě zobrazit hovor prostřednictvím CallKit, jinak systém může ukončit úlohu na pozadí. Apple doporučuje dokončit zpracování do 30 sekund, ale pro VoIP hovory je kritické zobrazit obrazovku hovoru před uplynutím první sekundy.

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

Omezení iOS 13 a pravidla používání PushKit

S vydáním iOS 13 zavedla Apple přísná omezení na používání PushKit. Vývojáři masivně používali VoIP-push jako skrytý mechanismus pro aktualizaci aplikací na pozadí — probuzení prostřednictvím PushKit umožňovalo načítání obsahu, synchronizaci dat a aktualizaci rozhraní bez výslovného souhlasu uživatele. Apple to považovalo za porušení konceptu úspory energie a omezilo PushKit pouze na indikaci příchozích hovorů.

Nyní každé PushKit oznámení musí okamžitě vést k zobrazení příchozího hovoru prostřednictvím CallKit. Pokud systém zjistí, že PushKit je používán k jiným účelům — například pro synchronizaci na pozadí nebo aktualizaci obsahu bez zobrazení hovoru — aplikace může být při moderování odmítnuta nebo odpojena od služby PushKit. Apple také odstranila možnost používat PushKit pro aktualizaci dat na pozadí od iOS 13.

Doporučení Apple pro používání PushKit (iOS 13+)

• Každé VoIP oznámení musí zavolat reportNewIncomingCall do 5 sekund po obdržení push
• Nepoužívejte PushKit pro pingy, synchronizaci obsahu nebo aktualizaci tokenů — k tomu slouží background fetch
• Serverová strana by měla odesílat push pouze při skutečném příchozím hovoru, ne pro předběžné probuzení
• Při obdržení push bez následného hovoru uživatel uvidí zmeškaný hovor v Recents — to je dezorientující

Integrace PushKit ve Swift

Plná integrace PushKit zahrnuje registraci, získání push tokenu a zpracování příchozích oznámení. PushKit nezávisle žádá o povolení k odesílání oznámení — další volání UNUserNotificationCenter není pro samotný PushKit nutné, ale může být potřebné pro lokální oznámení aplikace. Po registraci systém zavolá metodu pushRegistry:didUpdatePushCredentials pro předání push tokenu, který musí být odeslán na server.

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

Odeslání push oznámení ze serveru

Serverová strana odešle PushKit oznámení prostřednictvím APNs s push-type = voip a hlavičkou apns-push-type: voip. Na rozdíl od běžných APNs, VoIP-push používá vlastní certifikát a nevyžaduje konfiguraci topic. Payload by měl obsahovat minimální data pro identifikaci hovoru.

// Παράδειγμα payload VoIP push
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

Diagnostika a ladění PushKit oznámení

Ladění PushKit je obtížnější než standardních APNs, protože PushKit nefunguje na iOS simulátoru. Pro diagnostiku je potřebné fyzické iPhone nebo iPad. Prvním příznakem správné funkce je volání pushRegistry:didUpdatePushCredentials při spuštění a objevení push tokenu specifického formátu (64 hex znaků pro VoIP). Pokud delegát není volán, zkontrolujte entitlements své aplikace.

Dalším častým problémem je, že PushKit nedoručuje oznámení po aktualizaci aplikace. K tomu dochází, pokud se změnil push token, ale server nadále používá starý. Řešením je odeslání nového tokenu na server při spuštění aplikace a odstranění neplatných tokenů při volání pushRegistry:didInvalidatePushTokenForType. Apple také doporučuje implementovat záložní mechanismus prostřednictvím běžných APNs.

Typické problémy a jejich řešení