วิธีการ

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

ใช้เวลาอ่าน 3 นาที
ดูโปรไฟล์ของ Toni Heidenreich
Toni Heidenreich วิศวกรซอฟต์แวร์, Android

Media3 1.11 พร้อมให้ใช้งานแล้ว การเปิดตัวครั้งนี้จะช่วยขับเคลื่อนแอปสื่อยอดนิยมส่วนใหญ่ใน Android โดยมาพร้อมฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงต่างๆ ในคอมโพเนนต์การเล่น การแก้ไข และ UI เรากำลังขยายโมดูล UI ของ Jetpack Compose ด้วยช่อง Player ที่ปรับแต่งได้และค่าเริ่มต้นที่ใช้งานง่าย, ท่าทางสัมผัสแบบอินเทอร์แอกทีฟ, ผู้สังเกตการณ์สถานะ และการโหลดวิดีโอแบบสั้นล่วงหน้าโดยใช้ PlayerPool นอกจากนี้ เรายังปรับปรุงการผสานรวม Media3 Cast ให้ทันสมัยด้วยการรองรับตัวสลับเอาต์พุต SystemUI, เปิดตัวส่วนขยายเครือข่ายไคลเอ็นต์ HTTP Ktor ใหม่ และเพิ่มยูทิลิตีการมัลติเพล็กซ์ใหม่สำหรับไฟล์ Ogg และ WAV

อ่านต่อเพื่อดูไฮไลต์สำคัญ และดูรายการการเปลี่ยนแปลงทั้งหมดได้ในบันทึกประจำรุ่นฉบับเต็ม

UI การเล่นและ Compose

เมื่อ Android เปลี่ยนมาใช้ Compose เป็นหลัก เราจึงขยายโมดูล media3-ui-compose และ media3-ui-compose-material3 อย่างต่อเนื่อง การอัปเดตนี้ช่วยให้คุณควบคุมเลย์เอาต์ของโปรแกรมเล่นได้ละเอียดยิ่งขึ้น มีรูปแบบการโต้ตอบที่สมบูรณ์ยิ่งขึ้น และผสานรวมกับ Material3 ได้ลึกซึ้งยิ่งขึ้น

เลย์เอาต์เพลเยอร์ที่ปรับแต่งได้

ตอนนี้คอมโพสิเบิล Player ของ Material 3 รองรับช่องเนื้อหาเฉพาะสำหรับ topControls, centerControls, bottomControls และ errorOverlay แล้ว คุณสามารถวาง Composable ของคุณเองหรือใช้ค่าเริ่มต้นที่สร้างไว้ล่วงหน้าซึ่งเผยแพร่ใน PlayerDefaults ได้ ดังนี้

Player(
  player = player,
  topControls = { PlayerDefaults.TopControls(player) },
  centerControls = { PlayerDefaults.CenterControls(player) },
  bottomControls = { PlayerDefaults.BottomControls(player) },
)

นอกจากนี้ Composable Player ยังผสานรวมการรองรับ FocusRequester ด้วย ซึ่งช่วยให้ไปยังส่วนต่างๆ ด้วย D-pad และแป้นพิมพ์ได้อย่างราบรื่นใน Android TV, อุปกรณ์แบบพับได้ และสภาพแวดล้อมเดสก์ท็อป 

player_video.png
ตัวอย่างสำหรับ Composable Player ที่มีตัวควบคุมที่กำหนดเอง

ท่าทางสัมผัสและการควบคุมความเร็วในการเล่น

ตอนนี้ PlaybackSpeedState มี API สำหรับการกรอไปข้างหน้า/สโลว์โมชันแล้ว demo-compose app แสดงให้เห็นถึงการใช้ท่าทางสัมผัสแบบกดค้างเพื่อกรอวิดีโอไปข้างหน้าและการกรอวิดีโอด้วยการแตะสองครั้ง เมื่อรวมกับ ProgressSlider ที่เปิดตัวในเวอร์ชัน 1.10 ตอนนี้ UI ของเพลเยอร์ Compose จะมอบการโต้ตอบด้วยการสัมผัสและท่าทางสัมผัสที่หลากหลายได้ทันที

การโหลดวิดีโอแบบสั้นล่วงหน้าด้วย PlayerPool

สำหรับแอปที่มีฟีดสื่อแบบหน้าต่างเลื่อน (เช่น วิดีโอแนวตั้งแบบสั้น) การจัดการอินสแตนซ์ ExoPlayer หลายรายการอย่างมีประสิทธิภาพถือเป็นความท้าทายที่พบได้ทั่วไป Media3 1.11 เปิดตัว PlayerPool (ใน common-ktx) และ rememberPooledPlayer (ใน ui-compose) เพื่อจัดการการรีไซเคิลเพลเยอร์และการโหลดล่วงหน้าโดยอัตโนมัติ

ShortFormPlayerScreen ใหม่ในdemo-composeแสดงให้เห็นถึงการทำงานนี้ ซึ่งเป็นฟีดการแบ่งหน้าแนวตั้งที่ผู้เล่นจะได้รับการรวมไว้ โหลดไว้ล่วงหน้า และรีไซเคิลอย่างราบรื่นเมื่อผู้ใช้เลื่อนดู

MiniController

MiniController Composable ใหม่ใน media3-ui-compose-material3 มีแถบการเล่นขนาดกะทัดรัดที่แสดงชื่อ ศิลปิน อาร์ตเวิร์ก และความคืบหน้าของรายการปัจจุบัน พร้อมด้วยตัวควบคุมการเล่น/หยุดชั่วคราว เช่นเดียวกับ Composable เริ่มต้นทั้งหมดใน media3-ui-compose-material3 MiniController รองรับการผสานรวมสีแบบไดนามิกของ Material3 ซึ่งช่วยให้ปรับให้เข้ากับธีมวอลเปเปอร์ของผู้ใช้โดยอัตโนมัติ เหมาะอย่างยิ่งสำหรับ Bottom Sheet แบบถาวรหรือความสามารถในการใช้งานมินิเพลเยอร์ เช่น ขณะที่ผู้ใช้เรียกดูเนื้อหาหรือระหว่างเซสชันการแคสต์ที่ใช้งานอยู่

mini_player.png
Media3 MiniController แสดงปกอัลบั้ม ข้อมูลเมตาของสื่อ และการควบคุมพื้นฐาน

ตัวเก็บสถานะแบบขยายสำหรับข้อมูลเมตาและข้อผิดพลาด

เราได้เพิ่มตัวเก็บสถานะแบบรีแอ็กทีฟใหม่หลายรายการลงใน media3-ui-compose ดังนี้

  • rememberCurrentMediaItemState – สังเกตข้อมูลเมตาเกี่ยวกับรายการที่กำลังเล่นอยู่
  • rememberPlaylistState – สังเกตเพลย์ลิสต์ทั้งหมดและดัชนีที่ใช้งานอยู่
  • rememberErrorState – ติดตามข้อผิดพลาดในการเล่น โดยมี Composable ErrorText ที่ตรงกันและ ErrorOverlay เริ่มต้นใน Material3

เราจะดำเนินการเพิ่มสิ่งใหม่ๆ และตัวเลือกการปรับแต่งเพิ่มเติมในรุ่นต่อๆ ไป โปรดแชร์ความคิดเห็นในIssue Tracker ของโปรเจ็กต์

การผสานรวม Cast ที่ทันสมัย

Media3 1.11 อัปเดตส่วนขยาย Cast ด้วยตัวเลือกการกำหนดค่าแบบเป็นโปรแกรมและการรองรับการกำหนดเส้นทางระดับระบบปฏิบัติการ

CastParams และตัวสลับเอาต์พุต SystemUI

ตอนนี้คุณสามารถกำหนดค่าส่วนขยาย Cast โดยใช้ CastParams ได้แล้ว

val castParams = CastParams.Builder()
  .setShowSystemOutputSwitcherOnCastButtonClick(true)
  .build()


Cast.getSingletonInstance(context).initialize(castParams)

การตั้งค่า setShowSystemOutputSwitcherOnCastIconClick(true) จะกำหนดค่า MediaRouteButton ให้เปิดตัวสลับเอาต์พุต SystemUI แบบเนทีฟของ Android ในเวอร์ชันแพลตฟอร์มที่รองรับ ซึ่งจะมอบประสบการณ์การใช้งานเครื่องมือเลือกเอาต์พุตแบบรวมศูนย์

สถานะ MediaRouteButton แบบรีแอ็กทีฟใน Compose

ตอนนี้แอปที่ใช้ Jetpack Compose สามารถเพิ่มปุ่มการกำหนดเส้นทางสื่อ (หรือที่เรียกว่าปุ่มแคสต์) ได้อย่างง่ายดาย ซึ่งจะตรวจสอบสถานะกล่องโต้ตอบและอัปเดตตามสถานะโดยอัตโนมัติ ไม่จำเป็นต้องใช้ตรรกะเพิ่มเติมเมื่อใช้ร่วมกับ CastPlayer ของ Media3

@Composable
fun TopAppBarWithCast() {
  Row {
    Text(text = "App Title")
    MediaRouteButton()
  }
}
cast_button_2.png
ปุ่มเส้นทางสื่อ Media3 ในแอปที่เปิดกล่องโต้ตอบตัวสลับเอาต์พุตเริ่มต้น

การปรับปรุงการเล่นและเซสชันหลัก

Eclipsa Video - ข้อมูลเมตา HDR แบบไดนามิกของ HAGC (API 37 ขึ้นไป)

Eclipsa Video มอบประสบการณ์ HDR ที่สอดคล้องกันมากขึ้นในอุปกรณ์ต่างๆ ด้วยสีขาว HDR พื้นฐานที่สอดคล้องกัน และเฮดรูมที่ปรับเปลี่ยนได้ตามหน้าจอและสภาพแวดล้อม เพื่อให้มั่นใจว่าความตั้งใจในการสร้างสรรค์จะยังคงอยู่บนอุปกรณ์ทั้งหมด

ตอนนี้ ExoPlayer รองรับการเล่นข้อมูลเมตาแบบกำหนดเวลา HAGC (ST 2094-50) ที่จำเป็นสำหรับสื่อแบบโปรเกรสซีฟ (MP4, Matroska) แล้ว เพลเยอร์จะผสานแทร็กข้อมูลเมตา HAGC กับแทร็กวิดีโอที่เกี่ยวข้องโดยอัตโนมัติ และส่งข้อมูลเมตาแบบ Out-of-Band ไปยังตัวถอดรหัสในอุปกรณ์ API 37 ขึ้นไป ในอุปกรณ์รุ่นเก่า ExoPlayer จะเปลี่ยนกลับไปมอบประสบการณ์การเล่น HDR มาตรฐานโดยไม่มีการปรับเปลี่ยนอย่างราบรื่น  

eclipsa.png
ภาพแสดงประโยชน์ของ Eclipsa Video HDR เช่น คอนทราสต์ของสีที่สม่ำเสมอมากขึ้น

ส่วนขยายไคลเอ็นต์ HTTP ของ Ktor ใหม่

โมดูลส่วนขยาย media3-datasource-ktor ใหม่มี KtorDataSource ซึ่งได้รับการสนับสนุนโดยสแต็ก HTTP ของ Ktor ซึ่งเป็นทางเลือกที่เน้น Kotlin และเป็นมิตรกับโครูทีนแทนโมดูลแหล่งข้อมูล Cronet และ OkHttp ที่มีอยู่

การเชื่อมต่อ MediaSession แบบอะซิงโครนัส

ตอนนี้ MediaSession.Callback มี onConnectAsync() ซึ่งช่วยให้คุณประมวลผลการพยายามเชื่อมต่อตัวควบคุมแบบอะซิงโครนัสได้ เช่น เพื่อยืนยันการให้สิทธิ์ก่อนยอมรับการเชื่อมต่อ คุณสามารถแสดงผล Future ทันทีด้วย Futures.immediateFuture(ConnectionResult) เพื่อให้มีลักษณะการทำงานเหมือนกับ onConnect ที่มีอยู่ 

override fun onConnectAsync(
  session: MediaSession,
  controller: MediaSession.ControllerInfo
): ListenableFuture<MediaSession.ConnectionResult> {
  return authenticateControllerAsync(controller)
}

ค่าเริ่มต้นของ MediaSession ที่ปลอดภัยยิ่งขึ้น

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

การติดตั้งใช้งาน Muxer ใหม่และการแยกวิเคราะห์คอนเทนเนอร์

OggMuxer และ WavMuxer

เราได้เพิ่ม Muxer เฉพาะใหม่ 2 รายการ ได้แก่ OggMuxer สำหรับการมัลติเพล็กซ์สตรีม OPUS และ VORBIS เป็นไฟล์ .ogg มาตรฐาน และ WavMuxer สำหรับสร้างไฟล์เสียง .wav PCM แบบไม่บีบอัดและแบบจุดลอยตัว

การแยกวิเคราะห์คอนเทนเนอร์และการอ้างอิงแทร็ก

  • การอ้างอิงแทร็ก MP4 (tref): Mp4Muxer.addTrackReference ช่วยให้สามารถลิงก์ข้อมูลเมตาที่ขึ้นต่อกันหรือแทร็กเสริมกับสตรีมวิดีโอหลักได้
  • การแยกบท: ตอนนี้ระบบจะแยกบท QuickTime และ Nero จากไฟล์ MP4 (.m4a, .m4b) และบท Matroska เป็นรายการข้อมูลเมตา Chapter สำหรับการไปยังส่วนต่างๆ ของหนังสือเสียงและพอดแคสต์

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

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