Media3

เวอร์ชัน 1.5.0-rc01

13 พฤศจิกายน 2024

เวอร์ชัน 1.5.0-beta01

30 ตุลาคม 2024

เวอร์ชัน 1.5.0-alpha01

10 กันยายน 2024

เวอร์ชัน 1.4.0

เวอร์ชัน 1.4.1

27 สิงหาคม 2024

androidx.media3:media3-*:1.4.1 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.1 มีการคอมมิตเหล่านี้

ExoPlayer:
- จัดการการเรียกกลับการโหลดล่วงหน้าแบบไม่พร้อมกันใน PreloadMediaSource (#1568)
- อนุญาตให้เล่นวิดีโอต่อไม่ว่าระยะเวลาที่บัฟเฟอร์ไว้จะนานเท่าใดก็ตามเมื่อโหลดไม่สำเร็จ (#1571)
เครื่องมือแยกข้อมูล:
- MP3: แก้ไขข้อผิดพลาด Searched too many bytes โดยไม่สนใจข้อมูลส่วนท้ายที่ไม่ใช่ MP3 อย่างถูกต้องตามช่องความยาวในเฟรม Info (#1480)
ข้อความ:
- TTML: แก้ไขการจัดการค่า tts:fontSize ที่เป็นเปอร์เซ็นต์เพื่อให้รับค่าจากโหนดหลักที่มีค่า tts:fontSize ที่เป็นเปอร์เซ็นต์อย่างถูกต้อง
- แก้ไข IndexOutOfBoundsException ใน LegacySubtitleUtil เนื่องจากมีการจัดการกรณีที่เวลาเริ่มต้นของเอาต์พุตที่ขอมากกว่าหรือเท่ากับเวลาของเหตุการณ์สุดท้ายใน Subtitle อย่างไม่ถูกต้อง (#1516)
DRM:
- แก้ไขข้อผิดพลาด android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE ในอุปกรณ์ที่ใช้ API 31 ขึ้นไปขณะเล่นเนื้อหา Widevine ระดับ L1 ข้อผิดพลาดนี้เกิดจากการใช้งานเฟรมเวิร์กMediaDrm.requiresSecureDecoder (#1603) ที่ไม่สมบูรณ์
ผล:
- เพิ่มวิธีการ release() ลงใน GlObjectsProvider
เซสชัน:
- เปลี่ยนการแตะ 2 ครั้งของ KEYCODE_HEADSETHOOK เป็นการดำเนินการ "กรอไปยังรายการถัดไป" ตามที่ระบุไว้ (#1493)
- จัดการ KEYCODE_HEADSETHOOK เป็นคําสั่ง "เล่น" ใน MediaButtonReceiver เมื่อตัดสินใจว่าจะละเว้นหรือไม่เพื่อหลีกเลี่ยง ForegroundServiceDidNotStartInTimeException (#1581)
ส่วนขยาย RTSP:
- ข้ามคำอธิบายสื่อที่ไม่ถูกต้องในการแยกวิเคราะห์ SDP (#1087)

เวอร์ชัน 1.4.0

25 กรกฎาคม 2024

androidx.media3:media3-*:1.4.0 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0 มีการคอมมิตเหล่านี้

คลังทั่วไป:
- ส่งต่อการเรียกใช้การค้นหาที่ถือว่าไม่มีการดำเนินการไปยังเมธอด BasePlayer.seekTo() และ SimpleBasePlayer.handleSeek() ที่ปกป้องแทนการละเว้น หากใช้เมธอดเหล่านี้ในโปรแกรมเล่นที่กำหนดเอง คุณอาจต้องจัดการการเรียกเพิ่มเติมเหล่านี้ด้วย mediaItemIndex == C.INDEX_UNSET
- นำการพึ่งพาการคอมไพล์ในการแปลง Sugar ของ Java 8 ที่ปรับปรุงแล้วออก (#1312)
- ตรวจสอบว่าระบบจะไม่สนใจระยะเวลาที่ส่งไปยัง MediaItem.Builder.setImageDurationMs() สำหรับ MediaItem ที่ไม่ใช่รูปภาพ (ตามที่ระบุไว้ในเอกสารประกอบ)
- เพิ่ม Format.customData เพื่อจัดเก็บข้อมูลที่กําหนดเองซึ่งแอประบุเกี่ยวกับFormatอินสแตนซ์
ExoPlayer:
- เพิ่ม BasePreloadManager ซึ่งจะประสานการโหลดล่วงหน้าสำหรับแหล่งที่มาหลายแห่งตามลำดับความสำคัญที่กำหนดโดย rankingData คุณสามารถปรับแต่งได้โดยขยายคลาสนี้ เพิ่ม DefaultPreloadManager ซึ่งใช้ PreloadMediaSource เพื่อโหลดตัวอย่างสื่อจากแหล่งที่มาลงในหน่วยความจำล่วงหน้า และใช้จำนวนเต็ม rankingData ที่ระบุดัชนีของรายการใน UI
- เพิ่ม PlayerId ลงในเมธอดส่วนใหญ่ของ LoadControl เพื่อเปิดใช้การติดตั้งใช้งาน LoadControl ที่รองรับผู้เล่นหลายคน
- นำ Buffer.isDecodeOnly() และ C.BUFFER_FLAG_DECODE_ONLY ออก คุณไม่จำเป็นต้องตั้งค่า Flag นี้เนื่องจากโปรแกรมแสดงผลและโปรแกรมถอดรหัสจะตัดสินใจข้ามบัฟเฟอร์ตามการประทับเวลา การติดตั้งใช้งาน Renderer ที่กําหนดเองควรตรวจสอบว่าเวลาบัฟเฟอร์อย่างน้อย BaseRenderer.getLastResetPositionUs() เพื่อตัดสินใจว่าควรแสดงตัวอย่างหรือไม่ การใช้งาน SimpleDecoder ที่กําหนดเองจะตรวจสอบได้ isAtLeastOutputStartTimeUs() หากจําเป็น หรือทําเครื่องหมายบัฟเฟอร์อื่นๆ ด้วย DecoderOutputBuffer.shouldBeSkipped เพื่อข้ามบัฟเฟอร์เหล่านั้น
- อนุญาตให้ TargetPreloadStatusControl.getTargetPreloadStatus(T) แสดงผลค่า Null เพื่อระบุว่าไม่โหลด MediaSource ล่วงหน้าด้วย rankingData ที่ระบุ
- เพิ่ม remove(MediaSource) ไปยัง BasePreloadManager
- เพิ่ม reset() ลงใน BasePreloadManager เพื่อปล่อยแหล่งที่มาที่ถือครองทั้งหมดขณะเก็บอินสแตนซ์ตัวจัดการการโหลดล่วงหน้าไว้
- เพิ่ม ExoPlayer.setPriority() (และ Builder.setPriority()) เพื่อกำหนดค่าลําดับความสําคัญที่ใช้ใน PriorityTaskManager และความสําคัญของ MediaCodec จาก API 35
- แก้ไขปัญหาการอัปเดตเวลาในการบัฟเฟอร์ใหม่ครั้งล่าสุดซึ่งส่งผลให้คีย์ bs (บัฟเฟอร์ไม่เพียงพอ) ใน CMCD ไม่ถูกต้อง (#1124)
- เพิ่ม PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) เพื่อระบุว่าโหลดแหล่งที่มาจนจบแล้ว ซึ่งจะช่วยให้การติดตั้งใช้งาน DefaultPreloadManager และPreloadMediaSource.PreloadControlที่กำหนดเองสามารถโหลดแหล่งที่มาถัดไปล่วงหน้าหรือดำเนินการอื่นๆ ได้
- แก้ไขข้อบกพร่องที่การข้ามช่วงเงียบที่ท้ายรายการอาจทริกเกอร์ข้อยกเว้นการเล่น
- เพิ่ม clear ลงใน PreloadMediaSource เพื่อทิ้งระยะเวลาการโหลดล่วงหน้า
- เพิ่มรหัสข้อผิดพลาดใหม่ PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED ที่ใช้เมื่อมีการเรียกคืนทรัพยากรโค้ดสำหรับงานที่มีลำดับความสำคัญสูงกว่า
- อนุญาตให้ AdsMediaSource โหลดโฆษณาตอนต้นก่อนที่การเตรียมสื่อเนื้อหาเริ่มต้นจะเสร็จสมบูรณ์ (#1358)
- แก้ไขข้อบกพร่องที่การเล่นย้ายไปที่ STATE_ENDED เมื่อเตรียมสตรีมแบบสด DASH แบบหลายช่วงเวลาอีกครั้งหลังจากที่นำช่วงเวลาเดิมออกจากไฟล์ Manifest แล้ว
- เปลี่ยนชื่อ onTimelineRefreshed() เป็น onSourcePrepared() และ onPrepared() เป็น onTracksSelected() ใน PreloadMediaSource.PreloadControl และเปลี่ยนชื่อ IntDefs ใน DefaultPreloadManager.Stage ด้วย
- เพิ่มการรองรับแบบทดลองสำหรับการกำหนดเวลาแบบไดนามิกเพื่อปรับให้การทำงานสอดคล้องกับรอบการตื่นของ CPU ได้ดียิ่งขึ้น และเลื่อนเวลาการตื่นขึ้นเพื่อรอให้โปรแกรมแสดงผลทำงานได้ คุณสามารถเปิดใช้โดยใช้ experimentalSetDynamicSchedulingEnabled() เมื่อตั้งค่าอินสแตนซ์ ExoPlayer
- เพิ่ม Renderer.getDurationToProgressUs() Renderer สามารถใช้วิธีนี้เพื่อส่งกลับระยะเวลาที่การเล่นต้องส่งต่อไปยัง ExoPlayer เพื่อให้โปรแกรมแสดงผลทำงานต่อไปได้ หากตั้งค่า ExoPlayer ด้วย experimentalSetDynamicSchedulingEnabled() ExoPlayer จะเรียกใช้เมธอดนี้เมื่อคำนวณเวลาเพื่อกำหนดเวลางาน
- เพิ่ม MediaCodecAdapter#OnBufferAvailableListener เพื่อแจ้งเตือนเมื่อบัฟเฟอร์อินพุตและเอาต์พุตพร้อมให้ MediaCodecRenderer ใช้ MediaCodecRenderer จะส่งสัญญาณให้ ExoPlayer เมื่อได้รับการเรียกกลับเหล่านี้ และหากตั้งค่า ExoPlayer ด้วย experimentalSetDynamicSchedulingEnabled() แล้ว ExoPlayer จะกำหนดเวลาลูปการทำงานเมื่อโปรแกรมแสดงผลทํางานได้
- ใช้คลาสข้อมูลสําหรับเมธอด LoadControl แทนพารามิเตอร์แต่ละรายการ
- เพิ่ม ExoPlayer.isReleased() เพื่อตรวจสอบว่ามีเรียกใช้ Exoplayer.release() หรือไม่
- เพิ่ม ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() เพื่อกําหนดค่าตําแหน่งสูงสุดที่ seekToPrevious() จะเลื่อนไปยังรายการก่อนหน้า (#1425)
- แก้ไขความไม่สอดคล้องกันของโฟกัสเสียงบางรายการ เช่น ไม่รายงานการสูญเสียโฟกัสอย่างสมบูรณ์หรือชั่วคราวขณะที่เพลเยอร์หยุดชั่วคราว (#1436)
- แก้ไขIndexOutOfBoundsExceptionที่อาจเกิดขึ้นจากโปรแกรมแยกที่รายงานแทร็กเพิ่มเติมหลังจากขั้นตอนเตรียมการเริ่มต้น (#1476)
- Effects ใน ExoPlayer.setVideoEffect() จะได้รับการประทับเวลาโดยนำออฟเซ็ตของโปรแกรมแสดงผลออกแล้ว (#1098)
- แก้ไข IllegalArgumentException ที่อาจเกิดขึ้นเมื่อจัดการข้อผิดพลาดของโปรแกรมเล่นที่เกิดขึ้นขณะอ่านรายการอื่นในเพลย์ลิสต์ (#1483)
Transformer:
- เพิ่ม audioConversionProcess และ videoConversionProcess ลงใน ExportResult เพื่อระบุวิธีสร้างแทร็กที่เกี่ยวข้องในไฟล์เอาต์พุต
- ผ่อนปรนการตรวจสอบระดับ H.264 ของการเพิ่มประสิทธิภาพการตัด
- เพิ่มการรองรับการเปลี่ยนระหว่างสื่ออินพุต SDR และ HDR ตามลำดับ
- เพิ่มการรองรับเอฟเฟกต์เสียงระดับการประพันธ์
- เพิ่มการรองรับการแปลงไฟล์ภาพ Ultra HDR เป็นวิดีโอ HDR
- แก้ไขปัญหาที่ DefaultAudioMixer แสดงผลจำนวนไบต์ที่ไม่ถูกต้องหลังจากรีเซ็ตและนํามาใช้ซ้ำ
- แก้ปัญหาข้อบกพร่องของตัวถอดรหัสที่จำกัดจำนวนช่องเสียงไว้ที่สเตอริโอเมื่อจัดการอินพุต PCM
- เมื่อเลือกแทร็กใน ExoPlayerAssetLoader ให้ละเว้นข้อจำกัดจำนวนช่องเสียง เนื่องจากข้อจำกัดดังกล่าวมีผลกับการเล่นเท่านั้น
- แทนที่อินเทอร์เฟซ androidx.media3.transformer.Muxer ด้วย androidx.media3.muxer.Muxer และนํา androidx.media3.transformer.Muxer ออก
- แก้ไขการโหลดรูปภาพ HEIC จากรูปแบบ URI ของเนื้อหา (#1373)
- ปรับระยะเวลาของแทร็กเสียงใน AudioGraphInput เพื่อปรับปรุงการซิงค์ AV
- นำช่อง ExportResult.processedInputs ออก หากคุณใช้ช่องนี้สำหรับรายละเอียดตัวแปลงรหัส ให้ใช้ DefaultDecoderFactory.listener แทน ในกรณีที่มีข้อยกเว้นเกี่ยวกับตัวแปลงรหัส รายละเอียดตัวแปลงรหัสจะแสดงใน ExportException.codecInfo
เครื่องมือแยกข้อมูล:
- MPEG-TS: เลื่อนการเปลี่ยนแปลงไปข้างหน้าเพื่อให้แน่ใจว่าระบบแสดงผลเฟรมสุดท้ายโดยส่งหน่วยการเข้าถึงสุดท้ายของสตรีมไปยังคิวตัวอย่าง (#7909) การใช้การแก้ไขเพื่อแก้ไขปัญหาที่เกิดขึ้นในสตรีม HLS ที่เป็น I-frame เท่านั้น(#1150) และสตรีม HLS ที่เป็น H.262 (#1126)
- MP3: แนะนำให้ใช้ขนาดข้อมูลจากเฟรม Info แทนขนาดที่รายงานโดยสตรีมที่อยู่เบื้องหลัง (เช่น ขนาดไฟล์หรือส่วนหัว Content-Length ของ HTTP) วิธีนี้จะช่วยยกเว้นข้อมูลตัวอย่างเพลงที่เล่นไม่ได้ (เช่น อาร์ตเวิร์กอัลบั้ม) ออกจากการคํานวณการกรอตามอัตราบิตคงที่ ซึ่งทําให้การกรอแม่นยํายิ่งขึ้น (#1376)
- MP3: ใช้จำนวนเฟรมและข้อมูลอื่นๆ ในเฟรม Info (หากมี) เพื่อคํานวณอัตราบิตเฉลี่ยสำหรับการกรอตามอัตราบิตคงที่ แทนที่จะคาดคะเนจากอัตราบิตของเฟรมหลังเฟรม Info ซึ่งอาจต่ำเกินจริง เช่น เฟรม PCUT (#1376)
- แก้ไขการดึงข้อมูลรูปแบบเสียง PCM ในคอนเทนเนอร์ AVI
เสียง:
- แก้ไขแอตทริบิวต์การเข้ารหัส DTS:X โปรไฟล์ 2 สำหรับการผ่านการเล่น (#1299)
- สําหรับการเล่นที่ระบบโหลดไว้ล่วงหน้า ให้รีเซ็ตช่องการติดตามสําหรับการเล่นสตรีมจนจบใน DefaultAudioSink ก่อนเรียก AudioTrack.stop() เพื่อให้ AudioTrack.StreamEventCallback#onPresentationEnded ระบุได้อย่างถูกต้องเมื่อเล่นข้อมูลทั้งหมดที่รอดําเนินการแล้ว
- แก้ไขข้อบกพร่องใน SilenceSkippingAudioProcessor ที่การเปลี่ยนรูปแบบเสียง (เช่น จากสเตอริโอเป็นโมโน) อาจทําให้ตัวประมวลผลแสดงข้อยกเว้น (#1352)
- ใช้ MediaCodecAudioRenderer.getDurationToProgressUs() เพื่อให้ ExoPlayer กำหนดเวลาลูปการทำงานหลักแบบไดนามิกเมื่อ MediaCodecAudioRenderer ทำงานได้
วิดีโอ:
- แก้ไขปัญหาที่ Listener.onRenderedFirstFrame() แสดงขึ้นเร็วเกินไปเมื่อเปลี่ยนแพลตฟอร์มระหว่างการเล่น
- แก้ไขตรรกะสำรองของตัวถอดรหัสสำหรับ Dolby Vision เพื่อใช้ตัวถอดรหัส AV1 ที่เข้ากันได้ หากจำเป็น (#1389)
- แก้ไขข้อยกเว้นของตัวแปลงรหัสที่อาจเกิดจากการเปิดใช้โปรแกรมแสดงผลวิดีโอขณะเล่น
ข้อความ:
- แก้ไขปัญหาที่ระบบข้ามคำบรรยายที่เริ่มต้นก่อนตำแหน่งการกรอ ปัญหานี้เกิดขึ้นใน Media3 1.4.0-alpha01 เท่านั้น
- เปลี่ยนลักษณะการแยกวิเคราะห์คำบรรยายแทนเสียงเริ่มต้นเพื่อให้เกิดขึ้นระหว่างการดึงข้อมูลแทนที่จะเป็นระหว่างการแสดงผล (ดูความแตกต่างระหว่างการดึงข้อมูลกับการแสดงผลได้ในแผนภาพสถาปัตยกรรมของ ExoPlayer)
  - การเปลี่ยนแปลงนี้สามารถลบล้างได้โดยเรียกใช้ทั้ง MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) และ TextRenderer.experimentalSetLegacyDecodingEnabled(true) ดูวิธีต่อเชื่อมคอมโพเนนต์เหล่านี้กับอินสแตนซ์ ExoPlayer ในเอกสารเกี่ยวกับการปรับแต่ง เราจะนำเมธอดเหล่านี้ (และการสนับสนุนทั้งหมดสำหรับการถอดรหัสคำบรรยายแบบเดิม) ออกในรุ่นต่อๆ ไป
  - แอปที่มีการติดตั้งใช้งาน SubtitleDecoder ที่กำหนดเองต้องอัปเดตเพื่อติดตั้งใช้งาน SubtitleParser แทน (และ SubtitleParser.Factory แทน SubtitleDecoderFactory)
- PGS: แก้ไขการถอดรหัสความยาวกลุ่มเพื่อแก้ไข 0 เป็นดัชนีสีแทนที่จะเป็นค่าสีตามตัวอักษร (#1367)
- CEA-708: ละเว้นค่า rowLock ข้อกำหนด CEA-708-E S-2023 ระบุว่าทั้ง rowLock และ columnLock ควรถือว่า "จริง" เสมอ โดยไม่คำนึงถึงค่าที่มีอยู่ในสตรีม (ระบบไม่ได้รองรับ columnLock จึงถือว่า "เท็จ" เสมอ)
  - ข้อมูลนี้เดิมรวมอยู่ในบันทึกประจำรุ่น 1.3.0-alpha01 แต่ระบบเปลี่ยนกลับการเปลี่ยนแปลงนี้โดยไม่ได้ตั้งใจก่อนการเปิดตัว 1.3.0-rc01 ปัญหานี้ได้รับการแก้ไขแล้ว การเปลี่ยนแปลงจึงปรากฏขึ้นอีกครั้ง
- CEA-708: หลีกเลี่ยงการใส่บรรทัดใหม่ซ้ำกันเนื่องจากการจัดการคำสั่ง "set pen location" ของ ExoPlayer ที่ไม่ซับซ้อน (#1315)
- แก้ไข IllegalArgumentException จาก LegacySubtitleUtil เมื่อตัวอย่างคำบรรยาย WebVTT ไม่มีคำบอกเวลา เช่น เป็นส่วนหนึ่งของสตรีม DASH (#1516)
ข้อมูลเมตา:
- แก้ไขการแมป MP4 กับแท็กการจัดเรียง ID3 ก่อนหน้านี้ ระบบแมปแท็ก MP4 "การจัดเรียงอัลบั้ม" (soal), "การจัดเรียงศิลปิน" (soar) และ "การจัดเรียงศิลปินอัลบั้ม" (soaa) กับแท็ก ID3 TSO2, TSOA และ TSOP อย่างไม่ถูกต้อง (#1302)
- แก้ไขการอ่านแท็กตัวเลข gnre (ประเภท) และ tmpo (จังหวะ) ของ MP4 (/iTunes) เมื่อค่ามีความยาวมากกว่า 1 ไบต์
- เผยแพร่เฟรม ID3 TCON ไปยัง MediaMetadata.genre (#1305)
รูปภาพ:
- เพิ่มการรองรับตารางภาพปก DASH ที่ไม่ได้เป็นรูปสี่เหลี่ยมจัตุรัส (#1300)
- เพิ่มการรองรับ AVIF สำหรับ API 34 ขึ้นไป
- อนุญาตให้ใช้ null เป็นพารามิเตอร์สําหรับ ExoPlayer.setImageOutput() เพื่อล้าง ImageOutput ที่ตั้งไว้ก่อนหน้านี้
DataSource:
- รองรับ android.resource://package/id URI ของทรัพยากรดิบ โดยที่ package แตกต่างจากแพ็กเกจของแอปพลิเคชันปัจจุบัน ก่อนหน้านี้ยังไม่มีการบันทึกว่าวิธีนี้ใช้งานได้ แต่นี่เป็นวิธีที่มีประสิทธิภาพมากกว่าในการเข้าถึงทรัพยากรในแพ็กเกจอื่นเมื่อเทียบกับการเข้าถึงตามชื่อ
- ตรวจสอบว่า url ไม่ใช่ค่า Null ในคอนสตรัคเตอร์ DataSpec มีการกำกับเนื้อหาพารามิเตอร์นี้ไว้ว่าไม่ใช่ค่า Null อยู่แล้ว
- อนุญาตให้ ByteArrayDataSource แปลง URI เป็นอาร์เรย์ไบต์ระหว่าง open() แทนที่จะกำหนดค่าแบบฮาร์ดโค้ดเมื่อสร้าง (#1405)
DRM:
- อนุญาตให้ตั้งค่า LoadErrorHandlingPolicy ใน DefaultDrmSessionManagerProvider (#1271)
ผล:
- รองรับการเปลี่ยนแปลงความเร็วหลายรายการภายใน EditedMediaItem เดียวกัน หรือ Composition ใน SpeedChangeEffect
- รองรับเอาต์พุต HLG และ PQ จากอินพุตบิตแมป HDR ขั้นสูง
- เพิ่มการรองรับ EGL_GL_COLORSPACE_BT2020_HLG_EXT ซึ่งจะปรับปรุงเอาต์พุตพื้นผิว HLG ใน ExoPlayer.setVideoEffect และ Debug SurfaceView ของ Transformer
- อัปเดตการใช้งานเมทริกซ์การวางซ้อนเพื่อให้สอดคล้องกับเอกสารประกอบโดยการพลิกค่า x และ y ที่ใช้ใน setOverlayFrameAnchor() หากใช้ OverlaySettings.Builder.setOverlayFrameAnchor() ให้พลิกค่า x และ y โดยคูณด้วย -1
- แก้ไขข้อบกพร่องที่ TimestampWrapper ขัดข้องเมื่อใช้ร่วมกับ ExoPlayer#setVideoEffects (#821)
- เปลี่ยนพื้นที่ทํางานสี SDR เริ่มต้นจากสีเชิงเส้นเป็นวิดีโอ SDR รูปแบบไฟฟ้าของ BT 709 รวมถึงระบุตัวเลือกที่ 3 เพื่อคงรูปแบบสีเดิมไว้
- อนุญาตให้กำหนดลําดับ z ที่ไม่แน่นอนของ EditedMediaItemSequences (#1055)
- รักษาช่วงความสว่างให้สอดคล้องกันในเนื้อหา HDR แต่ละส่วน (ใช้ช่วง HLG)
- เพิ่มการรองรับการวางซ้อน Ultra HDR (บิตแมป) ในเนื้อหา HDR
- อนุญาตให้ใช้เอฟเฟกต์ SeparableConvolution ก่อน API 26
- นำ OverlaySettings.useHdr ที่ไม่ได้ใช้ออกเนื่องจากช่วงไดนามิกของการวางซ้อนและเฟรมต้องตรงกัน
- เพิ่มการรองรับ HDR สำหรับ TextOverlay คุณปรับความสว่างของข้อความวางซ้อนได้ด้วย OverlaySettings.Builder.setHdrLuminanceMultiplier()
ส่วนขยาย IMA
- โปรโมต API ที่จําเป็นสําหรับแอปในการเล่นสตรีมโฆษณา DAI ให้เป็นเวอร์ชันเสถียร
- เพิ่ม replaceAdTagParameters(Map <String, String>) ลงใน ImaServerSideAdInsertionMediaSource.AdLoader ซึ่งช่วยให้แทนที่พารามิเตอร์แท็กโฆษณาได้เมื่อรันไทม์
- แก้ไขข้อบกพร่องที่ไม่มีการเรียกใช้ VideoAdPlayer.VideoAdPlayerCallback.onError() เมื่อเกิดข้อผิดพลาดเกี่ยวกับโปรแกรมเล่นระหว่างการเล่นโฆษณา (#1334)
- อัปเกรด IMA SDK เป็นเวอร์ชัน 3.33.0 เพื่อแก้ไขปัญหา NullPointerException เมื่อใช้ URI ของแท็กโฆษณา data:// (#700)
เซสชัน:
- เปลี่ยนค่าเริ่มต้นของ CommandButton.enabled เป็น true และตรวจสอบว่าค่าดังกล่าวเป็นเท็จได้สําหรับตัวควบคุมแม้ว่าคําสั่งที่เกี่ยวข้องจะพร้อมใช้งานก็ตาม
- เพิ่มค่าคงที่ของไอคอนสำหรับ CommandButton ที่จะนําไปใช้แทนทรัพยากรไอคอนที่กําหนดเอง
- เพิ่ม MediaSessionService.isPlaybackOngoing() เพื่อให้แอปค้นหาว่าจำเป็นต้องหยุดบริการใน onTaskRemoved() หรือไม่ (#1219)
- เพิ่ม MediaSessionService.pauseAllPlayersAndStopSelf() ที่สะดวกต่อการหยุดเล่นเซสชันทั้งหมดชั่วคราวและเรียกใช้ stopSelf() เพื่อสิ้นสุดวงจรชีวิตของ MediaSessionService
- ลบล้าง MediaSessionService.onTaskRemoved(Intent) เพื่อให้มีการใช้งานเริ่มต้นที่ปลอดภัยซึ่งจะทําให้บริการทํางานอยู่เบื้องหน้าหากการเล่นกําลังดำเนินอยู่ หรือจะหยุดบริการก็ได้
- ซ่อนแถบเลื่อนหาจุดที่ต้องการในการแจ้งเตือนสื่อสำหรับสตรีมแบบสดโดยไม่ตั้งค่าระยะเวลาลงในข้อมูลเมตาของเซสชันแพลตฟอร์ม (#1256)
- ปรับการเปลี่ยนค่าของ MediaMetadata เป็น MediaDescriptionCompat เพื่อใช้ลําดับและตรรกะที่ต้องการเดียวกันเมื่อเลือกพร็อพเพอร์ตี้ข้อมูลเมตาเช่นเดียวกับใน media1
- เพิ่ม MediaSession.sendError() ที่อนุญาตให้ส่งข้อผิดพลาดที่ไม่ร้ายแรงไปยังตัวควบคุม Media3 เมื่อใช้ตัวควบคุมการแจ้งเตือน (ดูMediaSession.getMediaNotificationControllerInfo()) ระบบจะใช้ข้อผิดพลาดที่กําหนดเองเพื่ออัปเดต PlaybackState ของเซสชันแพลตฟอร์มเป็นสถานะข้อผิดพลาดพร้อมข้อมูลข้อผิดพลาดที่ระบุ (#543)
- เพิ่ม MediaSession.Callback.onPlayerInteractionFinished() เพื่อแจ้งให้เซสชันทราบเมื่อชุดการโต้ตอบของผู้เล่นจากตัวควบคุมหนึ่งๆ สิ้นสุดลง
- เพิ่ม SessionError และใช้กับ SessionResult และ LibraryResultแทนรหัสข้อผิดพลาดเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดและวิธีแก้ไขข้อผิดพลาด (หากเป็นไปได้)
- เผยแพร่โค้ดสําหรับแอปทดสอบตัวควบคุม media3 ซึ่งสามารถใช้เพื่อทดสอบการโต้ตอบกับแอปที่เผยแพร่เซสชันสื่อ
- เผยแพร่ข้อมูลเพิ่มเติมที่ส่งไปยัง MediaSession[Builder].setSessionExtras() ของ media3 ไปยัง PlaybackStateCompat.getExtras() ของตัวควบคุม media1
- จับคู่ข้อผิดพลาดร้ายแรงและไม่ร้ายแรงจากเซสชันแพลตฟอร์ม A PlaybackException แมปกับสถานะข้อผิดพลาดร้ายแรงของ PlaybackStateCompat SessionError ที่ส่งไปยังตัวควบคุมการแจ้งเตือนสื่อที่มี MediaSession.sendError(ControllerInfo, SessionError) จะแมปกับข้อผิดพลาดที่ไม่ร้ายแรงใน PlaybackStateCompat ซึ่งหมายความว่ามีการตั้งค่ารหัสและข้อความแสดงข้อผิดพลาด แต่สถานะของเซสชันแพลตฟอร์มยังคงแตกต่างจาก STATE_ERROR
- อนุญาตให้ตั้งค่ากิจกรรมเซสชันต่อตัวควบคุมเพื่อลบล้างกิจกรรมเซสชันส่วนกลาง คุณสามารถกําหนดกิจกรรมเซสชันสําหรับตัวควบคุมได้เมื่อเชื่อมต่อโดยสร้าง ConnectionResult ด้วย AcceptedResultBuilder.setSessionActivivty(PendingIntent) เมื่อเชื่อมต่อแล้ว คุณสามารถอัปเดตกิจกรรมเซสชันด้วย MediaSession.setSessionActivity(ControllerInfo, PendingIntent)
- ปรับปรุงการจำลองข้อผิดพลาดของการเรียก MediaLibrarySession.Callback ตอนนี้คุณกำหนดค่าการจําลองข้อผิดพลาดได้โดยใช้ MediaLibrarySession.Builder.setLibraryErrorReplicationMode() เพื่อเลือกประเภทข้อผิดพลาดหรือเลือกไม่ใช้การจําลองข้อผิดพลาดซึ่งเปิดอยู่โดยค่าเริ่มต้น
UI:
- เพิ่มการรองรับการแสดงรูปภาพใน PlayerView เมื่อเชื่อมต่อกับ ExoPlayer (#1144)
- เพิ่มการปรับแต่งไอคอนต่างๆ ใน PlayerControlView ผ่านแอตทริบิวต์ xml เพื่ออนุญาตให้ใช้ภาพวาดที่แตกต่างกันต่ออินสแตนซ์ PlayerView แทนการลบล้างแบบทั่วโลก (#1200)
- แก้ปัญหาข้อบกพร่องของแพลตฟอร์มที่ทําให้วิดีโอยืด/ครอบตัดเมื่อใช้ SurfaceView ใน Compose AndroidView ใน API 34 (#1237)
การดาวน์โหลด
- ตรวจสอบว่า DownloadHelper ไม่ได้เปิดเผยอินสแตนซ์ Renderer ที่ยังไม่ได้เผยแพร่ ซึ่งอาจส่งผลให้แอปขัดข้องด้วย IllegalStateException: Too many receivers, total of 1000, registered for pid (#1224)
ส่วนขยาย Cronet:
- แก้ไข SocketTimeoutException ใน CronetDataSource ใน Cronet บางเวอร์ชัน คำขอที่ได้จากคอลแบ็กจะไม่เหมือนกันเสมอไป ซึ่งส่งผลให้การเรียกกลับไม่เสร็จสมบูรณ์และคำขอหมดเวลา (https://issuetracker.google.com/328442628)
ส่วนขยาย HLS:
- แก้ไขข้อบกพร่องที่ตัวอย่าง EMSG ที่รอดำเนินการซึ่งรอการหยุดชะงักได้รับการมอบสิทธิ์ใน HlsSampleStreamWrapper โดยมีออฟเซตที่ไม่ถูกต้องซึ่งทําให้เกิด IndexOutOfBoundsException หรือ IllegalArgumentException (#1002)
- แก้ไขข้อบกพร่องที่เพลย์ลิสต์ที่ไม่ใช่หลักโหลดซ้ำสตรีม LL-HLS อยู่เรื่อยๆ (#1240)
- แก้ไขข้อบกพร่องที่การเปิดใช้ CMCD สำหรับ HLS ที่มีกลุ่มเริ่มต้นทำให้ Source Error และ IllegalArgumentException
- แก้ไขข้อบกพร่องที่เพลย์ลิสต์ที่เล่นอยู่ซึ่งไม่ใช่เพลย์ลิสต์หลักไม่รีเฟรชระหว่างการเล่นแบบสด (#1240)
- แก้ไขข้อบกพร่องที่การเปิดใช้ CMCD สำหรับสตรีมแบบสด HLS ทำให้เกิดข้อผิดพลาด ArrayIndexOutOfBoundsException (#1395)
ส่วนขยาย DASH
- แก้ไขข้อบกพร่องที่การเตรียมสตรีมแบบสดหลายช่วงเวลาอีกครั้งอาจทำให้เกิดข้อผิดพลาด IndexOutOfBoundsException (#1329)
- เพิ่มการรองรับdashif:Laurl URL ของใบอนุญาต (#1345)
ส่วนขยาย Cast
- แก้ไขข้อบกพร่องที่แปลงชื่ออัลบั้มของ MediaQueueItem เป็นชื่อศิลปินในรายการสื่อ Media3 (#1255)
ยูทิลิตีการทดสอบ
- ติดตั้งใช้งาน onInit() และ onRelease() ใน FakeRenderer
- เปลี่ยนเมธอด TestPlayerRunHelper.runUntil()/playUntil() ให้ดำเนินการไม่สำเร็จเมื่อเกิดข้อผิดพลาดที่ไม่ร้ายแรง (เช่น ข้อผิดพลาดที่รายงานไปยัง AnalyticsListener.onVideoCodecError()) ใช้เชนเมธอด TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() ใหม่เพื่อปิดใช้ลักษณะการทำงานนี้
แอปเดโม:
- ใช้ DefaultPreloadManager ในแอปสาธิตแบบสั้น
- อนุญาตให้ตั้งค่าโหมดซ้ำด้วยอาร์กิวเมนต์ Intent จากบรรทัดคำสั่ง (#1266)
- ใช้ HttpEngineDataSource เป็น HttpDataSource เมื่ออุปกรณ์รองรับ
นำสัญลักษณ์ที่เลิกใช้งานออก
- นำ CronetDataSourceFactory ออก ให้ใช้ CronetDataSource.Factory instead.
- นำตัวสร้าง DataSpec บางรายการออก ให้ใช้ DataSpec.Builder แทน
- นำวิธีการชำระเงิน setContentTypePredicate(Predicate) ออกจาก DefaultHttpDataSource, OkHttpDataSource และ CronetDataSource ให้ใช้วิธีเทียบเท่าใน XXXDataSource.Factory แต่ละรายการแทน
- นำตัวสร้าง OkHttpDataSource และ OkHttpDataSourceFactory ออก ให้ใช้ OkHttpDataSource.Factory แทน
- นำ PlayerMessage.setHandler(Handler) ออก ให้ใช้ setLooper(Looper) instead.
- นำช่อง Timeline.Window.isLive ออก ให้ใช้เมธอด isLive() แทน
- นำตัวสร้าง DefaultHttpDataSource ออก ให้ใช้ DefaultHttpDataSource.Factory แทน
- นำ DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS ออก ให้ใช้ DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS แทน
- นำ MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) ออก ให้ใช้ MediaCodecInfo.canReuseCodec(Format, Format) แทน
- นำDrmSessionManager.DUMMYและgetDummyDrmSessionManager()วิธีการชำระเงินออก ให้ใช้ DrmSessionManager.DRM_UNSUPPORTED แทน
- นำAnalyticsListener.onAudioInputFormatChanged(EventTime, Format), AnalyticsListener.onVideoInputFormatChanged(EventTime, Format), AudioRendererEventListener.onAudioInputFormatChanged(Format), VideoRendererEventListener.onVideoInputFormatChanged(Format)ออก ใช้การโอเวอร์โหลดที่รับ DecoderReuseEvaluation แทน
- นำค่าคงที่ RendererSupport.FormatSupport IntDef และ FORMAT_HANDLED, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE ออก ใช้ IntDef และค่าคงที่ที่เทียบเท่าใน androidx.media3.common.C แทน (เช่น C.FORMAT_HANDLED)
- นำอินเทอร์เฟซ Bundleable ออก ซึ่งรวมถึงการนำช่องค่าคงที่ Bundleable.Creator<Foo> CREATOR ทั้งหมดออก ผู้เรียกใช้ควรใช้เมธอด Bundle toBundle() และ static Foo fromBundle(Bundle) กับแต่ละประเภทแทน

เวอร์ชัน 1.4.0-rc01

10 กรกฎาคม 2024

เวอร์ชัน 1.4.0-beta01

26 มิถุนายน 2024

เวอร์ชัน 1.4.0-alpha02

7 มิถุนายน 2024

เวอร์ชัน 1.4.0-alpha01

17 เมษายน 2024

เวอร์ชัน 1.3.0

เวอร์ชัน 1.3.1

11 เมษายน 2024

androidx.media3:media3-*:1.3.1 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.1 มีการคอมมิตเหล่านี้

คลังทั่วไป:
- เพิ่ม Format.labels เพื่ออนุญาตให้ใช้ป้ายกำกับที่แปลแล้วหรือป้ายกำกับอื่นๆ
ExoPlayer:
- แก้ไขปัญหาที่ PreloadMediaPeriod เก็บสตรีมไว้ไม่ได้เมื่อโหลดล่วงหน้าอีกครั้ง
- ใช้ TrackSelectionResult ที่เกี่ยวข้องที่ถูกต้องกับระยะเวลาการเล่นในการเลือกแทร็กอีกครั้ง
- เริ่มโปรแกรมแสดงผลที่เปิดใช้ก่อนเวลาหลังจากเลื่อนระยะเวลาการเล่นไปข้างหน้าเท่านั้นเมื่อเปลี่ยนระหว่างรายการสื่อ (#1017)
- เพิ่มประเภทผลลัพธ์ที่ขาดหายไปในกฎ -keepclasseswithmembers ของ Proguard สำหรับ DefaultVideoFrameProcessor.Factory.Builder.build() (#1187)
Transformer:
- เพิ่มวิธีแก้ปัญหาสำหรับข้อยกเว้นที่แสดงเนื่องจาก MediaMuxer ไม่รองรับการประทับเวลาการนำเสนอเชิงลบก่อน API 30
การเลือกแทร็ก:
- DefaultTrackSelector: แนะนำให้ใช้แทร็กวิดีโอที่มีอัตราเฟรม "เหมาะสม" (>=10 fps) มากกว่าแทร็กที่มีอัตราเฟรมต่ำกว่าหรือไม่กำหนด วิธีนี้ช่วยให้มั่นใจว่าโปรแกรมเล่นจะเลือกแทร็กวิดีโอ "จริง" ใน MP4 ที่ดึงมาจากภาพเคลื่อนไหวซึ่งมีแทร็ก HEVC 2 แทร็กที่แทร็กหนึ่งมีความละเอียดสูงกว่าแต่มีจำนวนเฟรมน้อยมาก (#1051)
เครื่องมือแยกข้อมูล:
- แก้ไขปัญหาที่ระบบไม่ข้ามการเติมเมื่ออ่านข้อมูลขนาดแปลกๆ จากไฟล์ WAV (#1117)
- MP3: ป้อนข้อมูล Format.averageBitrate จากเฟรมข้อมูลเมตา เช่น XING และ VBRI
- MPEG-TS: เปลี่ยนกลับการเปลี่ยนแปลงที่มีจุดประสงค์เพื่อให้แน่ใจว่าระบบจะแสดงผลเฟรมสุดท้ายโดยส่งหน่วยการเข้าถึงสุดท้ายของสตรีมไปยังคิวตัวอย่าง (#7909) เนื่องจากการเปลี่ยนแปลงนี้ทำให้เกิดปัญหาใหม่กับสตรีม HLS ที่มีเฉพาะเฟรม I (#1150) และสตรีม HLS ที่ใช้ H.262 (#1126)
เสียง:
- อนุญาตให้กู้คืนโปรแกรมแสดงผลโดยปิดใช้การโอนหากแทร็กเสียงเริ่มต้นไม่สำเร็จในโหมดการโอน
วิดีโอ:
- เพิ่มวิธีแก้ปัญหาเกี่ยวกับอุปกรณ์ใน Galaxy Tab S7 FE, Chromecast พร้อม Google TV และ Lenovo M10 FHD Plus ซึ่งทําให้ระบบทําเครื่องหมายสตรีม H265 60 fps ว่าไม่รองรับ
- เพิ่มวิธีแก้ปัญหาที่ช่วยให้เฟรมแรกได้รับการแสดงผลเสมอขณะที่ทำการเทนเนิล แม้ว่าอุปกรณ์จะไม่ทำโดยอัตโนมัติตามที่ API กำหนด (#1169) (#966)
- แก้ไขปัญหาที่การจัดการข้อมูลสี HDR ทําให้ตัวแปลงรหัสทํางานผิดปกติและป้องกันไม่ให้สลับรูปแบบแบบปรับเปลี่ยนได้สำหรับแทร็กวิดีโอ SDR (#1158)
ข้อความ:
- WebVTT: ป้องกันไม่ให้คำบอกทางที่อยู่ติดกันโดยตรงสร้างCuesWithTimingอินสแตนซ์เพิ่มเติมที่ไม่ถูกต้องจากWebvttParser.parse (#1177)
DRM:
- แก้ปัญหา NoSuchMethodError ที่อาจแสดงโดยเฟรมเวิร์ก MediaDrm แทน ResourceBusyException หรือ NotProvisionedException ในอุปกรณ์ Android 14 บางรุ่น (#1145)
ผล:
- ปรับปรุงการแมปโทนสี PQ เป็น SDR ด้วยการแปลงพื้นที่สี
เซสชัน:
- แก้ปัญหาที่ตำแหน่งปัจจุบันจะกระโดดกลับเมื่อตัวควบคุมแทนที่รายการปัจจุบัน (#951)
- แก้ไขปัญหาที่ MediaMetadata ที่มีเพียง extras ที่ไม่ใช่ค่า Null เท่านั้นที่ไม่มีการส่งระหว่างตัวควบคุมสื่อกับเซสชัน (#1176)
UI:
- แสดงชื่อภาษาของแทร็กเสียงเป็นทางเลือกในกรณีที่ Locale ไม่สามารถระบุชื่อที่แสดง (#988)
ส่วนขยาย DASH
- ป้อนข้อมูลองค์ประกอบ Label ทั้งหมดจากไฟล์ Manifest ลงใน Format.labels (#1054)
ส่วนขยาย RTSP:
- ข้ามค่าข้อมูลเซสชัน (แท็ก i) ที่ว่างเปล่าในการแยกวิเคราะห์ SDP (#1087)
ส่วนขยายโปรแกรมถอดรหัส (FFmpeg, VP9, AV1, MIDI ฯลฯ)
- ปิดใช้ส่วนขยาย MIDI ในฐานะทรัพยากร Dependency ในเครื่องโดยค่าเริ่มต้น เนื่องจากต้องมีการกำหนดค่าที่เก็บ Maven เพิ่มเติม ผู้ใช้ที่ต้องการใช้ข้อบังคับนี้จากข้อกำหนดเบื้องต้นในเครื่องจะเปิดใช้ข้อบังคับดังกล่าวอีกครั้งได้

เวอร์ชัน 1.3.0

6 มีนาคม 2024

androidx.media3:media3-*:1.3.0 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0 มีการคอมมิตเหล่านี้

คลังทั่วไป:
- ใช้การรองรับ URI ของandroid.resource://package/[type/]name ทรัพยากรดิบ โดยที่ package แตกต่างจากแพ็กเกจของแอปพลิเคชันปัจจุบัน การดำเนินการนี้ได้รับการบันทึกไว้ว่าใช้งานได้เสมอ แต่ยังไม่มีการใช้งานอย่างถูกต้องจนถึงตอนนี้
- เปลี่ยนประเภท MIME ที่โค้ดแอปตั้งค่าหรืออ่านจากสื่อให้เป็นตัวพิมพ์เล็กทั้งหมด
- กําหนดโฆษณาด้วย MediaItem แบบเต็มแทน Uri เดียวใน AdPlaybackState
- เพิ่ม minSdk เป็น 19 (Android KitKat) ซึ่งสอดคล้องกับไลบรารี AndroidX อื่นๆ ทั้งหมด และจําเป็นต่อเราในการอัปเกรดข้อกําหนดของ AndroidX เป็นเวอร์ชันล่าสุด
- ป้อนข้อมูลทั้ง artworkUri และ artworkData ใน MediaMetadata.Builder.populate(MediaMetadata) เมื่ออย่างน้อย 1 รายการไม่มีค่า Null (#964)
ExoPlayer:
- เพิ่ม PreloadMediaSource และ PreloadMediaPeriod ที่อนุญาตให้แอปโหลดแหล่งที่มาของสื่อเนื้อหาล่วงหน้าที่ตำแหน่งเริ่มต้นที่เฉพาะเจาะจงก่อนเล่น PreloadMediaSource มีหน้าที่เตรียมแหล่งที่มาของสื่อเนื้อหาเพื่อรับ Timeline, เตรียมและแคชระยะเวลาที่ตําแหน่งเริ่มต้นที่ระบุ เลือกแทร็ก และโหลดข้อมูลสื่อของระยะเวลา แอปควบคุมความคืบหน้าในการโหลดล่วงหน้าโดยใช้ PreloadMediaSource.PreloadControl และตั้งค่าแหล่งที่มาที่โหลดไว้ล่วงหน้าให้กับโปรแกรมเล่นเพื่อเล่น
- เพิ่ม ExoPlayer.setImageOutput ที่อนุญาตให้แอปตั้งค่า ImageRenderer.ImageOutput
- ตอนนี้ DefaultRenderersFactory จะส่ง ImageRenderer ให้กับโปรแกรมเล่นโดยค่าเริ่มต้นพร้อม ImageOutput และ ImageDecoder.Factory.DEFAULT ที่ว่าง
- ส่งเหตุการณ์ Player.Listener.onPositionDiscontinuity เมื่อข้ามช่วงเงียบ (#765)
- เพิ่มการรองรับเวอร์ชันทดลองสำหรับการแยกวิเคราะห์คำบรรยายระหว่างการดึงข้อมูล คุณเปิดใช้ฟีเจอร์นี้ได้โดยใช้ MediaSource.Factory.experimentalParseSubtitlesDuringExtraction()
- รองรับแหล่งที่มาของสื่อแบบปรับเปลี่ยนได้ด้วย PreloadMediaSource
- ใช้ HttpEngineDataSource ซึ่งเป็น HttpDataSource โดยใช้ HttpEngine API
- ป้องกันการแบ่งชั้น CompositeSequenceableLoader คอมโพเนนต์นี้เคยทำให้ขยายได้แต่ไม่เคยมีคลาสย่อยภายในไลบรารี การปรับแต่งทำได้โดยการตัดอินสแตนซ์โดยใช้รูปแบบตัวตกแต่งและการใช้ CompositeSequenceableLoaderFactory ที่กําหนดเอง
- แก้ไขปัญหาที่การซ้ำเวลาเดียวกันทำให้ข้อมูลเมตาจากรายการนี้ถูกล้าง (#1007)
- เปลี่ยนชื่อเมธอด experimentalSetSubtitleParserFactory ใน BundledChunkExtractor.Factory และ DefaultHlsExtractorFactory เป็น setSubtitleParserFactory และห้ามไม่ให้ส่ง null ใช้เมธอด experimentalParseSubtitlesDuringExtraction(boolean) ใหม่เพื่อควบคุมลักษณะการแยกวิเคราะห์
- เพิ่มการรองรับการปรับแต่ง SubtitleParser.Factory ที่ใช้ในระหว่างการดึงข้อมูล ซึ่งทำได้ด้วย MediaSource.Factory.setSubtitleParserFactory()
- เพิ่มคำนำหน้าแหล่งที่มาในช่อง Format.id ทั้งหมดที่สร้างขึ้นจาก MergingMediaSource ซึ่งจะช่วยระบุแหล่งที่มาของ Format (#883)
- แก้ไขนิพจน์ทั่วไปที่ใช้ตรวจสอบชื่อคีย์ Common Media Client Data (CMCD) ที่กําหนดเองโดยแก้ไขให้ตรวจสอบเฉพาะขีดกลาง (#1028)
- หยุดการเข้ารหัสพารามิเตอร์การค้นหา CMCD ซ้ำ (#1075)
Transformer:
- เพิ่มการรองรับการแปลงวิดีโอสโลว์โมชัน H.265/HEVC SEF เป็นวิดีโอแบบแบน
- เพิ่มความเร็วในการแปลงรหัส โดยเฉพาะสำหรับการแก้ไข "นำวิดีโอออก"
- เพิ่ม API เพื่อให้ไฟล์เอาต์พุตเริ่มต้นที่เฟรมวิดีโอ ซึ่งอาจทำให้เอาต์พุตของการดำเนินการตัดแต่งเข้ากันได้มากขึ้นกับการใช้งานโปรแกรมเล่นที่ไม่แสดงเฟรมวิดีโอแรกจนกว่าจะถึงการประทับเวลาของการแสดง (#829)
- เพิ่มการรองรับการเพิ่มประสิทธิภาพการดำเนินการตัด MP4 ของชิ้นงานเดียว
- เพิ่มการรองรับเพื่อให้เฟรมวิดีโอมีการประทับเวลาแรกในไฟล์เอาต์พุต แก้ไขไฟล์เอาต์พุตที่ขึ้นต้นด้วยเฟรมสีดําในโปรแกรมเล่น iOS (#829)
การเลือกแทร็ก:
- เพิ่ม DefaultTrackSelector.selectImageTrack เพื่อเปิดใช้การเลือกแทร็กรูปภาพ
- เพิ่ม TrackSelectionParameters.isPrioritizeImageOverVideoEnabled เพื่อระบุว่าจะเลือกแทร็กรูปภาพหรือไม่หากมีทั้งแทร็กรูปภาพและแทร็กวิดีโอ ค่าเริ่มต้นคือ false ซึ่งหมายความว่าระบบจะให้ความสำคัญกับการเลือกแทร็กวิดีโอ
เครื่องมือแยกข้อมูล:
- เพิ่มการแยกวิเคราะห์ AV1C เพิ่มเติมลงในโปรแกรมแยก MP4 เพื่อดึงค่า ColorInfo.colorSpace, ColorInfo.colorTransfer และ ColorInfo.colorRange (#692)
- MP3: ใช้การค้นหาอัตราบิตคงที่ (CBR) สำหรับไฟล์ที่มีส่วนหัว Info (เทียบเท่า CBR ของส่วนหัว Xing) ก่อนหน้านี้เราใช้ตารางการกรอจากส่วนหัว Info แต่การกรอนี้มีความแม่นยำน้อยกว่าการละเว้นและถือว่าไฟล์เป็น CBR
- MPEG2-TS: เพิ่มการรองรับ DTS, DTS-LBR และ DTS:X Profile2 (#275)
- ดึงข้อมูลประเภทเสียงจากตัวระบุ TS และจับคู่กับ Flag บทบาท ซึ่งจะช่วยให้ผู้ใช้เลือกแทร็กเสียงได้อย่างมีข้อมูลมากขึ้น (#973)
เสียง:
- ปรับปรุงอัลกอริทึมการข้ามช่วงเงียบด้วยการปรับระดับเสียงอย่างราบรื่น คงช่วงเงียบไว้ให้น้อยที่สุด และทำให้ช่วงเงียบเป็นธรรมชาติมากขึ้น (#7423)
- รายงานช่วงเงียบที่ข้ามอย่างแน่ชัดยิ่งขึ้น (#1035)
วิดีโอ:
- เปลี่ยนเครื่องมือสร้าง MediaCodecVideoRenderer ที่ใช้อาร์กิวเมนต์ VideoFrameProcessor.Factory แล้วแทนที่ด้วยเครื่องมือสร้างที่ใช้อาร์กิวเมนต์ VideoSinkProvider แอปที่ต้องการแทรก VideoFrameProcessor.Factory ที่กําหนดเองสามารถสร้าง CompositingVideoSinkProvider ที่ใช้ VideoFrameProcessor.Factory ที่กําหนดเอง และส่งผู้ให้บริการส่งผ่านวิดีโอไปยัง MediaCodecVideoRenderer
ข้อความ:
- แก้ไขการทำให้เป็นอนุกรมของคำแนะนำแบบบิตแมปเพื่อแก้ไขข้อผิดพลาด Tried to marshall a Parcel that contained Binder objects เมื่อใช้ DefaultExtractorsFactory.setTextTrackTranscodingEnabled (#836)
- CEA-708: ละเว้นค่า rowLock ข้อกำหนด CEA-708-E S-2023 ระบุว่าทั้ง rowLock และ columnLock ควรถือว่า "จริง" เสมอ โดยไม่คำนึงถึงค่าที่มีอยู่ในสตรีม (ระบบไม่ได้รองรับ columnLock จึงถือว่า "เท็จ" เสมอ)
รูปภาพ:
- เพิ่มการรองรับภาพปก DASH ระบบจะครอบตัดรูปภาพในตารางกริดและจัดเตรียมภาพขนาดย่อแต่ละรายการให้ImageOutputใกล้เคียงกับเวลาที่แสดง
DRM:
- เล่นตัวอย่างเพลงที่ "นำหน้าชัดเจน" ซึ่งไม่มีการเข้ารหัสในเนื้อหา DRM โดยค่าเริ่มต้นทันที แม้ว่าคีย์สำหรับตัวอย่างเพลงที่เข้ารหัสในภายหลังจะยังไม่พร้อมใช้งานก็ตาม ซึ่งอาจทำให้การเล่นหยุดชะงักกลางคันหากคีย์ยังไม่พร้อมเมื่อตำแหน่งการเล่นถึงตัวอย่างที่เข้ารหัส (แต่ก่อนหน้านี้การเล่นจะไม่เริ่มต้นเลยเมื่อถึงจุดนี้) ลักษณะการทำงานนี้สามารถปิดใช้ได้ด้วย MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey หรือ DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys
ส่วนขยาย IMA
- แก้ไขปัญหาที่เล่นโฆษณา DASH และ HLS ที่ไม่มีนามสกุลไฟล์ที่เหมาะสมไม่ได้
เซสชัน:
- ปิดใช้การตรวจจับการคลิกสองครั้งสำหรับแอปทีวี (#962)
- แก้ไขปัญหาที่ MediaItem.RequestMetadata ที่มีเพียงข้อมูลเพิ่มเติมที่ไม่ใช่ค่า Null ไม่ได้ส่งระหว่างตัวควบคุมสื่อกับเซสชัน
- เพิ่มคอนสตรคเตอร์ใน MediaLibrarySession.Builder ที่รับเฉพาะ Context แทน MediaLibraryService
ส่วนขยาย HLS:
- ลด HlsMediaPeriod ให้เป็นระดับการเข้าถึงระดับแพ็กเกจ ไม่ควรใช้ประเภทนี้โดยตรงจากภายนอกแพ็กเกจ HLS
- แก้ปัญหาเพื่อค้นหาจุดเริ่มต้นของกลุ่มอย่างมีประสิทธิภาพมากขึ้น (#1031)
ส่วนขยายโปรแกรมถอดรหัส (FFmpeg, VP9, AV1, MIDI ฯลฯ)
- ตัวถอดรหัส MIDI: ละเว้นข้อความเหตุการณ์ SysEx (#710)
ยูทิลิตีการทดสอบ
- อย่าหยุดเล่นชั่วคราวใน TestPlayerRunHelper.playUntilPosition การทดสอบจะคงการเล่นไว้ในสถานะเล่น แต่หยุดความคืบหน้าไว้จนกว่าการทดสอบจะเพิ่มการยืนยันและการดําเนินการเพิ่มเติมได้
แอปเดโม:
- เพิ่มโมดูลสาธิตแบบสั้นเพื่อสาธิตการใช้งาน PreloadMediaSource กับ Use Case ของเนื้อหาแบบสั้น

เวอร์ชัน 1.3.0-rc01

22 กุมภาพันธ์ 2024

ใช้เวอร์ชัน 1.3.0 ที่เสถียร

เวอร์ชัน 1.3.0-beta01

7 กุมภาพันธ์ 2024

ใช้เวอร์ชัน 1.3.0 ที่เสถียร

เวอร์ชัน 1.3.0-alpha01

15 มกราคม 2024

ใช้เวอร์ชัน 1.3.0 ที่เสถียร

เวอร์ชัน 1.2.0

เวอร์ชัน 1.2.1

9 มกราคม 2024

ExoPlayer:
- แก้ปัญหาที่การกรอด้วยตนเองนอกช่วงLiveConfiguration.min/maxOffsetจะปรับออฟเซ็ตกลับไปที่min/maxOffset
- แก้ไขปัญหาเลย์เอาต์ช่อง OPUS และ VORBIS ไม่ถูกต้องสำหรับช่อง 3, 5, 6, 7 และ 8 (#8396)
- แก้ไขปัญหาที่การเลือกแทร็กหลังจากกรอไป 0 วินาทีในสตรีมแบบสดทำให้สตรีมเริ่มเล่นที่ตำแหน่งเริ่มต้นอย่างไม่ถูกต้อง (#9347)
- แก้ไขปัญหาที่อินสแตนซ์ใหม่ของ CmcdData.Factory ได้รับค่าเชิงลบสำหรับ bufferedDurationUs จากแหล่งที่มาของข้อมูลโค้ด ทำให้ IllegalArgumentException (#888)
Transformer:
- แก้ปัญหาที่โปรแกรมเปลี่ยนไฟล์จะแสดงขึ้นเมื่อถึงเวลากําหนดค่าเนื่องจากตั้งค่าอัตราการทํางานสูง
เครื่องมือแยกข้อมูล:
- ทำเครื่องหมายแทร็ก HEVC รอง (เล่นไม่ได้) ในรูปภาพเคลื่อนไหว JPEG เป็นROLE_FLAG_ALTERNATEเพื่อป้องกันไม่ให้ระบบเลือกแทร็กดังกล่าวให้เล่นโดยอัตโนมัติเนื่องจากมีความละเอียดสูงกว่า
- แก้ไขการตรวจจับคีย์เฟรมที่ไม่ถูกต้องสำหรับสตรีม TS H264 (#864)
- แก้ไขการประมาณระยะเวลาของสตรีม TS ที่ยาวกว่า 47721 วินาที (#855)
เสียง:
- แก้ไขการจัดการ EOS สำหรับ SilenceSkippingAudioProcessor เมื่อเรียกใช้หลายครั้ง (#712)
วิดีโอ:
- เพิ่มวิธีแก้ปัญหาเกี่ยวกับอุปกรณ์ใน Galaxy Tab S7 FE, Chromecast พร้อม Google TV และ Lenovo M10 FHD Plus ซึ่งทําให้ระบบทําเครื่องหมายสตรีม AVC 60 fps ว่าไม่รองรับ (#693)
ข้อมูลเมตา:
- แก้ไขข้อบกพร่องที่ MediaMetadata สร้างขึ้นจากความคิดเห็น Vorbis เท่านั้น ที่มีคีย์ตัวพิมพ์ใหญ่ (#876)
- จับ OutOfMemoryError เมื่อแยกวิเคราะห์เฟรม ID3 ขนาดใหญ่มาก ซึ่งหมายความว่าการเล่นจะเล่นต่อได้โดยไม่ต้องใช้ข้อมูลแท็กแทนที่การเล่นจะเล่นไม่ได้เลย
DRM:
- ขยายวิธีแก้ปัญหาสำหรับ URL ใบอนุญาต https://default.url ของ ClearKey ที่ผิดพลาดไปยัง API ระดับ 33 ขึ้นไป (ก่อนหน้านี้วิธีแก้ปัญหาใช้ได้กับ API ระดับ 33 เท่านั้น) (#837)
- แก้ไข ERROR_DRM_SESSION_NOT_OPENED เมื่อเปลี่ยนจากเนื้อหาที่เข้ารหัสเป็นเนื้อหาที่ชัดเจนโดยไม่มีแพลตฟอร์มที่แนบอยู่กับโปรแกรมเล่น ข้อผิดพลาดนี้เกิดจากการใช้โปรแกรมถอดรหัสที่ปลอดภัยเพื่อเล่นเนื้อหาที่ชัดเจนอย่างไม่ถูกต้อง
เซสชัน:
- ใส่คีย์และค่าที่กำหนดเองใน MediaMetadataCompat ถึง MediaMetadata.extras และ MediaMetadata.extras ถึง MediaMetadataCompat (#756, #802)
- แก้ไขการออกอากาศ notifyChildrenChanged สำหรับตัวควบคุมรุ่นเดิม (#644)
- แก้ไขข้อบกพร่องที่การตั้งค่าเวลาติดลบสำหรับตัวจับเวลา setWhen ของการแจ้งเตือนที่ปิดใช้อยู่ทำให้อุปกรณ์บางรุ่นขัดข้อง (#903)
- แก้ไข IllegalStateException เมื่อตัวควบคุมการแจ้งเตือนสื่อยังไม่ได้เชื่อมต่อให้เสร็จสมบูรณ์เมื่อมีการขอการอัปเดตการแจ้งเตือนครั้งแรก (#917)
UI:
- แก้ปัญหาที่มองไม่เห็นปุ่มกรอไปข้างหน้าและกรอกลับเมื่อใช้กับ Material Design ใน BottomSheetDialogFragment (#511)
- แก้ปัญหาตัวเลขในปุ่มกรอไปข้างหน้าของ PlayerControlView ไม่ได้จัดแนวกัน (#547)
ส่วนขยาย DASH
- แยกวิเคราะห์ "f800" เป็นจำนวนช่อง 5 สำหรับ Dolby ในไฟล์ Manifest ของ DASH (#688)
ส่วนขยายโปรแกรมถอดรหัส (FFmpeg, VP9, AV1, MIDI ฯลฯ)
- MIDI: แก้ไขปัญหาที่การกรอไปข้างหน้าข้ามเหตุการณ์การเปลี่ยนแปลงโปรแกรม (#704)
- ย้ายข้อมูลไปยัง FFmpeg 6.0 และอัปเดต NDK ที่รองรับเป็น r26b (#707, #867)
ส่วนขยาย Cast
- ตรวจสอบการสร้าง Timeline เพื่อไม่ให้แอปขัดข้องเมื่อโหลดสื่อในอุปกรณ์แคสต์ไม่สำเร็จ (#708)

เวอร์ชัน 1.2.0

15 พฤศจิกายน 2023

คลังทั่วไป:
- เพิ่มพารามิเตอร์ @Nullable Throwable ลงในเมธอดในLog.Logger อินเทอร์เฟซ พารามิเตอร์ message ของเมธอดเหล่านี้จะไม่มีข้อมูลเกี่ยวกับ Throwable ที่ส่งไปยังเมธอด Log.{d,i,w,e}() อีกต่อไป ดังนั้นการติดตั้งใช้งานจะต้องเพิ่มข้อมูลนี้ด้วยตนเองหากต้องการ (อาจใช้ Logger.appendThrowableString(String, Throwable))
- แก้ไขปัญหาความเข้ากันได้ของ Kotlin ที่ระบบไม่ตรวจพบว่าพารามิเตอร์ประเภททั่วไปที่อนุญาตค่า Null และประเภทองค์ประกอบอาร์เรย์ที่อนุญาตค่า Null เป็นประเภทที่อนุญาตค่า Null ตัวอย่างคือพารามิเตอร์เมธอด TrackSelectorResult และ SimpleDecoder (#6792)
- เปลี่ยน UI และลักษณะการแจ้งเตือนเริ่มต้นใน Util.shouldShowPlayButton เพื่อแสดงปุ่ม "เล่น" ขณะที่การเล่นถูกระงับชั่วคราว (เช่น เนื่องจากการสูญเสียโฟกัสเสียงชั่วคราว) คุณคงลักษณะการทำงานเดิมได้โดยใช้ PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) หรือ MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) (#11213)
- อัปเกรด androidx.annotation:annotation-experimental เป็น 1.3.1 เพื่อแก้ไข https://issuetracker.google.com/251172715
- ย้าย ExoPlayer.setAudioAttributes ไปยังอินเทอร์เฟซ Player
ExoPlayer:
- แก้ไขปัญหาการกรอในสตรีม AC4 ที่เกิดจากการระบุตัวอย่างสำหรับการถอดรหัสเท่านั้นไม่ถูกต้อง (#11000)
- เพิ่มการระงับการเล่นในอุปกรณ์เอาต์พุตเสียงที่ไม่เหมาะสม (เช่น ลำโพงในตัวของอุปกรณ์ Wear OS) เมื่อเปิดใช้ฟีเจอร์นี้ผ่านExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput ระบบจะอัปเดตเหตุผลในการระงับการเล่นเป็นPlayer.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT หากมีการพยายามเล่นเมื่อไม่มีเอาต์พุตเสียงที่เหมาะสม หรือหากมีการยกเลิกการเชื่อมต่อเอาต์พุตที่เหมาะสมทั้งหมดในระหว่างการเล่น ระบบจะนำเหตุผลในการระงับออกเมื่อเชื่อมต่อเอาต์พุตที่เหมาะสมแล้ว
- เพิ่ม MediaSource.canUpdateMediaItem และ MediaSource.updateMediaItem เพื่อยอมรับการอัปเดต MediaItem หลังจากสร้างผ่าน Player.replaceMediaItem(s)
- อนุญาตให้ MediaItem อัปเดตคลาส MediaSource ทั้งหมดที่ได้จากไลบรารีผ่าน Player.replaceMediaItem(s) (#33, #9978)
- เปลี่ยนชื่อ MimeTypes.TEXT_EXOPLAYER_CUES เป็น MimeTypes.APPLICATION_MEDIA3_CUES
- เพิ่ม PngExtractor ที่ส่งและอ่านไฟล์ PNG ทั้งหมดลงใน TrackOutput เป็นตัวอย่างเดียว
- ปรับปรุงเมธอด SequenceableLoader.continueLoading(long) ในอินเทอร์เฟซ SequenceableLoader เป็น SequenceableLoader.continueLoading(LoadingInfo loadingInfo) LoadingInfo มีพารามิเตอร์เพิ่มเติม ซึ่งรวมถึง playbackSpeed และ lastRebufferRealtimeMs นอกเหนือจาก playbackPositionUs ที่มีอยู่
- ปรับปรุงChunkSource.getNextChunk(long, long, List, ChunkHolder) method ในอินเทอร์เฟซ ChunkSource เป็น ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder)
- เพิ่มช่องเพิ่มเติมในการบันทึกข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) ได้แก่ บัฟเฟอร์ที่ขาดแคลน (bs), กำหนดเวลา (dl), อัตราการเล่น (pr) และเวลาเริ่มต้น (su) (#8699)
- เพิ่มความลึกของบิตของค่าความสว่างและค่าสีเป็น ColorInfo (#491)
- เพิ่มช่องเพิ่มเติมในการบันทึก Common Media Client Data (CMCD) ได้แก่ คำขอออบเจ็กต์ถัดไป (nor) และคำขอช่วงถัดไป (nrr) (#8699)
- เพิ่มฟังก์ชันการทำงานเพื่อส่งข้อมูล Common Media Client Data (CMCD) โดยใช้พารามิเตอร์การค้นหา (#553)
- แก้ไข ConcurrentModificationException ใน ExperimentalBandwidthMeter (#612)
- เพิ่มพารามิเตอร์ MediaPeriodId ลงใน CompositeMediaSource.getMediaTimeForChildMediaTime
- รองรับ ClippingMediaSource (และแหล่งที่มาอื่นๆ ที่มีระยะ/เวลาเริ่มต้นของกรอบเวลา) ใน ConcatenatingMediaSource2 (#11226)
- เปลี่ยน BaseRenderer.onStreamChanged() ให้รับอาร์กิวเมนต์ MediaPeriodId ด้วย
Transformer:
- แยกวิเคราะห์ข้อมูลการหมุน EXIF สำหรับอินพุตรูปภาพ
- นำประเภทคำอธิบายประกอบ TransformationRequest.HdrMode และค่าคงที่ที่เกี่ยวข้องออก ให้ใช้ Composition.HdrMode และค่าคงที่ที่เกี่ยวข้องแทน
- ลดความซับซ้อนของ OverlaySettings เพื่อแก้ไขปัญหาการหมุน
- เปลี่ยนพารามิเตอร์ frameRate และ durationUs ของ SampleConsumer.queueInputBitmap เป็น TimestampIterator
การเลือกแทร็ก:
- เพิ่ม DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness เพื่ออนุญาตหรือไม่อนุญาตการปรับที่ไม่ราบรื่นอย่างชัดเจน ค่าเริ่มต้นจะยังคงเป็นลักษณะการทำงานปัจจุบันของ true
เครื่องมือแยกข้อมูล:
- MPEG-TS: ตรวจสอบว่าระบบแสดงผลเฟรมสุดท้ายโดยส่งหน่วยการเข้าถึงสุดท้ายของสตรีมไปยังคิวตัวอย่าง (#7909)
- แก้ไขคำที่สะกดผิดเมื่อระบุ rotationDegrees เปลี่ยนจาก projectionPosePitch เป็น projectionPoseRoll (#461)
- นำข้อสันนิษฐานที่ว่าสามารถตรวจสอบอินสแตนซ์ Extractor โดยตรงด้วย instanceof ออก หากต้องการเข้าถึงรายละเอียดการใช้งาน Extractor ในรันไทม์ คุณต้องเรียกใช้ Extractor.getUnderlyingInstance ก่อน
- เพิ่ม BmpExtractor
- เพิ่ม WebpExtractor
- เพิ่ม HeifExtractor
- เพิ่มการรองรับ QuickTime Classic ใน Mp4Extractor
เสียง:
- เพิ่มการรองรับ PCM แบบ Big Endian 24/32 บิตใน MP4 และ Matroska และแยกวิเคราะห์การเข้ารหัส PCM สำหรับ lpcm ใน MP4
- เพิ่มการรองรับการแยกเสียง Vorbis ใน MP4
- เพิ่ม AudioSink.getFormatOffloadSupport(Format) ที่ดึงข้อมูลระดับการรองรับการโอนข้อมูลไปยังอุปกรณ์ปลายทางที่ซิงค์สามารถให้บริการสำหรับรูปแบบผ่าน DefaultAudioOffloadSupportProvider ผลลัพธ์ที่ได้คือ AudioOffloadSupport ใหม่ที่มี isFormatSupported, isGaplessSupported และ isSpeedChangeSupported
- เพิ่ม AudioSink.setOffloadMode() ที่ใช้กำหนดค่าการโอนข้อมูลในซิงค์เสียง ค่าเริ่มต้นคือ AudioSink.OFFLOAD_MODE_DISABLED
- คุณเปิดใช้การย้ายข้อมูลไปยัง SD Card ผ่าน setAudioOffloadPreference ใน TrackSelectionParameters ได้ หากค่ากำหนดที่ตั้งไว้คือเปิดใช้ อุปกรณ์รองรับการโอนสำหรับรูปแบบนั้น และการเลือกแทร็กเป็นแทร็กเสียงแทร็กเดียว ระบบจะเปิดใช้การโอนเสียง
- หากตั้งค่า audioOffloadModePreference เป็น AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED DefaultTrackSelector จะเลือกเฉพาะแทร็กเสียงในกรณีที่ระบบรองรับรูปแบบของแทร็กนั้นในการโอน หากระบบไม่รองรับแทร็กเสียงในการโอน ระบบจะไม่เลือกแทร็กใดๆ
- การปิดใช้การรองรับการเล่นแบบไม่มีช่วงพักระหว่างเพลงสำหรับการโอนเมื่อเป็น API ระดับก่อน 33 เนื่องจากปัญหาตำแหน่งการเล่นหลังจากการเปลี่ยนแทร็ก
- นําพารามิเตอร์ enableOffload ออกจากลายเซ็นเมธอด DefaultRenderersFactory.buildAudioSink
- นำวิธีการชำระเงิน DefaultAudioSink.Builder.setOffloadMode ออก
- นำค่า intdef DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED ออก
- เพิ่มการรองรับข้อมูลเมตาของ Opus แบบไม่มีช่วงพักระหว่างการเล่นขณะสตรีม
- อนุญาตให้กู้คืนโปรแกรมแสดงผลโดยปิดใช้การโอนหากเขียนครั้งแรกไม่สำเร็จ (#627)
- เปิดใช้การตั้งเวลาการออฟโหลดโดยค่าเริ่มต้นสำหรับการเล่นแบบออฟโหลดเฉพาะเสียง
- ลบ ExoPlayer.experimentalSetOffloadSchedulingEnabled และ AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged
- เปลี่ยนชื่อ onExperimentalSleepingForOffloadChanged เป็น onSleepingForOffloadChanged และ onExperimentalOffloadedPlayback เป็น onOffloadedPlayback
- ย้ายTrackSelectionParametersอินเทอร์เฟซ และคำจำกัดความที่เกี่ยวข้องกับโหมดการโอนเสียงไปยังคลาส AudioOffloadPreferences ภายใน
- เพิ่มการเรียกกลับ onAudioTrackInitialized และ onAudioTrackReleased ไปยัง AnalyticsListener, AudioRendererEventListener และ AudioSink.Listener
- แก้ไขปัญหาบัฟเฟอร์เสียง DTS Express ต่ำกว่าเกณฑ์ (#650)
- แก้ไขข้อบกพร่องที่การตรวจสอบความสามารถของ E-AC3-JOC แสดงข้อผิดพลาด IllegalArgumentException (#677)
วิดีโอ:
- อนุญาตให้ MediaCodecVideoRenderer ใช้ VideoFrameProcessor.Factory ที่กําหนดเอง
- แก้ไขข้อบกพร่องที่ไม่สามารถแสดงผลเฟรมแรกได้หากสตรีมเสียงเริ่มต้นด้วยการประทับเวลาเชิงลบ (#291)
ข้อความ:
- นำ ExoplayerCuesDecoder ออก ตอนนี้ TextRenderer จะจัดการแทร็กข้อความที่มี sampleMimeType = application/x-media3-cues โดยตรงโดยไม่ต้องใช้อินสแตนซ์ SubtitleDecoder
ข้อมูลเมตา:
- MetadataDecoder.decode จะไม่เรียกใช้อีกต่อไปสำหรับตัวอย่าง "decode-only" เนื่องจากการติดตั้งใช้งานต้องแสดงผลเป็น null อยู่แล้ว
ผล:
- เพิ่ม VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) การจัดคิวอินพุตบิตแมปตามการประทับเวลา
- เปลี่ยน VideoFrameProcessor.registerInputStream() เป็น "ไม่บล็อก" แอปต้องใช้ VideoFrameProcessor.Listener#onInputStreamRegistered()
- เปลี่ยนพารามิเตอร์ frameRate และ durationUs ของ VideoFrameProcessor.queueInputBitmap เป็น TimestampIterator
ส่วนขยาย IMA
- แก้ไขข้อบกพร่องที่สตรีมแบบสด DASH แบบหลายช่วงเวลาที่ไม่ใช่รายการแรกในเพลย์ลิสต์อาจทำให้เกิดข้อยกเว้น (#571)
- ปล่อย StreamManager ก่อนที่จะเรียก AdsLoader.destroy()
- อัปเกรด IMA SDK เป็นเวอร์ชัน 3.31.0
เซสชัน:
- ตั้งค่าลักษณะการทํางานของบริการที่ทำงานอยู่เบื้องหน้าของการแจ้งเตือนเป็น FOREGROUND_SERVICE_IMMEDIATE ใน DefaultMediaNotificationProvider (#167)
- ใช้เฉพาะ android.media.session.MediaSession.setMediaButtonBroadcastReceiver() API ระดับ 31 ขึ้นไปเพื่อหลีกเลี่ยงปัญหาเกี่ยวกับ API ที่เลิกใช้งานในอุปกรณ์ Samsung (#167)
- ใช้ตัวควบคุมการแจ้งเตือนสื่อเป็นพร็อกซีเพื่อตั้งค่าคําสั่งที่ใช้ได้และเลย์เอาต์ที่กําหนดเองซึ่งใช้ในการสร้างการแจ้งเตือนและเซสชันแพลตฟอร์ม
- แปลงเหตุการณ์ปุ่มสื่อที่ MediaSessionService.onStartCommand() ได้รับภายใน Media3 แทนการส่งเหตุการณ์ไปยังเซสชันแพลตฟอร์มแล้วกลับไปที่ Media3 ซึ่งหมายความว่าตัวควบคุมการโทรจะเป็นตัวควบคุมการแจ้งเตือนสื่อเสมอ และแอปจะจดจำการโทรที่มาจากข้อความแจ้งเตือนได้ง่ายๆ ในลักษณะเดียวกันในทุกระดับ API ที่รองรับ
- แก้ไขข้อบกพร่องที่ MediaController.getCurrentPosition() ไม่เลื่อนไปข้างหน้าเมื่อเชื่อมต่อกับ MediaSessionCompat รุ่นเดิม
- เพิ่ม MediaLibrarySession.getSubscribedControllers(mediaId) เพื่อใช้อ้างอิง
- ลบล้าง MediaLibrarySession.Callback.onSubscribe() เพื่อยืนยันความพร้อมใช้งานของรหัสหลักที่ตัวควบคุมสมัครใช้บริการ หากดำเนินการสำเร็จ ระบบจะยอมรับการสมัครใช้บริการและเรียกใช้ notifyChildrenChanged() ทันทีเพื่อแจ้งให้เบราว์เซอร์ทราบ (#561)
- เพิ่มโมดูลการสาธิตเซสชันสำหรับ Automotive OS และเปิดใช้การสาธิตเซสชันสำหรับ Android Auto
- อย่าตั้งค่าคิวของเซสชันเฟรมเวิร์กเมื่อ COMMAND_GET_TIMELINE ไม่พร้อมใช้งานสำหรับตัวควบคุมการแจ้งเตือนสื่อ เมื่อใช้ Android Auto เป็นเครื่องมือควบคุมไคลเอ็นต์ที่อ่านจากเซสชันเฟรมเวิร์ก ผลที่ได้คือปุ่ม queue ใน UI ของ Android Auto จะไม่แสดง (#339)
- ใช้ DataSourceBitmapLoader โดยค่าเริ่มต้นแทน SimpleBitmapLoader (#271, #327)
- เพิ่ม MediaSession.Callback.onMediaButtonEvent(Intent) ที่อนุญาตให้แอปลบล้างการจัดการเหตุการณ์ของปุ่มสื่อเริ่มต้น
UI:
- เพิ่มการใช้งาน Player.Listener สำหรับอุปกรณ์ Wear OS ที่จัดการกับการระงับการเล่นเนื่องจาก Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT โดยเปิดกล่องโต้ตอบของระบบเพื่อให้ผู้ใช้เชื่อมต่อเอาต์พุตเสียงที่เหมาะสม (เช่น หูฟังบลูทูธ) เครื่องเล่นจะเล่นต่อโดยอัตโนมัติหากมีอุปกรณ์ที่เหมาะสมเชื่อมต่ออยู่ภายในระยะหมดเวลาที่กําหนดได้ (ค่าเริ่มต้นคือ 5 นาที)
การดาวน์โหลด
- ประกาศประเภทบริการที่ทำงานอยู่เบื้องหน้า "การซิงค์ข้อมูล" สำหรับ DownloadService เพื่อให้เข้ากันได้กับ Android 14 เมื่อใช้บริการนี้ แอปจะต้องเพิ่ม dataSync เป็น foregroundServiceType ในไฟล์ Manifest และเพิ่มสิทธิ์ FOREGROUND_SERVICE_DATA_SYNC ด้วย (#11239)
ส่วนขยาย HLS:
- รีเฟรชเพลย์ลิสต์สตรีมแบบสด HLS ด้วยช่วงเวลาที่คำนวณจากเวลาเริ่มต้นการโหลดครั้งล่าสุดแทนเวลาการโหลดเสร็จสมบูรณ์ครั้งล่าสุด (#663)
ส่วนขยาย DASH
- อนุญาตตัวระบุ DASH เดียวกันหลายรายการใน URL ของเทมเพลตกลุ่ม
- เพิ่มการรองรับเวอร์ชันทดลองสำหรับการแยกวิเคราะห์คำบรรยายระหว่างการดึงข้อมูล ซึ่งรองรับการผสานคำบรรยายที่ซ้อนทับกันได้ดียิ่งขึ้น รวมถึงแก้ปัญหาการกะพริบเมื่อเปลี่ยนระหว่างส่วนคำบรรยาย คุณเปิดใช้ฟีเจอร์นี้ได้โดยใช้ DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() (#288)
ส่วนขยาย RTSP:
- แก้ไขเงื่อนไขการแข่งขันที่อาจทําให้ IndexOutOfBoundsException เมื่อเปลี่ยนไปใช้ TCP หรือการเล่นค้างในบางสถานการณ์
- ตรวจสอบสถานะในการตั้งค่า RTSP เมื่อแสดงสถานะการโหลดของ RtspMediaPeriod (#577)
- ละเว้นวิธีการส่งคำขอ Rtsp แบบกำหนดเองในส่วนหัวสาธารณะของการตอบกลับตัวเลือก (#613)
- ใช้ค่าระยะหมดเวลาของคำตอบการตั้งค่า RTSP ในช่วงเวลาที่ส่งคำขอตัวเลือก RTSP แบบ "Keep-Alive" (#662)
ส่วนขยายโปรแกรมถอดรหัส (FFmpeg, VP9, AV1, MIDI ฯลฯ)
- เปิดตัวโมดูลตัวถอดรหัส MIDI ซึ่งรองรับการเล่นไฟล์ MIDI มาตรฐานโดยใช้ไลบรารี Jsyn เพื่อสังเคราะห์เสียง
- เพิ่ม DecoderOutputBuffer.shouldBeSkipped เพื่อทําเครื่องหมายบัฟเฟอร์เอาต์พุตที่ไม่ต้องแสดงโดยตรง ซึ่งวิธีนี้แนะนำมากกว่า C.BUFFER_FLAG_DECODE_ONLY ที่จะเลิกใช้งาน
- เพิ่ม Decoder.setOutputStartTimeUs และ SimpleDecoder.isAtLeastOutputStartTimeUs เพื่ออนุญาตให้โปรแกรมถอดรหัสส่งตัวอย่างที่ถอดรหัสเท่านั้นก่อนเวลาเริ่มต้น ซึ่งควรใช้แทน Buffer.isDecodeOnly ที่จะเลิกใช้งาน
- แก้ไขข้อบกพร่องในการเผยแพร่อาร์ติแฟกต์โปรแกรมถอดรหัส MIDI ไปยังที่เก็บ Maven เปลี่ยนชื่ออาร์ติแฟกต์เป็น media3-exoplayer-midi (#734)
ส่วนขยาย Leanback
- แก้ไขข้อบกพร่องที่การปิดใช้แพลตฟอร์มอาจทำให้เกิด ArithmeticException ในรหัส Leanback (#617)
ยูทิลิตีการทดสอบ
- ทําให้ TestExoPlayerBuilder และ FakeClock เข้ากันได้กับการทดสอบ UI ของ Espresso และการทดสอบ UI ของ Compose การแก้ไขนี้ช่วยแก้ไขข้อบกพร่องที่การเล่นจะข้ามไปข้างหน้าแบบไม่แน่นอนระหว่างการโต้ตอบกับมุมมอง Espresso หรือ Compose
นำสัญลักษณ์ที่เลิกใช้งานออก
- นำ TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) และ TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) ออก ให้ใช้ Composition.Builder.setHdrMode(int) และส่ง Composition ไปยัง Transformer.start(Composition, String) แทน
- นําเมธอด DownloadNotificationHelper.buildProgressNotification ที่เลิกใช้งานออก แล้วใช้เมธอดที่ยังไม่เลิกใช้งานซึ่งใช้พารามิเตอร์ notMetRequirements แทน

เวอร์ชัน 1.2.0-rc01

1 พฤศจิกายน 2023

เวอร์ชัน 1.2.0-beta01

19 ตุลาคม 2023

เวอร์ชัน 1.2.0-alpha02

29 กันยายน 2023

เวอร์ชัน 1.2.0-alpha01

17 สิงหาคม 2023