Ваш клиент не может принять звонок, пока телефон заблокирован. Или появляется эхо, которое раздражает обоих собеседников. А иногда звонок обрывается, когда приходит SMS. Эти баги — типичные последствия неполноценной интеграции VoIP. Мы решаем их на уровне архитектуры, опираясь на опыт в телемедицине, логистике и корпоративных коммуникациях.
Реализация VoIP-звонков в мобильном приложении — не одна задача, а несколько связанных технических слоёв: сигнальный протокол, медиатранспорт, управление аудиосессией и интеграция с системными API звонков. Пропустить или упростить любой из этих слоёв — получить звонок, который работает в демо, но ломается в продакшне: эхо, пропадание звука при входящем уведомлении, невозможность принять звонок с заблокированного экрана.
Как работает CallKit?
На iOS VoIP без CallKit технически возможен, но приложение не получает аудиосессию при входящем звонке на заблокированном экране, система не показывает системный экран входящего звонка, а после iOS 13 приложения без CallKit не получают PushKit уведомления для VoIP. CallKit — системный фреймворк, который показыват системный экран входящего звонка, управляет аудиосессией, поддерживает Bluetooth/AirPods и отображает звонки в истории вызовов.
import CallKit class CallManager: NSObject { let provider: CXProvider let callController = CXCallController() init() { let config = CXProviderConfiguration() config.supportsVideo = false config.maximumCallsPerCallGroup = 1 config.supportedHandleTypes = [.phoneNumber, .emailAddress] provider = CXProvider(configuration: config) super.init() provider.setDelegate(self, queue: nil) } func reportIncomingCall(uuid: UUID, callerName: String) { let update = CXCallUpdate() update.remoteHandle = CXHandle(type: .generic, value: callerName) update.hasVideo = false provider.reportNewIncomingCall(with: uuid, update: update) { error in // начинаем отвечать на звонок после разрешения системы } } } PushKit для входящих звонков в фоне. В отличие от обычных APNs push, PushKit будит приложение мгновенно и с высоким приоритетом. Но с iOS 13 Apple требует немедленно вызвать reportNewIncomingCall при получении VoIP push — иначе приложение завершается с crash. Нельзя делать сетевой запрос перед вызовом CallKit.
Android: ConnectionService и Telecom API
Аналог CallKit на Android — ConnectionService из пакета android.telecom. Позволяет приложению стать «телефонным аккаунтом» в системе, показывать звонки на экране блокировки, управлять аудиомаршрутизацией. Для входящих звонков в фоне — FCM push с priority: high. На Android 14+ фоновые сервисы ограничены, но ForegroundService типа phoneCall (добавлен в Android 14) решает именно эту задачу — у него нет ограничений на запуск при входящем звонке.
Управление аудиосессией через AudioManager:
val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as AudioManager audioManager.mode = AudioManager.MODE_IN_COMMUNICATION audioManager.isSpeakerphoneOn = false // при завершении: audioManager.mode = AudioManager.MODE_NORMAL Bluetooth-гарнитуры — отдельная головная боль. BluetoothHeadset profile, SCO соединение для голоса (не A2DP!), BroadcastReceiver на ACTION_SCO_AUDIO_STATE_UPDATED. Без явного управления SCO звук идёт через динамик даже при подключённой Bluetooth-гарнитуре.
Почему важен TURN-сервер?
Если используем WebRTC самостоятельно (а не через Twilio/Vonage), нужен TURN-сервер для пробивания NAT. Без него звонки работают только в одной сети — классический баг на демо, который ломается у клиента за офисным NAT. TURN-сервер также помогает при симметричных NAT, когда стандартный STUN не срабатывает.
coturn — open source TURN сервер, разворачивается на VPS за несколько часов. Конфигурация ICE:
// Android WebRTC SDK val iceServers = listOf( PeerConnection.IceServer.builder("stun:stun.example.com:3478").createIceServer(), PeerConnection.IceServer.builder("turn:turn.example.com:3478") .setUsername("user") .setPassword("password") .createIceServer() ) Кодеки: Opus для аудио (адаптивный битрейт 6–510 кбит/с, хорошо работает при потерях пакетов до 20%). WebRTC SDK включает его по умолчанию.
Детали выбора аудиокодека
Opus — адаптивный кодек, битрейт от 6 до 510 кбит/с. Поддерживает стерео и многоканальный звук. Для совместимости с SIP-телефонами могут понадобиться G.711 (PCMA/PCMU) или G.722. При выборе кодека учитывайте: поддержку на клиентах, ширину канала, требования к качеству.Сравнение подходов: Managed SDK vs WebRTC
| Параметр | Managed SDK (Twilio, Agora) | WebRTC + TURN |
|---|---|---|
| Сложность разработки | Низкая | Средняя |
| Стоимость минуты | ~$0.004–0.01 | ~$0.001 (свой TURN) |
| Контроль | Ограниченный | Полный |
| Задержка | Зависит от SDK | Минимальная (<100 мс) |
| Требуемые ресурсы | Нет | TURN-сервер |
Managed SDK проще в разработке, но WebRTC позволяет сэкономить до 80% затрат на звонки при собственной инфраструктуре TURN. При высокой нагрузке (более 10 000 минут в месяц) разница становится существенной.
Типичные ошибки и их решения
| Ошибка | Решение |
|---|---|
| Эхо | Установка MODE_IN_COMMUNICATION на обоих платформах + AEC (акустическая эхоподавление) |
| Звонок не приходит на заблокированный экран | Интеграция CallKit/ConnectionService |
| Задержка >300 мс | Настройка P2P ICE, TURN только как fallback |
| Прерывание при SMS | Обработка AVAudioSessionInterruptionNotification (iOS) и AudioManager (Android) |
| Bluetooth звук не переключается | Явное управление SCO через BroadcastReceiver |
Что входит в работу
- Анализ требований и выбор оптимального стека (WebRTC, Twilio, Agora или кастомный SIP).
- Проектирование сигнального канала (WebSocket, SIP или собственный протокол).
- Развертывание TURN-сервера (coturn) и настройка ICE-кандидатов.
- Интеграция CallKit (iOS) и ConnectionService (Android) с PushKit/FCM.
- Тестирование на 20+ реальных устройствах с разными версиями ОС и сетевыми условиями.
- Оптимизация аудиокачества: AEC, адаптивный jitter buffer, коррекция потерь пакетов.
- Документация и обучение команды заказчика.
- Поддержка после запуска (мониторинг, bugfix, доработки).
Процесс разработки VoIP-звонков
- Анализ требований и выбор стека (managed SDK vs WebRTC).
- Проектирование сигнального и медиаканала.
- Развертывание TURN-сервера и настройка ICE.
- Интеграция CallKit/ConnectionService и PushKit/FCM.
- Тестирование на реальных устройствах с различными сетевыми условиями.
- Оптимизация аудиокачества и устранение артефактов.
- Деплой и мониторинг.
Свяжитесь с нами, чтобы обсудить архитектуру вашего VoIP-решения. Закажите разработку, и мы гарантируем стабильные звонки без эха и обрывов. Получите консультацию инженера — мы готовы помочь.