प्लेयर इंटरफ़ेस

प्लेयर, आपके ऐप्लिकेशन का वह कॉम्पोनेंट होता है जो मीडिया आइटम चलाने में मदद करता है. Media3 Player इंटरफ़ेस, आम तौर पर प्लेयर की ओर से हैंडल की जाने वाली सुविधाओं के लिए एक आउटलाइन सेट अप करता है. इसमें ये शामिल हैं:

• प्लेबैक कंट्रोल पर असर डालती हैं. जैसे, वीडियो चलाना, रोकना, और आगे-पीछे करना
• फ़िलहाल चल रहे मीडिया की प्रॉपर्टी के बारे में क्वेरी करना. जैसे, प्लेबैक की पोजीशन
• मीडिया आइटम की प्लेलिस्ट/कतार मैनेज करना
• प्लेबैक की प्रॉपर्टी कॉन्फ़िगर करना. जैसे, शफ़ल करना, दोहराना, स्पीड, और वॉल्यूम
• वीडियो को स्क्रीन पर रेंडर करना

Media3, Player इंटरफ़ेस को लागू करने की सुविधा भी देता है. इसे ExoPlayer कहा जाता है.

कॉम्पोनेंट के बीच एक कॉमन इंटरफ़ेस

Media3 में कई कॉम्पोनेंट, Player इंटरफ़ेस लागू करते हैं. उदाहरण के लिए:

हालांकि, MediaSession, Player इंटरफ़ेस लागू नहीं करता है, लेकिन इसे बनाते समय Player की ज़रूरत होती है. इसका मकसद, अन्य प्रोसेस या थ्रेड से Player को ऐक्सेस करने की अनुमति देना है.

Media3 के प्लेबैक का आर्किटेक्चर

अगर आपके पास Player का ऐक्सेस है, तो आपको सीधे तौर पर इसके तरीकों को कॉल करना चाहिए, ताकि प्लेबैक के निर्देश दिए जा सकें. MediaSession लागू करके, अपने कॉन्टेंट के प्लेबैक का विज्ञापन किया जा सकता है. साथ ही, बाहरी सोर्स को प्लेबैक कंट्रोल करने की अनुमति दी जा सकती है. ये बाहरी सोर्स, MediaController लागू करते हैं. इससे मीडिया सेशन से कनेक्ट करना और मीडिया चलाने के अनुरोध भेजना आसान हो जाता है.

बैकग्राउंड में मीडिया चलाने के लिए, आपको अपने मीडिया सेशन और प्लेयर को MediaSessionService या MediaLibraryService में रखना होगा. यह फ़ोरग्राउंड सेवा के तौर पर काम करता है. ऐसा करने पर, आपके पास अपने प्लेयर को ऐप्लिकेशन में मौजूद उस गतिविधि से अलग करने का विकल्प होता है जिसमें वीडियो चलाने के कंट्रोल के लिए यूज़र इंटरफ़ेस (यूआई) होता है. इसके लिए, आपको मीडिया कंट्रोलर का इस्तेमाल करना पड़ सकता है.

प्लेयर की स्थिति

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 का दस्तावेज़ देखें.

ध्यान दें कि लिसनर इंटरफ़ेस में, सामान्य प्लेबैक की प्रोग्रेस को ट्रैक करने के लिए कोई कॉलबैक शामिल नहीं होता. वीडियो चलाने की प्रोग्रेस पर लगातार नज़र रखने के लिए, आपको सही इंटरवल पर मौजूदा पोज़िशन के बारे में क्वेरी करनी चाहिए. जैसे, प्रोग्रेस बार यूज़र इंटरफ़ेस (यूआई) सेट अप करने के लिए.

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

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

ऑडियो कंट्रोल करने का तरीक़ा

Player इंटरफ़ेस में, स्थिति में बदलाव करने और वीडियो चलाने को कंट्रोल करने के कई तरीके उपलब्ध हैं:

• वीडियो चलाने के बुनियादी कंट्रोल जैसे कि play(), pause(), prepare(), और stop().
• प्लेलिस्ट से जुड़ी कार्रवाइयां, जैसे कि addMediaItem() या removeMediaItem().
• सीकिंग का इस्तेमाल, मौजूदा आइटम या पोज़िशन बदलने के लिए किया जाता है.
• दोहराने के मोड और शफ़ल मोड सेट करें.
• ट्रैक चुनने की प्राथमिकताओं को अपडेट करें.
• वीडियो चलाने की स्पीड सेट करें.

कस्टम Player लागू करने के तरीके

कस्टम प्लेयर बनाने के लिए, Media3 में शामिल SimpleBasePlayer का इस्तेमाल किया जा सकता है. यह क्लास, Player इंटरफ़ेस को लागू करने का बुनियादी तरीका उपलब्ध कराती है. इससे आपको कम से कम तरीकों को लागू करना पड़ता है.

getState() तरीके को बदलकर शुरू करें. इस तरीके को कॉल किए जाने पर, मौजूदा खिलाड़ी की स्थिति की जानकारी अपने-आप भरनी चाहिए. इसमें यह जानकारी शामिल होनी चाहिए:

• उपलब्ध निर्देशों का सेट
• वीडियो चलाने की प्रॉपर्टी. जैसे, प्लेयर को तब वीडियो चलाना शुरू करना चाहिए, जब वीडियो चलाने की स्थिति STATE_READY हो, फ़िलहाल चल रहे मीडिया आइटम का इंडेक्स, और मौजूदा आइटम में वीडियो चलाने की स्थिति

class CustomPlayer : SimpleBasePlayer(looper) {
  override fun getState(): State {
    return State.Builder()
      .setAvailableCommands(...) // 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()
  }
}

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

  @Override
  protected State getState() {
    return new State.Builder()
      .setAvailableCommands(...) // 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();
  }
}

SimpleBasePlayer यह पक्का करेगा कि State को राज्य की वैल्यू के मान्य कॉम्बिनेशन के साथ बनाया गया हो. यह लिसनर को मैनेज करने के साथ-साथ, स्थिति में हुए बदलावों के बारे में लिसनर को सूचना देने का काम भी करेगा. अगर आपको स्थिति के अपडेट को मैन्युअल तरीके से ट्रिगर करना है, तो invalidateState() को कॉल करें.

getState() तरीके के अलावा, आपको सिर्फ़ उन तरीकों को लागू करना होगा जिनका इस्तेमाल उन कमांड के लिए किया जाता है जिन्हें आपका प्लेयर उपलब्ध होने का एलान करता है. उस फ़ंक्शन के लिए, ओवरराइड किए जा सकने वाले हैंडलर का तरीका ढूंढें जिसे आपको लागू करना है. उदाहरण के लिए, handleSeek() तरीके को ओवरराइड करके, COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM और COMMAND_SEEK_TO_NEXT_MEDIA_ITEM जैसे ऑपरेशन किए जा सकते हैं.

Player लागू करने के तरीके में बदलाव करना

पूरी तरह से कस्टम Player बनाने के बजाय, ForwardingSimpleBasePlayer का इस्तेमाल करके किसी मौजूदा Player की स्थिति और व्यवहार में बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, पसंद के मुताबिक बनाने वाले पेज पर मौजूद गाइड देखें.