תמונות

ExoPlayer תומך בפורמטים הבאים של תמונות. במאמר ספריות טעינה של תמונות מוסבר איך לשלב ספריות חיצוניות שעשויות לספק תמיכה בקבוצה אחרת של פורמטים.

פורמט תמונה	נתמך	הערות
BMP	כן
GIF	לא	אין תמיכה ב-Extractor
JPEG	כן
JPEG Motion Photo	כן	תמונות וסרטונים נתמכים
JPEG Ultra HDR	כן	חזרה ל-SDR לפני Android 14 או במסכים ללא HDR
PNG	כן
WebP	כן
HEIF/HEIC	כן
תמונה עם תנועה בפורמט HEIC	באופן חלקי	יש תמיכה רק בתמונות סטילס*
AVIF (baseline)	כן	פענוח ב-Android מגרסה 14 ואילך בלבד

* אפשר לקבל את החלק של הסרטון בתמונות הווידאו בפורמט HEIC באמצעות MetadataRetriever ולהפעיל אותו כקובץ עצמאי.

שימוש ב-MediaItem

כדי להפעיל תמונה כחלק מפלייליסט, יוצרים 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

כדי לקבל אפשרויות נוספות להתאמה אישית, אפשר ליצור 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. מגדירים MediaItem עם סוג MIME APPLICATION_EXTERNALLY_LOADED_IMAGE.
2. מספקים מפענח תמונות כדי לאחזר Bitmap מספריית טעינת התמונות.
3. מספקים מעבד טעינה חיצוני כדי להפעיל אחסון במטמון וטעינה מראש.

MediaItem עם סוג MIME של תמונה שנטענה באופן חיצוני

כדי להשתמש בנתיבים של קוד ספריית הטעינה של התמונות, ה-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 כדי לטעון תמונה:

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