डैश

ExoPlayer, कई कंटेनर फ़ॉर्मैट के साथ DASH का इस्तेमाल करता है. मीडिया स्ट्रीम को डिम्यूक्स किया जाना चाहिए. इसका मतलब है कि वीडियो, ऑडियो, और टेक्स्ट को DASH मेनिफ़ेस्ट में अलग-अलग AdaptationSet एलिमेंट में तय किया जाना चाहिए. हालांकि, CEA-608 एक अपवाद है, जैसा कि नीचे दी गई टेबल में बताया गया है. इसमें शामिल ऑडियो और वीडियो सैंपल के फ़ॉर्मैट भी काम करने चाहिए. ज़्यादा जानकारी के लिए, सैंपल फ़ॉर्मैट सेक्शन देखें.

सुविधा	इनकी अनुमति है	टिप्पणियां
कंटेनर
FMP4	हां	सिर्फ़ अलग-अलग ऑडियो और वीडियो ट्रैक में बांटी गई स्ट्रीम
WebM	हां	सिर्फ़ अलग-अलग ऑडियो और वीडियो ट्रैक में बांटी गई स्ट्रीम
Matroska	हां	सिर्फ़ अलग-अलग ऑडियो और वीडियो ट्रैक में बांटी गई स्ट्रीम
MPEG-TS	नहीं	सहायता उपलब्ध नहीं है
सबटाइटल/कैप्शन
TTML	हां	रॉ या ISO/IEC 14496-30 के मुताबिक FMP4 में एम्बेड किया गया
WebVTT	हां	रॉ या ISO/IEC 14496-30 के मुताबिक FMP4 में एम्बेड किया गया
CEA-608	हां	SCTE Accessibility descriptors का इस्तेमाल करके सिग्नल मिलने पर, FMP4 में एम्बेड किया जाता है
CEA-708	हां	SCTE Accessibility descriptors का इस्तेमाल करके सिग्नल मिलने पर, FMP4 में एम्बेड किया जाता है
मेटाडेटा
EMSG मेटाडेटा	हां	FMP4 में एम्बेड किया गया
कॉन्टेंट की सुरक्षा
वाइडवाइन	हां	"cenc" स्कीम: एपीआई 19+; "cbcs" स्कीम: एपीआई 25+
PlayReady SL2000	हां	Android TV, सिर्फ़ "cenc" स्कीम
ClearKey	हां	एपीआई 21 और उसके बाद के वर्शन, सिर्फ़ "cenc" स्कीम
लाइव वीडियो चलाना
लाइव स्ट्रीम को सामान्य तरीके से चलाना	हां
इंतज़ार का समय बहुत कम रखने वाला CMAF लाइव प्लेबैक	हां
कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी)	हां	इंटिग्रेशन गाइड

MediaItem का इस्तेमाल करना

DASH स्ट्रीम चलाने के लिए, आपको DASH मॉड्यूल का इस्तेमाल करना होगा.

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.4.1")

Groovy

implementation "androidx.media3:media3-exoplayer-dash:1.4.1"

इसके बाद, DASH MPD यूआरआई के लिए MediaItem बनाया जा सकता है और उसे प्लेयर को पास किया जा सकता है.

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(dashUri))
// Prepare the player.
player.prepare()

Java

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(dashUri));
// Prepare the player.
player.prepare();

अगर आपका यूआरआई .mpd पर खत्म नहीं होता है, तो कॉन्टेंट के टाइप के बारे में साफ़ तौर पर बताने के लिए, MediaItem.Builder के setMimeType में MimeTypes.APPLICATION_MPD को पास किया जा सकता है.

ExoPlayer, उपलब्ध बैंडविड्थ और डिवाइस की क्षमताओं को ध्यान में रखते हुए, मेनिफ़ेस्ट में बताए गए रिप्रज़ेंटेशन के बीच अपने-आप अडजस्ट हो जाएगा.

DashMediaSource का इस्तेमाल करना

पसंद के मुताबिक बनाने के ज़्यादा विकल्पों के लिए, DashMediaSource बनाएं और उसे MediaItem के बजाय सीधे प्लेयर को पास करें.

Kotlin

val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a dash media source pointing to a dash manifest uri.
val mediaSource: MediaSource =
  DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri))
// Create a player instance which gets an adaptive track selector by default.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a dash media source pointing to a dash manifest uri.
MediaSource mediaSource =
    new DashMediaSource.Factory(dataSourceFactory)
        .createMediaSource(MediaItem.fromUri(dashUri));
// Create a player instance which gets an adaptive track selector by default.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

मेनिफ़ेस्ट ऐक्सेस करना

Player.getCurrentManifest को कॉल करके, मौजूदा मेनिफ़ेस्ट को वापस पाया जा सकता है. DASH के लिए, आपको दिखाए गए ऑब्जेक्ट को DashManifest में कास्ट करना चाहिए. जब भी मेनिफ़ेस्ट लोड होता है, तब Player.Listener के onTimelineChanged कॉलबैक को भी कॉल किया जाता है. मांग पर उपलब्ध कॉन्टेंट के लिए ऐसा एक बार होगा और लाइव कॉन्टेंट के लिए कई बार. नीचे दिया गया कोड स्निपेट दिखाता है कि जब भी मेनिफ़ेस्ट लोड होता है, तो ऐप्लिकेशन कुछ कैसे कर सकता है.

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is DashManifest) {
        // Do something with the manifest.
      }
    }
  }
)

Java

player.addListener(
    new Player.Listener() {
      @Override
      public void onTimelineChanged(
          Timeline timeline, @Player.TimelineChangeReason int reason) {
        Object manifest = player.getCurrentManifest();
        if (manifest != null) {
          DashManifest dashManifest = (DashManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

वीडियो चलाने की सेटिंग में बदलाव करना

ExoPlayer में, वीडियो चलाने के अनुभव को अपने ऐप्लिकेशन की ज़रूरतों के हिसाब से बनाने के कई तरीके उपलब्ध हैं. उदाहरणों के लिए, पसंद के मुताबिक बनाने का पेज देखें.