Реализация офлайн-воспроизведения медиа в мобильном приложении
Скачать сериал в самолёт — базовый пользовательский сценарий. Реализовать его правильно — нетривиально: нужно управление хранилищем, отображение прогресса загрузки, поддержка паузы и возобновления, а если контент защищён — DRM с офлайн-лицензией.
Загрузка: подходы и инструменты
iOS. AVAssetDownloadURLSession — нативный API для загрузки HLS. Сохраняет не отдельные файлы, а структуру HLS-потока в виде AVURLAsset на диск:
let configuration = URLSessionConfiguration.background(withIdentifier: "com.app.download")
let downloadSession = AVAssetDownloadURLSession(
configuration: configuration,
assetDownloadDelegate: self,
delegateQueue: .main
)
let task = downloadSession.makeAssetDownloadTask(
asset: asset,
assetTitle: "Эпизод 1",
assetArtworkData: nil,
options: [AVAssetDownloadTaskMinimumRequiredMediaBitrateKey: 2_000_000]
)
task.resume()
background конфигурация — загрузка продолжается, когда приложение в фоне или закрыто. Прогресс через URLSessionTaskDelegate.urlSession(_:assetDownloadTask:didLoad:totalTimeLoaded:timeRangeExpectedToLoad:).
Android. media3 DownloadManager + DownloadService. Сервис держит загрузки живыми в фоне:
val downloadManager = DownloadManager(
context, databaseProvider, downloadCache, HttpDataSource.Factory(), Executor.Main
)
val downloadRequest = DownloadRequest.Builder(contentId, uri)
.setMimeType(MimeTypes.APPLICATION_M3U8)
.build()
DownloadService.sendAddDownload(context, MyDownloadService::class.java, downloadRequest, false)
Прогресс через DownloadManager.Listener.onDownloadChanged. Для прогрессивных файлов (MP4, MP3) без HLS — стандартный WorkManager + OkHttp с поддержкой Range заголовков для возобновления.
Управление хранилищем
Офлайн-контент накапливается. Пользователь не всегда помнит, что скачал.
Показываем размер каждого скачанного элемента. iOS: AVURLAsset.assetCache?.isPlayableOffline — флаг готовности, размер через FileManager.attributesOfItem(atPath:)[.size]. Android: DownloadHelper.getDownloadedBytes(download).
Ручное удаление и автоматическая очистка старых файлов (дольше N дней не воспроизводились). Квота: предупреждаем, если меньше 500 МБ свободного места (UIDevice.current.freeDiskSpaceInBytes / StatFs).
DRM: офлайн-лицензии
Без DRM раздел упрощается. С DRM — добавляется значительный пласт интеграции.
FairPlay (iOS). Офлайн-воспроизведение требует офлайн-лицензии: AVContentKeyRequest с makeStreamingContentKeyRequestData(forApp:contentIdentifier:options:). Лицензия скачивается от сервера (KSM) и сохраняется в защищённом хранилище. При воспроизведении офлайн — AVContentKeySession использует сохранённую лицензию.
Widevine (Android). ExoPlayer + DefaultDrmSessionManager. Офлайн-лицензия: OfflineLicenseHelper.downloadLicense(drmInitData), сохраняем keySetId. При воспроизведении офлайн — setLicenseUri + keySetId в MediaItem.DrmConfiguration.
Воспроизведение скачанного контента
После загрузки на iOS: AVURLAsset(url: localHlsURL) — путь к сохранённому HLS. asset.assetCache?.isPlayableOffline должен быть true перед созданием AVPlayerItem. Если открыть ассет без проверки этого флага — плеер попытается обратиться к сети.
На Android с media3 DownloadManager: получаем DownloadRequest из базы данных, передаём в ExoPlayer через DownloadHelper.getDownloadedBytesForRequest(). CacheDataSource.Factory автоматически подставляет локальные данные вместо сетевых запросов.
Прогресс загрузки в UI
Несколько скачиваемых файлов одновременно — стандартная ситуация. Каждой загрузке нужен отдельный ProgressBar с процентом. На iOS: URLSession.progress.fractionCompleted через KVO, обновляем @Published в ViewModel. На Android: DownloadManager.Listener вызывается на фоновом потоке — переводим в Main через withContext(Dispatchers.Main).
Сроки
Загрузка без DRM с управлением хранилищем — 3–4 дня. С DRM (FairPlay или Widevine) — плюс 3–4 дня на интеграцию с лицензионным сервером. Полная реализация для iOS + Android — 7–10 дней.