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ให้สอดคล้องกันด้วย