ข่าวสารเกี่ยวกับผลิตภัณฑ์

Media3 1.9.0 - มีอะไรใหม่

ใช้เวลาอ่าน 6 นาที
ดูโปรไฟล์ของ Kristina Simakova
Kristina Simakova ผู้จัดการฝ่ายวิศวกรรม

Media3 1.9.0 เปิดตัวแล้ว นอกจากการแก้ไขข้อบกพร่องและการปรับปรุงประสิทธิภาพตามปกติแล้ว เวอร์ชันล่าสุดยังมีโมดูลใหม่หรือโมดูลที่เขียนใหม่เป็นส่วนใหญ่ 4 รายการ ดังนี้

  • media3-inspector - ดึงข้อมูลเมตาและเฟรมนอกการเล่น
  • media3-ui-compose-material3 - สร้าง UI สื่อ Compose ของ Material3 พื้นฐานในไม่กี่ขั้นตอน
  • media3-cast - จัดการการเปลี่ยนระหว่างการเล่นผ่าน Cast และการเล่นในเครื่องโดยอัตโนมัติ
  • media3-decoder-av1 - การเล่น AV1 ที่สอดคล้องกันด้วยตัวถอดรหัสส่วนขยายที่เขียนใหม่โดยอิงตามไลบรารี dav1d

นอกจากนี้ เรายังเพิ่มการปรับปรุงการแคชและการจัดการหน่วยความจำใน PreloadManager รวมถึงปรับปรุง ExoPlayer, Transformer และ MediaSession ให้ใช้งานง่ายขึ้น 

นอกจากนี้ รุ่นนี้ยังให้สิทธิ์เข้าถึง CompositionPlayer เวอร์ชันทดลองเป็นครั้งแรกเพื่อดูตัวอย่างการแก้ไขสื่อ  


อ่านต่อเพื่อดูข้อมูลเพิ่มเติม และโปรดดูบันทึกประจำรุ่นฉบับเต็มเพื่อดูภาพรวมที่ครอบคลุมของการเปลี่ยนแปลงในรุ่นนี้

ดึงข้อมูลเมตาและเฟรมนอกการเล่น

มีหลายกรณีที่คุณอาจต้องการตรวจสอบสื่อโดยไม่ต้องเริ่มเล่น เช่น คุณอาจต้องการตรวจหาว่าไฟล์มีรูปแบบใดหรือมีระยะเวลาเท่าใด หรือต้องการดึงข้อมูลภาพปก

โมดูล media3-inspector ใหม่รวมยูทิลิตีทั้งหมดเพื่อตรวจสอบสื่อโดยไม่ต้องเล่นไว้ในที่เดียว ดังนี้

  • MetadataRetriever เพื่ออ่านระยะเวลา รูปแบบ และข้อมูลเมตาแบบคงที่จาก MediaItem
  • FrameExtractor เพื่อรับเฟรมหรือภาพปกจากรายการ
  • MediaExtractorCompat เป็นการแทนที่โดยตรงสำหรับคลาส MediaExtractor ของแพลตฟอร์ม Android เพื่อดูข้อมูลโดยละเอียดเกี่ยวกับตัวอย่างในไฟล์

MetadataRetriever และ FrameExtractor เป็นไปตามรูปแบบ AutoCloseable ง่ายๆ ดูรายละเอียดเพิ่มเติมได้ที่หน้าคำแนะนำใหม่

suspend fun extractThumbnail(mediaItem: MediaItem) {

  FrameExtractor.Builder(context, mediaItem).build().use {

    val thumbnail = frameExtractor.getThumbnail().await()

  } 

}

สร้าง UI สื่อ Compose ของ Material3 พื้นฐานได้ในไม่กี่ขั้นตอน

ในรุ่นก่อนหน้า เราได้เริ่มจัดเตรียมโค้ดเครื่องมือเชื่อมต่อระหว่างองค์ประกอบ UI ของ Compose กับอินสแตนซ์ Player ใน Media3 1.9.0 เราได้เพิ่มโมดูลใหม่ media3-ui-compose-material3 ที่มีปุ่มและองค์ประกอบเนื้อหา Material3 ที่มีสไตล์ครบถ้วน ซึ่งช่วยให้คุณสร้าง UI สื่อได้ในไม่กี่ขั้นตอน พร้อมทั้งให้ความยืดหยุ่นในการปรับแต่งรูปแบบที่กำหนดเอง หากต้องการสร้างสไตล์ UI ของคุณเอง คุณสามารถใช้ Building Block ที่ดูแลตรรกะการอัปเดตและการเชื่อมต่อทั้งหมด เพื่อให้คุณมุ่งเน้นเฉพาะการออกแบบองค์ประกอบ UI เท่านั้น โปรดดูหน้าคำแนะนำเพิ่มเติมสำหรับโมดูล Compose UI

นอกจากนี้ เรายังคงพัฒนาคอมโพเนนต์ Compose เพิ่มเติม เช่น แถบเลื่อนที่สร้างไว้ล่วงหน้า ซึ่งเป็นคอมโพเนนต์ที่พร้อมใช้งานทันทีเพื่อแทนที่ PlayerView รวมถึงการผสานรวมคำบรรยายและโฆษณา

@Composable
fun SimplePlayerUI(player: Player, modifier: Modifier = Modifier) {
  Column(modifier) {
    ContentFrame(player)  // Video surface and shutter logic
    Row (Modifier.align(Alignment.CenterHorizontally)) {                 
      SeekBackButton(player)   // Simple controls
      PlayPauseButton(player)
      SeekForwardButton(player)
    }
  }
}

 

image.png

UI ของเพลเยอร์ Compose ที่เรียบง่ายพร้อมองค์ประกอบที่พร้อมใช้งานทันที

จัดการการเปลี่ยนระหว่างการเล่นผ่าน Cast และการเล่นในเครื่องโดยอัตโนมัติ

CastPlayer ในโมดูล media3-cast ได้รับการเขียนใหม่เพื่อจัดการการเปลี่ยนระหว่างการเล่นในเครื่อง (เช่น ด้วย ExoPlayer) และการเล่น Cast ระยะไกลโดยอัตโนมัติ

เมื่อตั้งค่า MediaSession คุณเพียงแค่สร้าง CastPlayer รอบๆ ExoPlayer และเพิ่ม MediaRouteButton ลงใน UI ก็เป็นอันเสร็จสิ้น

// MediaSession setup with CastPlayer 

val exoPlayer = ExoPlayer.Builder(context).build()

val castPlayer = CastPlayer.Builder(context).setLocalPlayer(exoPlayer).build()

val session = MediaSession.Builder(context, castPlayer).build()

// MediaRouteButton in UI 

@Composable fun UIWithMediaRouteButton() {

  MediaRouteButton()

}
image.png

การผสานรวม CastPlayer ใหม่ในแอปสาธิตเซสชัน Media3

การเล่น AV1 ที่สอดคล้องกันด้วยส่วนขยายที่เขียนใหม่โดยอิงตาม dav1d

รุ่น 1.9.0 มีโมดูลส่วนขยาย AV1 ที่เขียนใหม่ทั้งหมดโดยอิงตามไลบรารี dav1d ยอดนิยม 

เช่นเดียวกับโมดูลตัวถอดรหัสส่วนขยายทั้งหมด โปรดทราบว่าคุณต้องสร้างจากแหล่งที่มาเพื่อรวมโค้ดแบบเนทีฟที่เกี่ยวข้องอย่างถูกต้อง การรวมตัวถอดรหัสจะช่วยให้การรองรับรูปแบบและอุปกรณ์ทั้งหมดมีความสอดคล้องกัน แต่เนื่องจากตัวถอดรหัสจะทำงานในกระบวนการของคุณ จึงเหมาะที่สุดสำหรับเนื้อหาที่คุณเชื่อถือ 

ผสานรวมการแคชและการจัดการหน่วยความจำเข้ากับ PreloadManager

เราได้ปรับปรุง PreloadManager ให้ดียิ่งขึ้นด้วย ซึ่งช่วยให้คุณโหลดสื่อไว้ล่วงหน้าในหน่วยความจำนอกการเล่นได้อยู่แล้ว จากนั้นจึงส่งสื่อไปยังเพลเยอร์ได้อย่างราบรื่นเมื่อจำเป็น แม้ว่าจะมีประสิทธิภาพค่อนข้างดี แต่คุณก็ยังต้องระวังไม่ให้ใช้หน่วยความจำเกินขีดจำกัดโดยการโหลดล่วงหน้ามากเกินไปโดยไม่ตั้งใจ ดังนั้นใน Media3 1.9.0 เราจึงเพิ่มฟีเจอร์ 2 รายการที่ช่วยให้การดำเนินการนี้ง่ายและเสถียรยิ่งขึ้น ดังนี้

  1. การรองรับการแคช - เมื่อกำหนดระยะเวลาที่จะโหลดล่วงหน้า ตอนนี้คุณสามารถเลือก PreloadStatus.specifiedRangeCached(0, 5000) เป็นสถานะเป้าหมายสำหรับรายการที่โหลดล่วงหน้าได้แล้ว ซึ่งจะเพิ่มช่วงที่ระบุลงในแคชบนดิสก์แทนการโหลดข้อมูลลงในหน่วยความจำ ซึ่งจะช่วยให้คุณระบุรายการที่หลากหลายมากขึ้นสำหรับการโหลดล่วงหน้าได้ เนื่องจากรายการที่อยู่ห่างจากรายการปัจจุบันไม่จำเป็นต้องใช้หน่วยความจำอีกต่อไป โปรดทราบว่าคุณต้องตั้งค่า Cache ใน DefaultPreloadManager.Builder
  2. การจัดการหน่วยความจำอัตโนมัติ – เรายังได้อัปเดตอินเทอร์เฟซ LoadControl เพื่อจัดการเคสการโหลดล่วงหน้าได้ดียิ่งขึ้น ตอนนี้คุณจึงสามารถกำหนดขีดจำกัดหน่วยความจำสูงสุดที่ชัดเจนสำหรับรายการที่โหลดล่วงหน้าทั้งหมดในหน่วยความจำได้แล้ว โดยค่าเริ่มต้นคือ 144 MB และคุณสามารถกำหนดค่าขีดจำกัดได้ใน DefaultLoadControl.Builder DefaultPreloadManager จะหยุดโหลดล่วงหน้าโดยอัตโนมัติเมื่อถึงขีดจำกัด และจะปล่อยหน่วยความจำของรายการที่มีลำดับความสำคัญต่ำกว่าโดยอัตโนมัติหากจำเป็น

ใช้ลักษณะการทำงานเริ่มต้นแบบใหม่ที่เรียบง่ายขึ้นใน ExoPlayer

และเช่นเคย เราได้เพิ่มการปรับปรุงที่เพิ่มขึ้นจำนวนมากให้กับ ExoPlayer ด้วย ตัวอย่างเช่น

  • ปิดเสียงและเปิดเสียง - เรามีเมธอด setVolume อยู่แล้ว แต่ตอนนี้ได้เพิ่มเมธอด mute และ unmute เพื่อความสะดวกในการคืนค่าระดับเสียงก่อนหน้าได้อย่างง่ายดายโดยไม่ต้องติดตามด้วยตนเอง
  • การตรวจหาเพลเยอร์ที่ค้าง – ในบางกรณีที่พบได้ไม่บ่อย เพลเยอร์อาจค้างอยู่ในสถานะบัฟเฟอร์หรือเล่นโดยไม่มีความคืบหน้า เช่น เนื่องจากปัญหาเกี่ยวกับตัวแปลงรหัสหรือการกำหนดค่าที่ไม่ถูกต้อง ผู้ใช้จะรู้สึกรำคาญ แต่คุณจะไม่เห็นปัญหาเหล่านี้ในข้อมูลวิเคราะห์ เพื่อให้เห็นได้ชัดเจนยิ่งขึ้น ตอนนี้โปรแกรมเล่นจะรายงาน StuckPlayerException เมื่อตรวจพบสถานะค้าง
  • Wakelock โดยค่าเริ่มต้น – ก่อนหน้านี้ การจัดการ Wake Lock เป็นแบบเลือกใช้ ส่งผลให้ค้นหาเคสที่ผิดปกติได้ยาก ซึ่งความคืบหน้าในการเล่นอาจล่าช้ามากเมื่อทำงานในเบื้องหลัง ตอนนี้ฟีเจอร์นี้เป็นแบบเลือกไม่ใช้ คุณจึงไม่ต้องกังวลเกี่ยวกับฟีเจอร์นี้ และยังนำการจัดการ Wake Lock ด้วยตนเองทั้งหมดเกี่ยวกับการเล่นออกได้ด้วย
  • การตั้งค่าที่เรียบง่ายขึ้นสำหรับตรรกะของปุ่ม CC – การเปลี่ยน TrackSelectionParameters ให้เป็น "เปิด/ปิดคำบรรยาย" นั้นทำได้ยากอย่างน่าประหลาดใจ เราจึงเพิ่มตัวเลือกบูลีน selectTextByDefault แบบง่ายสำหรับกรณีการใช้งานนี้

ลดความซับซ้อนของค่ากำหนดปุ่มสื่อใน MediaSession

ก่อนหน้านี้ การกำหนดค่ากำหนดสำหรับปุ่มที่ควรแสดงในลิ้นชักการแจ้งเตือนสื่อบน Android Auto หรือ WearOS จำเป็นต้องกำหนดคำสั่งและปุ่มที่กำหนดเอง แม้ว่าคุณจะเพียงต้องการเรียกใช้เมธอดเพลเยอร์มาตรฐานก็ตาม

Media3 1.9.0 มีฟังก์ชันการทำงานใหม่ที่ช่วยให้การดำเนินการนี้ง่ายขึ้นมาก โดยตอนนี้คุณสามารถกำหนดค่ากำหนดปุ่มสื่อด้วยคำสั่งเพลเยอร์มาตรฐานได้แล้ว โดยไม่จำเป็นต้องจัดการคำสั่งที่กำหนดเองเลย

session.setMediaButtonPreferences(listOf(
    CommandButton.Builder(CommandButton.ICON_FAST_FORWARD) // choose an icon
      .setDisplayName(R.string.skip_forward)
      .setPlayerCommand(Player.COMMAND_SEEK_FORWARD) // choose an action 
      .build()
))
image.png

ค่ากำหนดปุ่มสื่อที่มีปุ่มกรอไปข้างหน้า

CompositionPlayer สำหรับการแสดงตัวอย่างแบบเรียลไทม์

รุ่น 1.9.0 เปิดตัว CompositionPlayer ภายใต้คำอธิบายประกอบ @ExperimentalApi ใหม่ คำอธิบายประกอบระบุว่าพร้อมให้ทดสอบ แต่ยังอยู่ระหว่างการพัฒนา 

CompositionPlayer เป็นคอมโพเนนต์ใหม่ใน API การแก้ไข Media3 ที่ออกแบบมาสำหรับการแสดงตัวอย่างการแก้ไขสื่อแบบเรียลไทม์ CompositionPlayer สร้างขึ้นบนอินเทอร์เฟซ Media3 Player ที่คุ้นเคย ซึ่งช่วยให้ผู้ใช้เห็นการเปลี่ยนแปลงที่เกิดขึ้นจริงก่อนที่จะเริ่มกระบวนการส่งออก โดยจะใช้ออบเจ็กต์ Composition เดียวกับที่คุณส่งไปยัง Transformer เพื่อส่งออก ซึ่งจะช่วยปรับปรุงเวิร์กโฟลว์การแก้ไขให้มีประสิทธิภาพมากขึ้นด้วยการรวมโมเดลข้อมูลสำหรับการแสดงตัวอย่างและการส่งออกเข้าด้วยกัน

เราขอแนะนำให้คุณเริ่มใช้ CompositionPlayer และแชร์ความคิดเห็น รวมถึงคอยติดตามโพสต์และการอัปเดตเอกสารประกอบที่กำลังจะมาถึงเพื่อดูรายละเอียดเพิ่มเติม

InAppMuxer เป็น Muxer เริ่มต้นใน Transformer

ตอนนี้ Transformer ใช้ InAppMp4Muxer เป็น Muxer เริ่มต้นสำหรับการเขียนไฟล์คอนเทนเนอร์สื่อ ภายใน InAppMp4Muxer จะขึ้นอยู่กับโมดูล Muxer ของ Media3 ซึ่งจะให้ลักษณะการทำงานที่สอดคล้องกันใน API ทุกเวอร์ชัน 

โปรดทราบว่าแม้ Transformer จะไม่ได้ใช้ MediaMuxer ของแพลตฟอร์ม Android โดยค่าเริ่มต้นอีกต่อไป แต่คุณยังคงระบุ FrameworkMuxer.Factory ผ่าน setMuxerFactory ได้หากกรณีการใช้งานของคุณกำหนดให้ต้องใช้

API การปรับความเร็วใหม่

รุ่น 1.9.0 ช่วยให้ API การปรับความเร็วสำหรับการตัดต่อสื่อใช้งานได้ง่ายขึ้น เราได้เปิดตัวเมธอดใหม่ใน EditedMediaItem.Builder โดยตรงเพื่อควบคุมความเร็ว ซึ่งทำให้ API ใช้งานง่ายขึ้น ตอนนี้คุณเปลี่ยนความเร็วของคลิปได้โดยเรียกใช้ setSpeed(SpeedProvider provider) ใน EditedMediaItem.Builder ดังนี้

val speedProvider = object : SpeedProvider {
    override fun getSpeed(presentationTimeUs: Long): Float {
        return speed
    }

    override fun getNextSpeedChangeTimeUs(timeUs: Long): Long {
        return C.TIME_UNSET
    }
}

EditedMediaItem speedEffectItem = EditedMediaItem.Builder(mediaItem)
    .setSpeed(speedProvider)
    .build()

แนวทางใหม่นี้จะแทนที่วิธีการใช้ Effects#createExperimentalSpeedChangingEffects() ก่อนหน้านี้ ซึ่งเราได้เลิกใช้งานแล้วและจะนำออกในรุ่นต่อๆ ไป

ขอแนะนำประเภทแทร็กสำหรับ EditedMediaItemSequence 

ในรุ่น 1.9.0 EditedMediaItemSequence กำหนดให้ระบุประเภทแทร็กเอาต์พุตที่ต้องการในระหว่างการสร้างลำดับ การเปลี่ยนแปลงนี้ช่วยให้มั่นใจได้ว่าการจัดการแทร็กจะชัดเจนและมีประสิทธิภาพมากขึ้นตลอดทั้ง Composition 

โดยทำผ่านตัวสร้าง EditedMediaItemSequence.Builder ใหม่ที่ยอมรับชุดประเภทแทร็ก (เช่น C.TRACK_TYPE_AUDIO, C.TRACK_TYPE_VIDEO) 

เราได้เพิ่มเมธอดแบบคงที่ใหม่เพื่อความสะดวกในการสร้าง ดังนี้

  • EditedMediaItemSequence.withAudioFrom(List<EditedMediaItem>)
  • EditedMediaItemSequence.withVideoFrom(List<EditedMediaItem>)
  • EditedMediaItemSequence.withAudioAndVideoFrom(List<EditedMediaItem>)

เราขอแนะนำให้คุณย้ายข้อมูลไปยังคอนสตรัคเตอร์ใหม่หรือเมธอดที่สะดวกเพื่อคำจำกัดความของลำดับที่ชัดเจนและเชื่อถือได้มากขึ้น

ตัวอย่างการสร้างลำดับที่มีเฉพาะวิดีโอ

EditedMediaItemSequence videoOnlySequence =
    EditedMediaItemSequence.Builder(setOf(C.TRACK_TYPE_VIDEO))
        .addItem(editedMediaItem)
        .build()

โปรดติดต่อเราผ่านเครื่องมือติดตามปัญหาของ Media3 หากพบข้อบกพร่อง หรือหากมีคำถามหรือคำขอฟีเจอร์ เราหวังเป็นอย่างยิ่งว่าจะได้รับการติดต่อจากคุณ

เขียนโดย
อ่านต่อ