Изображения

ExoPlayer поддерживает следующие форматы изображений. См. «Библиотеки загрузки изображений», чтобы узнать, как интегрироваться с внешними библиотеками, которые могут обеспечивать поддержку другого набора форматов.

Формат изображения Поддерживается Примечания
БМП ДА
гифка НЕТ Нет поддержки Экстрактора
JPEG ДА
Движущееся фото в формате JPEG ДА Поддерживаются неподвижные изображения и видео
JPEG Ультра HDR ДА Возвращается к SDR до версии Android 14 или на дисплеях без HDR.
PNG ДА
ВебП ДА
HEIF/HEIC ДА
HEIC Движущееся фото Частично Поддерживаются только неподвижные изображения*
AVIF (базовый уровень) ДА Декодировано только на Android 14+.

* Видеочасть движущихся фотографий HEIC можно получить с помощью MetadataRetriever и воспроизвести как отдельный файл.

Использование Медиаитем

Чтобы воспроизвести изображение как часть списка воспроизведения, создайте MediaItem с URI изображения и передайте его проигрывателю. MediaItem должен иметь imageDurationMs , чтобы указать, как долго должно отображаться изображение.

Котлин 

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played with the desired duration.
player.setMediaItem(
    MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build())
// Prepare the player.
player.prepare()

Ява 

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played with the desired duration.
player.setMediaItem(
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build());
// Prepare the player.
player.prepare();

Фотографии движения

Движущиеся фотографии — это файлы, сочетающие неподвижное изображение с коротким видео.

  • Если продолжительность изображения определена с помощью setImageDuration , движущаяся фотография отображается в течение заявленной продолжительности как неподвижное изображение.
  • Если продолжительность изображения не определена, движущееся фото воспроизводится как видео.

Использование ProgressiveMediaSource

Для получения дополнительных возможностей настройки вы можете создать ProgressiveMediaSource и передать его непосредственно проигрывателю вместо MediaItem .

Котлин 

// Create a data source factory.
val dataSourceFactory = DefaultHttpDataSource.Factory()
// Create a media item with the image URI and the desired duration.
val mediaItem =
    MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build()
// Create a progressive media source for this media item.
val mediaSource =
    ProgressiveMediaSource.Factory(dataSourceFactory)
        .createMediaSource(mediaItem)
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Ява 

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a media item with the image URI and the desired duration.
MediaItem mediaItem =
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build();
// Create a progressive media source for this media item.
MediaSource mediaSource =
    new ProgressiveMediaSource.Factory(dataSourceFactory)
        .createMediaSource(mediaItem);
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

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

ExoPlayer предоставляет вам несколько способов адаптировать воспроизведение к потребностям вашего приложения. Примеры см. на странице «Настройки» .

Библиотеки загрузки изображений

Изображения часто управляются внешними библиотеками загрузки изображений, например Glide или Coil .

Интеграция этих библиотек в конвейер воспроизведения требует 3 шагов:

  1. Определите MediaItem с MIME-типом APPLICATION_EXTERNALLY_LOADED_IMAGE .
  2. Предоставьте декодер изображений для получения Bitmap из библиотеки загрузки изображений.
  3. Предоставьте внешний загрузчик для запуска кэширования и предварительной загрузки.

MediaItem с MIME-типом загружаемого извне изображения

MediaItem , добавленный в Player должен явно определить MIME-тип APPLICATION_EXTERNALLY_LOADED_IMAGE , чтобы использовать пути кода библиотеки загрузки изображений:

Котлин 

val mediaItem =
  MediaItem.Builder()
    .setUri(imageUri)
    .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
    .build()

Ява 

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(imageUri)
        .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
        .build();

Декодер изображений с использованием библиотеки загрузки изображений

Средство рендеринга изображений нуждается в ExternallyLoadedImageDecoder для получения Bitmap из Uri . Этот декодер можно предоставить, переопределив DefaultRenderersFactory.getImageDecoderFactory .

В следующем примере Glide используется для загрузки изображения:

Котлин 

val glideImageDecoderFactory: ImageDecoder.Factory =
  ExternallyLoadedImageDecoder.Factory { request: ExternalImageRequest ->
    GlideFutures.submit(Glide.with(context).asBitmap().load(request.uri))
  }
val player: Player =
  ExoPlayer.Builder(context)
    .setRenderersFactory(
      object : DefaultRenderersFactory(context) {
        override fun getImageDecoderFactory(): ImageDecoder.Factory {
          return glideImageDecoderFactory
        }
      }
    )
    .build()

Ява 

ImageDecoder.Factory glideImageDecoderFactory =
    new ExternallyLoadedImageDecoder.Factory(
        request -> GlideFutures.submit(
            Glide.with(context).asBitmap().load(request.uri)));
Player player =
    new ExoPlayer.Builder(context)
        .setRenderersFactory(
            new DefaultRenderersFactory(context) {
              @Override
              protected ImageDecoder.Factory getImageDecoderFactory() {
                return glideImageDecoderFactory;
              }
            })
        .build();

Предварительная загрузка изображений с помощью библиотеки загрузки изображений

Во время воспроизведения проигрыватель запрашивает предварительную загрузку следующего изображения после полной загрузки предыдущего элемента в списке воспроизведения. При использовании внешней библиотеки загрузки изображений необходимо указать ExternalLoader для запуска этой предварительной загрузки. Если предварительная загрузка невозможна или не требуется, этот загрузчик все равно необходимо предоставить, но он ничего не может сделать.

В следующем примере Glide используется для обеспечения предварительной загрузки запрошенного изображения на диск:

Котлин 

val glidePreloader = ExternalLoader { request: LoadRequest ->
  GlideFutures.submit(
    Glide.with(context)
      .asFile()
      .apply(
        RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.DATA)
          .priority(Priority.HIGH)
          .skipMemoryCache(true)
      )
      .load(request.uri)
  )
}

Ява 

ExternalLoader glidePreloader =
    request ->
        GlideFutures.submit(
            Glide.with(context)
                .asFile()
                .apply(
                    diskCacheStrategyOf(DiskCacheStrategy.DATA)
                        .priority(Priority.HIGH)
                        .skipMemoryCache(true))
                .load(request.uri));