Resimler

ExoPlayer aşağıdaki resim biçimlerini destekler. Farklı biçimler için destek sağlayabilecek harici kitaplıklarla nasıl entegrasyon yapılacağını öğrenmek için Resim Yükleme Kitaplıkları bölümüne bakın.

Resim biçimi Destekleniyor Notlar
BMP EVET
GIF HAYIR Extractor desteği yok
JPEG EVET
JPEG Hareketli Fotoğraf EVET Hareketsiz resim ve video desteklenir
JPEG Ultra HDR EVET Android 14'ten önceki sürümlerde veya HDR olmayan ekranlarda SDR'ye geri döner.
PNG EVET
WebP EVET
HEIF/HEIC EVET
HEIC Hareketli Fotoğraf EVET
AVIF (temel) EVET Yalnızca Android 14 ve sonraki sürümlerde kodu çözülür

Oynatma listesindeki resimleri oynatma

Bir resmi oynatma listesinin parçası olarak oynatmak için resim URI'siyle bir MediaItem oluşturun ve oynatıcıya iletin. Resmin ne kadar süreyle gösterileceğini belirtmek için MediaItem öğesinin bir imageDurationMs değeri olmalıdır.

Kotlin

// 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()

Java

// 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();

Hareketli fotoğrafları oynatma

Hareketli fotoğraflar, hareketsiz bir resim ile kısa bir videoyu birleştiren dosyalardır.

  • Resim süresi setImageDuration ile tanımlanırsa hareketli fotoğraf, belirtilen süre boyunca hareketsiz resim olarak gösterilir.
  • Resim süresi tanımlanmamışsa hareketli fotoğraf video olarak oynatılır.

Medya kaynağıyla resim yüklemeyi özelleştirme

Daha fazla özelleştirme seçeneği için ProgressiveMediaSource oluşturabilir ve MediaItem yerine doğrudan oynatıcıya iletebilirsiniz.

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = 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()

Java

// 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();

Oynatmayı özelleştirme

ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre uyarlamanız için birden fazla yöntem sunar. Örnekler için Özelleştirme sayfası'na bakın.

Harici resim yükleme kitaplıklarını entegre etme

Resimler genellikle Glide veya Coil gibi harici resim yükleme kitaplıkları tarafından yönetilir.

Bu kitaplıkları oynatma ardışık düzenine entegre etmek için 3 adım gerekir:

  1. APPLICATION_EXTERNALLY_LOADED_IMAGE MIME türüne sahip bir MediaItem tanımlayın.
  2. Resim yükleme kitaplığından Bitmap almak için bir resim kod çözücü sağlayın.
  3. Önbelleğe alma ve önceden yükleme işlemlerini tetiklemek için harici bir yükleyici sağlayın.

Medya öğelerini harici yükleme için yapılandırma

Player öğesine eklenen MediaItem, resim yükleme kitaplığı kod yollarını kullanmak için APPLICATION_EXTERNALLY_LOADED_IMAGE MIME türünü açıkça tanımlamalıdır:

Kotlin

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

Java

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

Harici bir kitaplık kullanarak resimlerin kodunu çözme

Resim oluşturucunun, Uri üzerinden Bitmap değerini almak için bir ExternallyLoadedImageDecoder değerine ihtiyacı vardır. Bu kod çözücü, DefaultRenderersFactory.getImageDecoderFactory geçersiz kılınarak sağlanabilir.

Aşağıdaki örnekte, bir resmi yüklemek için Glide kullanılmaktadır. Çok büyük Bitmap nesneleri oluşturmamak için çıkış, ekran boyutuyla sınırlandırılmıştır:

Kotlin

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

Java

ImageDecoder.Factory glideImageDecoderFactory =
    new ExternallyLoadedImageDecoder.Factory(request -> {
      Point displaySize = Util.getCurrentDisplayModeSize(context);
      return GlideFutures.submit(
          Glide.with(context)
              .asBitmap()
              .load(request.uri)
              .override(max(displaySize.x, displaySize.y)));
    });
Player player =
    new ExoPlayer.Builder(context)
        .setRenderersFactory(
            new DefaultRenderersFactory(context) {
              @Override
              protected ImageDecoder.Factory getImageDecoderFactory(Context context) {
                return glideImageDecoderFactory;
              }
            })
        .build();

Harici bir kitaplık kullanarak resimleri önceden yükleme

Oynatma sırasında oynatıcı, oynatma listesindeki önceki öğe tamamen yüklendikten sonra bir sonraki resmi önceden yüklemeyi ister. Harici bir resim yükleme kitaplığı kullanırken bu önceden yüklemeyi tetiklemek için bir ExternalLoader belirtmeniz gerekir. Önceden yükleme mümkün değilse veya gerekmiyorsa bu yükleyicinin yine de sağlanması gerekir ancak hiçbir şey yapamaz.

Aşağıdaki örnekte, istenen resmin diske önceden yüklendiğinden emin olmak için Glide kullanılmaktadır:

Kotlin

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

Java

ExternalLoader glidePreloader =
    request ->
        GlideFutures.submit(
            Glide.with(context)
                .asFile()
                .apply(
                    diskCacheStrategyOf(DiskCacheStrategy.DATA)
                        .priority(Priority.HIGH)
                        .skipMemoryCache(true))
                .load(request.uri));
Player player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setExternalImageLoader(glidePreloader))
        .build();