DASH

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

Groovy

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

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

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