ExoPlayer: что это такое, возможности и настройка

Что такое ExoPlayer?

ExoPlayer — это библиотека для воспроизведения мультимедиа под Android с открытым исходным кодом (Apache 2.0), первая версия которой была выпущена Google в 2014 году. В отличие от встроенного MediaPlayer, который является тонкой обёрткой над системным медиа-кодеком (MediaCodec), ExoPlayer реализован полностью на уровне Java/Kotlin, что даёт разработчикам полный контроль над каждым этапом воспроизведения.

Архитектурно ExoPlayer построен на модульном принципе: каждый аспект воспроизведения реализован отдельным компонентом. Основной модуль (exoplayer-core) содержит плеер, рендереры, трек-селекторы и управление буфером. Дополнительные модули (exoplayer-dash, exoplayer-hls, exoplayer-rtsp, exoplayer-smoothstreaming) добавляют поддержку соответствующих протоколов стриминга. Такая архитектура позволяет приложениям подключать только необходимые компоненты, минимизируя размер APK.

ExoPlayer 2 (текущая мажорная версия) была выпущена в 2018 году и принесла кардинальную переработку API: введение Player Interface, поддержку Compose через AndroidX Media3, улучшенную обработку ошибок и адаптивные алгоритмы выбора треков. Начиная с версии 2.19 (2024), ExoPlayer стал частью библиотеки AndroidX Media, что упростило интеграцию и обновление через стандартный Android-менеджер зависимостей.

Архитектура ExoPlayer

В основе ExoPlayer лежит компонент ExoPlayerImpl, который управляет жизненным циклом воспроизведения. Он содержит MediaSource (источник медиа), TrackSelector (выбор дорожек), LoadControl (управление буферизацией) и список Renderer (рендереры для видео, аудио, субтитров и метаданных). Каждый компонент может быть заменён собственной реализацией через Builder или фабричные методы.

Для рендеринга видео ExoPlayer использует SurfaceView, TextureView или SphericalSurfaceView (для 360-градусного видео). Рекомендуемым вариантом является SurfaceView, так как он обеспечивает аппаратное ускорение и минимальное энергопотребление. Для Jetpack Compose библиотека AndroidX Media3 предоставляет компонент `AndroidView`, оборачивающий SurfaceView, и экспериментальный `Media3Compose` с нативной Compose-интеграцией.

Возможности ExoPlayer

ExoPlayer предоставляет широкий набор функций, выходящих за рамки обычного медиаплеера. Основные возможности включают поддержку всех популярных протоколов стриминга, гибкую DRM-систему, адаптивное переключение битрейта (ABR) и инструменты аналитики воспроизведения.

Адаптивное переключение битрейта

ABR (Adaptive Bitrate) в ExoPlayer реализован через интерфейс AdaptiveTrackSelection. По умолчанию используется AdaptiveTrackSelectionFactory, который создаёт DefaultAdaptiveTrackSelection — сбалансированный алгоритм, учитывающий пропускную способность сети и размер буфера. Для специфических сценариев можно подключить альтернативные реализации: BOLA (минимизация переключений), RandomAdaptiveTrackSelection (тестирование) или собственную реализацию через интерфейс TrackSelection.

BandwidthMeter — ещё один ключевой компонент, отвечающий за измерение пропускной способности сети. По умолчанию используется DefaultBandwidthMeter, который собирает статистику по всем HTTP-запросам плеера. Разработчик может расширить его для учёта дополнительных факторов: типа сети (Wi-Fi, 4G, 5G), сигнала сотовой вышки или стоимости трафика для пользователя.

DRM и защита контента

ExoPlayer поддерживает Widevine (L1, L3), PlayReady и ClearKey DRM. Получение лицензии настраивается через DrmSessionManager, который взаимодействует с лицензионным сервером. Для видео премиум-класса (4K HDR) требуется аппаратная поддержка Widevine L1, что обеспечивает защиту на уровне чипа и предотвращает захват экрана. Выбор DRM-системы зависит от целевой платформы: Widevine используется на Android и Chromecast, PlayReady — на Xbox и Windows, FairPlay — на iOS и Apple TV. ExoPlayer определяет доступную DRM-систему автоматически на основе MPD-файла и не требует ручной конфигурации для базовых сценариев.

Как интегрировать ExoPlayer в Android-проект

Подключение ExoPlayer к Android-проекту выполняется через Gradle-зависимости. Начиная с версии 2.19, ExoPlayer входит в состав AndroidX Media (androidx.media3), что обеспечивает совместимость с Jetpack Compose и другими компонентами AndroidX. Рассмотрим пошаговую интеграцию на Kotlin.

Подключение зависимостей

Добавьте модули ExoPlayer в файл build.gradle (Module). Минимальный набор включает core, ui и модуль для необходимого протокола стриминга. Для воспроизведения DASH-контента потребуется exoplayer-dash, для HLS — exoplayer-hls.

dependencies {
    implementation "androidx.media3:media3-exoplayer:1.5.0"
    implementation "androidx.media3:media3-ui:1.5.0"
    implementation "androidx.media3:media3-exoplayer-dash:1.5.0"
    implementation "androidx.media3:media3-exoplayer-hls:1.5.0"
}

Базовая интеграция в Activity

Создание и настройка плеера в Activity или Fragment. ExoPlayer использует PlayerView (или StyledPlayerView для кастомизации) для отображения видео и встроенных элементов управления. Минимальная конфигурация включает создание плеера через ExoPlayer.Builder и передачу MediaItem с URI источника.

class PlayerActivity : AppCompatActivity() {

    private var player: ExoPlayer? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_player)

        player = ExoPlayer.Builder(this).build()
        val playerView = findViewById<StyledPlayerView>(R.id.playerView)
        playerView.player = player

        val mediaItem = MediaItem
            .Builder()
            .setUri("https://example.com/video.mp4")
            .build()
        player?.setMediaItem(mediaItem)
        player?.prepare()
    }

    override fun onDestroy() {
        player?.release()
        super.onDestroy()
    }
}

Обработка ошибок и состояний

Для production-приложений необходима обработка возможных ошибок воспроизведения: сетевые сбои, неподдерживаемые форматы, ошибки DRM-лицензирования. ExoPlayer предоставляет интерфейс Player.Listener с методами onPlayerError, onPlaybackStateChanged и onPlayWhenReadyChanged. Рекомендуется показывать пользователю информативные сообщения об ошибках с возможностью повтора.

ExoPlayer против MediaPlayer: сравнение

Выбор между ExoPlayer и встроенным MediaPlayer — распространённый вопрос при разработке Android-приложений. MediaPlayer является частью Android SDK с версии 1.0, в то время как ExoPlayer — библиотека, требующая подключения через Gradle. Рассмотрим их различия по ключевым критериям.

ExoPlayer выигрывает в сценариях, требующих стриминга (DASH, HLS), кастомизации UI, поддержки DRM и независимости от версии Android. MediaPlayer подходит для простых приложений, воспроизводящих локальные медиафайлы, где размер APK критичен и нет требований к адаптивному стримингу. Для современных приложений с контентом из сети ExoPlayer является однозначным выбором.

Исключение — приложения с минимальным SDK ниже API 16 (Android 4.1), которых практически не осталось на рынке. Для всех приложений с targetSdk 33+ и минимальным SDK 21+ ExoPlayer не только предпочтительнее, но и необходим для поддержки современных форматов, таких как AV1 и Dolby Vision через соответствующие расширения.

Продвинутая настройка ExoPlayer

Для production-приложений базовая интеграция ExoPlayer часто требует дополнительной настройки: управление кэшированием, оптимизация буферизации для мобильных сетей, интеграция с аналитикой и кастомизация выбора аудио-дорожек. Рассмотрим продвинутые сценарии использования.

Кэширование контента

CacheDataSourceFactory позволяет кэшировать загруженные сегменты на локальном хранилище, что экономит трафик при повторном просмотре и обеспечивает офлайн-воспроизведение. ExoPlayer использует SimpleCache из библиотеки exoplayer-cas — файловое кэширование с поддержкой LRU-эвакуации и лимитов размера.

val cache = SimpleCache(
    cacheDir,
    LeastRecentlyUsedCacheEvictor(50 * 1024 * 1024),
    AppDatabaseProvider(this)
)

val cacheDataSourceFactory = CacheDataSource
    .Factory()
    .setCache(cache)

val player = ExoPlayer.Builder(this)
    .setMediaSourceFactory(
        DefaultMediaSourceFactory(cacheDataSourceFactory)
    )
    .build()

Обработка переключения сети

В мобильных приложениях критична обработка переключения между Wi-Fi и сотовой сетью. ExoPlayer предоставляет ConnectivityManager для отслеживания состояния сети. При потере соединения рекомендуется не останавливать плеер, а перевести его в состояние PAUSED с сохранением позиции. После восстановления соединения — возобновить воспроизведение с перезагрузкой сегментов.

Интеграция с Jetpack Compose

С выходом AndroidX Media3 библиотека получила экспериментальную поддержку Jetpack Compose. Компонент `AndroidView` оборачивает SurfaceView или PlayerView, обеспечивая совместимость с Compose-иерархией. Для более глубокой интеграции используется библиотека `androidx.media3:media3-ui-compose`, предоставляющая Compose-совместимые элементы управления плеером.

@Composable
fun VideoPlayer(uri: String) {
    val context = LocalContext.current
    val player = remember {
        ExoPlayer.Builder(context).build()
            .also { it.setMediaItem(MediaItem.fromUri(uri)) }
    }

    DisposableEffect(key = null) {
        player.prepare()
        onDispose { player.release() }
    }

    AndroidView(
        factory = { StyledPlayerView(context).also { it.player = player } }
    )
}