圖片

ExoPlayer 支援下列圖片格式。如要瞭解如何整合可能支援不同格式的外部程式庫，請參閱「圖片載入程式庫」。

圖片格式 支援 附註
BMP 是
GIF 否 不支援 Extractor
JPEG 是
JPEG 動態相片 是 支援靜態影像和影片
JPEG Ultra HDR 是 在 Android 14 之前或非 HDR 螢幕上，會改用 SDR
PNG 是
WebP 是
HEIF/HEIC 是
HEIC 動態相片 不盡然 僅支援靜態圖片*
AVIF (基準) 是 僅在 Android 14 以上版本解碼

* 您可以使用 MetadataRetriever 取得 HEIC 動態相片的影片部分，並以獨立檔案播放。

使用 MediaItem

如要播放圖片做為播放清單的一部分，請使用圖片 URI 建立 MediaItem，並將其傳遞給播放器。MediaItem 必須包含 imageDurationMs，才能指定圖片的顯示時間長度。

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

動態相片

動態相片是結合靜態相片和短片的檔案。

  • 如果圖片時間長度是使用 setImageDuration 定義，系統會在宣告的時間長度內，以靜態圖片的形式顯示動態相片。
  • 如果未定義圖片時間長度，系統會以影片形式播放動態相片。

使用 ProgressiveMediaSource

如需更多自訂選項，您可以建立 ProgressiveMediaSource，並直接將其傳遞給播放器，而非 MediaItem。

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

自訂播放功能

ExoPlayer 提供多種方式，讓您依據應用程式需求調整播放體驗。如需範例，請參閱自訂頁面。

圖片載入程式庫

圖片通常由外部圖片載入程式庫管理，例如 Glide 或 Coil。

將這些程式庫整合至播放管道需要 3 個步驟：

  1. 使用 APPLICATION_EXTERNALLY_LOADED_IMAGE MIME 類型定義 MediaItem。
  2. 提供圖片解碼器，從圖片載入程式庫中擷取 Bitmap。
  3. 提供外部載入器，觸發快取和預先載入。

使用外部載入圖片 MIME 類型的 MediaItem

新增至 Player 的 MediaItem 必須明確定義 APPLICATION_EXTERNALLY_LOADED_IMAGE MIME 類型，才能使用圖片載入程式庫程式碼路徑：

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

使用圖片載入程式庫的圖片解碼器

圖片轉譯器需要 ExternallyLoadedImageDecoder，才能從 Uri 擷取 Bitmap。您可以覆寫 DefaultRenderersFactory.getImageDecoderFactory 來提供此解碼器。

以下範例使用 Glide 載入圖片：

Kotlin

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

Java

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，確保系統會將要求的圖片預先載入磁碟：

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)
  )
}

Java

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