ExoPlayer תומך ב-DASH עם כמה פורמטים של קונטיינרים. צריך לבצע ניתוק של שידורי המדיה, כלומר צריך להגדיר את הווידאו, האודיו והטקסט באלמנטים נפרדים של AdaptationSet
במניפסט DASH (CEA-608 הוא יוצא מן הכלל, כפי שמתואר בטבלה שבהמשך). צריך גם לתמוך בפורמטים של קטעי האודיו והווידאו שכלולים במודעה (פרטים מופיעים בקטע פורמטים של קטעי קוד).
תכונה | נתמך | תגובות |
---|---|---|
קונטיינרים | ||
FMP4 | כן | רק שידורים שהופרדו לרכיבים |
WebM | כן | רק שידורים שהופרדו לרכיבים |
Matroska | כן | רק שידורים שהופרדו לרכיבים |
MPEG-TS | לא | אין תמיכה מתוכננת |
כתוביות | ||
TTML | כן | פורמט RAW או מוטמע ב-FMP4 בהתאם ל-ISO/IEC 14496-30 |
WebVTT | כן | פורמט RAW או מוטמע ב-FMP4 בהתאם ל-ISO/IEC 14496-30 |
CEA-608 | כן | מוטמעים ב-FMP4 כששולחים אות באמצעות תיאורי נגישות של SCTE |
CEA-708 | כן | מוטמע ב-FMP4 כשהאות נשלח באמצעות תיאורי נגישות של SCTE |
מטא-נתונים | ||
מטא-נתונים של EMSG | כן | מוטמע ב-FMP4 |
הגנה על תוכן | ||
Widevine | כן | הסכימה 'cenc': API מגרסה 19 ואילך. הסכימה 'cbcs': 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, צריך להמיר את האובייקט המוחזר ל-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 יש כמה דרכים להתאים אישית את חוויית ההפעלה לצרכים של האפליקציה. דוגמאות מופיעות בדף ההתאמה האישית.