ছবি

এক্সোপ্লেয়ার নিম্নলিখিত চিত্র ফর্ম্যাটগুলিকে সমর্থন করে। বিভিন্ন ফর্ম্যাটের জন্য সমর্থন প্রদান করতে পারে এমন বহিরাগত লাইব্রেরির সাথে কীভাবে সংহত করবেন তার জন্য চিত্র লোডিং লাইব্রেরিগুলি দেখুন।

ছবির বিন্যাস সমর্থিত মন্তব্য
বিএমপি হ্যাঁ
জিআইএফ না কোনও এক্সট্র্যাক্টর সাপোর্ট নেই
জেপিইজি হ্যাঁ
জেপিইজি মোশন ফটো হ্যাঁ স্থির চিত্র এবং ভিডিও সমর্থিত
জেপিইজি আল্ট্রা এইচডিআর হ্যাঁ অ্যান্ড্রয়েড ১৪ এর আগে বা নন-এইচডিআর ডিসপ্লেতে আবার এসডিআর ব্যবহার করা হয়
পিএনজি হ্যাঁ
ওয়েবপি হ্যাঁ
HEIF/HEIC হ্যাঁ
HEIC মোশন ফটো আংশিকভাবে শুধুমাত্র স্থির চিত্র সমর্থিত*
AVIF (বেসলাইন) হ্যাঁ শুধুমাত্র Android 14+ এ ডিকোড করা হয়েছে

* HEIC মোশন ফটোর ভিডিও অংশটি MetadataRetriever দিয়ে পাওয়া যাবে এবং একটি স্বতন্ত্র ফাইল হিসেবে চালানো যাবে।

মিডিয়াআইটিম ব্যবহার করা

প্লেলিস্টের অংশ হিসেবে একটি ছবি চালানোর জন্য, ছবির URI দিয়ে একটি MediaItem তৈরি করুন এবং প্লেয়ারে পাঠান। ছবিটি কতক্ষণ প্রদর্শিত হবে তা নির্দিষ্ট করার জন্য MediaItem এ একটি imageDurationMs থাকতে হবে।

কোটলিন

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

জাভা

// 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 এর পরিবর্তে এটি সরাসরি প্লেয়ারে পাঠাতে পারেন।

কোটলিন

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

জাভা

// 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 আপনাকে একাধিক উপায় প্রদান করে। উদাহরণের জন্য কাস্টমাইজেশন পৃষ্ঠাটি দেখুন।

ছবি লোডিং লাইব্রেরি

ছবিগুলি প্রায়শই বহিরাগত ছবি লোডিং লাইব্রেরি দ্বারা পরিচালিত হয়, উদাহরণস্বরূপ গ্লাইড বা কয়েল

এই লাইব্রেরিগুলিকে প্লেব্যাক পাইপলাইনে একীভূত করার জন্য 3টি ধাপ প্রয়োজন:

  1. APPLICATION_EXTERNALLY_LOADED_IMAGE MIME টাইপ সহ একটি MediaItem সংজ্ঞায়িত করুন।
  2. ইমেজ লোডিং লাইব্রেরি থেকে একটি Bitmap পুনরুদ্ধার করার জন্য একটি ইমেজ ডিকোডার প্রদান করুন।
  3. ক্যাশিং এবং প্রিলোডিং ট্রিগার করার জন্য একটি বহিরাগত লোডার সরবরাহ করুন।

বাহ্যিকভাবে লোড করা ছবি MIME টাইপ সহ মিডিয়াআইটেম

ইমেজ লোডিং লাইব্রেরি কোড পাথ ব্যবহার করার জন্য Player যোগ করা MediaItem অবশ্যই APPLICATION_EXTERNALLY_LOADED_IMAGE MIME টাইপ স্পষ্টভাবে সংজ্ঞায়িত করতে হবে:

কোটলিন

val mediaItem =
  MediaItem.Builder()
    .setUri(imageUri)
    .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
    .build()

জাভা

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(imageUri)
        .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
        .build();

একটি ইমেজ লোডিং লাইব্রেরি ব্যবহার করে ইমেজ ডিকোডার

Uri থেকে Bitmap পুনরুদ্ধার করার জন্য ইমেজ রেন্ডারারের একটি ExternallyLoadedImageDecoder প্রয়োজন। এই ডিকোডারটি DefaultRenderersFactory.getImageDecoderFactory ওভাররাইড করে সরবরাহ করা যেতে পারে।

নিচের উদাহরণে গ্লাইড ব্যবহার করে একটি ছবি লোড করা হয়েছে, যা খুব বড় Bitmap অবজেক্ট তৈরি এড়াতে আউটপুটকে ডিসপ্লে সাইজের মধ্যে সীমাবদ্ধ করে:

কোটলিন

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

জাভা

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 নির্দিষ্ট করতে হবে। যদি কোনও প্রিলোডিং সম্ভব না হয় বা প্রয়োজন না হয়, তবে এই লোডারটি এখনও সরবরাহ করতে হবে, তবে এটি কিছুই করতে পারবে না।

অনুরোধকৃত ছবিটি ডিস্কে প্রিলোড করা আছে কিনা তা নিশ্চিত করার জন্য নিম্নলিখিত উদাহরণে গ্লাইড ব্যবহার করা হয়েছে:

কোটলিন

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 =
    ExoPlayer.Builder(context)
      .setMediaSourceFactory(DefaultMediaSourceFactory(context)
        .setExternalImageLoader(glidePreloader))
      .build()

জাভা

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