Интеграция VK Live в мобильное приложение — задача, которая кажется простой, пока не столкнёшься с отсутствием официального SDK. Всё упирается в RTMP-протокол, сессионный ключ и кодирование в реальном времени. Мы решали её для iOS и Android, и вот что выяснили.
Какие технические сложности возникают при интеграции VK Live?
Как получить RTMP-ключ без участия пользователя? — интеграция трансляции в
Самая частая проблема — получение RTMP-ключа через VK API без ручного ввода. Метод video.startStreaming требует авторизацию через VK Connect с scope video. Если токен просрочен или не содержит нужный scope, возвращается error_code: 15 (access denied), и трансляция не запускается. Мы храним токен в Keychain (iOS) или EncryptedSharedPreferences (Android), обновляем через refresh flow до истечения, а не по факту ошибки. Это повышает успешность первой трансляции до 95% и экономит до 30 секунд на каждом входе. Получите консультацию по настройке OAuth2-потока — это сэкономит дни разработки.
Почему кодирование H.264 требует точной настройки?
Кодирование на мобиле — узкое место. На iOS используем VideoToolbox через AVAssetWriter + AVAssetWriterInput с параметрами:
-
AVVideoCodecKey: AVVideoCodecType.h264 -
AVVideoWidthKey: 1280,AVVideoHeightKey: 720 -
AVVideoCompressionPropertiesKey→AVVideoAverageBitRateKey: 2_500_000 -
AVVideoMaxKeyFrameIntervalKey: 60(keyframe каждые 2 секунды при 30fps)
Без явного AVVideoMaxKeyFrameIntervalKey энкодер расставляет keyframe слишком редко — RTMP-сервер VK начинает буферизировать дольше, зрители замечают рывки при смене сцены. На Android — MediaCodec с MediaFormat.MIMETYPE_VIDEO_AVC и BITRATE_MODE_CBR. VBR на нестабильном соединении даёт всплески битрейта, которые дроп-пакеты на VK-ингесте превращают в артефакты на 2–3 секунды. Поэтому мы фиксируем CBR и ограничиваем GOP до 60 кадров.
Как мы реализуем RTMP-трансляцию
Сравнение подходов: HaishinKit vs кастомный RTMP
| Параметр | HaishinKit (iOS) | Кастомный RTMP (Android) |
|---|---|---|
| Время разработки | 1–2 дня | 3–5 дней |
| Гибкость | Средняя | Высокая — полный контроль над буферами |
| Зависимости | Внешняя библиотека | Только стандартные API |
| Поддержка | Активная, обновления | Своими силами |
| Производительность | Хорошая, 60 fps | Отличная при кастомном пуле потоков |
HaishinKit сокращает время внедрения в 2–3 раза по сравнению с кастомным решением, но даёт меньше гибкости для тонкой настройки буферизации.
На iOS для RTMP-передачи используем HaishinKit (Swift, активно поддерживается). На Android — предпочитаем нативный MediaCodec с кастомным RTMP-клиентом поверх java.net.Socket, избегая тяжёлых зависимостей. Схема для iOS с HaishinKit:
let rtmpConnection = RTMPConnection() let rtmpStream = RTMPStream(connection: rtmpConnection) rtmpStream.videoSettings = VideoCodecSettings( videoSize: CGSize(width: 1280, height: 720), bitRate: 2_500_000, profileLevel: kVTProfileLevel_H264_High_AutoLevel as String ) rtmpStream.audioSettings = AudioCodecSettings(bitRate: 128_000) rtmpConnection.connect("rtmp://vp.vkforms.ru/live") rtmpStream.publish(streamKey) Мониторинг качества — подписываемся на RTMPConnection.Event.rtmpStatus, отслеживаем NetStream.Publish.BadName (неверный ключ), NetStream.Failed (разрыв соединения). При NetStream.Failed логируем в Firebase Crashlytics с параметрами: битрейт в момент разрыва, тип соединения (Wi-Fi/Cellular), версия ОС.
Переподключение реализуем с exponential backoff: 2s → 4s → 8s → 16s → 30s (максимум). Бесконечный retry без паузы заблокирует аккаунт на VK-стороне за flood.
Сравнение настроек кодирования для iOS и Android
| Параметр | iOS (VideoToolbox) | Android (MediaCodec) |
|---|---|---|
| Кодек | H.264/H.265 | H.264/H.265 |
| Битрейт | 2.5–4 Mbps | 2.5–4 Mbps |
| GOP | 60 кадров | 60 кадров |
| Режим битрейта | CBR | CBR |
| Профиль | High | High |
Авторизация и получение stream key
Через VK SDK (iOS: VKSDK, Android: vk-android-sdk) или прямой OAuth2-flow:
- Открываем WebView или SFSafariViewController на
https://oauth.vk.com/authorize?client_id=APP_ID&scope=video&response_type=token - Перехватываем redirect на
https://oauth.vk.com/blank.html#access_token=... - Вызываем
video.startStreamingс полученным токеном - Из ответа берём
rtmp_urlиkey
Ключ сессионный — действует одну трансляцию. Сохранять между сессиями нельзя.
Чек-лист проверки интеграции
- [ ] Токен авторизации получен с scope video
- [ ] RTMP-ключ действителен для текущей трансляции
- [ ] Параметры кодирования установлены (CBR, GOP 60)
- [ ] Обработка ошибок с exponential backoff
- [ ] Логирование в Crashlytics
- [ ] Проверка соответствия App Store Review Guidelines и Google Play Developer Policy
Что входит в работу
- Полная интеграция RTMP-трансляции на iOS или Android (по выбору)
- OAuth2-авторизация через VK с обработкой токенов
- Настройка кодирования H.264/H.265: битрейт, GOP, профиль
- Обработка сетевых ошибок и авто-переподключение
- Мониторинг через Firebase Crashlytics с кастомными логами
- Документация по использованию и поддержке
- Помощь при публикации в App Store / Google Play (проверка соответствия правилам)
Сроки и стоимость
Интеграция на одной платформе (iOS или Android): 2–3 недели с учётом OAuth-flow, захвата видео и базовой обработки ошибок. Добавление адаптивного битрейта и автопереподключения — ещё неделя. Стоимость рассчитывается индивидуально после анализа требований. Свяжитесь, чтобы мы оценили ваш проект и подобрали оптимальный стек. Получите консультацию — поможем разобраться с деталями.
Даём гарантию на стабильность трансляции при соблюдении рекомендованных настроек. Опыт более 15 проектов — уверены в качестве.