Настройка

В основе библиотеки ExoPlayer лежит интерфейс Player . Player предоставляет традиционные функциональные возможности медиаплеера высокого уровня, такие как возможность буферизации мультимедиа, воспроизведения, паузы и поиска. Реализация ExoPlayer по умолчанию предназначена для того, чтобы делать мало предположений (и, следовательно, накладывать мало ограничений) о типе воспроизводимого мультимедиа, о том, как и где он хранится и как он отображается. Вместо того, чтобы напрямую реализовывать загрузку и рендеринг мультимедиа, реализации ExoPlayer делегируют эту работу компонентам, которые вводятся при создании проигрывателя или при передаче проигрывателю новых источников мультимедиа. Компоненты, общие для всех реализаций ExoPlayer :

  • Экземпляры MediaSource , которые определяют воспроизводимый носитель, загружают носитель и из которого загруженный носитель можно читать. Экземпляр MediaSource создается из MediaItem с помощью MediaSource.Factory внутри проигрывателя. Их также можно передать непосредственно проигрывателю с помощью API плейлиста на основе медиа-источника .
  • Экземпляры MediaSource.Factory , преобразующие MediaItem в MediaSource . MediaSource.Factory внедряется при создании проигрывателя.
  • Экземпляры средства Renderer , которые визуализируют отдельные компоненты мультимедиа. Они вводятся при создании игрока.
  • TrackSelector , который выбирает дорожки, предоставленные MediaSource для использования каждым доступным Renderer . TrackSelector добавляется при создании проигрывателя.
  • LoadControl , который контролирует, когда MediaSource буферизует больше мультимедиа и сколько мультимедиа буферизуется. LoadControl вводится при создании проигрывателя.
  • LivePlaybackSpeedControl , который управляет скоростью воспроизведения во время воспроизведения в реальном времени, позволяя проигрывателю оставаться близким к настроенному смещению в реальном времени. LivePlaybackSpeedControl внедряется при создании проигрывателя.

Концепция внедрения компонентов, реализующих части функциональности проигрывателя, присутствует во всей библиотеке. Реализации некоторых компонентов по умолчанию делегируют работу дальнейшим внедренным компонентам. Это позволяет индивидуально заменять многие подкомпоненты реализациями, настроенными индивидуально.

Настройка игрока

Ниже описаны некоторые распространенные примеры настройки плеера путем внедрения компонентов.

Настройка сетевого стека

У нас есть страница о настройке сетевого стека, используемого ExoPlayer .

Кэширование данных, загружаемых из сети

См. руководства по временному кэшированию и загрузке мультимедиа в реальном времени.

Настройка взаимодействия с сервером

Некоторым приложениям может потребоваться перехватывать HTTP-запросы и ответы. Возможно, вы захотите внедрить собственные заголовки запросов, прочитать заголовки ответов сервера, изменить URI запросов и т. д. Например, ваше приложение может аутентифицировать себя, внедряя токен в качестве заголовка при запросе медиасегментов.

В следующем примере показано, как реализовать это поведение путем внедрения пользовательского DataSource.Factory в DefaultMediaSourceFactory :

Котлин 

val dataSourceFactory =
  DataSource.Factory {
    val dataSource = httpDataSourceFactory.createDataSource()
    // Set a custom authentication request header.
    dataSource.setRequestProperty("Header", "Value")
    dataSource
  }
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory)
    )
    .build()

Ява

DataSource.Factory dataSourceFactory =
    () -> {
      HttpDataSource dataSource = httpDataSourceFactory.createDataSource();
      // Set a custom authentication request header.
      dataSource.setRequestProperty("Header", "Value");
      return dataSource;
    };

ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory))
        .build();

В приведенном выше фрагменте кода внедренный HttpDataSource включает заголовок "Header: Value" в каждый HTTP-запрос. Это поведение фиксируется для каждого взаимодействия с источником HTTP.

Для более детального подхода вы можете внедрить поведение «точно в срок», используя ResolvingDataSource . В следующем фрагменте кода показано, как внедрить заголовки запроса непосредственно перед взаимодействием с источником HTTP:

Котлин 

val dataSourceFactory: DataSource.Factory =
  ResolvingDataSource.Factory(httpDataSourceFactory) { dataSpec: DataSpec ->
    // Provide just-in-time request headers.
    dataSpec.withRequestHeaders(getCustomHeaders(dataSpec.uri))
  }

Ява

    DataSource.Factory dataSourceFactory =
        new ResolvingDataSource.Factory(
            httpDataSourceFactory,
            // Provide just-in-time request headers.
            dataSpec -> dataSpec.withRequestHeaders(getCustomHeaders(dataSpec.uri)));

Вы также можете использовать ResolvingDataSource для своевременного изменения URI, как показано в следующем фрагменте:

Котлин 

val dataSourceFactory: DataSource.Factory =
  ResolvingDataSource.Factory(httpDataSourceFactory) { dataSpec: DataSpec ->
    // Provide just-in-time URI resolution logic.
    dataSpec.withUri(resolveUri(dataSpec.uri))
  }

Ява 

DataSource.Factory dataSourceFactory =
    new ResolvingDataSource.Factory(
        httpDataSourceFactory,
        // Provide just-in-time URI resolution logic.
        dataSpec -> dataSpec.withUri(resolveUri(dataSpec.uri)));

Настройка обработки ошибок

Реализация пользовательской LoadErrorHandlingPolicy позволяет приложениям настраивать способ реакции ExoPlayer на ошибки загрузки. Например, приложению может потребоваться быстрый сбой вместо многократных повторных попыток, или может потребоваться настроить логику отсрочки, которая контролирует, как долго игрок ждет между каждой повторной попыткой. В следующем фрагменте показано, как реализовать пользовательскую логику отсрочки:

Котлин 

val loadErrorHandlingPolicy: LoadErrorHandlingPolicy =
  object : DefaultLoadErrorHandlingPolicy() {
    override fun getRetryDelayMsFor(loadErrorInfo: LoadErrorInfo): Long {
      // Implement custom back-off logic here.
      return 0
    }
  }
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setLoadErrorHandlingPolicy(loadErrorHandlingPolicy)
    )
    .build()

Ява

LoadErrorHandlingPolicy loadErrorHandlingPolicy =
    new DefaultLoadErrorHandlingPolicy() {
      @Override
      public long getRetryDelayMsFor(LoadErrorInfo loadErrorInfo) {
        // Implement custom back-off logic here.
        return 0;
      }
    };

ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context)
                .setLoadErrorHandlingPolicy(loadErrorHandlingPolicy))
        .build();

Аргумент LoadErrorInfo содержит дополнительную информацию о неудачной загрузке для настройки логики в зависимости от типа ошибки или неудачного запроса.

Настройка флагов экстрактора

Флаги экстрактора можно использовать для настройки извлечения отдельных форматов из прогрессивных носителей. Их можно установить в DefaultExtractorsFactory , предоставленном DefaultMediaSourceFactory . В следующем примере передается флаг, который включает поиск потоков MP3 по индексу.

Котлин 

val extractorsFactory =
  DefaultExtractorsFactory().setMp3ExtractorFlags(Mp3Extractor.FLAG_ENABLE_INDEX_SEEKING)
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(DefaultMediaSourceFactory(context, extractorsFactory))
    .build()

Ява 

DefaultExtractorsFactory extractorsFactory =
    new DefaultExtractorsFactory().setMp3ExtractorFlags(Mp3Extractor.FLAG_ENABLE_INDEX_SEEKING);

ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(new DefaultMediaSourceFactory(context, extractorsFactory))
        .build();

Включение поиска постоянного битрейта

Для потоков MP3, ADTS и AMR вы можете включить приблизительный поиск, используя предположение о постоянном битрейте с флагами FLAG_ENABLE_CONSTANT_BITRATE_SEEKING . Эти флаги можно установить для отдельных экстракторов с помощью отдельных методов DefaultExtractorsFactory.setXyzExtractorFlags , как описано выше. Чтобы включить поиск постоянного битрейта для всех экстракторов, которые его поддерживают, используйте DefaultExtractorsFactory.setConstantBitrateSeekingEnabled .

Котлин 

val extractorsFactory = DefaultExtractorsFactory().setConstantBitrateSeekingEnabled(true)

Ява

DefaultExtractorsFactory extractorsFactory =
    new DefaultExtractorsFactory().setConstantBitrateSeekingEnabled(true);

Затем ExtractorsFactory можно внедрить через DefaultMediaSourceFactory , как описано выше для настройки флагов экстрактора.

Включение асинхронной буферной очереди

Асинхронная организация очереди в буфере — это усовершенствование конвейера рендеринга ExoPlayer, который управляет экземплярами MediaCodec в асинхронном режиме и использует дополнительные потоки для планирования декодирования и рендеринга данных. Включение этого параметра может уменьшить пропущенные кадры и задержки звука.

Асинхронная буферная очередь включена по умолчанию на устройствах под управлением Android 12 (уровень API 31) и более поздних версий и может быть включена вручную, начиная с Android 6.0 (уровень API 23). Рассмотрите возможность включения этой функции для определенных устройств, на которых вы наблюдаете пропадание кадров или прерывание звука, особенно при воспроизведении контента с защитой DRM или контента с высокой частотой кадров.

В простейшем случае вам необходимо внедрить плееру DefaultRenderersFactory следующим образом:

Котлин 

val renderersFactory = 
  DefaultRenderersFactory(context).forceEnableMediaCodecAsynchronousQueueing()
val exoPlayer = ExoPlayer.Builder(context, renderersFactory).build()

Ява

DefaultRenderersFactory renderersFactory =
    new DefaultRenderersFactory(context).forceEnableMediaCodecAsynchronousQueueing();
ExoPlayer exoPlayer = new ExoPlayer.Builder(context, renderersFactory).build();

Если вы создаете экземпляры средств визуализации напрямую, передайте AsynchronousMediaCodecAdapter.Factory конструкторам MediaCodecVideoRenderer и MediaCodecAudioRenderer .

Перехват вызовов методов с помощью ForwardingPlayer

Вы можете настроить некоторые параметры поведения экземпляра Player , обернув его в подкласс ForwardingPlayer и переопределив методы, чтобы выполнять любое из следующих действий:

  • Получите доступ к параметрам перед их передачей делегату Player .
  • Получите доступ к возвращаемому значению делегата Player перед его возвратом.
  • Полностью переопределите метод.

При переопределении методов ForwardingPlayer важно гарантировать, что реализация остается самосогласованной и совместимой с интерфейсом Player , особенно при работе с методами, которые должны иметь идентичное или связанное поведение. Например:

  • Если вы хотите переопределить каждую операцию «воспроизведения», вам необходимо переопределить как ForwardingPlayer.play , так и ForwardingPlayer.setPlayWhenReady , поскольку вызывающий объект будет ожидать, что поведение этих методов будет идентичным, когда playWhenReady = true .
  • Если вы хотите изменить приращение поиска вперед, вам необходимо переопределить как ForwardingPlayer.seekForward для выполнения поиска с вашим настраиваемым приращением, так и ForwardingPlayer.getSeekForwardIncrement , чтобы сообщить правильное настраиваемое приращение обратно вызывающему объекту.
  • Если вы хотите контролировать, какие Player.Commands объявляются экземпляром проигрывателя, вы должны переопределить как Player.getAvailableCommands() , так и Player.isCommandAvailable() , а также прослушивать обратный вызов Player.Listener.onAvailableCommandsChanged() , чтобы получать уведомления об изменениях. исходящий от основного игрока.

Настройка медиаисточника

В приведенных выше примерах внедряются настроенные компоненты для использования во время воспроизведения всех объектов MediaItem , передаваемых проигрывателю. Там, где требуется детальная настройка, также можно внедрить настроенные компоненты в отдельные экземпляры MediaSource , которые можно передать непосредственно проигрывателю. В приведенном ниже примере показано, как настроить ProgressiveMediaSource для использования пользовательских DataSource.Factory , ExtractorsFactory и LoadErrorHandlingPolicy :

Котлин 

val mediaSource =
  ProgressiveMediaSource.Factory(customDataSourceFactory, customExtractorsFactory)
    .setLoadErrorHandlingPolicy(customLoadErrorHandlingPolicy)
    .createMediaSource(MediaItem.fromUri(streamUri))

Ява 

ProgressiveMediaSource mediaSource =
    new ProgressiveMediaSource.Factory(customDataSourceFactory, customExtractorsFactory)
        .setLoadErrorHandlingPolicy(customLoadErrorHandlingPolicy)
        .createMediaSource(MediaItem.fromUri(streamUri));

Создание пользовательских компонентов

Библиотека предоставляет реализации по умолчанию компонентов, перечисленных в верхней части этой страницы, для распространенных случаев использования. ExoPlayer может использовать эти компоненты, но также может быть создан для использования пользовательских реализаций, если требуется нестандартное поведение. Вот некоторые варианты использования пользовательских реализаций:

  • Renderer . Возможно, вы захотите реализовать собственный Renderer для обработки типа мультимедиа, не поддерживаемого реализациями по умолчанию, предоставляемыми библиотекой.
  • TrackSelector — реализация пользовательского TrackSelector позволяет разработчику приложения изменить способ выбора треков, предоставляемых MediaSource , для использования каждым из доступных Renderer .
  • LoadControl — реализация пользовательского LoadControl позволяет разработчику приложения изменять политику буферизации проигрывателя.
  • Extractor . Если вам необходимо поддерживать формат контейнера, который в настоящее время не поддерживается библиотекой, рассмотрите возможность реализации собственного класса Extractor .
  • MediaSource . Реализация пользовательского класса MediaSource может быть подходящей, если вы хотите получать образцы мультимедиа для передачи в средства рендеринга собственным способом или если вы хотите реализовать собственное поведение композиции MediaSource .
  • MediaSource.Factory — реализация пользовательского MediaSource.Factory позволяет приложению настраивать способ создания MediaSource из MediaItem .
  • DataSource — исходный пакет ExoPlayer уже содержит ряд реализаций DataSource для различных вариантов использования. Возможно, вы захотите реализовать собственный класс DataSource для загрузки данных другим способом, например, по специальному протоколу, с использованием специального стека HTTP или из пользовательского постоянного кэша.

При создании пользовательских компонентов мы рекомендуем следующее:

  • Если пользовательскому компоненту необходимо сообщать о событиях обратно в приложение, мы рекомендуем вам делать это, используя ту же модель, что и существующие компоненты ExoPlayer, например, используя классы EventDispatcher или передавая Handler вместе с прослушивателем конструктору компонента.
  • Мы рекомендовали, чтобы пользовательские компоненты использовали ту же модель, что и существующие компоненты ExoPlayer, чтобы приложение могло изменять конфигурацию во время воспроизведения. Для этого пользовательские компоненты должны реализовать PlayerMessage.Target и получать изменения конфигурации в методе handleMessage . Код приложения должен передавать изменения конфигурации, вызывая метод createMessage ExoPlayer, настраивая сообщение и отправляя его компоненту с помощью PlayerMessage.send . Отправка сообщений для доставки в поток воспроизведения гарантирует, что они выполняются в том же порядке, что и любые другие операции, выполняемые на проигрывателе.