รายการสื่อ

playlist API อิงตามอินสแตนซ์ MediaItem ซึ่งสร้างได้ง่ายๆ โดยใช้ MediaItem.Builder ภายในโปรแกรมเล่น MediaItem จะถูกแปลงเป็น MediaSource ที่เล่นได้โดย MediaSource.Factory หากไม่มีการกำหนดค่าที่กำหนดเอง การแปลงนี้จะดำเนินการโดย DefaultMediaSourceFactory ซึ่งสามารถสร้างแหล่งที่มาของสื่อที่ซับซ้อนซึ่งสอดคล้องกับพร็อพเพอร์ตี้ของรายการสื่อ พร็อพเพอร์ตี้บางรายการที่ตั้งค่าในรายการสื่อได้จะอธิบายไว้ในส่วนต่อไปนี้

รายการสื่อแบบง่าย

คุณสามารถสร้างรายการสื่อที่ประกอบด้วย URI ของสตรีมเท่านั้นได้ด้วยfromUri เมธอดอำนวยความสะดวกต่อไปนี้

Kotlin

val mediaItem = MediaItem.fromUri(videoUri)

Java

MediaItem mediaItem = MediaItem.fromUri(videoUri);

ในกรณีอื่นๆ ทั้งหมด คุณสามารถใช้ MediaItem.Builder ได้ ในตัวอย่างต่อไปนี้ รายการสื่อสร้างขึ้นโดยมีรหัสและข้อมูลเมตาที่แนบมาด้วย

Kotlin

val mediaItem =
  MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build()

Java

MediaItem mediaItem =
    new MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build();

การแนบข้อมูลเมตาจะมีประโยชน์สำหรับการอัปเดต UI ของแอปเมื่อมีการเปลี่ยนเพลย์ลิสต์

รูปภาพ

การเล่นรูปภาพต้องมีระยะเวลาในรายการสื่อเพื่อระบุระยะเวลาที่ควรแสดงรูปภาพระหว่างการเล่น ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปภาพเคลื่อนไหวและไลบรารีการโหลดรูปภาพ (เช่น Glide) ได้ที่หน้าคำแนะนำเกี่ยวกับรูปภาพ

Kotlin

val mediaItem = MediaItem.Builder().setUri(imageUri).setImageDurationMs(3000).build()

Java

MediaItem mediaItem =
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(3_000).build();

นามสกุลไฟล์ที่ไม่ได้มาตรฐานสำหรับสื่อแบบปรับเปลี่ยนได้

ExoPlayer มีแหล่งที่มาของสื่อแบบปรับอัตโนมัติสำหรับ DASH, HLS และ SmoothStreaming หาก URI ของรายการสื่อแบบปรับอัตโนมัติดังกล่าวลงท้ายด้วยนามสกุลไฟล์มาตรฐาน ระบบจะสร้างแหล่งที่มาของสื่อที่เกี่ยวข้องโดยอัตโนมัติ หาก URI มีนามสกุลที่ไม่เป็นมาตรฐานหรือไม่มีนามสกุลเลย คุณสามารถตั้งค่าประเภท MIME อย่างชัดแจ้งเพื่อระบุประเภทของรายการสื่อได้ ดังนี้

Kotlin

val mediaItem =
  MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build()

Java

MediaItem mediaItem =
    new MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build();

สำหรับสตรีมสื่อแบบโปรเกรสซีฟ ไม่จำเป็นต้องใช้ประเภท MIME

เนื้อหาที่คุ้มครอง

สำหรับเนื้อหาที่มีการคุ้มครอง ควรตั้งค่าพร็อพเพอร์ตี้ DRM ของรายการสื่อ ต้องระบุ UUID ส่วนพร็อพเพอร์ตี้อื่นๆ ทั้งหมดไม่บังคับ

ตัวอย่างการกำหนดค่าสำหรับการเล่นรายการที่ได้รับการปกป้องด้วย Widevine DRM โดยที่ URI ใบอนุญาตไม่พร้อมใช้งานโดยตรงในสื่อ (เช่น ในเพลย์ลิสต์ DASH) และต้องใช้หลายเซสชัน (เช่น เนื่องจากการหมุนเวียนคีย์)

Kotlin

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setDrmConfiguration(
      MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID)
        .setLicenseUri(licenseUri)
        .setMultiSession(true)
        .setLicenseRequestHeaders(httpRequestHeaders)
        .build()
    )
    .build()

Java

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setDrmConfiguration(
            new MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID)
                .setLicenseUri(licenseUri)
                .setMultiSession(true)
                .setLicenseRequestHeaders(httpRequestHeaders)
                .build())
        .build();

ภายในโปรแกรมเล่น DefaultMediaSourceFactory จะส่งพร็อพเพอร์ตี้เหล่านี้ไปยัง DrmSessionManagerProvider เพื่อรับ DrmSessionManager ซึ่งจะแทรกลงใน MediaSource ที่สร้างขึ้น คุณสามารถปรับแต่งลักษณะการทำงานของ DRM เพิ่มเติมได้ตามความต้องการ

การไซด์โหลดแทร็กคำบรรยาย

หากต้องการไซด์โหลดแทร็กคำบรรยาย คุณสามารถเพิ่มอินสแตนซ์ MediaItem.Subtitle ได้เมื่อสร้างรายการสื่อ ดังนี้

Kotlin

val subtitle =
  MediaItem.SubtitleConfiguration.Builder(subtitleUri)
    .setMimeType(mimeType) // The correct MIME type (required).
    .setLanguage(language) // The subtitle language (optional).
    .setSelectionFlags(selectionFlags) // Selection flags for the track (optional).
    .build()
val mediaItem =
  MediaItem.Builder().setUri(videoUri).setSubtitleConfigurations(listOf(subtitle)).build()

Java

MediaItem.SubtitleConfiguration subtitle =
    new MediaItem.SubtitleConfiguration.Builder(subtitleUri)
        .setMimeType(mimeType) // The correct MIME type (required).
        .setLanguage(language) // The subtitle language (optional).
        .setSelectionFlags(selectionFlags) // Selection flags for the track (optional).
        .build();
MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setSubtitleConfigurations(ImmutableList.of(subtitle))
        .build();

ภายใน DefaultMediaSourceFactory จะใช้ MergingMediaSource เพื่อรวมแหล่งที่มาของสื่อเนื้อหากับ SingleSampleMediaSource สำหรับแทร็กคำบรรยายแต่ละแทร็ก DefaultMediaSourceFactory ไม่รองรับการไซด์โหลดคำบรรยายสำหรับ DASH แบบหลายช่วงเวลา

การตัดคลิปสตรีมสื่อ

หากต้องการตัดเนื้อหาที่อ้างอิงโดยรายการสื่อ ให้ตั้งค่าตำแหน่งเริ่มต้นและสิ้นสุดที่กำหนดเอง ดังนี้

Kotlin

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setClippingConfiguration(
      MediaItem.ClippingConfiguration.Builder()
        .setStartPositionMs(startPositionMs)
        .setEndPositionMs(endPositionMs)
        .build()
    )
    .build()

Java

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setClippingConfiguration(
            new ClippingConfiguration.Builder()
                .setStartPositionMs(startPositionMs)
                .setEndPositionMs(endPositionMs)
                .build())
        .build();

ภายใน DefaultMediaSourceFactory จะใช้ ClippingMediaSource เพื่อรวมแหล่งที่มาของสื่อเนื้อหา มีพร็อพเพอร์ตี้การตัดคลิปเพิ่มเติม ดูรายละเอียดเพิ่มเติมได้ที่ MediaItem.Builder Javadoc

การแทรกโฆษณา

หากต้องการแทรกโฆษณา คุณควรตั้งค่าพร็อพเพอร์ตี้ URI ของแท็กโฆษณาของรายการสื่อดังนี้

Kotlin

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setAdsConfiguration(MediaItem.AdsConfiguration.Builder(adTagUri).build())
    .build()

Java

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
        .build();

ภายใน DefaultMediaSourceFactory จะรวมแหล่งที่มาของสื่อเนื้อหาไว้ใน AdsMediaSource เพื่อแทรกโฆษณาตามที่แท็กโฆษณากำหนด เพื่อให้ฟีเจอร์นี้ทำงานได้ โปรแกรมเล่นจะต้องกำหนดค่าDefaultMediaSourceFactoryให้สอดคล้องกันด้วย