DASH

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

ฟีเจอร์ รองรับ ความคิดเห็น
คอนเทนเนอร์
FMP4 ใช่ สตรีมที่แยกข้อมูลเท่านั้น
WebM ใช่ สตรีมแบบ Demux เท่านั้น
Matroska ใช่ สตรีมแบบ Demux เท่านั้น
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" เท่านั้น
การแทรกโฆษณา
การเล่นแบบหลายช่วงเวลา ใช่
การแทรกโฆษณาตามคำแนะนำของเซิร์ฟเวอร์ (xlink) ไม่
โฆษณาฝั่งเซิร์ฟเวอร์และฝั่งไคลเอ็นต์ของ IMA ใช่ คู่มือการแทรกโฆษณา
การเล่นแบบสด
การเล่นไลฟ์สดปกติ ใช่
การเล่นไลฟ์สด CMAF ที่มีเวลาในการตอบสนองต่ำมาก ใช่
Common Media Client Data (CMCD) ใช่ คู่มือการผสานรวม CMCD

การใช้ MediaItem

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

Kotlin

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

ดึงดูด

implementation "androidx.media3:media3-exoplayer-dash:1.11.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 ระบบจะเรียกใช้ Callback onTimelineChanged ของ Player.Listener ด้วยเมื่อใดก็ตามที่มีการโหลดไฟล์ Manifest ซึ่งจะเกิดขึ้น 1 ครั้งสำหรับเนื้อหาแบบออนดีมานด์ และอาจเกิดขึ้นหลายครั้งสำหรับเนื้อหาสด ข้อมูลโค้ดต่อไปนี้แสดงวิธีที่แอปสามารถดำเนินการบางอย่างเมื่อใดก็ตามที่มีการโหลดไฟล์ Manifest

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(
      timeline: Timeline,
      @Player.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 มีวิธีมากมายในการปรับแต่งประสบการณ์การเล่นให้เหมาะกับความต้องการของแอป ดูตัวอย่างได้ที่หน้าการปรับแต่ง