ExoPlayer, इन इमेज फ़ॉर्मैट के साथ काम करता है. बाहरी लाइब्रेरी के साथ इंटिग्रेट करने का तरीका जानने के लिए, इमेज लोड करने वाली लाइब्रेरी देखें. ये लाइब्रेरी, फ़ॉर्मैट के अलग-अलग सेट के लिए सहायता दे सकती हैं.
इमेज फ़ॉर्मैट | इनकी अनुमति है | नोट |
---|---|---|
BMP | हां | |
GIF | नहीं | एक्सट्रैक्टर की सुविधा उपलब्ध नहीं है |
JPEG | हां | |
JPEG मोशन फ़ोटो | हां | स्टिल इमेज और वीडियो का इस्तेमाल किया जा सकता है |
JPEG अल्ट्रा एचडीआर | हां | Android 14 से पहले या बिना एचडीआर वाले डिसप्ले पर, एसडीआर पर वापस आ जाता है |
PNG | हां | |
WebP | हां | |
HEIF/HEIC | हां | |
HEIC फ़ॉर्मैट में मोशन फ़ोटो | कुछ हद तक | सिर्फ़ स्टिल इमेज का इस्तेमाल किया जा सकता है* |
AVIF (बेसलाइन) | हां | सिर्फ़ Android 14 और इसके बाद के वर्शन पर डिकोड किया जाता है |
* MetadataRetriever की मदद से, HEIC फ़ॉर्मैट में ली गई मोशन फ़ोटो का वीडियो हिस्सा पाया जा सकता है और उसे स्टैंडअलोन फ़ाइल के तौर पर चलाया जा सकता है.
MediaItem का इस्तेमाल करना
किसी इमेज को प्लेलिस्ट के हिस्से के तौर पर चलाने के लिए, इमेज के यूआरआई के साथ 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 का इस्तेमाल करना
पसंद के मुताबिक बनाने के ज़्यादा विकल्पों के लिए, 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.
इन लाइब्रेरी को वीडियो चलाने की प्रोसेस में इंटिग्रेट करने के लिए, तीन चरणों को पूरा करना होगा:
APPLICATION_EXTERNALLY_LOADED_IMAGE
MIME टाइप के साथMediaItem
तय करें.- इमेज लोड करने वाली लाइब्रेरी से
Bitmap
को वापस पाने के लिए, इमेज डिकोडर दें. - कैश मेमोरी में सेव करने और प्रीलोड करने की सुविधा को ट्रिगर करने के लिए, कोई बाहरी लोडर उपलब्ध कराएं.
बाहर से लोड की गई इमेज के MIME टाइप वाला MediaItem
Player
में जोड़े गए MediaItem
में, इमेज लोड करने वाली लाइब्रेरी के कोड पाथ का इस्तेमाल करने के लिए, APPLICATION_EXTERNALLY_LOADED_IMAGE
MIME टाइप साफ़ तौर पर तय करना ज़रूरी है:
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 का इस्तेमाल किया गया है:
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));