इमेज

ExoPlayer में ये इमेज फ़ॉर्मैट काम करते हैं. इमेज लोड करने वाली लाइब्रेरी देखें. इससे आपको पता चलेगा कि बाहरी लाइब्रेरी के साथ कैसे इंटिग्रेट किया जा सकता है. ये लाइब्रेरी, फ़ॉर्मैट के अलग-अलग सेट के लिए सहायता उपलब्ध करा सकती हैं.

इमेज फ़ॉर्मैट समर्थित नोट
BMP हां
GIF नहीं एक्सट्रैक्टर की सुविधा उपलब्ध नहीं है
JPEG हां
JPEG मोशन फ़ोटो हां स्टिल इमेज और वीडियो का इस्तेमाल किया जा सकता है
JPEG अल्ट्रा एचडीआर हां Android 14 से पहले के वर्शन या बिना एचडीआर वाले डिसप्ले पर, एसडीआर पर वापस स्विच हो जाता है
PNG हां
WebP हां
HEIF/HEIC हां
HEIC मोशन फ़ोटो हां
AVIF (बेसलाइन) हां सिर्फ़ Android 14 और इसके बाद के वर्शन पर डिकोड किया गया

प्लेलिस्ट में मौजूद इमेज चलाना

किसी इमेज को प्लेलिस्ट के हिस्से के तौर पर चलाने के लिए, इमेज के यूआरआई के साथ 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 बनाएं और उसे 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.

इन लाइब्रेरी को प्लेबैक पाइपलाइन में इंटिग्रेट करने के लिए, ये तीन चरण पूरे करने होंगे:

  1. APPLICATION_EXTERNALLY_LOADED_IMAGE एमआईएमई टाइप के साथ MediaItem तय करें.
  2. इमेज लोड करने वाली लाइब्रेरी से Bitmap को वापस पाने के लिए, इमेज डिकोडर उपलब्ध कराएं.
  3. कैश मेमोरी में सेव करने और पहले से लोड करने की प्रोसेस को ट्रिगर करने के लिए, बाहरी लोडर उपलब्ध कराएं.

बाहरी सोर्स से लोड करने के लिए, मीडिया आइटम कॉन्फ़िगर करना

Player में जोड़े गए MediaItem को साफ़ तौर पर 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();

किसी बाहरी लाइब्रेरी का इस्तेमाल करके इमेज डिकोड करना

इमेज रेंडरर को Uri से Bitmap को वापस पाने के लिए, ExternallyLoadedImageDecoder की ज़रूरत होती है. इस डिकोडर को 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();