Images

ExoPlayer hỗ trợ các định dạng hình ảnh sau. Hãy xem phần Thư viện tải hình ảnh để biết cách tích hợp với các thư viện bên ngoài có thể hỗ trợ một nhóm định dạng khác.

Định dạng hình ảnh Được hỗ trợ Ghi chú
BMP CÓ
GIF KHÔNG Không hỗ trợ Extractor
JPEG CÓ
Ảnh chuyển động JPEG CÓ Hỗ trợ hình ảnh tĩnh và video
JPEG Ultra HDR CÓ Quay lại SDR trước Android 14 hoặc trên màn hình không phải HDR
PNG CÓ
WebP CÓ
HEIF/HEIC CÓ
Ảnh chuyển động HEIC CÓ
AVIF (cơ sở) CÓ Chỉ giải mã được trên Android 14 trở lên

Phát hình ảnh trong danh sách phát

Để phát hình ảnh trong danh sách phát, hãy tạo một MediaItem bằng URI hình ảnh rồi truyền URI đó đến trình phát. MediaItem phải có imageDurationMs để chỉ định thời gian hiển thị hình ảnh.

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

Phát ảnh chuyển động

Ảnh chuyển động là tệp kết hợp giữa ảnh tĩnh và video ngắn.

  • Nếu thời lượng hình ảnh được xác định bằng setImageDuration, thì ảnh chuyển động sẽ được hiển thị trong thời lượng đã khai báo dưới dạng hình ảnh tĩnh.
  • Nếu thời lượng của ảnh không được xác định, thì ảnh chuyển động sẽ phát dưới dạng video.

Tuỳ chỉnh việc tải hình ảnh bằng nguồn nội dung nghe nhìn

Để có thêm các lựa chọn tuỳ chỉnh, bạn có thể tạo ProgressiveMediaSource và truyền trực tiếp đến trình phát thay vì MediaItem.

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

Tuỳ chỉnh chế độ phát

ExoPlayer cung cấp nhiều cách để bạn điều chỉnh trải nghiệm phát cho phù hợp với nhu cầu của ứng dụng. Hãy xem trang Tuỳ chỉnh để biết ví dụ.

Tích hợp thư viện tải hình ảnh bên ngoài

Hình ảnh thường được quản lý bằng các thư viện tải hình ảnh bên ngoài, chẳng hạn như Glide hoặc Coil.

Việc tích hợp các thư viện này vào quy trình phát đòi hỏi 3 bước:

  1. Xác định MediaItem có loại MIME APPLICATION_EXTERNALLY_LOADED_IMAGE.
  2. Cung cấp bộ giải mã hình ảnh để truy xuất Bitmap từ thư viện tải hình ảnh.
  3. Cung cấp trình tải bên ngoài để kích hoạt tính năng lưu vào bộ nhớ đệm và tải trước.

Định cấu hình mục nội dung nghe nhìn để tải từ bên ngoài

MediaItem được thêm vào Player phải xác định rõ ràng loại MIME APPLICATION_EXTERNALLY_LOADED_IMAGE để sử dụng các đường dẫn mã thư viện tải hình ảnh:

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

Giải mã hình ảnh bằng thư viện bên ngoài

Trình kết xuất hình ảnh cần có ExternallyLoadedImageDecoder để truy xuất Bitmap từ Uri. Bạn có thể cung cấp bộ giải mã này bằng cách ghi đè DefaultRenderersFactory.getImageDecoderFactory.

Ví dụ sau đây sử dụng Glide để tải hình ảnh, giới hạn kết quả đầu ra theo kích thước hiển thị để tránh tạo các đối tượng Bitmap rất lớn:

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

Tải trước hình ảnh bằng thư viện bên ngoài

Trong khi phát, trình phát sẽ yêu cầu tải trước hình ảnh tiếp theo sau khi mục trước đó trong danh sách phát đã tải xong. Khi sử dụng thư viện tải hình ảnh bên ngoài, bạn phải chỉ định một ExternalLoader để kích hoạt quá trình tải trước này. Nếu không thể hoặc không cần tải trước, thì trình tải này vẫn cần được cung cấp nhưng không thể làm gì.

Ví dụ sau đây sử dụng Glide để đảm bảo rằng hình ảnh được yêu cầu được tải trước vào ổ đĩa:

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