รูปภาพ

ExoPlayer รองรับรูปแบบรูปภาพต่อไปนี้ ดูไลบรารีการโหลดรูปภาพเพื่อดูวิธีผสานรวมกับไลบรารีภายนอกที่อาจรองรับรูปแบบชุดอื่นๆ

รูปแบบรูปภาพ รองรับ หมายเหตุ
BMP ใช่
GIF ไม่ ไม่รองรับ Extractor
JPEG ใช่
รูปภาพเคลื่อนไหว JPEG ใช่ รองรับภาพนิ่งและวิดีโอ
JPEG Ultra HDR ใช่ เปลี่ยนกลับไปใช้ SDR ก่อน Android 14 หรือบนจอแสดงผลที่ไม่ใช่ HDR
PNG ใช่
WebP ใช่
HEIF/HEIC ใช่
รูปภาพเคลื่อนไหว HEIC ใช่
AVIF (พื้นฐาน) ใช่ ถอดรหัสใน Android 14 ขึ้นไปเท่านั้น

เล่นรูปภาพในเพลย์ลิสต์

หากต้องการเล่นรูปภาพเป็นส่วนหนึ่งของเพลย์ลิสต์ ให้สร้าง MediaItem ด้วย URI ของรูปภาพและส่งไปยังเพลเยอร์ 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 และส่งไปยังโปรแกรมเล่นโดยตรงแทน 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();

ปรับแต่งการเล่น

ExoPlayer มีวิธีมากมายในการปรับแต่งประสบการณ์การเล่นให้เหมาะกับความต้องการของแอป ดูตัวอย่างได้ที่หน้าการปรับแต่ง

ผสานรวมไลบรารีการโหลดรูปภาพภายนอก

รูปภาพมักจะได้รับการจัดการโดยไลบรารีการโหลดรูปภาพภายนอก เช่น Glide หรือ Coil

การผสานรวมไลบรารีเหล่านี้เข้ากับไปป์ไลน์การเล่นมี 3 ขั้นตอนดังนี้

  1. กำหนด MediaItem ที่มีประเภท MIME เป็น APPLICATION_EXTERNALLY_LOADED_IMAGE
  2. ระบุโปรแกรมถอดรหัสรูปภาพเพื่อดึงข้อมูล Bitmap จากไลบรารีการโหลดรูปภาพ
  3. ระบุตัวโหลดภายนอกเพื่อทริกเกอร์การแคชและการโหลดล่วงหน้า

กำหนดค่ารายการสื่อสำหรับการโหลดจากภายนอก

MediaItem ที่เพิ่มลงใน Player ต้องกำหนดประเภท MIME APPLICATION_EXTERNALLY_LOADED_IMAGE อย่างชัดเจนเพื่อใช้เส้นทางโค้ดของไลบรารีการโหลดรูปภาพ ดังนี้

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 เพื่อดึงข้อมูล Bitmap จาก Uri คุณสามารถระบุตัวถอดรหัสนี้ได้โดยการลบล้าง DefaultRenderersFactory.getImageDecoderFactory

ตัวอย่างต่อไปนี้ใช้ Glide เพื่อโหลดรูปภาพ โดยจำกัดเอาต์พุตให้เป็นขนาดที่แสดงเพื่อหลีกเลี่ยงการสร้างออบเจ็กต์ Bitmap ขนาดใหญ่มาก

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

โหลดรูปภาพล่วงหน้าโดยใช้ไลบรารีภายนอก

ในระหว่างการเล่น เพลเยอร์จะขอโหลดรูปภาพถัดไปล่วงหน้าเมื่อรายการก่อนหน้าในเพลย์ลิสต์โหลดเสร็จสมบูรณ์แล้ว เมื่อใช้ไลบรารีการโหลดรูปภาพภายนอก คุณต้องระบุ 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)
  )
}
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();