מקף

ExoPlayer תומך ב-DASH עם מספר פורמטים של קונטיינרים. צריך לבצע ניתוק של שידורי המדיה, כלומר צריך להגדיר את הווידאו, האודיו והטקסט באלמנטים נפרדים של AdaptationSet במניפסט DASH (CEA-608 הוא יוצא מן הכלל, כפי שמתואר בטבלה שבהמשך). צריך גם לתמוך בפורמטים של קטעי האודיו והווידאו שכלולים במודעה (פרטים מופיעים בקטע פורמטים של קטעי קוד).

תכונה	נתמך	תגובות
קונטיינרים
FMP4	כן	רק שידורים שהופרדו לרכיבים
WebM	כן	סטרימינג לדוגמה בלבד
מטרוסקה	כן	רק שידורים שהופרדו לרכיבים
MPEG-TS	לא	לא מתוכננת תמיכה
כתוביות
TTML	כן	גולמי או מוטמע ב-FMP4 בהתאם לתקן ISO/IEC 14496-30
WebVTT	כן	גולמי או מוטמע ב-FMP4 בהתאם לתקן ISO/IEC 14496-30
CEA-608	כן	מוטמעים ב-FMP4 כששולחים אות באמצעות תיאורי נגישות של SCTE
CEA-708	כן	מוטמע ב-FMP4 כשהאות נשלח באמצעות תיאורי נגישות של SCTE
מטא-נתונים
מטא-נתונים של EMSG	כן	מוטמע ב-FMP4
הגנה על תוכן
Widevine	כן	'cenc' scheme: API 19+; 'cbcs' scheme: API 25+
PlayReady SL2000	כן	Android TV, סכימה מסוג 'cenc' בלבד
ClearKey	כן	API 21+ , "cenc" סכמה בלבד
הפעלה בשידור חי
הפעלה רגילה של שידור חי	כן
הפעלה של שידורים חיים ב-CMAF בזמן אחזור קצר במיוחד	כן
Common Media Client Data ‏(CMCD)	כן	מדריך לשילוב

שימוש ב-MediaItem

כדי להפעיל זרם DASH, יש להסתמך על מודול ה-DASH.

Kotlin

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

Groovy

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

לאחר מכן אפשר ליצור MediaItem עבור URI של MPD ב-DASH ולהעביר אותו לנגן.

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

אם ה-URI לא מסתיים ב-.mpd, אפשר להעביר את MimeTypes.APPLICATION_MPD אל setMimeType מתוך MediaItem.Builder כדי לציין במפורש את סוג תוכן.

המערכת של 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 צריך להפעיל Cast של האובייקט שהוחזר אל DashManifest. תתבצע גם שיחה חוזרת של onTimelineChanged במספר Player.Listener בכל פעם המניפסט נטען. זה יקרה פעם אחת לתוכן על פי דרישה, כפעמים רבות לתוכן בשידור חי. קטע הקוד הבא מראה איך אפליקציה אפשרות לבצע פעולה כלשהי בכל פעם שהמניפסט נטען.

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 מספק דרכים רבות להתאמה אישית של חוויית ההפעלה לצרכים של האפליקציה. אפשר לראות דוגמאות בדף ההתאמה האישית.