Розробка голосових дзвінків (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. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції 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%. Економія трафіку була значною при 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 відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

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. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

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 — запити з перетинаючимися даними оновлюють кеш без дублювання.

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 (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

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

Що входить у роботу

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

Терміни та вартість

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