DASH

ExoPlayer รองรับ DASH ที่มีรูปแบบคอนเทนเนอร์หลายรูปแบบ สตรีมสื่อต้องได้รับการแยกสัญญาณ (Demux) ซึ่งหมายความว่าวิดีโอ เสียง และข้อความต้องกำหนดไว้ในองค์ประกอบ 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.10.0")

ดึงดูด

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

จากนั้นคุณจะสร้าง 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()
Dash.kt

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();
Dash.java

หาก 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()
Dash.kt

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();
Dash.java

การเข้าถึงไฟล์ 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.
      }
    }
  }
)
Dash.kt

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.
        }
      }
    });
Dash.java

การปรับแต่งการเล่น

ExoPlayer มีหลายวิธีให้คุณปรับแต่งประสบการณ์การเล่นให้เหมาะกับความต้องการของแอป ดูตัวอย่างได้ที่หน้าการปรับแต่ง