প্লেয়ার ইন্টারফেস

প্লেয়ার হল আপনার অ্যাপের কম্পোনেন্ট যা মিডিয়া আইটেম প্লেব্যাক করতে সাহায্য করে। Media3 Player ইন্টারফেস সাধারণত প্লেয়ারের মাধ্যমে ম্যানেজ করা কার্যকারিতার জন্য একটি আউটলাইন সেট-আপ করে। এর মধ্যে রয়েছে:

• প্লেব্যাক কন্ট্রোলকে প্রভাবিত করে, যেমন চালানো, পজ করা এবং খোঁজা
• বর্তমানে চলছে এমন মিডিয়ার প্রপার্টি কোয়েরি করা, যেমন প্লেব্যাক পজিশন
• মিডিয়া আইটেমের প্লেলিস্ট/সারি ম্যানেজ করা
• প্লেব্যাক প্রপার্টি কনফিগার করা, যেমন শাফেল করা, রিপিট করা, স্পিড এবং ভলিউম
• স্ক্রিনে ভিডিও রেন্ডার করা হচ্ছে

এছাড়াও, Media3 Player ইন্টারফেসের একটি ইমপ্লিমেন্টেশন প্রদান করে, যাকে ExoPlayer বলা হয়।

কম্পোনেন্টের মধ্যে একটি সাধারণ ইন্টারফেস

Media3-এর একাধিক কম্পোনেন্ট Player ইন্টারফেস প্রয়োগ করে, যেমন:

যদিও MediaSession, Player ইন্টারফেস প্রয়োগ করে না, এটি তৈরি করার সময় Player প্রয়োজন হয়। অন্যান্য প্রসেস বা থ্রেড থেকে Player-এ অ্যাক্সেস প্রদান করাই এর উদ্দেশ্য।

Media3 প্লেব্যাক আর্কিটেকচার

আপনার কাছে Player-এর অ্যাক্সেস থাকলে, প্লেব্যাক কমান্ড ইস্যু করতে সরাসরি এর মেথড কল করা উচিত। আপনি নিজের প্লেব্যাক বিজ্ঞাপন করতে এবং MediaSession প্রয়োগ করে এক্সটার্নাল সোর্সকে প্লেব্যাক কন্ট্রোল করার অনুমতি দিতে পারবেন। এইসব এক্সটার্নাল সোর্স MediaController প্রয়োগ করে, যা মিডিয়া সেশনের সাথে কানেক্ট করতে এবং প্লেব্যাক কমান্ডের অনুরোধ ইস্যু করতে সাহায্য করে।

ব্যাকগ্রাউন্ডে মিডিয়া চালানোর সময়, আপনাকে মিডিয়া সেশন ও প্লেয়ারকে MediaSessionService বা MediaLibraryService-এর মধ্যে রাখতে হবে যা ফোরগ্রাউন্ড সার্ভিস হিসেবে চলে। আপনি এটি করলে, আপনার অ্যাপে অ্যাক্টিভিটি থেকে প্লেয়ার আলাদা করতে পারবেন যেটিতে প্লেব্যাক কন্ট্রোলের জন্য UI থাকে। এর জন্য আপনাকে মিডিয়া কন্ট্রোলার ব্যবহার করতে হতে পারে।

প্লেয়ার স্টেট

Player ইন্টারফেস প্রয়োগ করা মিডিয়া প্লেয়ারের স্ট্যাটাসে মূলত ৪টি বিভাগের তথ্য থাকে:

1. প্লেব্যাক স্টেট
   • getPlaybackState()-এর মাধ্যমে ফিরিয়ে আনুন।
   • ইন্টারফেসের মাধ্যমে নির্ধারিত স্টেট ভ্যালু হল STATE_IDLE, STATE_BUFFERING, STATE_READY, এবং STATE_ENDED।
2. মিডিয়া আইটেমের প্লেলিস্ট
   • প্লেব্যাকের জন্য MediaItemটি ইনস্ট্যান্সের একটি সিকোয়েন্স।
   • getCurrentTimeline()-এর মাধ্যমে ফিরিয়ে আনুন
   • Player ইনস্ট্যান্স প্লেলিস্ট অপারেশন পদ্ধতি প্রদান করতে পারে যেমন যোগ করা বা সরানো একটি MediaItem এবং সুবিধা পদ্ধতি যেমন getCurrentMediaItem().
3. প্লে/পজ প্রপার্টি, যেমন:
   • playWhenReady: ব্যবহারকারী সম্ভব হলে মিডিয়া চালাতে চান নাকি পজ করে রাখতে চান তার ইঙ্গিত
   • প্লেব্যাক বন্ধ থাকার কারণ: প্লেব্যাক কেন বন্ধ আছে তার ইঙ্গিত, যদি প্রযোজ্য হয়, এমনকি playWhenReady যদি true হয়
   • isPlaying: প্লেয়ার বর্তমানে চলছে কিনা তার ইঙ্গিত, যা শুধুমাত্র true হবে যদি প্লেব্যাক স্টেট STATE_READY হয়, playWhenReady হল true এবং প্লেব্যাক সাপ্রেস করা না হয়
4. প্লেব্যাক পজিশন, যার মধ্যে রয়েছে:
   • বর্তমান মিডিয়া আইটেম ইনডেক্স: প্লেলিস্টে বর্তমান MediaItem-এর ইনডেক্স।
   • isPlayingAd: যোগ করা বিজ্ঞাপন চলছে কিনা তার ইঙ্গিত।
   • বর্তমান প্লেব্যাক পজিশন: বর্তমান MediaItem বা যোগ করা বিজ্ঞাপনের মধ্যে বর্তমান প্লেব্যাক পজিশন।

এছাড়াও, Player ইন্টারফেস উপলভ্য ট্র্যাক, মিডিয়া মেটাডেটা, প্লেব্যাক স্পিড, ভলিউম এবং প্লেব্যাকের অন্যান্য সহায়ক প্রপার্টি অ্যাক্সেস করার অনুমতি দেয়।

পরিবর্তন সম্পর্কে শুনুন

Player-এ পরিবর্তন শোনার জন্য Player.Listener ব্যবহার করুন। কীভাবে লিসেনার তৈরি ও ব্যবহার করতে হয় সেই সম্পর্কে বিস্তারিত জানতে প্লেয়ার ইভেন্ট-এ ExoPlayer ডকুমেন্টেশন দেখুন।

মনে রাখবেন, লিসেনার ইন্টারফেসে সাধারণ প্লেব্যাক প্রগ্রেশন ট্র্যাক করার জন্য কোনও কলব্যাক অন্তর্ভুক্ত থাকে না। প্লেব্যাক প্রোগ্রেস ক্রমাগত মনিটর করতে, যেমন প্রোগ্রেস বার UI সেট-আপ করতে, আপনাকে সঠিক বিরতিতে বর্তমান পজিশন কোয়েরি করতে হবে।

fun checkPlaybackPosition(delayMs: Long): Boolean =
  handler.postDelayed(
    {
      val currentPosition = player.currentPosition
      // Update UI based on currentPosition
      checkPlaybackPosition(delayMs)
    },
    delayMs,
  )
Player.kt

boolean checkPlaybackPosition(long delayMs) {
  return handler.postDelayed(
      () -> {
        long currentPosition = player.getCurrentPosition();
        // Update UI based on currentPosition
        checkPlaybackPosition(delayMs);
      },
      delayMs);
}
Player.java

প্লেব্যাক কন্ট্রোল করুন

Player ইন্টারফেস, স্ট্যাটাস ও কন্ট্রোল প্লেব্যাক ম্যানিপুলেট করার অনেক উপায় অফার করে:

• play(), pause(), prepare() ও stop()-এর মতো প্রাথমিক প্লেব্যাক কন্ট্রোল।
• প্লেলিস্ট অপারেশন যেমন addMediaItem() বা removeMediaItem()।
• বর্তমান আইটেম বা পজিশন পরিবর্তন করার জন্য খোঁজা।
• রিপিট মোড এবং শাফেল মোড সেট করুন।
• ট্র্যাক বেছে নেওয়ার পছন্দ আপডেট করুন।
• প্লেব্যাক স্পিড সেট করুন।

কাস্টম Player প্রয়োগ

কাস্টম প্লেয়ার তৈরি করতে, আপনি Media3-তে অন্তর্ভুক্ত SimpleBasePlayer এক্সটেন্ড করতে পারবেন। এই ক্লাসটি Player ইন্টারফেসের একটি বেস ইমপ্লিমেন্টেশন প্রদান করে যাতে আপনাকে ন্যূনতম সংখ্যক পদ্ধতি ইমপ্লিমেন্ট করতে হয়।

getState() পদ্ধতি ওভাররাইড করে শুরু করুন। এই পদ্ধতি কল করার সময় প্লেয়ারের বর্তমান স্ট্যাটাস পপুলেট করবে, যার মধ্যে এগুলি অন্তর্ভুক্ত:

• উপলভ্য কমান্ডের সেট
• প্লেব্যাক প্রপার্টি, যেমন প্লেব্যাক স্ট্যাটাস STATE_READY হলে প্লেয়ার চালানো শুরু করা উচিত কিনা, বর্তমানে চলা মিডিয়া আইটেমের ইন্ডেক্স এবং বর্তমান আইটেমের মধ্যে প্লেব্যাক পজিশন

class CustomPlayer(looper: Looper) : SimpleBasePlayer(looper) {
  override fun getState(): State {
    return State.Builder()
      .setAvailableCommands(Commands.EMPTY) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build()
  }
}
Player.kt

private static final class CustomPlayer extends SimpleBasePlayer {
  public CustomPlayer(Looper looper) {
    super(looper);
  }

  @Override
  protected State getState() {
    return new State.Builder()
        .setAvailableCommands(Commands.EMPTY) // Set which playback commands the player can handle
        // Configure additional playback properties
        .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
        .setCurrentMediaItemIndex(0)
        .setContentPositionMs(0)
        .build();
  }
}
Player.java

SimpleBasePlayer এনফোর্স করবে যে State যেন স্টেট ভ্যালুর সঠিক কম্বিনেশন দিয়ে তৈরি করা হয়। এটি লিসেনারদের হ্যান্ডেল করবে এবং লিসেনারদের স্ট্যাটাস পরিবর্তন সম্পর্কে জানাবে। আপনাকে ম্যানুয়ালি কোনও স্টেট আপডেট ট্রিগার করতে হলে, invalidateState() কল করুন।

getState() পদ্ধতি ছাড়াও, আপনাকে শুধু সেইসব পদ্ধতি প্রয়োগ করতে হবে যেগুলি আপনার প্লেয়ারের উপলভ্য বলে ঘোষণা করা কমান্ডের জন্য ব্যবহার করা হয়। আপনি যে কার্যকারিতা প্রয়োগ করতে চান তার সাথে সম্পর্কিত ওভাররাইডযোগ্য হ্যান্ডলার পদ্ধতি খুঁজুন। যেমন, COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM এবং COMMAND_SEEK_TO_NEXT_MEDIA_ITEM-এর মতো অপারেশন সাপোর্ট করতে handleSeek() মেথড ওভাররাইড করুন।

Playerটি প্রয়োগ পরিবর্তন করুন

সম্পূর্ণ কাস্টম Player তৈরি করার পরিবর্তে, আপনি ForwardingSimpleBasePlayer ব্যবহার করে আগে থেকে থাকা Player-এর অবস্থা ও আচরণ পরিবর্তন করতে পারবেন। আরও বিবরণের জন্য কাস্টমাইজেশন পৃষ্ঠায় গাইড দেখুন।