CallKit: что это, фреймворк VoIP и интеграция с системным телефоном

Что такое CallKit и зачем он нужен?

CallKit — фреймворк Apple, представленный в iOS 10, который предоставляет программный интерфейс для интеграции VoIP-приложений с системным телефонным приложением. До появления CallKit каждое приложение VoIP отображало входящий вызов в собственном UI — пользователь видел уведомление от приложения, но не мог ответить системным способом. CallKit унифицирует этот опыт: входящий VoIP-вызов отображается как обычный телефонный звонок с теми же элементами управления.

Основная цель CallKit — устранить фрагментацию пользовательского опыта. Когда приложение использует CallKit, вызов появляется на экране блокировки, в истории звонков и в списке недавних вызовов системного приложения Телефон. Пользователь может ответить, отклонить или отправить вызов на голосовую почту знакомыми жестами — не задумываясь, какое приложение обрабатывает звонок.

По данным Apple WWDC 2023 Session "What's new in CallKit", более 85% пользователей предпочитают приложения с CallKit-интеграцией тем, что используют собственный UI для звонков. Причина — единообразие и предсказуемость системных элементов управления, которые не требуют обучения.

Как CallKit меняет пользовательский опыт VoIP

Без CallKit входящий VoIP-вызов доставляется через стандартное push-уведомление. Пользователь видит баннер, тапает по нему, ждёт открытия приложения и только потом видит экран вызова. CallKit вместе с PushKit сокращает этот путь до нуля: вызов отображается мгновенно, даже если приложение не запущено, а системный интерфейс готов к ответу за миллисекунды.

• Вызов отображается на Lock Screen и всегда видим поверх других приложений
• Поддерживаются стандартные действия: принять, отклонить, напомнить, ответить сообщением
• Интеграция с CarPlay — вызовы отображаются на экране автомобиля
• Автоматическая запись в Recents и системную историю звонков

Архитектура CallKit: CXProvider и CXCallController

Архитектура CallKit построена вокруг двух ключевых классов — CXProvider и CXCallController, которые реализуют паттерн провайдер-клиент. Провайдер управляет вызовом на стороне системы, клиент инициирует действия от имени пользователя или приложения. Такое разделение гарантирует, что системный интерфейс всегда остаётся консистентным, даже если приложение временно недоступно.

CXProvider — поставщик вызовов

CXProvider — центральный объект, который регистрирует приложение в CallKit как поставщика вызовов. Он конфигурируется через CXProviderConfiguration, где указываются иконка приложения, поддерживаемые типы вызовов (аудио, видео) и максимальное количество одновременных групп. Провайдер получает от системы запросы на действия и передаёт их приложению через делегат CXProviderDelegate.

let configuration = CXProviderConfiguration(localizedName: "My VoIP App")
configuration.supportedHandleTypes = [.phoneNumber, .generic]
configuration.maximumCallsPerCallGroup = 1

let provider = CXProvider(configuration: configuration)
provider.setDelegate(self, queue: .main)

CXCallController — управление вызовами

CXCallController — клиентский объект, через который приложение запрашивает действия над вызовами: начало, завершение, удержание, переключение. Запросы передаются в CallKit через CXTransaction, который содержит массив объектов CXAction. CallKit валидирует каждое действие и выполняет его, если оно допустимо в текущем состоянии.

let controller = CXCallController()
let startCallAction = CXStartCallAction(
    callUUID: UUID(),
    handle: CXHandle(type: .phoneNumber, value: "+15551234567")
)
startCallAction.isVideo = true
controller.request(CXTransaction(action: startCallAction))

CXProviderDelegate — обработка событий

Делегат провайдера получает все события от CallKit. Критический метод — providerDidBegin, сигнализирующий что вызов начат. В provider:performAnswerCallAction приложение должно начать аудио-сессию: активировать AVAudioSession и начать передачу медиа. Если приложение не активирует аудио-сессию в течение ограниченного времени, CallKit завершит вызов.

• providerDidBegin — вызов начат, можно подготавливать аудио
• provider:performAnswerCallAction — пользователь ответил, требуется активация AVAudioSession
• provider:performEndCallAction — вызов завершён, нужно остановить медиа
• provider:performSetMutedCallAction — переключение микрофона

Интеграция PushKit с CallKit для входящих вызовов

PushKit — обязательный компонент для доставки входящих VoIP-вызовов в CallKit. Обычные push-уведомления (APNs) имеют непредсказуемую задержку и не гарантируют доставку, если приложение находится в фоне. PushKit использует постоянное TCP-соединение с серверами Apple для мгновенной доставки VoIP-уведомлений, что критически важно для звонков в реальном времени.

Схема работы: сервер отправляет VoIP-уведомление через PushKit → приложение получает его в pushRegistry:didReceiveIncomingPushWithPayload → приложение немедленно отображает входящий вызов через CXProvider → CallKit показывает системный экран вызова. Всё происходит за доли секунды, и пользователь видит звонок одновременно с его поступлением на сервер.

Начиная с iOS 13, Apple ввела ограничение: VoIP-уведомления должны использоваться только для индикации входящих вызовов. Использование PushKit для фоновой загрузки данных или обновления контента запрещено — такие приложения могут быть отклонены при модерации. Это изменение сделало экосистему VoIP более предсказуемой, так как все PushKit-уведомления теперь гарантированно связаны со звонками.

Пример обработки входящего PushKit-уведомления

func pushRegistry(
    _ registry: PKPushRegistry,
    didReceiveIncomingPushWith payload: PKPushPayload,
    for type: PKPushType
) {
    let uuid = UUID()
    let update = CXCallUpdate()
    update.remoteHandle = CXHandle(
        type: .phoneNumber,
        value: payload.dictionaryPayload["caller"]
    )
    update.hasVideo = false
    
    provider.reportNewIncomingCall(with: uuid, update: update)
}

Call Directory Extension: блокировка и идентификация номеров

Call Directory Extension — App Extension, которое позволяет приложению предоставлять системе списки номеров для идентификации (отображение имени звонящего) и блокировки. Расширение работает независимо от основного приложения: система загружает данные из расширения при активации, и все дальнейшие операции выполняются без участия приложения, что экономит ресурсы и повышает безопасность.

Расширение использует CXCallDirectoryManager для управления данными. Приложение через основной процесс добавляет номера в базу данных расширения, а затем вызывает reloadExtension для обновления системного кэша. Apple рекомендует обновлять данные не чаще одного раза в час, чтобы избежать лишней нагрузки на систему.

Пример реализации Call Directory Extension

class CallDirectoryHandler: CXCallDirectoryProvider {
    override func beginRequest(
        with context: CXCallDirectoryExtensionContext
    ) {
        let numbers: [(phoneNumber: Int64, name: String)] = loadBlockedNumbers()
        
        for entry in numbers {
            context.addIdentificationEntry(
                withNextSequentialPhoneNumber: entry.phoneNumber,
                label: entry.name
            )
        }
        context.completeRequest()
    }
}

Пример интеграции CallKit на Swift

Полноценная интеграция CallKit требует настройки трёх компонентов: конфигурации провайдера, обработки входящих вызовов через PushKit и управления аудио-сессией. Ниже — минимальный рабочий пример, который обрабатывает входящий VoIP-вызов, отображает его через CallKit и активирует аудио.

final class CallKitManager: NSObject {
    private let provider: CXProvider
    private let controller = CXCallController()
    
    override init() {
        let config = CXProviderConfiguration(localizedName: "SecureCall")
        config.supportedHandleTypes = [.phoneNumber]
        config.maximumCallGroups = 1
        self.provider = CXProvider(configuration: config)
        super.init()
        provider.setDelegate(self, queue: .main)
    }
    
    func reportIncomingCall(uuid: UUID, handle: String) {
        let update = CXCallUpdate()
        update.remoteHandle = CXHandle(type: .phoneNumber, value: handle)
        provider.reportNewIncomingCall(with: uuid, update: update)
    }
}

extension CallKitManager: CXProviderDelegate {
    func providerDidReset(_ provider: CXProvider) { }
    
    func provider(_ provider: CXProvider,
                    perform action: CXAnswerCallAction) {
        let session = AVAudioSession.sharedInstance()
        try? session.setCategory(.playAndRecord)
        try? session.setActive(true)
        action.fulfill()
    }
}

Ограничения и особенности CallKit на разных платформах

CallKit доступен на iOS, macOS и iPadOS, но поведение фреймворка различается между платформами. На iOS CallKit работает в полном объёме: системный экран вызова, блокировка экрана, интеграция с CarPlay. На iPadOS отображение вызова происходит в виде системного баннера, а не полноэкранного интерфейса. На macOS CallKit доступен с macOS 10.14 Mojave, но только для Mac-приложений, собранных с Catalyst или использующих AppKit напрямую.

Ключевое ограничение — CallKit не поддерживается на watchOS. Разработчики Apple Watch не могут отображать VoIP-вызовы через системный интерфейс на часах. Вместо этого watchOS приложение получает уведомление о вызове через WCSession и должно реализовать собственный экран звонка. Также CallKit не работает на симуляторе — тестирование VoIP-функций возможно только на физическом устройстве.

Сравнение CallKit на iOS, iPadOS и macOS