DASH

ExoPlayer รองรับ DASH ที่มีรูปแบบคอนเทนเนอร์หลายรูปแบบ ต้องแยกสตรีมสื่อออก ซึ่งหมายความว่าต้องกำหนดวิดีโอ เสียง และข้อความในองค์ประกอบ AdaptationSet ที่แตกต่างกันในไฟล์ Manifest ของ DASH (CEA-608 เป็นข้อยกเว้นตามที่อธิบายไว้ในตารางด้านล่าง) นอกจากนี้ รูปแบบตัวอย่างเสียงและวิดีโอที่อยู่ในไฟล์ต้องได้รับการรองรับด้วย (ดูรายละเอียดได้ที่ส่วนรูปแบบตัวอย่าง)

ฟีเจอร์ รองรับ ความคิดเห็น
คอนเทนเนอร์
FMP4 ใช่ สตรีมที่แยกแล้วเท่านั้น
WebM ใช่ สตรีมที่แยกแล้วเท่านั้น
Matroska ใช่ สตรีมที่แยกแล้วเท่านั้น
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": API 19 ขึ้นไป; รูปแบบ "cbcs": API 25 ขึ้นไป
PlayReady SL2000 ใช่ Android TV, รูปแบบ "cenc" เท่านั้น
ClearKey ใช่ API 21 ขึ้นไป รูปแบบ "cenc" เท่านั้น
การแทรกโฆษณา
การเล่นแบบหลายช่วงเวลา ใช่
การแทรกโฆษณาที่เซิร์ฟเวอร์แนะนำ (xlinks) ไม่
โฆษณาฝั่งเซิร์ฟเวอร์และ ฝั่งไคลเอ็นต์ของ IMA ใช่ คู่มือการแทรกโฆษณา
การเล่นสด
การเล่นไลฟ์สดปกติ ใช่
การเล่นสดแบบ CMAF ที่มีเวลาในการตอบสนองต่ำมาก ใช่
ข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) ใช่ คู่มือการผสานรวม CMCD

การใช้ MediaItem

หากต้องการเล่นสตรีม DASH คุณต้องใช้โมดูล DASH

Kotlin

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

Groovy

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

จากนั้นคุณจะสร้าง MediaItem สำหรับ URI ของ DASH MPD และส่งไปยังเพลเยอร์ได้

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 จะปรับเปลี่ยนระหว่างการแสดงที่กำหนดไว้ใน ไฟล์ Manifest โดยอัตโนมัติ โดยคำนึงถึงทั้งแบนด์วิดท์ที่พร้อมใช้งานและความสามารถของอุปกรณ์

การใช้ 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();

การเข้าถึงไฟล์ Manifest

คุณสามารถเรียกข้อมูลไฟล์ Manifest ปัจจุบันได้โดยเรียก Player.getCurrentManifest สำหรับ DASH คุณควรแคสต์ออบเจ็กต์ที่ส่งคืนเป็น DashManifest ระบบจะเรียกใช้ onTimelineChanged Callback ของ Player.Listener ทุกครั้งที่โหลด ไฟล์ Manifest การดำเนินการนี้จะเกิดขึ้น 1 ครั้งสำหรับเนื้อหาออนดีมานด์ และ อาจเกิดขึ้นหลายครั้งสำหรับเนื้อหาแบบสด ข้อมูลโค้ดต่อไปนี้แสดงวิธีที่แอป สามารถทำบางอย่างได้ทุกครั้งที่โหลดไฟล์ Manifest

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 มีหลายวิธีให้คุณปรับแต่งประสบการณ์การเล่นให้ตรงกับความต้องการของแอป ดูตัวอย่างได้ที่หน้าการปรับแต่ง