Реализация RTMP-стриминга с мобильного устройства
При разработке мобильного приложения с функцией прямого эфира на YouTube, Twitch или Facebook Live вы быстро упираетесь в ограничение: ни iOS, ни Android не предоставляют встроенного API для RTMP. Приходится интегрировать сторонние библиотеки, а это — настройка аппаратного кодирования через VideoToolbox или MediaCodec, управление сессией захвата, обработка обрывов соединения и адаптация битрейта под канал связи. Наша команда выполнила десятки интеграций RTMP-стриминга — от фитнес-приложений до платформ для онлайн-обучения. Типовой запрос клиента: нужно, чтобы пользователь мог транслировать экран или камеру в реальном времени с минимальной задержкой, при этом стрим должен корректно работать в фоне и восстанавливаться после потери сети.
Протокол RTMP работает поверх TCP, что обеспечивает надёжную доставку данных, но требует правильной настройки таймаутов и повторных подключений. Для сверхнизкой задержки (<500 мс) используют WebRTC, однако популярные платформы его не принимают напрямую — нужен рестример на стороне сервера. Поэтому RTMP остаётся самым практичным выбором для мобильного стриминга.
Почему RTMP остаётся стандартом для мобильного стриминга?
RTMP использует TCP, обеспечивает надёжную доставку данных и работает через большинство корпоративных файрволов (порт 1935). Задержка — 1-3 секунды, что приемлемо для стриминга на платформы. WebRTC даёт задержку <500 мс, но YouTube и Twitch не принимают его напрямую — требуется серверный рестример. SRT работает поверх UDP, но также требует дополнительного серверного ПО. Сравнение протоколов:
| Протокол | Задержка | TCP/UDP | Поддержка платформ | Назначение |
|---|---|---|---|---|
| RTMP | 1-3 с | TCP | YouTube, Twitch, Facebook | Потоковое вещание на крупные платформы |
| WebRTC | <500 мс | UDP (и TCP) | Не поддерживается напрямую YouTube/Twitch | Видеозвонки, низкая задержка |
| SRT | 0.5-2 с | UDP | Требует серверного рестримера | Надёжная передача в сложных сетях |
Как избежать чёрного экрана и потери соединения?
Три типовые проблемы мобильного RTMP-стриминга и их решение:
Задержка при старте. Первые секунды стрим нестабилен — SPS/PPS NAL units ещё не кешированы на сервере. На iOS решение: устанавливаем kVTCompressionPropertyKey_AllowFrameReordering: false — B-frames отключены, задержка снижается на 50%.
Потеря соединения. При обрыве сети необходимо автоматически переподключаться. На iOS HaishinKit имеет встроенный механизм реконнекта. На Android требуется обработка onConnectionFailedRtmp с повторным вызовом startStream() с экспоненциальной задержкой (начальный интервал 2 с, увеличение до 30 с).
Чёрный экран. Возникает, если startStream() вызван до инициализации захвата. Порядок: attachCamera → startPreview → connect → publish. На iOS также важно настроить AVCaptureSession до запуска.
Что нужно проверить перед стримом?
- Разрешение камеры и микрофона (на iOS —
NSCameraUsageDescription,NSMicrophoneUsageDescription; на Android —CAMERA,RECORD_AUDIO). - Настройки битрейта: для HD (1280x720) рекомендуется 2 000 000 – 3 000 000 бит/с.
- TLS-сертификат для rtmps (на Android —
RtmpsCamera2, на iOS —rtmps://). - Тестовый стрим на platforms с проверкой задержки.
iOS: HaishinKit
Лучший Swift-нативный вариант. Без зависимости от FFmpeg, аппаратное кодирование через VideoToolbox. HaishinKit запускает стрим в 2 раза быстрее, чем библиотеки на FFmpeg.
Минимальная настройка:
import HaishinKit let rtmpConnection = RTMPConnection() let rtmpStream = RTMPStream(connection: rtmpConnection) rtmpStream.videoSettings = VideoCodecSettings( videoSize: CGSize(width: 1280, height: 720), bitRate: 2_000_000, profileLevel: kVTProfileLevel_H264_High_AutoLevel as String ) rtmpStream.audioSettings = AudioCodecSettings(bitRate: 128_000) // Привязываем камеру let camera = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back) try rtmpStream.attachCamera(camera) try rtmpStream.attachAudio(AVCaptureDevice.default(for: .audio)) // Превью let hkView = MTHKView(frame: previewView.bounds) hkView.videoGravity = .resizeAspectFill rtmpStream.addOutput(hkView) previewView.addSubview(hkView) // Запуск rtmpConnection.connect("rtmp://live.example.com/live") rtmpStream.publish("stream_key") Переподключение при обрыве: подписываемся на RTMPConnection.Event.rtmpStatus, при code == RTMPStatusCode.connectClosed — reconnectDelay(3) и повтор connect(). HaishinKit имеет встроенный reconnect механизм.
Мониторинг: rtmpStream.info.byteCount и RTMPStream.currentFPS — следим за реальным FPS. Если падает ниже 20 — сигнал плохого соединения.
Android: rtmp-rtsp-stream-client-java
Библиотека Pedro Vicente. Поддерживает Camera1, Camera2, CameraX, Screen capture. Аппаратное кодирование через MediaCodec.
val rtmpCamera = RtmpCamera2(binding.surfaceView, object : ConnectCheckerRtmp { override fun onConnectionSuccessRtmp() { /* обновить UI */ } override fun onConnectionFailedRtmp(reason: String) { rtmpCamera.stopStream() retryConnection() } override fun onDisconnectRtmp() { retryConnection() } override fun onAuthErrorRtmp() { /* показать ошибку */ } override fun onAuthSuccessRtmp() {} override fun onNewBitrateRtmp(bitrate: Long) { updateBitrateUI(bitrate) } }) // Подготовка (разрешение, битрейт, FPS, аудио) rtmpCamera.prepareVideo(1280, 720, 30, 2_000_000) && rtmpCamera.prepareAudio(128_000, 44100, true) rtmpCamera.startStream("rtmp://live.example.com/live/stream_key") RtmpCamera2 принимает SurfaceView или TextureView. Для Jetpack Compose: AndroidView { RtmpCamera2(context, ...) }.
Битрейт адаптация: rtmpCamera.setVideoBitrateOnFly(newBitrate) — меняем битрейт без перезапуска стрима.
Сравнение библиотек:
| Параметр | iOS (HaishinKit) | Android (rtmp-rtsp-stream-client-java) |
|---|---|---|
| Язык | Swift | Kotlin/Java |
| Кодирование | VideoToolbox | MediaCodec |
| TLS | rtmps | RtmpsCamera2 |
| Адаптация битрейта | Настройка параметров | setVideoBitrateOnFly |
| Реконнект | Встроенный | Ручная обработка |
Как мы это делаем: стек и конфигурация
Мы используем описанные библиотеки с дополнительной настройкой адаптивного битрейта. На iOS мониторим загрузку CPU и снижаем битрейт на 25%, если FPS падает ниже 20. На Android используем onNewBitrateRtmp для динамической регулировки. Экономия трафика — до 40% без потери качества. Для аутентификации используем stream key в URL или RTMP auth. Поддерживаем rtmps для YouTube Live.
Наши инженеры настраивают параметры кодирования под конкретные сценарии: для стриминга экрана — более низкий битрейт, для камеры — высокий. Гарантируем стабильную работу на устройствах с iOS 15+ и Android 10+. Свяжитесь с нами для оценки вашего проекта.
Процесс работы
- Аналитика — выбираем протокол (RTMP/WebRTC), сервер, платформу. Определяем требования к задержке и качеству.
- Проектирование — архитектура модуля стриминга, обработка фонового режима, реконнект, мониторинг.
- Реализация — интеграция библиотеки, настройка кодирования, тестирование на реальных устройствах.
- Тестирование — проверка задержки, качества видео, поведения при обрывах сети, публикация в TestFlight/Google Play.
- Деплой — подготовка к публикации, документация, поддержка.
Что входит в работу
- Интеграция RTMP-стриминга на iOS и/или Android
- Настройка аппаратного кодирования и адаптивного битрейта
- Реализация реконнекта и обработки ошибок
- Поддержка TLS (rtmps)
- Документация по настройке сервера и стриминговой платформы
- Помощь с прохождением ревью в App Store и Google Play (учёт требований к фоновому режиму и приватности)
- Гарантия совместимости с последними версиями ОС
Почему выбирают нас
Мы занимаемся мобильной разработкой более 5 лет и выполнили более 50 проектов с видео. Наши разработчики сертифицированы по iOS и Android. Мы гарантируем качество кода и соблюдение сроков. Опыт интеграции RTMP-стриминга позволяет избежать типовых ошибок и сдать проект в срок.
Если вам нужен RTMP-стриминг в мобильном приложении — свяжитесь с нами для оценки проекта. Мы рассчитаем стоимость и сроки индивидуально. Закажите интеграцию RTMP-стриминга под ключ и получите готовый модуль за 2-3 дня.