ExoPlayer รองรับ SmoothStreaming ด้วยรูปแบบคอนเทนเนอร์ FMP4 สตรีมสื่อต้องได้รับการแยกข้อมูล ซึ่งหมายความว่าต้องกำหนดวิดีโอ เสียง และข้อความในองค์ประกอบ StreamIndex ที่ต่างกันในไฟล์ Manifest ของ SmoothStreaming นอกจากนี้ยังต้องรองรับรูปแบบเสียงและวิดีโอตัวอย่างที่มีอยู่ด้วย (ดูรายละเอียดในส่วนรูปแบบตัวอย่าง)
ฟีเจอร์ | รองรับ | ความคิดเห็น |
---|---|---|
คอนเทนเนอร์ | ||
FMP4 | ใช่ | สตรีมที่แยกข้อมูลออกแล้วเท่านั้น |
คำบรรยายแทนเสียง/คำบรรยายวิดีโอ | ||
TTML | ใช่ | ฝังอยู่ใน FMP4 |
การปกป้องเนื้อหา | ||
PlayReady SL2000 | ใช่ | Android TV เท่านั้น |
การเล่นแบบสด | ||
การเล่นแบบสดปกติ | ใช่ | |
ข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) | ใช่ | คู่มือการผสานรวม |
การใช้ MediaItem
หากต้องการเล่นสตรีม SmoothStreaming คุณต้องใช้ข้อบังคับของ SmoothStreaming
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.4.1"
จากนั้นคุณจะสร้าง MediaItem
สำหรับไฟล์ Manifest แบบ SmoothStreaming และส่งไปยังโปรแกรมเล่นได้
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(ssUri)) // 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(ssUri)); // Prepare the player. player.prepare();
หาก URI ไม่ได้ลงท้ายด้วย .ism/Manifest
คุณสามารถส่ง MimeTypes.APPLICATION_SS
ไปยัง setMimeType
ของ MediaItem.Builder
เพื่อระบุประเภทเนื้อหาอย่างชัดเจน
ExoPlayer จะปรับเปลี่ยนรูปแบบการนำเสนอที่กำหนดไว้ในไฟล์ Manifest โดยอัตโนมัติ โดยคำนึงถึงทั้งความสามารถของอุปกรณ์และแบนด์วิดท์ที่มีอยู่
การใช้ SsMediaSource
หากต้องการตัวเลือกการปรับแต่งเพิ่มเติม คุณอาจสร้าง SsMediaSource
และส่งไปยังโปรแกรมเล่นโดยตรงแทน MediaItem
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a SmoothStreaming media source pointing to a manifest uri. val mediaSource: MediaSource = SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a SmoothStreaming media source pointing to a manifest uri. MediaSource mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)); // Create a player instance. 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
สำหรับ SmoothStreaming คุณควรแคสต์วัตถุที่แสดงผลไปยัง SsManifest
จะมีการเรียกใช้ 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 SsManifest) { // 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) { SsManifest ssManifest = (SsManifest) manifest; // Do something with the manifest. } } });
การปรับแต่งการเล่น
ExoPlayer มีวิธีต่างๆ ในการปรับแต่งประสบการณ์การเล่นให้เหมาะกับความต้องการของแอป ดูตัวอย่างได้ที่หน้าการปรับแต่ง