Resimler

ExoPlayer aşağıdaki resim biçimlerini destekler. Farklı bir biçim grubu için destek sağlayabilecek harici kitaplıklarla nasıl entegrasyon yapacağınızı öğrenmek için Resim Yükleme Kitaplıkları başlıklı makaleyi inceleyin.

Resim biçimi Destekleniyor Notlar
BMP EVET
GIF HAYIR Extractor desteği yok
JPEG EVET
JPEG Motion Photo EVET Hareketsiz görüntü 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 Kısmen Yalnızca hareketsiz resim desteklenir*
AVIF (temel) EVET Yalnızca Android 14 ve sonraki sürümlerde çözülür.

* HEIC hareketli fotoğrafların video kısmı MetadataRetriever ile alınabilir ve bağımsız bir dosya olarak oynatılabilir.

MediaItem kullanma

Bir resmi oynatma listesinin parçası olarak oynatmak için resim URI'siyle MediaItem oluşturun ve oynatıcıya iletin. MediaItem, resmin ne kadar süreyle gösterileceğini belirtmek için imageDurationMs içermelidir.

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

Hareketli fotoğraflar, hareketsiz bir görüntü ile kısa bir videoyu birleştiren dosyalardır.

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

ProgressiveMediaSource'u kullanma

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

Kotlin

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

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 yol sunar. Örnekler için Özelleştirme sayfasına bakın.

Resim Yükleme Kitaplıkları

Görüntüler genellikle Glide veya Coil gibi harici görüntü yükleme kitaplıkları tarafından yönetilir.

Bu kitaplıkları oynatma işlem hattına entegre etmek için 3 adım gerekir:

  1. APPLICATION_EXTERNALLY_LOADED_IMAGE MIME türüyle 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üklemeyi tetiklemek için harici bir yükleyici sağlayın.

Harici olarak yüklenen resim MIME türüne sahip MediaItem

Player öğesine eklenen MediaItem, resim yükleme kitaplığı kodu 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();

Resim yükleme kitaplığı kullanan resim kod çözücü

Görüntü oluşturucunun, Uri kaynağından Bitmap öğesini almak için ExternallyLoadedImageDecoder öğesine ihtiyacı vardır. Bu kod çözücü, DefaultRenderersFactory.getImageDecoderFactory geçersiz kılınarak sağlanabilir.

Aşağıdaki örnekte, Glide kullanılarak bir resim yüklenir. Çok büyük Bitmap nesneleri oluşturmamak için çıkış, ekran boyutuyla sınırlandırılı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();

Resim yükleme kitaplığıyla resim ö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 ön 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 herhangi bir işlem yapamaz.

Aşağıdaki örnekte, istenen resmin diske önceden yüklenmesini sağlamak için Glide kullanılı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 =
    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();