Разработка голосовых звонков (VoIP) в мобильном приложении

Ваш клиент не может принять звонок, пока телефон заблокирован. Или появляется эхо, которое раздражает обоих собеседников. А иногда звонок обрывается, когда приходит 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 включает его по умолчанию.

Сравнение подходов: Managed SDK vs WebRTC

Managed SDK проще в разработке, но WebRTC позволяет сэкономить до 80% затрат на звонки при собственной инфраструктуре TURN. При высокой нагрузке (более 10 000 минут в месяц) разница становится существенной.

Типичные ошибки и их решения

Что входит в работу

• Анализ требований и выбор оптимального стека (WebRTC, Twilio, Agora или кастомный SIP).
• Проектирование сигнального канала (WebSocket, SIP или собственный протокол).
• Развертывание TURN-сервера (coturn) и настройка ICE-кандидатов.
• Интеграция CallKit (iOS) и ConnectionService (Android) с PushKit/FCM.
• Тестирование на 20+ реальных устройствах с разными версиями ОС и сетевыми условиями.
• Оптимизация аудиокачества: AEC, адаптивный jitter buffer, коррекция потерь пакетов.
• Документация и обучение команды заказчика.
• Поддержка после запуска (мониторинг, bugfix, доработки).

Процесс разработки VoIP-звонков

1. Анализ требований и выбор стека (managed SDK vs WebRTC).
2. Проектирование сигнального и медиаканала.
3. Развертывание TURN-сервера и настройка ICE.
4. Интеграция CallKit/ConnectionService и PushKit/FCM.
5. Тестирование на реальных устройствах с различными сетевыми условиями.
6. Оптимизация аудиокачества и устранение артефактов.
7. Деплой и мониторинг.

Свяжитесь с нами, чтобы обсудить архитектуру вашего VoIP-решения. Закажите разработку, и мы гарантируем стабильные звонки без эха и обрывов. Получите консультацию инженера — мы готовы помочь.

Интеграция API в мобильное приложение: с чего начать

Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.

Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.

Как выбрать протокол для интеграции API?

REST остаётся стандартом для большинства проектов. Но когда на экране профиля нужно 5 полей из 40, GraphQL исключает over-fetching и сокращает трафик на 30–60%. gRPC оправдан при тысячах запросов в минуту (trading, IoT) — бинарная сериализация в 3–5 раз быстрее JSON. WebSocket — единственный выбор для real-time без polling (сообщения, уведомления).

Пример из практики: для финтех-приложения мы заменили REST (40 полей) на GraphQL — размер ответа сократился с 12 КБ до 2,5 КБ, время рендера экрана упало на 70%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.

Как обеспечить надёжность соединения и offline-first

Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:

1. При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
2. Параллельно выполняем сетевой запрос, обновляем UI после ответа.
3. Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
4. При восстановлении сети автоматически синхронизируем изменения.

Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.

REST и выбор клиентской библиотеки

Alamofire (iOS) — де-факто стандарт для Swift-проектов. Поверх URLSession добавляет request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() с .validate() возвращает ошибку для любого статус-кода вне 200–299. Без .validate() Alamofire считает 404 и 500 успешными ответами. С Swift Concurrency — async-версия через serializingDecodable.

Retrofit (Android) — аннотационный HTTP-клиент поверх OkHttp. Интерфейс с аннотациями компилируется в реализацию. @GET, @POST, @Path, @Query, @Body — декларативное описание API. OkHttp под капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логирование в debug-сборке. Authenticator — автоматический refresh токена при 401.

Ktor (KMM/Flutter) — мультиплатформенный HTTP-клиент. На iOS работает через Darwin engine (URLSession), на Android — через OkHttp. Единый код для обеих платформ при KMM-архитектуре.

GraphQL: когда REST не справляется

REST возвращает фиксированную структуру. Экран профиля требует name, avatar, email — сервер отдаёт 40 полей. Over-fetching. GraphQL решает это: клиент запрашивает ровно нужные поля. Это критично для мобайла, где трафик и время парсинга — реальные ограничения. Apollo iOS и Apollo Kotlin генерируют типизированные классы по схеме: schema.graphql + query-файлы → строгие типы на этапе компиляции. Subscriptions через WebSocket — real-time без polling. Ограничение: GraphQL сложнее кешировать на уровне HTTP. Apollo использует нормализованный in-memory кеш InMemoryNormalizedCache — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation

WebSocket: real-time без лишнего трафика

Polling (setInterval каждые 5 секунд) — трата батареи и трафика. WebSocket — постоянное двунаправленное соединение. iOS: URLSessionWebSocketTask (нативный, iOS 13+). Android: OkHttp WebSocket. Обязательная обработка reconnect: при onFailure — экспоненциальный backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надстройка с автоматическим reconnect, но для новых проектов предпочтительнее нативный WebSocket (меньше зависимостей).

gRPC: для высоконагруженных сервисов

gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.

Certificate Pinning и безопасность

Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia

Что входит в работу

Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.

Сроки и стоимость

Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.