ছবি

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

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

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

MediaItem ব্যবহার করে

একটি প্লেলিস্টের অংশ হিসাবে একটি ইমেজ প্লে করতে, ইমেজ ইউআরআই সহ একটি 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 প্রকার সহ MediaItem৷

ইমেজ লোডিং লাইব্রেরি কোড পাথগুলি ব্যবহার করার জন্য 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 ওভাররাইড করে এই ডিকোডার প্রদান করা যেতে পারে।

নিম্নলিখিত উদাহরণটি একটি চিত্র লোড করতে গ্লাইড ব্যবহার করে:

কোটলিন

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

জাভা

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

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

কোটলিন

val glidePreloader = ExternalLoader { request: LoadRequest ->
  GlideFutures.submit(
    Glide.with(context)
      .asFile()
      .apply(
        RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.DATA)
          .priority(Priority.HIGH)
          .skipMemoryCache(true)
      )
      .load(request.uri)
  )
}

জাভা

ExternalLoader glidePreloader =
    request ->
        GlideFutures.submit(
            Glide.with(context)
                .asFile()
                .apply(
                    diskCacheStrategyOf(DiskCacheStrategy.DATA)
                        .priority(Priority.HIGH)
                        .skipMemoryCache(true))
                .load(request.uri));