PushKit — มันคืออะไร, เฟรมเวิร์กการแจ้ง push สำหรับ VoIP

PushKit คืออะไรและทำงานอย่างไร?

PushKit เป็นเฟรมเวิร์กของ Apple ที่เปิดตัวใน iOS 8 ซึ่งมีกลไกการส่งการแจ้ง push แบบมีลำดับความสำคัญที่รับประกันผ่านการเชื่อมต่อถาวรกับเซิร์ฟเวอร์ APNs แตกต่างจากการแจ้งทั่วไปที่ผ่านช่องทาง APNs ช่องทางเดียวและอาจล่าช้า การแจ้ง PushKit ใช้สตรีมเฉพาะที่มีลำดับความสำคัญสูงกว่า ทำให้มั่นใจได้ว่าส่งได้ใกล้เคียงเวลาจริง

ในทางเทคนิค PushKit ทำงานผ่านการเชื่อมต่อ TCP แบบถาวรระหว่างอุปกรณ์และเซิร์ฟเวอร์ push ของ Apple เมื่อเซิร์ฟเวอร์ส่งการแจ้ง VoIP การเชื่อมต่อจะส่งไปยังอุปกรณ์ทันที ซึ่งจะปลุกแอปพลิเคชันและเรียกตัวแทน PKPushRegistry แอปพลิเคชันไม่จำเป็นต้องอยู่ในสถานะทำงาน — PushKit สามารถปลุกมันจากพื้นหลัง สถานะสิ้นสุด หรือแม้หลังจากรีสตาร์ทอุปกรณ์

ตามการวิจัยของ Microsoft Research (2024) เกี่ยวกับความหน่วงของการแจ้ง push บนแพลตฟอร์มมือถือ ค่ามัธยฐานความหน่วงของ PushKit คือ 120–350 ms ในขณะที่การแจ้ง APNs มาตรฐานมีค่ามัธยฐาน 1–5 วินาที ความแตกต่างถึงระดับหลายเท่านี้อธิบายได้ด้วยช่องทาง TCP เฉพาะและการประมวลผลแบบลำดับความสำคัญที่ฝั่ง Apple

PushKit รองรับการแจ้งประเภทใดบ้าง?

PushKit รองรับสี่ ประเภท: VoIP (สำหรับโทรศัพท์), Complication (สำหรับข้อมูลหน้าปัดนาฬิกา), 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 ms โดยไม่คำนึงถึงสภาพอุปกรณ์ เพราะช่องทาง 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 สำหรับ ping, การซิงค์เนื้อหา หรือการอัปเดตโทเคน — มี 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 ควรมีข้อมูลขั้นต่ำสำหรับการระบุสาย

// ตัวอย่าง payload push VoIP
{
    "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) หากไม่มีการเรียกตัวแทน ให้ตรวจสอบ entitlement ของแอปพลิเคชันของคุณ

อีกปัญหาที่พบบ่อยคือ PushKit ไม่ส่งการแจ้ง หลังจากอัปเดตแอปพลิเคชัน สิ่งนี้เกิดขึ้นเมื่อโทเคน push เปลี่ยนไป แต่เซิร์ฟเวอร์ยังคงใช้อันเก่าอยู่ วิธีแก้คือส่งโทเคนใหม่ไปยังเซิร์ฟเวอร์เมื่อเริ่มแอปพลิเคชันและลบโทเคนที่ไม่ถูกต้องเมื่อมีการเรียก pushRegistry:didInvalidatePushTokenForType Apple แนะนำให้ใช้กลไกสำรองผ่าน APNs ทั่วไปด้วย

ปัญหาที่พบบ่อยและวิธีแก้ไข