PushKit — nó là gì, framework thông báo push cho VoIP

PushKit là gì và nó hoạt động như thế nào?

PushKit là một framework của Apple được giới thiệu trong iOS 8, cung cấp cơ chế gửi thông báo push với ưu tiên được đảm bảo thông qua kết nối liên tục với máy chủ APNs. Không giống như các thông báo thông thường đi qua một kênh APNs duy nhất và có thể bị trễ, các thông báo PushKit sử dụng một luồng chuyên dụng với ưu tiên cao hơn, đảm bảo giao hàng gần như thời gian thực.

Về mặt kỹ thuật, PushKit hoạt động thông qua kết nối TCP liên tục giữa thiết bị và máy chủ push của Apple. Khi một máy chủ gửi thông báo VoIP, kết nối sẽ ngay lập tức chuyển nó đến thiết bị, thiết bị sẽ đánh thức ứng dụng và gọi ủy quyền PKPushRegistry. Ứng dụng không cần ở trạng thái hoạt động — PushKit có thể đánh thức nó từ nền, trạng thái đã kết thúc hoặc thậm chí sau khi khởi động lại thiết bị.

Theo nghiên cứu của Microsoft Research (2024) về độ trễ thông báo push trên các nền tảng di động, độ trễ trung vị của thông báo PushKit là 120–350 ms, trong khi thông báo APNs tiêu chuẩn có trung vị là 1–5 giây. Sự khác biệt về cấp độ độ lớn được giải thích bởi kênh TCP chuyên dụng và xử lý ưu tiên tại phía Apple.

PushKit hỗ trợ những loại thông báo nào?

PushKit hỗ trợ bốn loại: VoIP (cho cuộc gọi), Complication (cho dữ liệu mặt đồng hồ), FileProvider (cho đồng bộ tập tin) và PushToTalk (cho chức năng bộ đàm). Kể từ iOS 13, chỉ có loại VoIP vẫn khả dụng rộng rãi cho các nhà phát triển bên thứ ba. Complication và FileProvider có ứng dụng chuyên biệt và bị giới hạn trong hệ sinh thái riêng của Apple.

PushKit so với APNs: sự khác biệt chính

APNs (Apple Push Notification service) là một dịch vụ gửi thông báo push phổ quát hoạt động thông qua một kênh duy nhất cho tất cả các ứng dụng. Apple có thể đệm, gộp hoặc thậm chí loại bỏ các thông báo APNs khi kênh bị tắc nghẽn. Mặt khác, PushKit sử dụng kết nối chuyên dụng cho mỗi loại thông báo và Apple đảm bảo giao hàng mỗi push VoIP mà không có đệm.

Sự khác biệt trở nên rõ ràng trong các kịch bản quan trọng về thời gian: một cuộc gọi đến được gửi qua APNs có thể đến với độ trễ 10–30 giây hoặc không đến nếu thiết bị ở chế độ tiết kiệm năng lượng. PushKit gửi cùng một thông báo trong 100–500 ms bất kể trạng thái thiết bị, vì kênh TCP của nó được hệ thống duy trì hoạt động với ưu tiên.

So sánh tính năng

Kiến trúc PushKit: PKPushRegistry và PKPushPayload

Kiến trúc PushKit được xây dựng xoay quanh PKPushRegistry — một đối tượng đăng ký ứng dụng để nhận thông báo của một loại cụ thể. Ứng dụng tạo một thể hiện PKPushRegistry, chỉ định loại mong muốn (ví dụ: PKPushTypeVoIP) và chỉ định một ủy quyền. Sau khi đăng ký, hệ thống tự động duy trì kết nối với APNs và gửi thông báo push thông qua ủy quyền.

Mỗi thông báo được đại diện bởi một đối tượng PKPushPayload, chứa dictionaryPayload với dữ liệu từ máy chủ. Kích thước payload được giới hạn ở 5 KB, đủ để truyền siêu dữ liệu cuộc gọi: mã nhận dạng người gọi, loại cuộc gọi (âm thanh/video), tên liên hệ và token phiên. Luồng phương tiện được truyền riêng qua WebRTC hoặc một giao thức thời gian thực khác.

Đăng ký PKPushRegistry

import PushKit

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

Nhận và xử lý thông báo push

PushKit gọi phương thức ủy quyền khi nhận được thông báo. Tại thời điểm này, ứng dụng phải trích xuất dữ liệu từ dictionaryPayload và hiển thị ngay cuộc gọi qua CallKit, nếu không hệ thống có thể kết thúc tác vụ nền. Apple khuyến nghị hoàn tất xử lý trong vòng 30 giây, nhưng đối với cuộc gọi VoIP, việc hiển thị màn hình cuộc gọi trong giây đầu tiên là rất quan trọng.

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

Hạn chế của iOS 13 và quy tắc sử dụng PushKit

Với việc phát hành iOS 13, Apple đã đưa ra các hạn chế nghiêm ngặt đối với việc sử dụng PushKit. Các nhà phát triển đã sử dụng rộng rãi VoIP push như một cơ chế ẩn để cập nhật ứng dụng nền — đánh thức qua PushKit cho phép tải nội dung, đồng bộ dữ liệu và cập nhật giao diện mà không có sự cho phép rõ ràng của người dùng. Apple coi đây là hành vi vi phạm khái niệm tiết kiệm năng lượng và giới hạn PushKit chỉ dành cho chỉ báo cuộc gọi đến.

Giờ đây, mỗi thông báo PushKit phải ngay lập tức dẫn đến việc hiển thị cuộc gọi đến qua CallKit. Nếu hệ thống phát hiện PushKit được sử dụng cho các mục đích khác — ví dụ, đồng bộ nền hoặc cập nhật nội dung mà không hiển thị cuộc gọi — ứng dụng có thể bị từ chối khi xem xét hoặc bị vô hiệu hóa khỏi dịch vụ PushKit. Apple cũng đã loại bỏ khả năng sử dụng PushKit để cập nhật dữ liệu nền kể từ iOS 13.

Khuyến nghị của Apple về sử dụng PushKit (iOS 13+)

• Mỗi thông báo VoIP phải gọi reportNewIncomingCall trong vòng 5 giây sau khi nhận được push
• Không sử dụng PushKit cho ping, đồng bộ nội dung hoặc cập nhật token — hãy dùng background fetch cho những việc đó
• Phía máy chủ chỉ nên gửi push khi có cuộc gọi đến thực sự, không phải để đánh thức trước
• Nhận push mà không có cuộc gọi tiếp theo sẽ hiển thị cuộc gọi nhỡ trong Recents — điều này gây nhầm lẫn cho người dùng

Tích hợp PushKit trong Swift

Tích hợp PushKit đầy đủ bao gồm đăng ký, lấy token push và xử lý các thông báo đến. PushKit tự động yêu cầu quyền gửi thông báo — không cần gọi thêm UNUserNotificationCenter cho riêng PushKit, nhưng có thể cần cho các thông báo cục bộ của ứng dụng. Sau khi đăng ký, hệ thống gọi pushRegistry:didUpdatePushCredentials để gửi token push, token này cần được gửi đến máy chủ.

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

Gửi thông báo push từ máy chủ

Phía máy chủ gửi thông báo PushKit qua APNs với push-type = voip và tiêu đề apns-push-type: voip. Không giống như APNs thông thường, VoIP push sử dụng chứng chỉ riêng và không yêu cầu cấu hình topic. Payload phải chứa dữ liệu tối thiểu để xác định cuộc gọi.

// Ví dụ về payload push VoIP
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

Chẩn đoán và gỡ lỗi thông báo PushKit

Việc gỡ lỗi PushKit phức tạp hơn APNs tiêu chuẩn vì PushKit không hoạt động trên trình mô phỏng iOS. Cần có iPhone hoặc iPad thật để chẩn đoán. Dấu hiệu đầu tiên của hoạt động chính xác là lời gọi pushRegistry:didUpdatePushCredentials khi khởi chạy và sự xuất hiện của token push ở định dạng cụ thể (64 ký tự hex cho VoIP). Nếu ủy quyền không được gọi, hãy kiểm tra entitlements của ứng dụng của bạn.

Một vấn đề phổ biến khác là PushKit không gửi thông báo sau khi cập nhật ứng dụng. Điều này xảy ra nếu token push đã thay đổi nhưng máy chủ vẫn tiếp tục sử dụng token cũ. Giải pháp là gửi token mới đến máy chủ khi khởi chạy ứng dụng và xóa các token không hợp lệ khi pushRegistry:didInvalidatePushTokenForType được gọi. Apple cũng khuyến nghị triển khai cơ chế dự phòng qua APNs thông thường.

Các vấn đề thường gặp và giải pháp