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:
- Xác định
MediaItemcó loại MIMEAPPLICATION_EXTERNALLY_LOADED_IMAGE. - Cung cấp bộ giải mã hình ảnh để truy xuất
Bitmaptừ thư viện tải hình ảnh. - 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();