Реализация отправки файлов в чате мобильного приложения
Мы сталкивались с десятками проектов, где отправка файлов в чате превращается в головную боль: утечка security scope на iOS, пустые файлы из iCloud, content:// URI на Android, которые не передать в сеть. Задача не сводится к кнопке «прикрепить файл»: нужно правильно обработать file picker на обеих платформах, корректно отобразить тип файла, организовать загрузку и безопасное скачивание на устройство получателя. Рассказываем, как это делаем мы.
Как мы выбираем файл: подводные камни платформ
На iOS системный UIDocumentPickerViewController возвращает URL с security-scoped bookmark. Доступ к файлу открывается через startAccessingSecurityScopedResource() и обязательно закрывается через stopAccessingSecurityScopedResource() после копирования во временную директорию. Если забыть второй вызов – утечка security scope, и при следующем запуске приложения доступ к файлу будет заблокирован системой. Мы гарантируем, что в нашем коде эти вызовы всегда парные.
Файлы из iCloud Drive приходят не сразу: NSMetadataQuery показывает статус загрузки. Если файл не скачан на устройство – нужно дождаться завершения NSMetadataUbiquitousItemIsDownloadingKey перед копированием. Без этого получим пустой файл размером 0 байт в upload-очереди.
На Android – Intent(Intent.ACTION_OPEN_DOCUMENT) с addCategory(Intent.CATEGORY_OPENABLE). Uri из content provider нельзя напрямую передавать в сетевые запросы – нужно скопировать содержимое через contentResolver.openInputStream() в кэш-директорию приложения. Файлы из Google Drive и других провайдеров не имеют реального пути в файловой системе, только content:// URI.
| Параметр |
iOS |
Android |
| Механизм доступа |
security-scoped bookmark + временное копирование |
contentResolver + кэш-директория |
| Управление ресурсами |
Явное открытие/закрытие |
Закрытие InputStream в finally |
| Работа с облачными файлами |
Ожидание загрузки iCloud |
Автоматическое копирование провайдером |
| Риски |
Утечка scope → потеря доступа |
Неправильный URI → сбой сети |
MIME-тип и иконки: почему проверка magic bytes лучше расширения
Определяем MIME по расширению через UTType (iOS 14+) или MimeTypeMap (Android). На сервере – дополнительно проверяем через magic bytes (первые байты файла). PDF начинается с %PDF, ZIP – с PK\x03\x04. Это защищает от переименованных исполняемых файлов. Сравнение: проверка по расширению занимает 1 мс, но mortal; magic bytes – 10 мс, но детектит 99.9% подделок.
В чате показываем иконку по категории: документ, таблица, архив, аудио, прочее. Не пытаться рендерить превью для каждого типа – только для PDF (через PDFKit на iOS или PdfRenderer на Android) и офисных форматов через QuickLook / ACTION_VIEW с системным приложением.
Загрузка и скачивание: background session и WorkManager
Upload – те же принципы, что для видео: чанкование для файлов > 5 МБ, background session на iOS, WorkManager на Android. Прогресс в байтах, не процентах – пользователь понимает 1.2 МБ из 8.4 МБ лучше, чем 14%. На iOS background session позволяет загрузке продолжаться даже после закрытия приложения – пользователь получит уведомление о завершении.
Скачивание на устройство получателя – отдельная история. На iOS файл сохраняем в FileManager.default.urls(for: .documentDirectory) и предлагаем через UIActivityViewController открыть в другом приложении. Прямое сохранение в «Файлы» – через UIDocumentPickerViewController в режиме экспорта.
На Android – DownloadManager системный: он корректно обрабатывает фоновую загрузку, показывает прогресс в шторке уведомлений и сохраняет в Downloads. Прямой путь через FileOutputStream в getExternalFilesDir() – только для внутреннего кэша приложения, не видного пользователю в файловом менеджере.
Безопасность: белый список и presigned URL
Белый список MIME-типов на сервере – обязательно. Исполняемые файлы (.exe, .apk, .ipa, .sh) блокируем или проверяем через антивирусный скан (ClamAV, VirusTotal API). Максимальный размер файла – лимит на уровне API gateway, не только на клиенте. Опыт показывает, что ограничение на клиенте легко обходится.
Ссылки на скачивание – presigned URL с TTL. Прямые ссылки на S3 без подписи означают публичный доступ к приватным чатам. Наши инженеры настраивают TTL так, чтобы ссылка работала 10–15 минут – достаточно для скачивания, но не для распространения.
Как мы подходим к реализации?
- Анализируем вашу аудиторию и типы файлов, которые будут передаваться.
- Проектируем архитектуру: выбираем механизм загрузки (чанки/весь файл), определяем лимиты.
- Реализуем file picker с учётом особенностей платформы.
- Настраиваем background upload и возобновление прерванных загрузок.
- Подключаем проверку MIME на сервере и генерацию presigned URL.
- Тестируем на реальных файлах: от 1 КБ до 2 ГБ.
Что входит в работу?
- Исходный код модуля отправки/скачивания файлов.
- Документация по API и интеграции.
- Доступ к репозиторию с примерами.
- Поддержка в течение 30 дней после сдачи.
Сроки ориентировочно
Базовая реализация (file picker, upload с прогрессом, отображение в чате, скачивание) – 2–3 дня. Поддержка background upload + возобновление + белый список типов – ещё 1 день. Стоимость рассчитывается индивидуально.
Оцените свой проект – свяжитесь с нами. Опыт 5+ лет и более 30 успешных проектов с чатами гарантируют, что отправка файлов будет работать стабильно и безопасно. Получите консультацию уже сегодня.
Как выбрать подход к камере на мобильных платформах
Приложения, где пользователи снимают, слушают или смотрят, технически одни из самых требовательных. Мы сталкиваемся с этим каждый день. Не из-за сложности API, а из-за разницы в железе: на флагмане камера работает идеально, на бюджетном устройстве с нестандартным Camera HAL возникают артефакты и сбои. На iOS стабилизация одного поколения отличается от другого. Платформенные различия формируют 80% всей сложности медиа-разработки. Наш опыт — 7+ лет в мобильных медиа и более 40 реализованных проектов с камерой, аудио и видео.
CameraX против Camera2 и AVFoundation
На Android долгое время Camera2 API был единственным адекватным выбором для кастомных камер. Это низкоуровневый API с CaptureRequest, CameraCharacteristics, ImageReader — мощный, но многословный. Только preview с корректным aspect ratio и правильной ориентацией занимает несколько сотен строк кода.
CameraX (Jetpack) — обёртка поверх Camera2 с автоматической адаптацией под устройство. Preview, ImageCapture, ImageAnalysis, VideoCapture — четыре use case, которые комбинируются. Он решает за вас проблему ориентации, aspect ratio и lifecycle: привязываете к LifecycleOwner и не думаете о закрытии камеры при сворачивании. В последних версиях CameraX получил Extensions API для боке, ночного режима, HDR — нативные алгоритмы производителей через единый интерфейс.
Когда нужен Camera2 напрямую: RAW-съёмка через ImageFormat.RAW_SENSOR, ручной контроль ISO/выдержки/фокуса или когда CameraX Extensions API не поддерживается и требуется кастомный ML-пайплайн в ImageAnalysis.
На iOS AVFoundation — единственный путь для кастомной камеры. AVCaptureSession с AVCaptureDeviceInput и нужным output (AVCapturePhotoOutput, AVCaptureVideoDataOutput, AVCaptureMovieFileOutput). Для реал-тайм обработки видео — AVCaptureVideoDataOutput + CVPixelBuffer в captureOutput(_:didOutput:from:) на фоновой очереди. Именно тут CoreML-модели получают кадры для инференса.
Типичная ошибка с AVFoundation: конфигурировать сессию на main thread. beginConfiguration() / commitConfiguration() должны вызываться на фоновом потоке. Иначе preview фризит, пользователь видит заморозку интерфейса. Эта ошибка встречается в 70% проектов, которые мы аудировали.
Почему AudioFocus критичен для Android приложений
Аудио на мобильных платформах требует корректного управления жизненным циклом звука. AudioFocus — механизм координации между приложениями. AudioManager.requestAudioFocus() с OnAudioFocusChangeListener. Если не обрабатывать AUDIOFOCUS_LOSS_TRANSIENT (паузировать) и AUDIOFOCUS_LOSS (останавливать) — ваше приложение будет играть поверх телефонного звонка. Это гарантированный плохой отзыв в Google Play. Android Developer Guide: AudioFocus
На iOS AudioSession категории определяют поведение: playback — для плееров (продолжает играть при заблокированном экране), record — для записи с отключением других источников, playAndRecord — для голосовых сообщений. Неправильная категория — приложение заглушает фоновую музыку пользователя при старте.
AVAudioEngine — современный API для обработки аудио: граф нод (микшеры, эквалайзеры), tap-ы для захвата буфера. Для речи в реальном времени — SFSpeechRecognizer + inputNode.installTap.
На Android для записи с шумоподавлением — NoiseSuppressor.isAvailable() + create(audioRecord.audioSessionId). Работает не на всех устройствах, нужен fallback.
Видео: воспроизведение и стриминг
ExoPlayer (Media3) — стандарт для Android. Поддерживает HLS, DASH, SmoothStreaming, прогрессивное воспроизведение. DefaultTrackSelector с Parameters позволяет выбирать качество вручную или адаптивно. DRM через DefaultDrmSessionManager с Widevine L1/L3.
Проблема, с которой сталкиваются почти все: ExoPlayer в RecyclerView при быстром скролле. Нужен PlayerPool — пул переиспользуемых плееров. Без пула каждый новый экземпляр создаёт MediaCodec инстанс, что дорого и приводит к MediaCodec$CodecException: Error -19 на некоторых Android 10 устройствах при >3 одновременных инстансах.
AVPlayer / AVPlayerViewController на iOS — для воспроизведения. Для кастомного UI — AVPlayerLayer + собственные контролы. HLS работает нативно через AVPlayer(url:) с m3u8. FairPlay DRM требует серверной части: AVContentKeySession, CKC-ответ от KSM-сервера, делегат ресурсов.
Для Flutter — video_player как базовый слой, chewie для UI. Для серьёзных задач — platform channel к нативному ExoPlayer/AVPlayer (из-за DRM и субтитров).
| Протокол |
Задержка |
Применение |
| RTMP |
2–5 сек |
Стриминг на YouTube/Twitch |
| HLS |
6–30 сек |
VOD, широковещательный |
| DASH |
6–30 сек |
VOD с адаптивным битрейтом |
| WebRTC |
< 500 мс |
Видеозвонки, P2P |
| SRT |
1–4 сек |
Профессиональный стриминг |
WebRTC на мобильных — через нативные фреймворки или flutter_webrtc. Реальная сложность — не в самом протоколе, а в сигналинге и TURN-серверах. Без TURN клиенты за симметричными NAT не установят соединение — это примерно 15–20% трафика. Coturn — стандартный open-source сервер.
RTMP публикация на мобильных: LFLiveKit для iOS, HaishinKit как более современная альтернатива. На Android — rtmp-rtsp-stream-client-java или через FFmpeg с JNI. Последнее даёт максимальную гибкость, но бинарник растёт на 10–15 МБ.
Обработка медиа: компрессия и транскодирование
Видео в ProRes может занимать 6 ГБ/минуту. Перед загрузкой нужна компрессия. На iOS — AVAssetExportSession с пресетом 1920×1080 или кастомный AVVideoComposition. VideoToolbox для аппаратного кодирования H264/HEVC — быстрее и экономнее по батарее.
На Android — MediaCodec напрямую или Transformer (Media3) — высокоуровневый API для трансформаций (обрезка, ресайз, эффекты через GlEffectsFrameProcessor). Для изображений — BitmapFactory.Options.inSampleSize для даунсемплинга, Glide / Coil для кеширования. Coil на Coroutines хорошо вписывается в Compose. Загружать оригинал 12 МП в ImageView 200×200dp — классический OutOfMemoryError на устройствах с 2 ГБ RAM.
Как реализовать стриминг на мобильных устройствах: пошаговый план
- Определить требования: целевая задержка, количество одновременных пользователей, необходимость P2P.
- Выбрать протокол и стек: WebRTC для видеозвонков, RTMP/HLSLive для вещания.
- Настроить сигналинг (SIP, WebSocket, MQTT) и TURN-сервер.
- Реализовать публикацию/просмотр через нативный API или кроссплатформенный плагин.
- Провести тестирование на реальных устройствах с разными камерами и сетевыми условиями.
- Оптимизировать битрейт и разрешение в зависимости от пропускной способности.
Типичные ошибки при разработке медиа-функциональности
- Конфигурация AVFoundation сессии на главном потоке.
- Отсутствие обработки AudioFocus Loss на Android.
- Игнорирование
MediaCodec ограничений на дешёвых устройствах.
- Использование эмулятора для тестов камеры — эмулятор не воспроизводит проблемы HAL.
- Утечка памяти при пересоздании медиаплееров без пула.
Что входит в работу
| Deliverable |
Описание |
| Анализ требований |
Выбор стека, приоритетов, тестовых устройств |
| Проектирование |
Архитектура, диаграммы потоков данных, выбор API |
| Реализация |
Код с использованием выбранных инструментов |
| Интеграция с бэкендом |
GraphQL/REST, DRM, WebRTC сигналинг |
| Тестирование |
На реальных устройствах (не менее 5 моделей) |
| Документация |
API-документация, инструкция по сборке |
| Поддержка после релиза |
1 месяц инцидентной поддержки, обучение команды |
Процесс разработки медиафункциональности
Сложность нелинейна: базовое воспроизведение видео — 1–2 дня, кастомная камера с обработкой кадров и стримингом — 3–5 недель. Начинаем с прояснения требований: DRM, форматы, минимальная OS, поддержка фоновых режимов. Тестирование на железе обязательно — эмулятор не воспроизводит проблемы с Camera HAL, аппаратным кодеком и AudioFocus. Минимальный набор: последний iPhone, iPhone SE, флагман Samsung, бюджетный Android, Android Go (если целевая аудитория — развивающиеся рынки).
Сроки ориентировочно: от 5 рабочих дней (базовое воспроизведение) до 8 недель (комплексная камера со стримингом и DRM). Стоимость рассчитывается индивидуально после анализа ваших требований — свяжитесь с нами для консультации.
Фраза услуги: «Работа с медиа в мобильных приложениях» — это наш профиль. Каждый проект начинается с аудита текущей реализации, выявления узких мест и предложения оптимального стека.
Коммерческие сигналы: закажите аудит вашей медиа-функциональности, получите консультацию инженера без обязательств.
