Media3
| नया अपडेट | स्टेबल रिलीज़ | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
|---|---|---|---|---|
| 11 नवंबर, 2026 | 1.11.1 | - | 1.12.0-beta01 | - |
डिपेंडेंसी का एलान करना
Media3 पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.
अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:
ग्रूवी
dependencies { def media3_version = "1.11.1" // For media playback using ExoPlayer implementation "androidx.media3:media3-exoplayer:$media3_version" // For DASH playback support with ExoPlayer implementation "androidx.media3:media3-exoplayer-dash:$media3_version" // For HLS playback support with ExoPlayer implementation "androidx.media3:media3-exoplayer-hls:$media3_version" // For SmoothStreaming playback support with ExoPlayer implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version" // For RTSP playback support with ExoPlayer implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version" // For MIDI playback support with ExoPlayer (see additional dependency requirements in // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md) implementation "androidx.media3:media3-exoplayer-midi:$media3_version" // For ad insertion using the Interactive Media Ads SDK with ExoPlayer implementation "androidx.media3:media3-exoplayer-ima:$media3_version" // For loading data using the Cronet network stack implementation "androidx.media3:media3-datasource-cronet:$media3_version" // For loading data using the OkHttp network stack implementation "androidx.media3:media3-datasource-okhttp:$media3_version" // For loading data using librtmp implementation "androidx.media3:media3-datasource-rtmp:$media3_version" // For building media playback UIs using Jetpack Compose implementation "androidx.media3:media3-ui-compose:$media3_version" // For building media playback UIs using Jetpack Compose with Material Design 3 implementation "androidx.media3:media3-ui-compose-material3:$media3_version" // For building media playback UIs using Views implementation "androidx.media3:media3-ui:$media3_version" // For building media playback UIs for Android TV using the Jetpack Leanback library implementation "androidx.media3:media3-ui-leanback:$media3_version" // For exposing and controlling media sessions implementation "androidx.media3:media3-session:$media3_version" // For extracting data from media containers implementation "androidx.media3:media3-extractor:$media3_version" // For inspecting media files implementation "androidx.media3:media3-inspector:$media3_version" // For extracting and processing video frames implementation "androidx.media3:media3-inspector-frame:$media3_version" // For integrating with Cast implementation "androidx.media3:media3-cast:$media3_version" // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version" // For transforming media files implementation "androidx.media3:media3-transformer:$media3_version" // For applying effects on video frames implementation "androidx.media3:media3-effect:$media3_version" // For applying Lottie effects on video frames implementation "androidx.media3:media3-effect-lottie:$media3_version" // For muxing media files implementation "androidx.media3:media3-muxer:$media3_version" // Utilities for testing media components (including ExoPlayer components) implementation "androidx.media3:media3-test-utils:$media3_version" // Utilities for testing media components (including ExoPlayer components) via Robolectric implementation "androidx.media3:media3-test-utils-robolectric:$media3_version" // Common functionality for reading and writing media containers implementation "androidx.media3:media3-container:$media3_version" // Common functionality for media database components implementation "androidx.media3:media3-database:$media3_version" // Common functionality for media decoders implementation "androidx.media3:media3-decoder:$media3_version" // Common functionality for loading data implementation "androidx.media3:media3-datasource:$media3_version" // Common functionality used across multiple media libraries implementation "androidx.media3:media3-common:$media3_version" // Common Kotlin-specific functionality implementation "androidx.media3:media3-common-ktx:$media3_version" }
Kotlin
dependencies { val media3_version = "1.11.1" // For media playback using ExoPlayer implementation("androidx.media3:media3-exoplayer:$media3_version") // For DASH playback support with ExoPlayer implementation("androidx.media3:media3-exoplayer-dash:$media3_version") // For HLS playback support with ExoPlayer implementation("androidx.media3:media3-exoplayer-hls:$media3_version") // For SmoothStreaming playback support with ExoPlayer implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version") // For RTSP playback support with ExoPlayer implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version") // For MIDI playback support with ExoPlayer (see additional dependency requirements in // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md) implementation("androidx.media3:media3-exoplayer-midi:$media3_version") // For ad insertion using the Interactive Media Ads SDK with ExoPlayer implementation("androidx.media3:media3-exoplayer-ima:$media3_version") // For loading data using the Cronet network stack implementation("androidx.media3:media3-datasource-cronet:$media3_version") // For loading data using the OkHttp network stack implementation("androidx.media3:media3-datasource-okhttp:$media3_version") // For loading data using librtmp implementation("androidx.media3:media3-datasource-rtmp:$media3_version") // For building media playback UIs using Compose implementation("androidx.media3:media3-ui-compose:$media3_version") // For building media playback UIs using Views implementation("androidx.media3:media3-ui:$media3_version") // For building media playback UIs using Jetpack Compose implementation("androidx.media3:media3-ui-compose:$media3_version") // For building media playback UIs for Android TV using the Jetpack Leanback library implementation("androidx.media3:media3-ui-leanback:$media3_version") // For exposing and controlling media sessions implementation("androidx.media3:media3-session:$media3_version") // For extracting data from media containers implementation("androidx.media3:media3-extractor:$media3_version") // For inspecting media files implementation("androidx.media3:media3-inspector:$media3_version") // For extracting and processing video frames implementation("androidx.media3:media3-inspector-frame:$media3_version") // For integrating with Cast implementation("androidx.media3:media3-cast:$media3_version") // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version") // For transforming media files implementation("androidx.media3:media3-transformer:$media3_version") // For applying effects on video frames implementation("androidx.media3:media3-effect:$media3_version") // For applying Lottie effects on video frames implementation("androidx.media3:media3-effect-lottie:$media3_version") // For muxing media files implementation("androidx.media3:media3-muxer:$media3_version") // Utilities for testing media components (including ExoPlayer components) implementation("androidx.media3:media3-test-utils:$media3_version") // Utilities for testing media components (including ExoPlayer components) via Robolectric implementation("androidx.media3:media3-test-utils-robolectric:$media3_version") // Common functionality for reading and writing media containers implementation("androidx.media3:media3-container:$media3_version") // Common functionality for media database components implementation("androidx.media3:media3-database:$media3_version") // Common functionality for media decoders implementation("androidx.media3:media3-decoder:$media3_version") // Common functionality for loading data implementation("androidx.media3:media3-datasource:$media3_version") // Common functionality used across multiple media libraries implementation("androidx.media3:media3-common:$media3_version") // Common Kotlin-specific functionality implementation("androidx.media3:media3-common-ktx:$media3_version") }
डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव/राय दें या शिकायत करें
आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. Media3 के समस्या ट्रैकर का इस्तेमाल करके, सवालों के जवाब, पहले से मौजूद समस्याएं, और सुविधाओं के अनुरोध ढूंढे जा सकते हैं. साथ ही, नई समस्याएं दर्ज की जा सकती हैं.
वर्शन 1.12.0
वर्शन 1.12.0-beta01
11 नवंबर, 2026
वर्शन 1.12.0-beta01 में ये कमिट शामिल हैं.
- कॉमन लाइब्रेरी:
C.DEFAULT_BUFFER_SEGMENT_SIZEको65536से घटाकर65520करें, ताकि हर बफ़र ऐलोकेशन (इसमेंbyte[]ऑब्जेक्ट हेडर भी शामिल है) एआरटी के बड़े ऑब्जेक्ट स्पेस में ओएस के पूरे पेजों में फ़िट हो जाए. इससे 4 केआईबी पेज वाले डिवाइसों पर सैंपल बफ़र मेमोरी का इस्तेमाल ~6% और 16 केआईबी पेज वाले डिवाइसों पर ~20% कम हो जाता है.androidx.media3.common.util.NullableTypeको JSpecify से बदलेंorg.jspecify.annotations.Nullable.- JSpecify के nullness एनोटेशन का इस्तेमाल करने के लिए,
androidx.media3.common.util.UnknownNullको हटाएं.RunnableFutureTaskकी Kotlin सबक्लास में, शून्य वैल्यू वाले नतीजे के टाइप (जैसे किVoid?) के लिए, शून्य वैल्यू वाले टाइप का आर्ग्युमेंट (उदाहरण के लिए,RunnableFutureTask<Void?, Exception>) तय करना ज़रूरी है. AdViewProvider.getAdVideoView()जोड़ें, ताकि वीडियो कंटेनरViewउपलब्ध कराया जा सके. विज्ञापन चलने के दौरान, इसका साइज़ बदला जा सकता है.MimeTypes.getMediaMimeTypeमेंmlpaRFC 6381 कोडेक स्ट्रिंग कोMimeTypes.AUDIO_TRUEHDपर मैप करें. इससे एचएलएस चंकलेस की तैयारी के दौरान, Dolby TrueHD ऑडियो ट्रैक के मौजूद न होने की समस्या ठीक हो जाएगी (#3485).- पास किए गए कलेक्शन को कॉपी करने के लिए
AdPlaybackState.withAdDurationsUsको ठीक करें और विज्ञापन ग्रुप के सभी कलेक्शन फ़ील्ड को कॉपी करने के लिएAdPlaybackState.fromAdPlaybackStateको ठीक करें, ताकि सेव किए गए या शेयर किए गए कलेक्शन की मदद से, किसी इंस्टेंस में बदलाव न किया जा सके. IllegalStateException("प्लेयर को गलत थ्रेड से ऐक्सेस किया गया है.") को ठीक किया गया. ऐसा तब होता है, जब प्लेयर के ऐप्लिकेशन थ्रेड के अलावा किसी अन्य थ्रेड सेPlayer.listenयाPlayer.listenToको रद्द किया जाता है. उदाहरण के लिए, Compose यूज़र इंटरफ़ेस (यूआई) टेस्ट टियरडाउन के दौरान (#3005).
- ExoPlayer:
- उस समस्या को ठीक किया गया है जिसमें आने वाले मीडिया पीरियड के लिए रेंडरर को जल्दी चालू करने पर, रेंडरिंग की प्रोसेस उस पीरियड में प्लेबैक ट्रांज़िशन से पहले शुरू हो सकती थी.
CompositeMediaSourceकी Kotlin सबक्लास, जो शून्य वैल्यू वाले चाइल्ड सोर्स आईडी (जैसे किVoid?) का इस्तेमाल करती हैं उन्हें शून्य वैल्यू वाले टाइप आर्ग्युमेंट (उदाहरण के लिए,CompositeMediaSource<Void?>) की जानकारी देनी होगी.AdsMediaSourceमें पुष्टि करें किAdPlaybackStateअपडेट के दौरान,AdPlaybackState.removedAdGroupCountमें कमी न आए.- उस समस्या को ठीक किया गया है जिसमें अलग-अलग रेंडरर का इस्तेमाल करने वाले मीडिया पीरियड के बीच ट्रांज़िशन करने पर, आउटगोइंग रेंडरर की रेंडरिंग पूरी होने से पहले ही इनकमिंग रेंडरर चालू हो जाता था. उदाहरण के लिए,
Flags.FLAG_PER_STREAM_MEDIA_PROGRESSIONचालू होने पर,IllegalStateException("एक से ज़्यादा रेंडरर मीडिया क्लॉक चालू हैं.") थ्रो करना. - उस समस्या को ठीक किया गया है जिसमें
Flags.FLAG_PER_STREAM_MEDIA_PROGRESSIONचालू होने पर, वीडियो चलाने की कस्टम स्पीड पर विज्ञापन पर ट्रांज़िशन करने से, सभी रेंडरर को विज्ञापन की अवधि तक आगे बढ़ाने में देरी हो सकती थी. - मीडिया पीरियड ट्रांज़िशन के दौरान, रेंडरर को पहले से वॉर्म करने से जुड़ी समस्याएं ठीक करना और ट्रैक को फिर से चुनने की सुविधा को बेहतर बनाना.
MediaPeriod.supportsStreamPrerollFlags()(डिफ़ॉल्ट रूप सेfalseपर सेट) जोड़ें, ताकि कस्टमMediaPeriodलागू करने वाले लोग,SampleStream.getFlags()का इस्तेमाल करके शुरुआती रुकावटों की रिपोर्टिंग के लिए ऑप्ट इन कर सकें. साथ ही, इसके काम न करने औरFlags.FLAG_PER_STREAM_MEDIA_PROGRESSIONके चालू होने पर,MediaPeriod.readDiscontinuity()पर वापस जा सकें.- उस समस्या को ठीक किया गया है जिसमें एक ही विज्ञापन ग्रुप में मौजूद किसी विज्ञापन को स्किप करने के बाद, दूसरे विज्ञापन को
DISCONTINUITY_REASON_SKIPके बजायDISCONTINUITY_REASON_AUTO_TRANSITIONके साथ रिपोर्ट किया जाता था. इसके अलावा, जबAdsMediaSourceलेज़ी कॉन्टेंट सोर्स प्रिपरेशन का इस्तेमाल करता था, तब रिपोर्ट नहीं किया जाता था.
- ट्रांसफ़ॉर्मर:
- CodecDB (
androidx.media3.transformer.codecdb) जोड़ें. यह एन्कोडर की क्वालिटी के मेज़र किए गए डेटा के आधार पर, मौजूदा डिवाइस के लिए वीडियो एन्कोडर के कॉन्फ़िगरेशन (कोडेक, एन्कोडर की सेटिंग, और बिटरेट) का सुझाव देता है.
- CodecDB (
- एक्सट्रैक्टर:
- एडीटीएस: पहले फ़्रेम के कुछ हिस्से के पेलोड में, गलत सिंक वर्ड से ऑडियो फ़ॉर्मैट को हासिल करने की समस्या को ठीक किया गया. इसकी वजह से, फ़्रेम के बीच में शामिल की गई लाइव एएसी स्ट्रीम को चलाने में समस्या आ सकती थी या वह रुक सकती थी (#3464).
AdtsExtractor FragmentedMp4ExtractorमेंArrayIndexOutOfBoundsExceptionको ठीक किया गया. ऐसा तब किया गया, जब फ़्रैगमेंट में बिना सैंपल वालाtrunबॉक्स मौजूद था (#3471).- ADTS:
AdtsExtractorमेंFLAG_DISABLE_ID3_METADATAजोड़ें, ताकि स्ट्रीम में मौजूद ID3 डेटा कोapplication/id3ट्रैक के तौर पर आउटपुट न किया जाए. - MP4: एएसी ट्रैक के गैपलेस प्लेबैक को ठीक किया गया. इन ट्रैक का मक्सर (जैसे, FFmpeg), एन्कोडर पैडिंग को हटाने के लिए आखिरी
sttsएंट्री को छोटा कर देता है. इसकी वजह से,elstकी बदलाव सूची से पैडिंग को 0 के तौर पर लिया जाता है और आखिरी फ़्रेम के आखिर तक चलाया जाता है (#3489). ID3से शुरू होने वाली खराब या बिना मीडिया वाली फ़ाइलों को स्निफ़ करते समय, बड़े अपफ़्रंट पीक बफ़र ऐलोकेशन औरOutOfMemoryErrorको ठीक करें (#3502).
- एडीटीएस: पहले फ़्रेम के कुछ हिस्से के पेलोड में, गलत सिंक वर्ड से ऑडियो फ़ॉर्मैट को हासिल करने की समस्या को ठीक किया गया. इसकी वजह से, फ़्रेम के बीच में शामिल की गई लाइव एएसी स्ट्रीम को चलाने में समस्या आ सकती थी या वह रुक सकती थी (#3464).
- इंस्पेक्टर:
- उस समस्या को ठीक किया गया है जिसमें
MetadataRetriever.retrieveDurationUs()से मिले फ़्यूचर को रद्द करने पर,close()कोMediaSourceरिलीज़ करने से रोका गया था (#3468). MediaExtractorCompatको ठीक करें, ताकि वह प्लैटफ़ॉर्मMediaExtractorसे मैच करने वाले पूर्णांक के तौर परMediaFormat.KEY_FRAME_RATEको दिखा सके.
- उस समस्या को ठीक किया गया है जिसमें
- ऑडियो:
- उस समस्या को ठीक किया गया है जिसमें बफ़र की गई स्किप की गई साइलेंस को
AudioSink.getCurrentPositionUs(boolean)में शामिल किया गया था. साथ ही, वीडियो चलाने से पहले,AudioSink.Listener.onSilenceSkipped()का इस्तेमाल करके स्किप किए गए हिस्से (#3472) की रिपोर्ट की गई थी. - कंप्रेस किए गए फ़ॉर्मैट से डिकोड किए गए, स्पेशलाइज़्ड मल्टीचैनल पीसीएम ऑडियो को चलाते समय, एपीआई 37 और इसके बाद के वर्शन पर
AudioTrack.Builder.setCodecProvenanceका इस्तेमाल करके, कोडेक की जानकारी सेट करें. AudioTrackको शुरू करने की कोशिशों को स्किप किए जाने की समस्या को ठीक किया गया. ऐसा तब होता था, जब एक सेकंड का ऑडियो, शुरुआती बफ़र साइज़ के बराबर या उससे बड़ा होता था. इस वजह से, सीमित ऑडियो मेमोरी वाले डिवाइसों पर डीटीएस-एचडी पासथ्रू की सुविधा काम नहीं करती थी (#3487).
- उस समस्या को ठीक किया गया है जिसमें बफ़र की गई स्किप की गई साइलेंस को
- वीडियो:
- पुराने सिस्टम के साथ काम करने वाली Dolby Vision प्रोफ़ाइल 7 की स्ट्रीम के लिए, H.265/HEVC डिकोडर पर वापस जाने की अनुमति दें. साथ ही, प्रोफ़ाइल 10 की उन स्ट्रीम के लिए AV1 डिकोडर पर वापस न जाएं जिनकी बेस लेयर, बिना किसी खास ट्रांसफ़र विशेषताओं के पूरी रेंज का सिग्नल देती है (#3486).
MediaCodecUtilमें डिकोडर चुनने की सुविधा को ठीक किया गया, ताकि ऐसे मुख्य डिकोडर न चुने जाएं जो फ़ॉर्मैट की प्रोफ़ाइल के साथ काम नहीं करते. जैसे, किसी दूसरी प्रोफ़ाइल के लिए Dolby Vision डिकोडर. ऐसा तब होता है, जब कोई भी डिकोडर फ़ॉर्मैट के साथ पूरी तरह से काम नहीं करता (#3486).
- टेक्स्ट:
DvbParserमें मेमोरी का इस्तेमाल कम करें. इसके लिए, सबटाइटल वाले हिस्सों को सीधे तौर पर उनके साइज़ के बिटमैप में रेंडर करें. ऐसा करने से, आपको फ़ुल-स्क्रीन स्क्रैच बिटमैप को बनाए रखने की ज़रूरत नहीं पड़ेगी.
- असर:
DefaultVideoFrameProcessorमें फ़्लश करते समयNullPointerExceptionको ठीक किया गया. उदाहरण के लिए,CompositionPlayerमें सीक या स्क्रब करते समय (#3470).- रिलीज़ के बाद प्रोवाइडर का फिर से इस्तेमाल किए जाने पर,
DefaultGlObjectsProvider.releaseकेGlExceptionथ्रो करने की समस्या को ठीक किया गया (#2016).
- मक्सर:
Mp4MuxerयाFragmentedMp4Muxerमें ट्रैक जोड़ते समय, ट्रैकFormatकी पुष्टि करें. इससे, सैंपल लिखते समय या मक्सर को बंद करते समय, बाद में होने वाली गड़बड़ी से बचा जा सकता है.Muxer.close()को बार-बार कॉल करने पर, लाइब्रेरीMuxerके सभी लागू होने वाले वर्शन में कोई कार्रवाई नहीं होती. साथ ही, मक्सर को बंद माना जाता है, भले हीclose()कोई गड़बड़ी दिखाए.close()के बाद किसी अन्य तरीके को कॉल करने पर, अबIllegalStateExceptionदिखता है.
- आईएमए एक्सटेंशन:
- IMA SDK के
ResizablePlayerइंटरफ़ेस का इस्तेमाल करें, ताकि इंटरैक्टिव विज्ञापन, विज्ञापन कंटेनर में वीडियो प्लेयर व्यू का साइज़ और जगह बदल सकें. साथ ही,ImaAdsLoader.requestAds(DataSpec, Object, AdViewProvider)जोड़ें (ImaAdsLoader.requestAds(DataSpec, Object, ViewGroup)अब काम नहीं करता).
- IMA SDK के
- सेशन:
- मीडिया बटन की प्राथमिकताओं वाले एपीआई को बेहतर बनाया गया है.
CacheBitmapLoaderमें कंप्रेस किए गए आर्टवर्क डेटा को सेव न करके, मेमोरी के इस्तेमाल को कम करें.- जब प्लैटफ़ॉर्म सेशन की सूची पहले से ही
nullहो, तो टाइमलाइन अपडेट पर ग़ैर-ज़रूरीMediaSession.setQueue(null)कॉल करने से बचें. उदाहरण के लिए, जबPlayer.COMMAND_GET_TIMELINEउपलब्ध न हो. - उस समस्या को ठीक किया गया है जिसमें
MediaSessionService, नया सेशन बनाने की कोशिश न करके, सेवा को ठीक से वापस पाने का विकल्प नहीं देता था (#3490). - जब लेगसी
MediaSessionCompatमेटाडेटा अपडेट, सूची में बदलाव किए बिना, सूची में मौजूद ऐक्टिव आइटम के मेटाडेटा या अवधि में बदलाव करता है, तबPlayer.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGEDके बजायPlayer.TIMELINE_CHANGE_REASON_SOURCE_UPDATEकी रिपोर्ट करें. - लेगसी सेशन के लिए, मौजूद न होने वाली आर्टवर्क को ठीक करें. ये सेशन, मान्य
METADATA_KEY_ALBUM_ARTके साथnullMETADATA_KEY_DISPLAY_ICON(या आर्टवर्क यूआरआई) सेट करते हैं: लेगसी मेटाडेटा को कन्वर्ट करते समय, अब आर्टवर्क की शून्य वैल्यू को स्किप कर दिया जाता है.
- यूज़र इंटरफ़ेस (यूआई):
ContentFrameऔरPlayerमेंsubtitlesकंपोज़ेबल स्लॉट जोड़ें. साथ ही, बिटमैप और हॉरिज़ॉन्टल टेक्स्ट सबटाइटल के संकेतों को रेंडर करने के लिए,media3-ui-compose-material3में डिफ़ॉल्ट सहायता जोड़ें.SubtitleView.setTextDirectionHeuristicको जोड़ें, ताकि दोनों दिशाओं में सबटाइटल टेक्स्ट रैपिंग के लिए इस्तेमाल किए जाने वाले टेक्स्ट डायरेक्शन ह्यूरिस्टिक को पसंद के मुताबिक बनाया जा सके (#3454).media3-ui-compose-material3मेंPlayerके सभी कंट्रोल स्लॉट ऐनिमेट करें. इनमें कस्टम स्लॉट भी शामिल हैं. साथ ही,PlayerDefaults.TopControls,CenterControls, औरBottomControlsसेvisibleपैरामीटर हटाएं. यह नुकसान पहुंचा सकने वाला बदलाव है, जो किसी अस्थिर एपीआई पर किया गया है.PlayerViewमेंAdViewProvider.getAdVideoView()का इस्तेमाल करने के लिए,exo_content_frameकोexo_content_frame_containerमें रैप करें.SubtitleViewमें मेमोरी का इस्तेमाल कम किया गया. इसके लिए, क्यू मिटाए जाने पर, कैश मेमोरी में सेव किए गए सबटाइटल बिटमैप और टेक्स्ट लेआउट को रिलीज़ किया गया. साथ ही, उस समस्या को ठीक किया गया जिसमें क्यू की चौड़ाई कम होने पर, सबटाइटल का पुराना टेक्स्ट दिखता रहता था.
- एचएलएस एक्सटेंशन:
- एचएलएस मीडिया के किसी ऐसे चंक को फिर से लोड करने पर आने वाली समस्याएं ठीक की गईं जो लोड नहीं हो पाया या जिसे रद्द कर दिया गया था. इन समस्याओं की वजह से, कुछ हद तक बफ़र किए गए सैंपल को खारिज या स्प्लाइस किए बिना सेव रखा जा सकता था या लोड की पोज़िशन को पुरानी सीक पोज़िशन पर रीसेट किया जा सकता था (#3362).
- अडैप्टिव ट्रैक स्विच के बाद, बफ़र किए गए सेगमेंट की शुरुआत में जाने पर,
IllegalStateExceptionको ठीक किया गया. - एचएलएस कॉन्टेंट स्टीयरिंग (#3465) की मदद से पाथवे स्विच करते समय, वीडियो चलाने से जुड़ी कई समस्याएं ठीक की गईं.
- DASH एक्सटेंशन:
- जब किसी स्ट्रीम में एम्बेड किए गए कई कैप्शन ट्रैक हों, तो डुप्लीकेट या खराब CEA-608 सबटाइटल की समस्या को ठीक किया गया (#887).
- Cast एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसमें Android TV रिसीवर,
RemoteCastPlayerलोड करने के अनुरोधों को छोड़ देते थे (#3462). com.google.android.gms:play-services-cast-frameworkडिपेंडेंसी को23.0.0पर अपडेट करें.CastParams.Builder.setSystemOutputSwitcherEnabled(boolean)जोड़ें, ताकि यह कॉन्फ़िगर किया जा सके कि Cast डिवाइस, सिस्टम आउटपुट स्विचर में दिखें. इसके लिए,AndroidManifest.xmlमेंMediaTransferReceiverका एलान करने की ज़रूरत नहीं है. साथ ही, एपीआई लेवल 37 या इसके बाद के वर्शन वाले डिवाइसों पर, एपीआई लेवल 37 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए, सिस्टम आउटपुट स्विचर को डिफ़ॉल्ट रूप से चालू करें.DefaultMediaItemConverterमें पहले से तय CastMediaMetadataफ़ील्ड के लिए सहायता उपलब्ध कराएं. इसके लिए,MediaItem.mediaMetadataप्रॉपर्टी के बिना फ़ील्ड कोMediaItem.mediaMetadata.extrasसे मैप करें. साथ ही,MediaInfo.customDataमें कस्टम एक्स्ट्रा को सुरक्षित रखें.- जब प्लेबैक यूआरआई मौजूद न हो या कन्वर्ज़न न हो पाए, तब
DefaultMediaItemConverterमें अपवादों को थ्रो करना बंद करें. साथ ही, बिना प्लेबैक यूआरआई वाले Cast सूची के आइटम के लिए,CastPlayerटाइमलाइन में मीडिया आईडी और मेटाडेटा को सुरक्षित रखें. SessionAvailabilityListener.onCastSessionAvailable(boolean)जोड़ें, ताकि यह पता चल सके कि उपलब्ध कास्ट सेशन को Intent to Join का इस्तेमाल करके शुरू किया गया था या नहीं. साथ ही,CastPlayerमें Intent to Join का इस्तेमाल करके कास्ट सेशन में शामिल होने पर, रिमोट प्लेबैक की स्थिति को सेव रखें. इसे लोकल प्लेयर की स्थिति से ओवरराइट न करें.DefaultMediaItemConverterऔरRemoteCastPlayerमें मौजूद नॉन-लाइव आइटम के लिए,MediaInfoऔर टाइमलाइन की अवधि कोMediaMetadata.durationMsसे पॉप्युलेट करें. साथ ही, रिसीवर से रिज़ॉल्व की गई अवधि और लाइव स्ट्रीम की स्थिति को सूची में मौजूद सभी आइटम के लिए बनाए रखें.
- उस समस्या को ठीक किया गया है जिसमें Android TV रिसीवर,
- डेमो ऐप्लिकेशन:
- सेशन डेमो ऐप्लिकेशन में, प्लेलिस्ट के आइटम को खींचकर और छोड़कर उनके क्रम को बदलने की अनुमति दें.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
androidx.media3.transformer.TextureAssetLoaderहटाएं. इसके बजाय,androidx.media3.transformer.RawAssetLoaderका इस्तेमाल करें.- सार्वजनिक
DefaultDecoderFactoryकंस्ट्रक्टर हटाएं. इसके बजाय,DefaultDecoderFactory.Builderका इस्तेमाल करें. DefaultLoadErrorHandlingPolicy.DEFAULT_TRACK_BLACKLIST_MSहटाएं. इसके बजाय,DefaultLoadErrorHandlingPolicy.DEFAULT_TRACK_EXCLUSION_MSका इस्तेमाल करें.DefaultVideoFrameProcessor.Factory.Builder.setRequireRegisteringAllInputFrames(boolean)को हटाएं. इसके बजाय,VideoFrameProcessor.INPUT_TYPE_SURFACE_AUTOMATIC_FRAME_REGISTRATIONका इस्तेमाल करें.EditedMediaItemSequence.Builder.experimentalSetForceAudioTrack(boolean)औरEditedMediaItemSequence.Builder.experimentalSetForceVideoTrack(boolean)को हटाएं. इसके बजाय,EditedMediaItemSequence.Builder(Set)का इस्तेमाल करें.EditedMediaItemSequence.forceAudioTrackहटाएं. इसके बजाय,trackTypes.contains(C.TRACK_TYPE_AUDIO)का इस्तेमाल करें.EditedMediaItemSequence.forceVideoTrackहटाएं. इसके बजाय,trackTypes.contains(C.TRACK_TYPE_VIDEO)का इस्तेमाल करें.ExportResult.durationMsऔरExportResult.Builder.setDurationMsको हटाएं. इसके बजाय,ExportResult.approximateDurationMsऔरExportResult.Builder.setApproximateDurationMsका इस्तेमाल करें.SilenceSkippingAudioProcessor.DEFAULT_PADDING_SILENCE_USहटाएं. इसके बजाय,silenceRetentionRatioका इस्तेमाल करके, साइलेंस मोड के व्यवहार के बारे में बताएं.Timeline.getPeriodPosition(Window, Period, int, long, long)हटाएं. इसके बजाय,Timeline.getPeriodPositionUs(Window, Period, int, long, long)का इस्तेमाल करें.
वर्शन 1.12.0-alpha02
26 अक्टूबर, 2026
वर्शन 1.12.0-alpha02 में ये कमिट शामिल हैं.
- Effect Play services:
- Google Play services के मीडिया इफ़ेक्ट उपलब्ध कराने वाला एक नया
media3-effect-play-servicesमॉड्यूल लॉन्च किया गया है. इसमें वीडियो को बेहतर बनाने की सुविधा के लिएEnhancementSessionDecoratorऔर ऑडियो सोर्स को अलग करने के लिएStudioSoundAudioProcessorशामिल है.
- Google Play services के मीडिया इफ़ेक्ट उपलब्ध कराने वाला एक नया
वर्शन 1.12.0-alpha01
21 अक्टूबर, 2026
वर्शन 1.12.0-alpha01 में ये कमिट शामिल हैं.
- कॉमन लाइब्रेरी:
C.COLOR_SPACE_DISPLAY_P3जोड़ें औरMediaFormatUtilऔरColorInfoआईएसओ कलर मैपिंग में, Display P3 कलर स्पेस के साथ काम करें.- एक्सपेरिमेंट के तौर पर उपलब्ध फ़ीचर फ़्लैग और कुछ लोगों के लिए रिलीज़ करने की सुविधा (
Flags.setCanaryModeEnabled) को मैनेज करने के लिए, एक सेंट्रलFlagsरजिस्ट्री जोड़ी गई. नए फ़्लैग एपीआई का इस्तेमाल करने के लिए, कई मौजूदा@ExperimentalApiतरीकों को माइग्रेट किया गया. MediaMetadata.playlistId,MediaMetadata.Builder.setPlaylistId(String),MediaMetadata.categories, औरMediaMetadata.Builder.setCategories(List<String>)जोड़ें.androidx.media3.common.util.NonNullApiको JSpecify से बदलेंorg.jspecify.annotations.NullMarked.
- ExoPlayer:
- उस समस्या को ठीक किया गया है जिसमें अगले पीरियड का पहला चंक लोड न होने पर, DASH मल्टी-पीरियड प्लेबैक अटक जाता है (#3396).
AnalyticsListener.onLoadErrorमेंwasCanceled = trueऔरMediaSourceEventListener.onLoadErrorकी रिपोर्ट करें, जब लोड करने की कोशिशें खत्म हो जाएं.ExoPlayer.addVideoFrameMetadataListenerऔरExoPlayer.removeVideoFrameMetadataListenerका इस्तेमाल करके, कईVideoFrameMetadataListenerइंस्टेंस रजिस्टर करने की सुविधा जोड़ी गई है. साथ ही,ExoPlayer.setVideoFrameMetadataListenerऔरExoPlayer.clearVideoFrameMetadataListenerको बंद कर दिया गया है.- हर पीरियड के लिए
AdPlaybackStateको स्प्लिट और ऑफ़सेट करके, मल्टी-पीरियड कॉन्टेंट (जैसे, DASH) में विज्ञापन दिखाने की सुविधा जोड़ें. PreCacheHelperमें रेस कंडिशन को ठीक किया गया. इसमें, तैयारी के लिए किए जा रहे अनुरोध को रद्द करने पर भी, बैकग्राउंड में डाउनलोड शुरू हो सकते थे.ProgressiveMediaSourceऔरDefaultMediaSourceFactoryपरsetLoadOnlySelectedTracks(true)को सीमित करें, ताकि सिर्फ़ चुने नहीं गए वीडियो और इमेज ट्रैक को फ़िल्टर किया जा सके. ऑडियो और टेक्स्ट ट्रैक हमेशा लोड होते हैं, ताकि बिना री-बफ़रिंग के ट्रैक को आसानी से स्विच किया जा सके.ProgressiveMediaSourceऔरDefaultMediaSourceFactoryपर, डिफ़ॉल्ट रूप सेsetLoadOnlySelectedTracks(true)को चालू करें. इससे मेमोरी की बचत होती है. साथ ही, सभी ट्रैक न चुने जाने पर,DefaultLoadControlबफ़र ऐलोकेशन कैलकुलेशन ज़्यादा सटीक तरीके से काम कर पाता है. ध्यान दें कि अगर वीडियो या इमेज ट्रैक को नहीं चुना गया है और उन्हें वीडियो चलने के दौरान चालू किया जाता है, तो वीडियो को बफ़र होने में ज़्यादा समय लग सकता है.- उस समस्या को ठीक किया गया है जिसमें डाइनैमिक शेड्यूलिंग चालू होने पर,
Player.getCurrentPosition()पुरानी वैल्यू दिखा सकता था. यह वैल्यू, हर सेकंड में सिर्फ़ कुछ बार अपडेट होती थी (#3286). - उस समस्या को ठीक किया गया है जिसमें
AudioTrackप्लेबैक हेड की पोज़िशन में अचानक कमी या रीसेट होने को, पूर्णांक ओवरफ़्लो के तौर पर गलत तरीके से माना जा सकता था. इससे बफ़रिंग में प्लेबैक रुक जाता था (#3407). - एक्सपेरिमेंटल
DefaultMediaCodecAdapterFactory.setAsyncCryptoSynchronizationEnabled(boolean)को हटाएं. - इंटरस्टीशियल या विज्ञापनों से, आखिर में क्लिप किए गए कॉन्टेंट पर वापस जाने पर, रेंडरर को बेवजह फिर से चालू करने और गड़बड़ियों से बचें (#3371).
- उस समस्या को ठीक किया गया है जिसमें
Flags.FLAG_PER_STREAM_MEDIA_PROGRESSIONचालू होने पर, प्लेलिस्ट में मौजूद अगले आइटम पर रेंडरर से जुड़ी गड़बड़ी होने की वजह से, मौजूदा वीडियो समय से पहले ही बंद हो जाता था. NullPointerExceptionको ठीक किया गया. यह समस्या तब हो सकती है, जबFlags.FLAG_PER_STREAM_MEDIA_PROGRESSIONचालू होने पर,ExoPlayerने रेंडरर को मीडिया की ऐसी अवधि में ट्रांज़िशन किया हो जो तैयार नहीं थी.- उस समस्या को ठीक किया गया है जिसमें
Flags.FLAG_VIDEO_RENDERER_DURATION_TO_PROGRESSचालू होने पर, डाइनैमिक शेड्यूलिंग के दौरान वीडियो फ़्रेम अचानक स्किप या ड्रॉप हो सकते थे. - लाइव स्ट्रीम के दौरान विज्ञापन दिखने पर वीडियो चलाना बंद करने से, Analytics में श्रोताओं की संख्या में
ArrayIndexOutOfBoundsExceptionकी गड़बड़ी को ठीक किया गया (#3423). - उस समस्या को ठीक किया गया है जिसमें
PreloadMediaSource,preload()को कॉल न किए जाने पर भी अचानक प्रीलोड इवेंट पोस्ट कर सकता था (#3408). - उस समस्या को ठीक किया गया है जिसमें मेटाडेटा ट्रैक के लिए
Format.subsampleOffsetUsको अनदेखा किया जाता था. इस वजह से, डिकोड किए गए SCTE-35 स्प्लाइस कमांड (#3413) में वीडियो चलाने के गलत टाइमस्टैंप दिखते थे. - एक ही सोर्स पर
preload()को कई बार कॉल करने पर,PreloadMediaSourceऔरDefaultPreloadManagerमें मेमोरी लीक की समस्या को ठीक किया गया (#3445). - कॉन्टेंट की टाइमलाइन रीफ़्रेश होने के दौरान,
AdsMediaSourceको रिलीज़ करते समयNullPointerExceptionको ठीक किया गया (#3442). - उस समस्या को ठीक किया गया है जिसमें प्रोग्रेसिव मीडिया को चलाने पर, वह गलत जगह पर जंप कर सकता था. ऐसा तब होता था, जब सीक करने के बाद लोड होने में (या वीडियो को शून्य के अलावा किसी अन्य जगह से चलाने पर) गड़बड़ी होती थी और फिर से कोशिश की जाती थी (#3440).
- Xiaomi TV Stick 4K (MiTV-AYFR0) H.264 डिकोडर के लिए, समस्या हल करने का तरीका जोड़ा गया. इससे रिज़ॉल्यूशन में आसानी से बदलाव करने पर, डिकोडर के फ़्रीज़ होने की समस्या हल हो गई है (#3457).
- जब पोस्ट किए गए लोड के पूरा होने या गड़बड़ी के कॉलबैक को लागू करने से पहले ट्रैकर को रोक दिया जाता है, तो
SteeringManifestTrackerमेंNullPointerExceptionको ठीक करें (#3443). - MP4 फ़ाइलों में
mebxबॉक्स वाले मेटाडेटा ट्रैक से, एचएजीसी (एसटी 2094-50) टाइम्ड मेटाडेटा प्लेबैक की सुविधा के साथ काम करना ज़रूरी है. - उस समस्या को ठीक करना जिसकी वजह से, प्लेलिस्ट में मौजूद मीडिया को लोड होने में ज़्यादा समय लगने पर, उसे स्किप किया जा सकता था.
- CompositionPlayer:
- वीडियो चलाने के वर्कफ़्लो के लिए,
Composition.Builder.setVideoFrameAggregationParametersका इस्तेमाल करके वीडियो फ़्रेम एग्रीगेशन के फ़्रेम रेट को कॉन्फ़िगर करने की सुविधा. - मल्टी-सीक्वेंस कंपोज़िशन में फ़्रेम ड्रॉप की समस्या को ठीक करें. यह समस्या, टाइमस्टैंप क्वांटाइज़ेशन या राउंडिंग मिसमैच की वजह से होती है. इसके लिए, फ़्रेम एग्रीगेशन के दौरान सबसे नज़दीकी टाइमस्टैंप वाला फ़्रेम चुनें. यह सुविधा सिर्फ़ एपीआई 29 से चालू की जा सकती है, क्योंकि इसके लिए हर वीडियो सीक्वेंस में एक अतिरिक्त फ़्रेम को होल्ड करना पड़ता है.
- वीडियो चलाने के वर्कफ़्लो के लिए,
- ट्रांसफ़ॉर्मर:
- एक्सपोर्ट वर्कफ़्लो के लिए,
Composition.Builder.setVideoFrameAggregationParametersका इस्तेमाल करके वीडियो फ़्रेम एग्रीगेशन के फ़्रेम रेट को कॉन्फ़िगर करने की सुविधा. - टाइमस्टैंप क्वांटाइज़ेशन या राउंडिंग मिसमैच की वजह से, कई सीक्वेंस वाले कंपोज़िशन में फ़्रेम ड्रॉप होने की समस्या को ठीक करें. इसके लिए, फ़्रेम एग्रीगेशन के दौरान सबसे नज़दीकी टाइमस्टैंप वाला फ़्रेम चुनें. यह सुविधा सिर्फ़ एपीआई 29 से चालू की जा सकती है, क्योंकि इसके लिए हर वीडियो सीक्वेंस में एक अतिरिक्त फ़्रेम को होल्ड करना पड़ता है.
AudioProcessorsका इस्तेमाल करते समय,Transformer#setAudioMimeType(AUDIO_RAW)का ध्यान रखें. इस समस्या को ठीक करने से पहले,MimeTypes.AUDIO_RAWका अनुरोध करने औरAudioProcessorलागू करने पर, कंप्रेस किया गया आउटपुट मिलता था.
- एक्सपोर्ट वर्कफ़्लो के लिए,
- ट्रैक चुनना:
- कुछ डिवाइसों पर, Dolby Vision ट्रैक के बजाय एसडीआर ट्रैक को गलत तरीके से प्राथमिकता देने की समस्या को ठीक किया गया (#3135).
- एक्सट्रैक्टर:
- Mp4Extractor: MP4 में Opus के लिए
dOpsबॉक्स पार्स करने की समस्या को ठीक किया गया. इसमेंPreSkip,InputSampleRate, औरOutputGainको बिग-एंडियन से लिटिल-एंडियन में नहीं बदला गया था. इस वजह से, एडिट लिस्ट मौजूद न होने पर ऑडियो के शुरुआती ~299 मि॰से॰ ड्रॉप हो जाते थे (#3431). Mp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES,Mp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES_H265,FragmentedMp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES, औरFragmentedMp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES_H265को हटाएं, क्योंकि H.264 और H.265 के लिए, GOP के अंदर सैंपल डिपेंडेंसी पार्स करने की सुविधा डिफ़ॉल्ट रूप से चालू होती है.- Mp4Extractor:
xyzबॉक्स से जगह की जानकारी के मेटाडेटा को पार्स करने की समस्या को ठीक किया गया. इन बॉक्स में,Mp4LocationDataको भरने के लिए ऊंचाई के निर्देशांक होते हैं. - एन्कोड किए गए ऑडियो फ़ॉर्मैट के लिए, हर सैंपल में ऑडियो फ़्रेम की संख्या का हिसाब लगाने के लिए,
ExtractorUtil.getFramesPerEncodedSampleजोड़ें (#3367). - टॉप-लेवल यूयूआईडी बॉक्स से एक्सएमपी मेटाडेटा निकालने के लिए,
Mp4ExtractorमेंFLAG_READ_XMP_METADATAजोड़ें. - डीवीडी-स्टाइल वाले MPEG-PS कॉन्टेंट को चलाते समय, खराब AC-3, डीटीएस, और एलपीसीएम ऑडियो को ठीक किया गया. इसके लिए, पेलोड को ऑडियो रीडर (#3327) को पास करने से पहले,
PsExtractorमें मौजूद हर पीईएस पैकेट सेprivate_stream_1सब-स्ट्रीम हेडर को हटा दिया गया. FragmentedMp4Extractorमें होने वाली गड़बड़ी को ठीक किया गया. यह गड़बड़ी तब होती थी, जब वर्शन 1tfdtबॉक्स, नेगेटिवbaseMediaDecodeTimeको एन्कोड करता था (#3412).- MPEG-TS:
Format.stereoModeको पॉप्युलेट करने के लिए, H.264 और H.265 फ़्रेम पैकिंग अरेंजमेंट एसईआई मैसेज को पार्स करने की सुविधा जोड़ी गई है (#3419). - Dolby Vision प्रोफ़ाइल 20 के कॉन्फ़िगरेशन डेटा को पार्स करना और Dolby Vision की उन प्रोफ़ाइलों को अस्वीकार करना जो काम नहीं करती हैं. ऐसा इसलिए, ताकि उन्हें गलत रंगों के साथ स्टैंडर्ड एचईवीसी के तौर पर न चलाया जाए (#3427).
- एमपी3: LAME/Xing एन्कोडर के डिले और पैडिंग मेटाडेटा में किए गए बदलावों को पहले जैसा किया गया, क्योंकि यह कई
MediaCodecएमपी3 डिकोडर के साथ काम नहीं करता (#3425). - Matroska: नेस्ट किए गए
ChapterAtomएलिमेंट को पार्स करते समय,NullPointerExceptionको ठीक किया गया (#3438). - Ogg: उस गड़बड़ी को ठीक किया गया है जिसमें 255 बाइट के साइज़ वाले पैकेट को अगले पैकेट के साथ मर्ज कर दिया जाता था. यह पैकेट, पेज की सीमा पर खत्म होता था.
- MP4:
Mp4ExtractorऔरFragmentedMp4Extractorमें,mebxबॉक्स में मौजूद टाइम मेटाडेटा ट्रैक को पार्स करें.it35कुंजी वाले ट्रैक,MimeTypes.APPLICATION_ITUT_T35के तौर पर दिखते हैं. इससे एचएजीसी प्लेबैक चालू हो जाता है. अन्यmebxट्रैक को तब तक अनदेखा किया जाता है, जब तकFLAG_EMIT_RAW_MEBX_DATAसेट न किया गया हो. अगर यह सेट किया गया है, तो सभीmebxट्रैक को रॉMimeTypes.APPLICATION_MEBXके तौर पर दिखाया जाता है. - Ogg: बिना किसी रुकावट के वीडियो चलाने के लिए, Opus एंड-पैडिंग को निकालने की सुविधा जोड़ी गई है (#2576). साथ ही, किसी ऐसे पेज पर जाने के बाद सैंपल टाइमस्टैंप को ठीक किया गया है जो जारी पैकेट से शुरू होता है.
- Ogg: चेन वाली Ogg Opus स्ट्रीम में, डिकोड करने से जुड़ी गड़बड़ियों और ~1 सेकंड के टाइमस्टैंप जंप को ठीक किया गया. इसके लिए, स्ट्रीम के बीच में मौजूद Opus आईडी और टिप्पणी हेडर पैकेट को अनदेखा किया गया.
- Mp4Extractor: MP4 में Opus के लिए
- इंस्पेक्टर:
MetadataRetrieverका इस्तेमाल करके, MP4 फ़ाइलों से एक्सएमपी मेटाडेटा वापस पाने की सुविधा.MediaExtractorCompatमेंmebxबॉक्स वाले टाइम मेटाडेटा ट्रैक कोMimeTypes.APPLICATION_MEBXके तौर पर एक्सट्रैक्ट करने की सुविधा.
- इंस्पेक्टर फ़्रेम:
FrameExtractorकी मदद से अल्ट्रा एचडीआर फ़्रेम निकालते समय, एसडीआर बेस इमेज में वाइड-गैमट BT.2020 रंगों की क्लिपिंग को ठीक करना. गैमट से बाहर के रंगों को अब क्लैंप करने के बजाय, sRGB गैमट में धीरे से कंप्रेस किया जाता है.
- ऑडियो:
- उन डिवाइसों के लिए समस्या हल करने का तरीका जोड़ें जो गलत थ्रेड पर
android.media.AudioDeviceCallbackको शुरू करते हैं (#3386). - कंप्रेस किए गए ऑफ़लोड के साथ ट्रैक ट्रांज़िशन के बाद, वीडियो चलाने में आने वाली संभावित समस्याओं को ठीक किया गया.
- Amazon Fire TV स्टिक पर आने वाली उस समस्या को ठीक किया गया है जिसमें पीरियड ट्रांज़िशन के दौरान, AC-3 ऑडियो फ़्रीज़ हो जाता था (#3448).
- Ogg और WebM/Matroska के लिए, स्ट्रीम के आखिर में एन्कोडर पैडिंग को ट्रिम करने की सुविधा जोड़ी गई. इससे Opus फ़ॉर्मैट में बिना किसी रुकावट के वीडियो चलाया जा सकता है (#2576).
- ट्रैक ट्रांज़िशन के दौरान, डाइनैमिक ऑफ़लोड गैपलेस डिले और पैडिंग अपडेट को ठीक करें, ताकि वे चल रहे ट्रैक के बजाय आने वाले ट्रैक पर लागू हों.
- सिंगल स्ट्रीम और प्लेलिस्ट की आखिरी स्ट्रीम पर, एन्कोडर की एंड-पैडिंग को ट्रिम करें. साथ ही, प्लेलिस्ट के बीच में बिना किसी रुकावट के ट्रांज़िशन की सुविधा दें (#2576).
- स्ट्रीम की शुरुआत में एन्कोडर की वजह से होने वाली देरी को ट्रिम करने के बाद,
TrimmingAudioProcessorमें ऑडियो बफ़र की ग़ैर-ज़रूरी कॉपी बनाने से बचें. साथ ही, स्ट्रीम के आखिर में पैडिंग को ट्रिम करने की ज़रूरत नहीं है.
- उन डिवाइसों के लिए समस्या हल करने का तरीका जोड़ें जो गलत थ्रेड पर
- वीडियो:
- एक जैसे रिलीज़ टाइमस्टैंप वाले देर से आने वाले वीडियो फ़्रेम की रिपोर्टिंग को ठीक करें, ताकि उन्हें स्किप किए गए फ़्रेम के बजाय, ड्रॉप किए गए फ़्रेम के तौर पर रिपोर्ट किया जा सके.
- टेक्स्ट:
- मीडिया के हिसाब से, अनजान सोर्स से इंस्टॉल किए गए सबटाइटल के टाइमस्टैंप को शिफ़्ट करने के लिए,
MediaItem.SubtitleConfiguration.timeOffsetUsजोड़ें. ऑफ़सेट को वीडियो चलाने के दौरानPlayer.replaceMediaItem(int, MediaItem)की मदद से बदला जा सकता है. इससे वीडियो चलाने में कोई रुकावट नहीं आती (#1976). - SubRip:
DefaultSubtitleParserFactoryमेंCharsetDetectorइंजेक्ट करने की सुविधा जोड़ी गई, ताकि बाइट ऑर्डर मार्क के बिना अलग से मौजूद SubRip सबटाइटल की कैरेक्टर एन्कोडिंग का पता लगाया जा सके (#2247).
- मीडिया के हिसाब से, अनजान सोर्स से इंस्टॉल किए गए सबटाइटल के टाइमस्टैंप को शिफ़्ट करने के लिए,
- असर:
- StudioSound GMSCore मॉड्यूल का इस्तेमाल करके, ऑडियो सोर्स को अलग करने के लिए
SoundSeparationAudioProcessorको लागू करें.
- StudioSound GMSCore मॉड्यूल का इस्तेमाल करके, ऑडियो सोर्स को अलग करने के लिए
- मक्सर:
Mp4MuxerऔरFragmentedMp4Muxerमें Opus के लिए,dOpsबॉक्स राइटिंग को ठीक किया गया. यहांPreSkip,InputSampleRate, औरOutputGainको बिग-एंडियन के बजाय लिटिल-एंडियन में लिखा गया था (#3431).Mp4Muxerका इस्तेमाल करके,Mp4LocationDataमें जीपीएस की मदद से ऊंचाई की जानकारी लिखने की सुविधा.Muxer.Factory.create(ParcelFileDescriptor)को जोड़ा गया, ताकि सीधेParcelFileDescriptorमें मक्सिंग की जा सके.- मीडिया डिकोड टाइमस्टैंप देने के लिए, फ़्रैगमेंट की गई MP4 फ़ाइलों के
trafबॉक्स में, डिफ़ॉल्ट रूप सेtfdt(ट्रैक फ़्रैगमेंट बेस मीडिया डिकोड टाइम) बॉक्स लिखें. Mp4Muxerमें E-AC-3 और E-AC-3 JOC (Dolby Atmos)dec3कंटेनर बॉक्स लिखने की सुविधा.MediaMuxerCompatमें WebM फ़ॉर्मैट के साथ काम करने की सुविधा जोड़ें.- फ़्रैगमेंट की गई MP4 फ़ाइलों के आखिर में
mfra(मूवी फ़्रैगमेंट रैंडम ऐक्सेस) बॉक्स लिखें, ताकिFLAG_READ_MFRA_FOR_SEEK_MAPका इस्तेमाल करकेFragmentedMp4Extractorमें खोज की जा सके. Mp4WriterऔरFragmentedMp4Writerमें क्रैश होने की समस्या को ठीक किया गया. यह समस्या तब आती थी, जब किसी अन्य सैंपल को लिखने से पहले, ईओएस सैंपल लिखा जाता था.- Dolby कॉन्टेंट को MP4 या फ़्रैगमेंटेड MP4 फ़ाइलों में मिक्स करते समय, कंटेनर हेडर में
dby1के साथ काम करने वाले ब्रैंड का विज्ञापन दिखाकर, कंटेनर की अनुपालन से जुड़ी समस्या को ठीक करें (#3369). Mp4MuxerऔरFragmentedMp4Muxerमें 32-बिट फ़्लोट पीसीएम ऑडियो ट्रैक के लिए सहायता जोड़ी गई (#3389).- ट्रैक जोड़ते समय,
Mp4MuxerऔरFragmentedMp4Muxerमें Dolby Vision की ऐसी प्रोफ़ाइलें अस्वीकार करें जो काम नहीं करतीं. Mp4MuxerऔरFragmentedMp4Muxerमें 24-बिट और 32-बिट वाले इंटीजर पीसीएम ऑडियो ट्रैक इस्तेमाल किए जा सकते हैं.
- आईएमए एक्सटेंशन:
ImaServerSideAdInsertionMediaSourceमें, प्लेयर के रोकने और फिर से शुरू करने के इवेंट को IMA SDK टूल पर फ़ॉरवर्ड करें.
- सेशन:
- लेगसी मेटाडेटा और ब्यौरों से प्लेलिस्ट और आइटम का मेटाडेटा भरने के लिए,
MediaConstants.EXTRAS_KEY_PLAYLIST_ID,MediaConstants.EXTRAS_KEY_PLAYLIST_TITLE,MediaConstants.EXTRAS_KEY_PLAYLIST_ARTWORK_URI, औरMediaConstants.EXTRAS_KEY_CATEGORIESजोड़ें. साथ ही, सुझावLibraryParams.extrasके लिएMediaConstants.EXTRAS_KEY_SUGGESTED_TYPEऔरMediaConstants.EXTRAS_KEY_TTL_SECONDSजोड़ें. - उन डिवाइसों पर
MediaSessionबनाते या रिलीज़ करते समयSecurityExceptionके क्रैश होने की समस्या को ठीक किया गया है जिन परPendingIntentकी सीमाएं सख्ती से लागू होती हैं. - उस समस्या को ठीक किया गया है जिसमें Android 12 (एपीआई 31 और 32) पर वीडियो चलाने के अनुरोधों के दौरान,
MediaSession.getControllerForCurrentRequest()नेnullदिखाया. ऐसा तब हुआ, जबMediaSessionServiceअब तक फ़ोरग्राउंड में नहीं था. MediaControllerके किसी ऐसे लेगसी सेशन से कनेक्ट होने परIllegalArgumentExceptionके क्रैश होने की समस्या को ठीक किया गया है जिसमें ज़्यादा से ज़्यादा वॉल्यूम की वैल्यू नेगेटिव हो.- उस समस्या को ठीक करें जिसमें रोके गए लेगसी
MediaSessionCompatपरMediaController.setMediaItemयाsetMediaItemsके बादplay()को कॉल करने पर,onPlayFrom*के बजाय काम न करने वालाonPrepareFrom*कॉलबैक भेजा जा सकता है या अनुरोध किए गए मीडिया आइटम को फिर से शुरू किए बिनाonPlay()भेजा जा सकता है. - कस्टम कमांड का जवाब मिलने पर, लेगसी
MediaBrowserमेंNullPointerExceptionको ठीक किया गया (#3432). IllegalArgumentExceptionके क्रैश होने की समस्या को ठीक किया गया. यह समस्या तब आती थी, जबBundleमें डुप्लीकेट कुंजियों के साथ लेगसी मेटाडेटा मिलता था.- लेगसी
MediaSessionCompatको कंट्रोल करते समय, एक हीLooperइटरेशन में किए गए आउटगोइंगMediaControllerCompat.TransportControlsकॉल को एक साथ जोड़ें. उदाहरण के लिए,setMediaItem,prepare, औरplayको एक साथ कॉल करने पर, अब एक हीonPlayFrom*कॉलबैक भेजा जाता है.
- लेगसी मेटाडेटा और ब्यौरों से प्लेलिस्ट और आइटम का मेटाडेटा भरने के लिए,
- यूज़र इंटरफ़ेस (यूआई):
- दाएं से बाएं लिखी जाने वाली भाषा के सबटाइटल में विराम चिह्न की पोज़िशन और स्पैन रेंज को सुरक्षित रखने की समस्या को ठीक किया गया. ऐसा तब किया गया, जब दोनों दिशाओं में टेक्स्ट रैपिंग की सुविधा चालू थी (#3454, #3455).
media3-ui-composeमॉड्यूल मेंTrackSelectionStateऔरTrackSelectionParametersStateक्लास और उनसे जुड़े कंपोज़ेबल स्टेट के रिमेंबर फ़ंक्शन जोड़ें.PresentationState.videoAspectRatioको पेश करें औरModifier.resizeWithContentScaleकोsourceSizeDp: Size?के बजायaspectRatio: Float?लेने के लिए कहें.- खिलाड़ी के मौजूदा क्यू सुनने के लिए,
media3-ui-composeमॉड्यूल मेंCuesStateक्लास औरrememberCuesStateकंपोज़ेबल जोड़ें. - अगर
ProgressSlider,ExoPlayerयाCompositionPlayerपर आधारित है, तो इसमें स्क्रबिंग मोड की सुविधा जोड़ें. PresentationStateमेंshowArtworkके लिए सहायता जोड़ें. साथ ही,ContentFrameऔरPlayerमें दिए गए वैकल्पिकartworkकंपोज़ेबल को रेंडर करने के लिए, इसका इस्तेमाल करें.artworkस्लॉट के लिए डिफ़ॉल्ट वैल्यू के तौर पर इस्तेमाल करने के लिए,Artworkकंपोज़ेबल जोड़ें.PlayPauseButtonState(showBuffering,showRetry,showReplay) में नए फ़ील्ड जोड़ें और ज़्यादा आइकॉन और बफ़रिंग इंडिकेटर रेंडर करने के लिए, उन्हेंPlayPauseButtonमें इस्तेमाल करें.- कस्टम प्लेबैक की स्थिति को मॉनिटर करने के लिए,
PlaybackStateक्लास जोड़ें. साथ ही,BufferingIndicatorको बटन से अलग कॉम्पोनेंट के तौर पर शामिल करें. - उस समस्या को ठीक किया गया है जिसमें
PlayerViewऔरPlayerControlView, मल्टी-पीरियड लाइव स्ट्रीम में लाइव पोस्टरोल प्लेसहोल्डर के लिए, पीरियड की सीमाओं पर विज्ञापन मार्कर दिखाते थे. Player,ContentFrame,PlayerDefaults, औरMiniControllerके कंपोज़ेबल स्लॉट को अब प्लेयर या कंट्रोल की विज़िबिलिटी, पैरामीटर के तौर पर नहीं मिलती. इसके बजाय, उन्हें कॉलिंग स्कोप से कैप्चर करें. उदाहरण के लिए,topControlsअब@Composable BoxScope.() -> Unitहै. यह एक अस्थिर एपीआई पर नुकसान पहुंचा सकने वाला बदलाव है.ContentFrame,Player, औरModifier.resizeWithContentScaleमेंalignmentपैरामीटर जोड़ें, ताकि स्केल किए गए कॉन्टेंट को उसके कंटेनर में रखा जा सके. साथ ही,ContentFrameके कॉन्टेंट को उसकी सीमाओं के हिसाब से क्लिप करें, ताकिContentScale.Cropकी मदद से स्केल किया गया वीडियो, कंटेनर से बाहर न जाए.ProgressSlider,ProgressStateWithTickCount, औरProgressStateWithTickIntervalमें लाइव स्ट्रीम के यूज़र इंटरफ़ेस (यूआई) की सुविधा जोड़ें. इसके लिए,isLiveऔरliveOffsetMsको एक्सपोज़ करें.media3-ui-compose-material3मेंLiveButtonकंपोज़ेबल जोड़ा गया (#2213).
- Ktor एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसमें
KtorDataSource, मिड-स्ट्रीम कनेक्शन की गड़बड़ियों कोHttpDataSourceExceptionदिखाने के बजाय, इनपुट के खत्म होने के तौर पर दिखा सकता था (#3460).
- उस समस्या को ठीक किया गया है जिसमें
- एचएलएस एक्सटेंशन:
EXT-X-STREAM-INFपरVIDEO-RANGE(PQऔरHLG) को पार्स करें औरEXT-X-I-FRAME-STREAM-INFकोFormat.colorInfoमें पार्स करें (#3441).- MPEG-TS
EXT-X-MAPके उन इनिशलाइज़ेशन सेगमेंट को पार्स करते समयNullPointerExceptionको ठीक किया गया जिनमें पीईएस मीडिया सैंपल (#3456) शामिल हैं. - एक्सपोज़्ड एचएलएस ट्रैक के लिए,
Format.idऔरFormat.metadataकोnullके तौर पर सेट करने से जुड़ी समस्या को ठीक किया गया है (#3402). - ऐसेट-लिस्ट विज्ञापनों को
X-PLAYOUT-LIMITपर क्लिप करें और उन विज्ञापनों को छोड़ दें जो तय सीमा से ज़्यादा लंबे हैं. साथ ही, कॉन्टेंट फिर से शुरू करने के ऑफ़सेट को डिफ़ॉल्ट रूप से 0 पर सेट करें. ऐसा तब करें, जब इंटरस्टीशियल विज्ञापनX-RESUME-OFFSETको छोड़ देता है और उसकी अवधि के बारे में जानकारी नहीं होती है. भले ही,X-PLAYOUT-LIMITसेट हो. - उस समस्या को ठीक किया गया है जिसकी वजह से
X-ASSET-LISTइंटरस्टीशियल को हल करने पर, उसी विज्ञापन ग्रुप में मौजूद अन्य इंटरस्टीशियल के कॉन्टेंट को फिर से शुरू करने के ऑफ़सेट योगदान को ओवरराइट कर दिया जाता था.
- DASH एक्सटेंशन:
DashManifestParserमें, वैकल्पिक एमपीडी इंसर्शन (urn:mpeg:dash:event:alternativeMPD:insert:2025) और रिप्लेसमेंट (urn:mpeg:dash:event:alternativeMPD:replace:2025) इवेंट को पार्स करने की सुविधा जोड़ी गई है. साथ ही, उन्हेंPeriod.alternativeMpdEventsमेंAlternativeMpdEventइंस्टेंस के तौर पर एक्सपोज़ किया गया है. यह उन ऐप्लिकेशन के लिए नुकसान पहुंचा सकने वाला बदलाव है जोDashManifestParserकी सबक्लास हैं:DashManifestParser.buildPeriodअब एक औरList<AlternativeMpdEvent>पैरामीटर लेता है. साथ ही, पिछले ओवरलोड को हटा दिया गया है.DashManifestParser.parseEventStream(XmlPullParser)को ओवरराइड करने वाले ऐप्लिकेशन को इसके बजाय,DashManifestParser.parseEventStream(XmlPullParser, String)को ओवरराइड करना चाहिए. ऐसा इसलिए, क्योंकि पहले वाले को अब सेवा से हटा दिया गया है और आने वाले समय में इसे निजी बना दिया जाएगा.EssentialPropertyऔरSupplementalPropertyडिस्क्रिप्टर से सीआईसीपी कलर की जानकारी (ColourPrimaries,TransferCharacteristics,MatrixCoefficients, औरVideoFullRangeFlag) को पार्स करके,Format.colorInfoमें बदलें (#3426).- ट्रिक मोड (
http://dashif.org/guidelines/trickmode) डिस्क्रिप्टर@valueएट्रिब्यूट (#3315) में,@idवैल्यू की व्हाइटस्पेस से अलग की गई सूचियों के साथ काम करता है. DashManifestParserमें<ProducerReferenceTime>को पार्स करने की सुविधा जोड़ी गई है. साथ ही, इसेAdaptationSet.producerReferenceTimesमें एक्सपोज़ किया गया है. इसके अलावा, वीओडी स्ट्रीम के लिएTimeline.Window.presentationStartTimeMsऔरTimeline.Window.windowStartTimeMsको पॉप्युलेट करने के लिए इसका इस्तेमाल किया गया है.- DASH कॉन्टेंट स्टीयरिंग के लिए सहायता जोड़ी गई (#1689).
NullPointerExceptionको ठीक किया गया. यह गड़बड़ी तब हो सकती है, जब<UTCTiming>एलिमेंट में एट्रिब्यूट मौजूद न होने पर, DASH मेनिफ़ेस्ट को पार्स किया जाता है (#3436).
- आरटीएसपी एक्सटेंशन:
- आरटीएसपी क्लाइंट बंद होने के बाद, नेटवर्क से मिलने वाले जवाबों को प्रोसेस करते समय,
IllegalStateExceptionके क्रैश होने की समस्या को ठीक किया गया. - उस समस्या को ठीक किया गया है जिसमें तेज़ी से स्क्रब करने पर, टीसीपी प्रोटोकॉल फ़ॉलबैक मैकेनिक गलत तरीके से ट्रिगर हो सकता था.
IllegalStateExceptionके क्रैश होने की समस्या को ठीक किया गया. यह समस्या तब हो सकती है, जब ट्रैक को फिर से चुनने, सेशन को खत्म करने या यूआरआई रीडायरेक्शन के दौरान, आरटीएसपी क्लाइंट के स्टेटस को रीसेट करने के बाद, नेटवर्क के जवाबों को प्रोसेस करने में देरी होती है.- उस समस्या को ठीक किया गया है जिसकी वजह से, वीडियो फिर से शुरू होने से पहले उसे फिर से आगे-पीछे करने पर,
IllegalStateExceptionक्रैश हो सकता था. - उस समस्या को ठीक किया गया है जिसमें वीडियो में आगे/पीछे जाने की प्रोसेस पहले से ही पेंडिंग होने पर, वीडियो में पीछे जाने से ऑडियो ड्रॉपआउट हो जाता था और वीडियो चलना बंद हो जाता था.
- उस समस्या को ठीक किया गया है जिसमें एग्रीगेशन या नॉन-आईडीआर पैकेट के साथ खत्म होने वाली H.264 और H.265 कीफ़्रेम ऐक्सेस यूनिट को कीफ़्रेम के तौर पर फ़्लैग नहीं किया जाता था. इस वजह से, वीडियो बफ़रिंग में अटक जाता था (#3434).
- आरटीएसपी क्लाइंट बंद होने के बाद, नेटवर्क से मिलने वाले जवाबों को प्रोसेस करते समय,
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- Opus एक्सटेंशन: अमान्य Opus डेटा को डिकोड करते समय, जेएनआई क्रैश होने की समस्या को ठीक किया गया.
- Opus एक्सटेंशन: प्री-स्किप और डिसकार्ड पैडिंग एक ही पैकेट पर होने पर, डिसकार्ड पैडिंग को अनदेखा किए जाने की समस्या को ठीक किया गया (#2576).
- Cast एक्सटेंशन:
- सेशन के उपलब्ध न होने की वजह बताने के लिए,
SessionAvailabilityListener.SessionUnavailableReasonको शामिल किया गया है. साथ ही, इसे दिखाने के लिएSessionAvailabilityListener.onCastSessionUnavailableके लिए ओवरलोड किया गया तरीका उपलब्ध कराया गया है. - उस समस्या को ठीक किया गया है जिसकी वजह से कास्ट सेशन बंद करने के बाद, वीडियो अचानक से डिवाइस पर फिर से चलने लगता था.
RemoteCastPlayerमेंRemoteMediaClientकार्रवाइयां (जैसे, चलाना, रोकना, स्पीड बदलना, रिपीट मोड, आवाज़, म्यूट करना या ट्रैक चुनना) पूरी न होने पर, गड़बड़ी को लॉग करें (#3373).RemoteCastPlayerमेंArrayIndexOutOfBoundsExceptionको ठीक किया गया. ऐसा तब किया गया, जब सीक ऑपरेशन के बाकी रहने के दौरान, Cast रिसीवर की सूची में बदलाव हुआ या वह छोटी हो गई (#3372).- डिफ़ॉल्ट Cast रिसीवर से जुड़ी समस्या को ठीक किया गया. इसमें टाइमलाइन पर, पूरी प्लेलिस्ट के बजाय सिर्फ़ चालू आइटम के आस-पास के मीडिया आइटम तुरंत पॉप्युलेट होते थे (#3129).
- प्लेलिस्ट (
setMediaItems,addMediaItems,moveMediaItems,removeMediaItems) में बदलाव करते समय याRemoteCastPlayerमें खोजते समय, टाइमलाइन और वीडियो चलाने की पोज़िशन को तुरंत अपडेट करें. साथ ही, प्लेलिस्ट में होने वाली कार्रवाइयों को सूची में जोड़ें, ताकि वे क्रम से सही तरीके से लागू हों (#2639, #3272). - उस समस्या को ठीक किया गया है जिसमें
RemoteCastPlayerमें खाली सूची परaddMediaItemsको कॉल करने पर, कास्ट रिसीवर पर मीडिया आइटम लोड नहीं हो पाते थे (#2402). RemoteCastPlayerमें आ रही एक समस्या को ठीक किया गया है. इसमें Cast रिसीवर की सूची के आखिर में पहुंचने पर, प्लेलिस्ट को बनाए रखने के बजाय टाइमलाइन को मिटा दिया जाता था.- उस समस्या को ठीक किया गया है जिसमें मीडिया आइटम लोड करने से पहले,
RemoteCastPlayerपर सेट किए गएplayWhenReady,repeatMode, औरplaybackParametersट्रांसफ़र या लागू नहीं होते थे. उदाहरण के लिए,CastPlayerमें लोकल से रिमोट प्लेबैक ट्रांसफ़र के दौरान (#889).
- सेशन के उपलब्ध न होने की वजह बताने के लिए,
- डेमो ऐप्लिकेशन:
- सेशन के डेमो ऐप्लिकेशन कैटलॉग में, डीआरएम से सुरक्षित मीडिया आइटम और एक अतिरिक्त एचएलएस सैंपल स्ट्रीम के लिए सहायता जोड़ें.
- कास्ट करते समय सबटाइटल और ऑडियो ट्रैक चुनने की सुविधा चालू करने के लिए, सेशन डेमो ऐप्लिकेशन में
CastTrackSelectorके साथRemoteCastPlayerको कॉन्फ़िगर करें.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
DashUtil.buildDataSpec(Representation, RangedUri, int)औरDashUtil.buildDataSpec(Representation, String, RangedUri, int)को हटाएं. इसके बजाय,DashUtil.buildDataSpec(Representation, BaseUrl, RangedUri, int, Map<String, String>)का इस्तेमाल करें.
- बनाएं:
- Gradle
minSdkको 24 पर सेट करें.
- Gradle
वर्शन 1.11.0
1.11.1
10 सितंबर, 2026
- ExoPlayer:
- प्रोग्रेसिव मीडिया के लिए, एचएजीसी मेटाडेटा को चालू/बंद करने वाले फ़्लैग को
MediaSource.FactoryसेExtractorsFactoryपर ले जाएं.setExperimentalEnableHagcPlaybackके पिछले तरीके को हटा दिया गया है और उसकी जगहExtractorsFactory.setParseHagcMetadataका इस्तेमाल किया गया है. इससे वह समस्या भी हल हो जाती है जिसमें Matroska/WebM कंटेनर के लिए, इस सुविधा को बंद करने पर भी यह काम करती थी. - वीडियो चलाने में आने वाली उस रुकावट को ठीक किया गया है जो ट्रांज़िशन न करने वाले सेकंडरी रेंडरर को पहले से वॉर्म करने की वजह से होती है.
- प्री-वॉर्मिंग की समस्या को ठीक करना. इसमें, जब कोई खोज रीसेट होती है और दोनों रेंडरर बंद हो जाते हैं, तो
Surfaceको प्राइमरी रेंडरर पर वापस भेज दिया जाना चाहिए. ArrayIndexOutOfBoundsExceptionको ठीक किया गया. ऐसा तब होता है, जब लाइव टाइमलाइन रीफ़्रेश होने पर, डिफ़ॉल्ट पोज़िशन, सर्वर-साइड पर डाले गए उस विज्ञापन से आगे बढ़ जाती है जो फ़िलहाल चलाया जा रहा है (#3348).- स्क्रबिंग मोड की उस समस्या को ठीक किया गया है जिसमें
ScrubbingModeParameters.allowSkippingMediaCodecFlushचालू होने पर, वीडियो को आगे-पीछे करने पर कुछ समय के लिए पुराने वीडियो फ़्रेम दिख सकते थे.
- प्रोग्रेसिव मीडिया के लिए, एचएजीसी मेटाडेटा को चालू/बंद करने वाले फ़्लैग को
- एक्सट्रैक्टर:
- Matroska: उस समस्या को ठीक किया गया है जिसमें क्लस्टर के बाद रखे गए ट्रैक, सीक की जा सकने वाली टाइमलाइन में नहीं दिखते थे (#3377).
- ऑडियो:
SilenceSkippingAudioProcessorमें बफ़र साइज़ का हिसाब लगाने की सुविधा को ठीक किया गया है, ताकि फ़्रेम साइज़ (#3271) की वजह से, आवाज़ न होने की कम से कम अवधि को गलत तरीके से कम न किया जाए.PcmAudioUtilमें 8-बिट पीसीएम हैंडलिंग को ठीक किया गया, ताकि सैंपल को अनसाइंड के तौर पर ट्रीट किया जा सके. ऐसा Android के मुताबिक किया गया है (#3271).- ऑफ़लोड से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, हार्डवेयर बफ़र साइज़ सीमित होने पर, प्री-रोल या बिना गैप वाले ट्रांज़िशन के दौरान वीडियो रुक सकता था.
DefaultAudioSinkमें मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, वीडियो चलाने वाला थ्रेड बंद होने पर भी रिलीज़ की संख्या कम नहीं होती थी (#3338).
- सेशन:
Player.Listenerकॉलबैक से प्रोसेस में मौजूदMediaControllerको रिलीज़ करने पर,NullPointerExceptionको ठीक किया गया (#3375).- जब कोई लेगसी
MediaBrowserकिसी ऐसी सेवा से कनेक्ट होती है जोonGetLibraryRoot()याonConnectAsync()से एसिंक्रोनस नतीजा दिखाती है, तो मुख्य थ्रेड पर डेडलॉक को ठीक करें (#3393).
- एचएलएस एक्सटेंशन:
- DASH एक्सटेंशन:
- इमेज ट्रैक के लिए, सैंपल के गलत टाइमस्टैंप की गिनती को ठीक किया गया
presentationTimeOffset(#3334).
- इमेज ट्रैक के लिए, सैंपल के गलत टाइमस्टैंप की गिनती को ठीक किया गया
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- Opus: एक साथ कई
OpusDecoderइंस्टेंस शुरू होने पर, मेमोरी खराब होने की समस्या को ठीक किया गया. - MPEG-H: मेमोरी लीक, ASCII के बाहर के वर्णों को छोटा करने, और कम मेमोरी होने पर
MpeghUiManagerको निर्देश भेजने पर संभावित नेटिव क्रैश की समस्या को ठीक किया गया है (#3365).
- Opus: एक साथ कई
वर्शन 1.11.0
05 अगस्त, 2026
- कॉमन लाइब्रेरी:
- ऑडियो चैनल मास्क को साफ़ तौर पर दिखाने के लिए,
Format.channelMaskजोड़ें. साथ ही, इसे सुरक्षित तरीके से हल करने के लिए, एक नयाUtil.getAudioTrackChannelConfig(Format)ओवरलोड जोड़ें. - Kotlin को 2.0.20 से 2.2.0 पर अपग्रेड करें.
- ऑडियो चैनल मास्क को साफ़ तौर पर दिखाने के लिए,
- ExoPlayer:
- समय पर निर्भर करने वाली कॉनकरेंसी की गड़बड़ी को ठीक किया गया है. इसकी वजह से, ExoPlayer में
IllegalStateExceptionयाIndexOutOfBoundsExceptionहो सकता था. AdsMediaSourceमें विज्ञापन ग्रुप की संख्या की जांच को कम करें, ताकि विज्ञापन ग्रुप की संख्या कम हो सके. ऐसा तब होगा, जब विज्ञापन ग्रुप पूरी तरह से प्रोसेस हो जाएगा (hasUnplayedAds(),falseहै). इससे रीसेट वर्कफ़्लो के दौरान, डाइनैमिक विज्ञापन ग्रुप का साइज़ बदला जा सकेगा.SampleStreamमेंgetFlags()औरFLAG_STRICT_DURATIONजोड़ें, ताकि स्ट्रीम, फ़्लैग की रिपोर्ट कर सकें. साथ ही, रेंडरर को अपडेट करें, ताकि वे इन फ़्लैग की डाइनैमिक तौर पर जांच कर सकें.- जब स्ट्रीम फ़ॉर्मैट से मान्य वैल्यू न मिले, तब कोडेक के ऑपरेटिंग रेट का हिसाब लगाने के लिए,
MediaCodecVideoRendererमें फ़्रेम रेट का अनुमान लगाने वाले टूल औरMediaCodecAudioRendererमें कोडेक के आउटपुट फ़ॉर्मैट का इस्तेमाल करें. साथ ही, कोडेक को बेवजह रीसेट करने से बचें. - कोर प्लेयर में क्लाइंट-साइड से डाले गए विज्ञापनों के लिए, कॉन्टेंट की क्लिपिंग हटाएं. इसके बजाय,
AdsMediaSourceक्लिपिंग लॉजिक का ध्यान रखता है. क्लाइंट-साइड पर डाले गए कस्टम विज्ञापनों के सोर्स को अपडेट करना होगा, ताकि कॉन्टेंट क्लिपिंग को इंटरनल तौर पर लागू किया जा सके. - सही तरीके से बनाए गए, लेकिन पहचाने नहीं जा सकने वाले कोडेक प्रोफ़ाइल या लेवल
वाले ट्रैक को
supported=YESके बजायsupported=NO_EXCEEDS_CAPABILITIESके तौर पर मार्क करें. के तौर पर उन ट्रैक को मार्क किया जाता है जिनकी प्रोफ़ाइल या लेवल की जानकारी मौजूद नहीं होती या गलत होती है. इससे यह पक्का होता है कि बेहतर विकल्प उपलब्ध होने पर, ऐसे ट्रैक न चुने जाएं जो डिवाइस पर काम न करें. DefaultPreloadManager.SimpleRankingDataComparatorजोड़ें, जो एकRankingDataComparatorहै. यह मीडिया आइटम की रैंक की तुलना, मौजूदा मीडिया आइटम के इंडेक्स से उनकी दूरी के आधार पर करता है. अगर तुलना करने के लिए ज़्यादा सटीक लॉजिक की ज़रूरत है, तो ऐप्लिकेशन इसकेcompare(Integer, Integer)तरीके को बदल सकते हैं. कस्टमSimpleRankingDataComparatorकोDefaultPreloadManager.Builderके नए कंस्ट्रक्टर के ज़रिए इंजेक्ट किया जा सकता है.- अगर उपलब्ध हीप मेमोरी कम लगती है, तो बफ़र बाइट साइज़ की सीमाओं पर वापस जाकर,
DefaultLoadControl.prioritizeTimeOverSizeThresholdsके ओओएम के जोखिम को कम करें. MediaItem.imageDurationUsसेट न होने पर, स्टिल इमेज को हैंडल करने के तरीके को अलाइन करें: JPEG और HEIC स्टिल इमेज अब डिफ़ॉल्ट रूप से बहुत कम समय के लिए 'चलाई' जाती हैं. PNG और अन्य इमेज पहले इसी तरह काम करती थीं.BandwidthMeterकोMediaSourceसे जोड़ने के लिए,MediaSource.prepareSource(MediaSourceCaller, PlayerId, BandwidthMeter)जोड़ें. हालांकि, कस्टम तरीके से लागू किए गए पुराने तरीके को डिफ़ॉल्ट रूप से कॉल किया जाएगा. हमारा सुझाव है कि आप नया तरीका लागू करें और पुराने तरीके की तरह ही काम करने के लिए,BandwidthMeter.getTransferListener()का इस्तेमाल करें.DefaultBandwidthMeterमें, कस्टमInitialBitrateSupplierके काम करने की सुविधा जोड़ें. इससे ऐप्लिकेशन, शुरुआती बिटरेट का अनुमान लगाने के लिए अपना लॉजिक उपलब्ध करा पाते हैं. इसका इस्तेमाल,DefaultBandwidthMeterबनाने और नेटवर्क टाइप में बदलाव करने पर किया जाएगा. सप्लायर कोDefaultBandwidthMeter.Builder.setInitialBitrateSupplier()की मदद से सेट किया जा सकता है.- डिफ़ॉल्ट रूप से, डाइनैमिक शेड्यूलिंग की सुविधा चालू करें.
ExoPlayerप्लेबैक वर्क लूप, स्टैटिक इंटरवल के बजाय डाइनैमिक तौर पर चलेगा. - ट्रैक को प्री-रोल सैंपल के साथ ऐक्टिव प्लेबैक में शामिल करते समय, बेवजह होने वाले रीसेट को हटाएं.
DefaultBandwidthMeterमें,getInitialBitrateCountryGroupAssignmentको ऑप्टिमाइज़ करें, ताकि देश के ग्रुप के असाइनमेंट को कलेक्शन के बजाय 32-बिट के पूर्णांक में पैक करके दिखाया जा सके. इससे कोड का साइज़ कम हो जाता है और असाइनमेंट से बचा जा सकता है.- कुछ डिवाइसों पर
AudioTrackके शुरू न होने की समस्या को ठीक किया गया. इसके लिए, यह पक्का किया गया कि अगर बफ़र साइज़ को आधा करके फिर से कोशिश करने पर भी समस्या हल नहीं होती है, तो फिर से कोशिश करने का लॉजिक हमेशा कम से कम एक सेकंड के बफ़र साइज़ की कोशिश करे (#3207). - कुछ डिवाइसों पर कोडेक की समस्या को ठीक किया गया है. इन डिवाइसों पर, इनपुट बफ़र मिलने से पहले कोडेक को फ़्लश करने पर, वह सभी सैंपल को हटा देता था.
- एक्सपेरिमेंटल
ExoPlayer.Builder.enablePerStreamMediaProgression()जोड़ें, ताकि हर स्ट्रीम के हिसाब से मीडिया प्रोसेसिंग को बेहतर बनाया जा सके. इससे प्लेलिस्ट के आइटम के बीच स्टार्टअप लेटेंसी कम हो जाती है. साथ ही, बहुत छोटे कॉन्टेंट (#3122) के साथ वीडियो चलाने की सुविधा "अटकने" से बच जाती है. - ऑडियो सेशन आईडी के इस्तेमाल से जुड़ी रेस कंडिशन को ठीक किया गया. इसमें
setAudioSessionIdकी सेट की गई वैल्यू के बजाय,ExoPlayerसे अपने-आप जनरेट हुए शुरुआती ऑडियो सेशन आईडी का इस्तेमाल किया जाता था (#3241). - प्रोग्रेसिव मीडिया (जैसे, MP4, Matroska) के लिए, एक्सपेरिमेंट के तौर पर एचएजीसी (एसटी 2094-50) टाइम किए गए मेटाडेटा प्लेबैक की सुविधा जोड़ी गई. प्लेयर, एचएजीसी मेटाडेटा ट्रैक को उससे जुड़े वीडियो ट्रैक के साथ अपने-आप मर्ज कर देता है. साथ ही, एपीआई 37 और इसके बाद के वर्शन वाले डिवाइसों पर, डिकोडर को आउट-ऑफ़-बैंड मेटाडेटा डिलीवर करता है. इस सुविधा को
DefaultMediaSourceFactory.setExperimentalEnableHagcPlayback(false)से बंद किया जा सकता है. - ट्रैक चुनने में
Formatकी प्राथमिकता को दिखाने के लिए,Format.selectionPriorityजोड़ें (#3236). - स्क्रबिंग मोड की संभावित समस्या को ठीक किया गया है. इसमें 'स्ट्रीम के आखिर' तक पहुंचने पर, स्क्रबिंग रुक सकती थी.
- समय पर निर्भर करने वाली कॉनकरेंसी की गड़बड़ी को ठीक किया गया है. इसकी वजह से, ExoPlayer में
- CompositionPlayer:
- उस समस्या को ठीक किया गया है जिसकी वजह से
TrackSelectorइंस्टेंस रिलीज़ नहीं हो रहे थे.
- उस समस्या को ठीक किया गया है जिसकी वजह से
- ट्रांसफ़ॉर्मर:
- उस समस्या को ठीक करना जिसकी वजह से
ExportResult.fileSizeBytesकी संख्या ज़रूरत से ज़्यादा दिख सकती है.
- उस समस्या को ठीक करना जिसकी वजह से
- ट्रैक चुनना:
BaseTrackSelection.DEFAULT_FORMAT_COMPARATORको एक्सपोज़ करें औरAdaptiveTrackSelection.Factory.setTrackFormatComparatorको जोड़ें, ताकि कस्टम फ़ॉर्मैट के क्रम और एबीआर चुनने की प्राथमिकता को सिर्फ़ बिटरेट के क्रम से ज़्यादा की अनुमति दी जा सके.- समय पर निर्भर करने वाली एक साथ होने वाली समस्या को ठीक किया गया है. इसमें ट्रैक चुनने के पैरामीटर में तेज़ी से होने वाले क्रम के अपडेट की वजह से, कुछ अपडेट खो सकते हैं या ओवरराइट हो सकते हैं.
- एक्सट्रैक्टर:
- MP4, MP3, और FLAC: कंटेनर को पार्स करने के दौरान, अटैच की गई तस्वीरों और कवर आर्ट के मेटाडेटा को खारिज करने की अनुमति देने के लिए,
FLAG_DISABLE_ARTWORK_METADATAको जोड़ा गया. इससे रनटाइम के दौरान मेमोरी की खपत कम होगी (#2077). इसेDefaultExtractorsFactory.setDisableArtworkMetadataकी मदद से, एक ही जगह से भी चालू किया जा सकता है. - MP4: ITU-T T.35 (
it35) टाइम मेटाडेटा ट्रैक निकालने के लिए सहायता जोड़ें. - MP4: चैप्टर के मेटाडेटा को एक्सट्रैक्ट करने के लिए सहायता जोड़ी गई. यह Nero और QuickTime, दोनों फ़ॉर्मैट के लिए उपलब्ध है. अगर दोनों मौजूद हैं, तो QuickTime चैप्टर को प्राथमिकता दी जाती है. चैप्टर की निकाली गई जानकारी, ट्रैक के
MetadataमेंChapterएंट्री के तौर पर दिखती है. इससे MP4, M4A, और M4B फ़ाइलों (जैसे, ऑडियो बुक और पॉडकास्ट) में नेटिव चैप्टर नेविगेशन की सुविधा मिलती है (#2803). - WAV, Matroska, और MP4: 64-बिट फ़्लोटिंग पॉइंट पीसीएम ऑडियो के लिए सहायता जोड़ी गई (#3090).
- Matroska:
ColorInfoको सटीक तरीके से भरने के लिए, कोडेक बिटस्ट्रीम मेटाडेटा का इस्तेमाल करें. - MP4:
sidxबॉक्स मौजूद न होने पर,mfraबॉक्स का इस्तेमाल करके, फ़्रैगमेंट की गई MP4 फ़ाइलों में वीडियो को आगे-पीछे करने की सुविधा जोड़ी गई. इसे चालू करने के लिए,FragmentedMp4ExtractorकोFLAG_READ_MFRA_FOR_SEEK_MAPदें. यह अबDefaultExtractorsFactory(#3088) में डिफ़ॉल्ट रूप से किया जाता है. av1Cके ऐसे डेटा को अनदेखा करें जिसका वर्शन काम नहीं करता.- MP4:
fpcmबॉक्स में बिग-एंडियन फ़्लोटिंग पॉइंट पीसीएम के लिए सहायता जोड़ी गई. - Matroska: ट्रैक के
MetadataमेंChapterएंट्री के लिए, चैप्टर की जानकारी को पार्स करें. - MPEG-TS: DTS-HD और DTS Express स्ट्रीम को बेहतर तरीके से एक्सट्रैक्ट करने के लिए, कोर और एक्सटेंशन सबस्ट्रीम को एक ही सैंपल में जोड़ें. इससे वीडियो चलाने से जुड़ी उन समस्याओं को ठीक किया जा सकेगा जिनमें दोनों को पहले अलग-अलग सैंपल के तौर पर आउटपुट किया जाता था (#3147).
- MP4: खाली
ilstमेटाडेटा टैग आइटम को पार्स करते समय, इनफ़ाइनाइट लूप और आउट-ऑफ़-बाउंड रीड को रोकें (#3191). - MPEG-TS: पक्का करें कि आखिरी फ़्रेम उन स्ट्रीम के लिए रेंडर किया गया हो जिनमें आखिरी पीईएस पैकेट की लंबाई पहले से पता हो (#3206).
- MP3: Xing और VBRI हेडर वाली फ़ाइलों के लिए, बिटरेट रिपोर्टिंग को ठीक किया गया.
- Matroska: आखिरी क्लस्टर में तय किए गए ट्रैक मैनेज करें (#3250).
- Matroska: ALAC के लिए सहायता जोड़ी गई (#3268).
- MP4: फ़्रैगमेंट की गई MP4 फ़ाइलों में, अलग-अलग लंबाई वाले
sgpdबॉक्स इस्तेमाल करने की अनुमति दी गई (#3243). - AVI: उस समस्या को ठीक किया गया है जिसमें ऑडियो ट्रैक पर कीफ़्रेम फ़्लैग के बिना फ़ाइलें चलाने पर, ऑडियो सुनाई नहीं देता था और
OutOfMemoryError. - MP3: Xing/Info हेडर से, बिना गैप वाली अवधि का इस्तेमाल करें (#3183).
- MP3: डिकोड किए गए पीसीएम ट्रिमिंग से मैच करने के लिए, LAME/Xing एन्कोडर की देरी और पैडिंग मेटाडेटा को अडजस्ट करें (#3200).
- MP4, MP3, और FLAC: कंटेनर को पार्स करने के दौरान, अटैच की गई तस्वीरों और कवर आर्ट के मेटाडेटा को खारिज करने की अनुमति देने के लिए,
- ऑडियो:
- ExoPlayer के ऑडियो रेंडरर में, रेडी से नॉट-रेडी स्टेट में ट्रांज़िशन करते समय 100 मि॰से॰ का ग्रेस पीरियड जोड़ें. इससे, ट्रांज़िएंट अंडररन को कम किया जा सकता है और ऐक्टिव प्लेआउट के दौरान अचानक बफ़रिंग होने से बचा जा सकता है (#3210).
DefaultAudioTrackBufferSizeProviderमें डिफ़ॉल्ट पीसीएम बफ़र साइज़ लॉजिक को बदलकर, 500 मि॰से॰ का बफ़र साइज़ तय करें. इससे डिवाइस पर निर्भरता कम हो जाएगी.MediaCodecAudioRendererको अपडेट करें, ताकि प्लैटफ़ॉर्म डिकोडर से स्पेशल channelMask को निकाला जा सके. इससेDefaultAudioSinkको चैनल की संख्या से अनुमान लगाने के बजाय, इस साफ़ तौर पर दिए गए मास्क का इस्तेमाल करने की अनुमति मिलती है.AudioSink.configureके पैरामीटर को डेटा क्लास में बदलें.ForwardingAudioSink.configureके कस्टम ओवरराइड को नए मेथड सिग्नेचर पर माइग्रेट करना होगा.EditedMediaItem.Builder#setSpeed(SpeedParameters)की मदद से, ऑडियो स्ट्रीम को टाइम-स्ट्रेच करते समय पिच को बनाए रखने के लिए सहायता जोड़ें.- 8-बिट पीसीएम, 16-बिट बिग-एंडियन पीसीएम, और 64-बिट फ़्लोटिंग पॉइंट पीसीएम को 32-बिट फ़्लोटिंग पॉइंट पीसीएम (#3090) में बदलने के लिए,
ToFloatPcmAudioProcessorको बेहतर बनाएं. DecoderAudioRenderer.getChannelMappingकी रिटर्न वैल्यू को बदलकरImmutableIntArrayकरें.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से कंप्रेस्ड ऑफ़लोड मोड में, बिना गैप वाले ऑडियो की प्लेलिस्ट चलाते समय ऑडियो रुक जाता था.
- ऑडियो प्रोसेसर को प्लेलिस्ट का कॉन्टेक्स्ट देने के लिए,
Timelineऔर पीरियड यूआईडी कोAudioSink.configureऔरAudioProcessor.StreamMetadataपर फ़ॉरवर्ड करें (#418). - समय के हिसाब से ऑडियो प्रोसेसिंग की अनुमति देने के लिए, सही
AudioProcessor.StreamMetadata.positionOffsetUsसेट करें (#418). - बिग एंडियन 32-बिट और 64-बिट फ़्लोटिंग पॉइंट पीसीएम के लिए सहायता जोड़ें.
- Google Pixel डिवाइसों पर वीडियो चलाने के लिए, EAC3-JOC से EAC3 पर फ़ॉलबैक पाथ को हटाया गया. ऐसा इसलिए, क्योंकि उनके स्टैंडर्ड EAC3 डिकोडर, EAC3-JOC स्ट्रीम को डिकोड नहीं कर सकते (#3257).
- वीडियो:
- वीडियो में शामिल होने के लॉजिक को ठीक करें, ताकि शामिल होने के दौरान ड्रॉप किए गए बफ़र को ड्रॉप किए गए के बजाय स्किप किए गए के तौर पर गिना जा सके.
- नई सरफ़ेस सेट करते समय, रेंडरिंग से जुड़े फ़ैसले को तुरंत ठीक करें, ताकि उन डिवाइसों पर फ़्रेम ड्रॉप न हों जिन पर प्लेसहोल्डर सरफ़ेस काम नहीं करते.
MediaCodecVideoRendererमें फ़्रेम रेट के अनुमान को ज़्यादा सटीक बनाने के लिए, ड्रॉप या स्किप किए गए फ़्रेम को ध्यान में रखें.- फ़्रेम को जल्दी शेड्यूल करने के लिए इस्तेमाल की जाने वाली थ्रेशोल्ड को कॉन्फ़िगर करने की अनुमति दें. डिफ़ॉल्ट रूप से, यह वैल्यू 50 मि॰से॰ होती है. हालांकि,
MediaCodecVideoRenderer.Builder.setMaxEarlyUsThreshold()का इस्तेमाल करके, इस वैल्यू को अपनी पसंद के मुताबिक सेट किया जा सकता है. VideoFrameReleaseHelperमें मौजूद गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से, डिसप्ले में बदलाव होने पर, मुख्य थ्रेड पर ग़ैर-ज़रूरीChoreographerकॉलबैक ट्रिगर हो सकते थे और सीपीयू को बार-बार चालू करना पड़ सकता था.
- टेक्स्ट:
- मेटाडेटा:
MediaMetadata.discSubtitleफ़ील्ड जोड़ें और इसे ID3v2.4TSSTऔर VorbisDISCSUBTITLEडेटा से पार्स करें.- ID3
TPOSफ़्रेम से डिस्क नंबर और संख्या को पार्स करें.
- असर:
- फ़्लश करते समय,
FinalShaderProgramWrapperमें रीड्रॉ स्टेट को मिटाएं, ताकि वीडियो को आगे-पीछे करते समय प्लेयर फ़्रीज़ न हो.
- फ़्लश करते समय,
- मक्सर:
- नए
addTrackReferenceएपीआई की मदद से,Mp4Muxerमें ट्रैक रेफ़रंस (trefबॉक्स) के लिए सहायता जोड़ें. इससे ट्रैक के बीच संबंध बनाए जा सकते हैं. जैसे, मेटाडेटा ट्रैक को उस वीडियो ट्रैक से लिंक करना जिसके बारे में वह जानकारी देता है. OggMuxerजोड़ें, ताकिOPUSयाVORBISमीडिया स्ट्रीम कोoggफ़ाइल फ़ॉर्मैट में मिक्स किया जा सके.- WAV फ़ाइल जनरेट करने के लिए,
WavMuxerजोड़ें. इसमें पूर्णांक और फ़्लोटिंग-पॉइंट पीसीएम का इस्तेमाल किया जा सकता है. InAppMp4Muxer.FactoryमेंsetAttemptStreamableOutputEnabledजोड़ें, ताकि रिज़र्व की गई जगह के बिना, स्ट्रीम न की जा सकने वाली छोटी फ़ाइलें लिखी जा सकें.Mp4MuxerऔरFragmentedMp4Muxerमें, IAMF ऑडियो के लिए सहायता जोड़ना.
- नए
- आईएमए एक्सटेंशन:
ImaServerSideAdInsertionMediaSource.AdsLoader.Builder.setPauseAdSlotजोड़ें, ताकि वीडियो रुकने पर दिखने वाले विज्ञापनों के लिए विज्ञापन स्लॉट उपलब्ध कराया जा सके.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, स्किप किए जा सकने वाले वीएएसटी विज्ञापनों के एक के बाद एक दिखने पर, दूसरे विज्ञापन पर तुरंत 'स्किप करें' बटन दिखता था (#3165).
- सेशन:
- बैकग्राउंड थ्रेड प्लेयर लूपर वाले सेशन का इस्तेमाल करते समय,
MediaNotificationManagerमें संभावित डेडलॉक औरIllegalStateExceptionक्रैश को ठीक करें. MediaSessionतरीकों के लिए, थ्रेडिंग से जुड़ी ज़्यादा सख्त ज़रूरी शर्तें लागू करें. Void तरीके अब ऐप्लिकेशन लूपर थ्रेड में अपने-आप पोस्ट हो जाते हैं. साथ ही, अगर ऐप्लिकेशन लूपर के अलावा किसी अन्य थ्रेड से कॉल किया जाता है, तो स्टेट ऐक्सेसर (गेटर) साफ़ तौर परIllegalStateExceptionथ्रो करते हैं.- सेशन साइड पर हर कंट्रोलर के लिए, स्टेट कंसिस्टेंसी को ट्रैक करके, आउट-ऑफ़-बाउंड टाइमलाइन मर्ज क्रैश (
MediaUtils.mergePlayerInfoमेंIllegalStateException) को ठीक करें. androidx.media3.session.MediaSessionManagerजोड़ें, ताकि ऐक्टिव मीडिया सेशन के बारे में क्वेरी की जा सके और Media3SessionTokenके इंस्टेंस दिखाए जा सकें.- अगर तरीके को ओवरराइड नहीं किया गया है, तो
MediaSession.Callback.onConnectके डिफ़ॉल्ट ऐक्शन और सेटिंग को बदलें, ताकि भरोसेमंद नहीं माने जाने वाले कंट्रोलर को सिर्फ़ रीड ऐक्सेस दिया जा सके. - नए एपीआई
MediaSession.Builder#setPackageNameOverrideकी मदद सेMediaSessionबनाते समय, पैकेज के नाम को बदलने की सुविधा जोड़ी गई. सेशन के पैकेज के नाम को बदलने के लिए, कॉलर के पासandroid.permission.OVERRIDE_MEDIA_SESSION_OWNERअनुमति होनी चाहिए. MediaSession.Callback.onConnectAsync()जोड़ें. नए तरीके से, कंट्रोलर के कनेक्शन की कोशिश को एसिंक्रोनस तरीके से प्रोसेस किया जा सकता है. ऐप्लिकेशन,Futures.immediateFuture(ConnectionResult)के साथ तुरंतFutureदिखा सकते हैं, ताकि पहले जैसा व्यवहार हासिल किया जा सके. हमारा सुझाव है कि आप नए तरीके पर माइग्रेट करें, क्योंकिCallback.onConnectको बंद किया जा सकता है.- एपीआई 36 और 37 पर, ब्लूटूथ एवीआरसीपी ब्राउज़िंग की सुविधा
MediaLibraryServiceको नहीं पहचानती थी. इस समस्या को ठीक किया गया. MediaSessionमें आर्टवर्क के साइज़ को दो बार छोटा करने की समस्या को ठीक किया गया. यह समस्या तब होती थी, जब इमेज का साइज़ प्लैटफ़ॉर्म की तय सीमा के करीब होता था. इससे सूचनाओं में धुंधलापन दिखने की समस्या हल हो गई है (#3134).MediaNotificationManagerमेंForegroundServiceStartNotAllowedExceptionके क्रैश होने की समस्या को ठीक किया गया. ऐसा तब होता था, जब ऐप्लिकेशन के बैकग्राउंड में होने पर, एसिंक्रोनस आर्टवर्क बिटमैप लोड कॉलबैक, फ़ोरग्राउंड सेवा शुरू करने की कोशिश करता था (#3270).- उस समस्या को ठीक किया गया है जिसमें
MediaControllerको मिलेPositionInfoऑब्जेक्ट में, उनके ओरिजनलTimelineयूआईडी मौजूद नहीं थे. अब सेशन, स्थिति में बदलाव होने पर इन यूआईडी का अनुवाद करता है और उन्हें आगे भेजता है. MediaSessionService.stopSelfSafely()मेंForegroundServiceStartNotAllowedExceptionको कैच करके, क्रैश की समस्या को ठीक किया गया (#3310).- एक ही मीडिया आइटम में सीक करने पर,
MediaControllerपर अचानक मिलने वालेonMediaItemTransition()कॉलबैक की समस्या को ठीक किया गया (#3248).
- बैकग्राउंड थ्रेड प्लेयर लूपर वाले सेशन का इस्तेमाल करते समय,
- यूज़र इंटरफ़ेस (यूआई):
- वीडियो चलाने के दौरान
ContentFrameको फिर से कंपोज़ करने पर, पहले फ़्रेम के गलत साइज़ में रेंडर होने की समस्या को ठीक किया गया (#3238). media3-ui-composeमॉड्यूल मेंCurrentMediaItemStateक्लास और उससे जुड़ाrememberCurrentMediaItemStateकंपोज़ेबल जोड़ें. इस स्टेट होल्डर का इस्तेमालdemo-composeमें किया जाता है, ताकि फ़िलहाल चल रहेMediaItemके बारे में अलग-अलग तरह का मेटाडेटा दिखाया जा सके.media3-ui-composeमॉड्यूल मेंPlaylistStateक्लास और उससे जुड़ाrememberPlaylistStateकंपोज़ेबल जोड़ें. इस स्टेट होल्डर का इस्तेमालdemo-composeमें किया जाता है, ताकि प्लेयर पर सेट किए गएMediaItemsके बारे में अलग-अलग मेटाडेटा जानकारी दिखाई जा सके.PlaybackSpeedStateमें फ़ास्टफ़ॉरवर्डिंग/स्लो मोशन एपीआई जोड़ें.demo-composeमें इस सुविधा का इस्तेमाल करके, वीडियो को दबाकर रखने पर उसे तेज़ी से आगे बढ़ाने की सुविधा दिखाएं.media3-ui-compose-material3मॉड्यूल मेंMiniControllerकंपोज़ेबल जोड़ें. यहPlayerको कंट्रोल करने के लिए, एक छोटा और आसान तरीका उपलब्ध कराता है. साथ ही, मौजूदा मीडिया आइटम का टाइटल, कलाकार, आर्टवर्क, और प्रोग्रेस दिखाता है.media3-ui-composeमॉड्यूल मेंErrorStateक्लास और उससे जुड़ाrememberErrorStateकंपोज़ेबल जोड़ें.ErrorTextकंपोज़ेबल कोmedia3-ui-compose-material3में जोड़ें और इसेPlayerपर डिफ़ॉल्ट ओवरले के तौर पर सेट करें.TopControls,CenterControls,BottomControls, औरErrorOverlayके लिए, कंपोज़ेबल के साथPlayerDefaultsऑब्जेक्ट पब्लिश करें.FocusRequesterकोPlayerकंपोज़ेबल और इसके कॉन्टेंट स्लॉट में जोड़ें.- स्लाइडिंग विंडो यूज़र इंटरफ़ेस (यूआई) वाले एनवायरमेंट में
MediaItemsको पहले से लोड करने के लिए,PlayerPool(common-ktx) औरrememberPooledPlayer(ui-compose) को पब्लिश करें.demo-composeमें इस सुविधा को दिखाने के लिए, एक नयाShortFormPlayerScreenजोड़ें. PlayerViewऔर ComposePresentationStateमें शटर सप्रेशन बग को ठीक किया गया. इसकी वजह से, उन टाइमलाइन पर क्रैश की समस्या आ रही थी जो पीरियड यूआईडी लुकअप (#3264) के साथ काम नहीं करती हैं.
- वीडियो चलाने के दौरान
- डाउनलोड:
- डाउनलोड करने के लिए फ़ेच किए जाने पर, मीडिया प्लेलिस्ट में एचएलएस वैरिएबल को रिज़ॉल्व करें (#3258).
- Ktor एक्सटेंशन:
- एचएलएस एक्सटेंशन:
- एचएलएस कॉन्टेंट स्टीयरिंग और पाथवे क्लोनिंग के लिए सहायता जोड़ी गई (#1689).
setWithAssetListResetकोHlsInterstitialsAdsLoaderमें जोड़ें, ताकि ऐप्लिकेशन, पूरी तरह से प्रोसेस की गई ऐसेट लिस्ट इंटरस्टीशियल को फिर से उपलब्ध न होने की स्थिति में रीसेट कर सकें. इससे, मांग पर फिर से रिज़ॉल्यूशन किया जा सकेगा.EXT-X-STREAM-INFऔरEXT-X-I-FRAME-STREAM-INFकेSCOREएट्रिब्यूट को पार्स करें और उसेFormat.selectionPriorityमें पॉप्युलेट करें (#3236).- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, शेड्यूल की गई एचएलएस प्लेलिस्ट के रीफ़्रेश होने की प्रोसेस जारी रहती थी. भले ही, प्लेलिस्ट अब मुख्य या चालू न हो (#3254).
- इंटरस्टीशियल ऐसेट सूचियों (#3322) को रिज़ॉल्व करते समय, कॉन्टेंट को फिर से शुरू करने के ऑफ़सेट की गिनती को ठीक किया गया.
- प्लेलिस्ट के अनुरोध के पूरा न होने के बाद, कम इंतज़ार के समय वाली लाइव स्ट्रीम को फिर से शुरू करने पर, ऑडियो ट्रैक के टाइमस्टैंप में अचानक आने वाली रुकावट को ठीक किया गया (#3311).
HlsMediaPeriod.getStreamKeys()में मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ऑडियो रेंडरेशन में मौजूद ID3 ट्रैक को सबटाइटल माना जाता था (#3333).
- DASH एक्सटेंशन:
- भाषा के आधार पर, सीईए सबटाइटल को अलग-अलग
TrackGroupमें बांटें (#3113). - मेनिफ़ेस्ट (एमपीडी) से कई
Locationएलिमेंट को पार्स करने और मेनिफ़ेस्ट लोड न होने पर,DashMediaSourceमें जगह की जानकारी के फ़ॉलबैक की सुविधा जोड़ी गई है. - खाली
<SegmentTimeline/>एलिमेंट वाले मेनिफ़ेस्ट खोलते समय, क्रैश (IndexOutOfBoundsException) होने की समस्या को ठीक किया गया (#3326).
- भाषा के आधार पर, सीईए सबटाइटल को अलग-अलग
- आरटीएसपी एक्सटेंशन:
- यूडीपी पोर्ट बाइंडिंग की गड़बड़ियों की वजह से, आरटीएसपी प्लेबैक की तैयारी के दौरान, प्लेबैक के रुकने या काम न करने की समस्या को ठीक करना.
- Cast एक्सटेंशन:
CastParamsक्लास जोड़ें, ताकिCast.initialize(CastParams)को कॉल करके Cast को कॉन्फ़िगर किया जा सके.- नया
CastParams.getShowSystemOutputSwitcherOnCastIconClick()विकल्प जोड़ें. इससे, उपलब्ध होने पर इन-ऐप्लिकेशन कास्ट डिवाइस पिकर के बजाय, SystemUI आउटपुट स्विचर का इस्तेमाल ट्रिगर होता है. - मीडिया रूट पिकर के दिखने की स्थिति को मॉनिटर करने के लिए,
MediaRouteButtonStateऔरrememberMediaRouteButtonStateको जोड़ें. साथ ही,MediaRouteButtonमेंstateपैरामीटर जोड़ें (#3172). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ट्रैक चुनने के बाद
RemoteCastPlayer, ट्रैक-मास्किंग की स्थिति में हमेशा के लिए अटक सकता था. इससे कास्ट रिसीवर से मिलने वाले ट्रैक के बाद के अपडेट को अनदेखा कर दिया जाता था (#3237). - उस गड़बड़ी को ठीक किया गया है जिसमें Media3 के अलावा किसी अन्य सेंडर से शुरू किए गए कास्ट सेशन में शामिल होने की कोशिश करने पर,
DefaultMediaItemConverterसेNullPointerExceptionथ्रो होता है. - ऐक्टिव प्लेयर को बदलते समय,
CastPlayerको ऐसेMediaItemsट्रांसफ़र करने से रोकें जिन्हें चलाया नहीं जा सकता (#3199). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कॉन्फ़िगर नहीं की गई लाइव स्ट्रीम (
liveConfiguration == UNSET) कोSTREAM_TYPE_BUFFEREDके तौर पर सूची में शामिल किया गया था (#3318).
- टेस्ट यूटिलिटी:
DataSourceContractTestको बड़ा करें, ताकि हेडर और बॉडी वालेPOSTअनुरोधों के लिए सहायता शामिल की जा सके. साथ ही,HttpDataSourceTestEnvमें कुछPOSTसंसाधन जोड़ें. इसके अलावा,WebServerDispatcherमें एचटीटीपी के लिए ज़रूरी तरीके, हेडर, और बॉडी के लिए दावे जोड़ें.DataSource.open()से मिले नतीजों की लंबाई के लिए,DataSourceContractTestमें असर्शन को और बेहतर बनाएं. जिन संसाधनों की वजह सेC.LENGTH_UNSETहो सकता है उन्हेंTestResource.Builder.setMayResolveToUnknownLength(boolean)का इस्तेमाल करके, इसकी जानकारी देनी चाहिए.TestExoPlayerBuilderमेंsetPlaybackLooperजोड़ें.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
androidx.media3.exoplayer.MetadataRetrieverहटाएं. इसके बजाय,androidx.media3.inspector.MetadataRetrieverका इस्तेमाल करें.androidx.media3.exoplayer.MediaExtractorCompatहटाएं. इसके बजाय,androidx.media3.inspector.MediaExtractorCompatका इस्तेमाल करें.Mp4Extractor.FLAG_READ_MOTION_PHOTO_METADATAहटाएं. इसके बजाय, HEIC फ़ाइलों से मोशन फ़ोटो का मेटाडेटा निकालने के लिए,HeifExtractorका इस्तेमाल करें.androidx.media3.extractor.metadata.mp4.MotionPhotoMetadataहटाएं. इसके बजाय,androidx.media3.extractor.metadata.MotionPhotoMetadataका इस्तेमाल करें.androidx.media3.extractor.DummyTrackOutputहटाएं. इसके बजाय,androidx.media3.extractor.DiscardingTrackOutputका इस्तेमाल करें.androidx.media3.extractor.DummyExtractorOutputहटाएं. इसके बजाय,androidx.media3.extractor.NoOpExtractorOutputका इस्तेमाल करें.androidx.media3.common.C.generateAudioSessionIdV21हटाएं. इसके बजाय,androidx.media3.common.util.Util.generateAudioSessionIdका इस्तेमाल करें.
- बनाना
- Gradle कंपोज़िट बिल्ड (
includeBuild) का इस्तेमाल करने के लिए, Media3 पर स्थानीय तौर पर निर्भर रहने से जुड़ेREADME.mdनिर्देशों को अपडेट किया गया है.core_settings.gradleस्क्रिप्ट को हटा दिया गया है. साथ ही,androidxMediaModulePrefixऔरandroidxMediaEnableMidiModuleप्रॉपर्टी का इस्तेमाल अब नहीं किया जाता.
- Gradle कंपोज़िट बिल्ड (
1.11.0-rc01
1.11.0 स्टेबल वर्शन का इस्तेमाल करें.
1.11.0-beta01
7 जुलाई, 2026
1.11.0 स्टेबल वर्शन का इस्तेमाल करें.
1.11.0-alpha01
24 जून, 2026
1.11.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.10.0
1.10.1
12 मई, 2026
- कॉमन लाइब्रेरी:
SimpleBasePlayerऔरForwardingSimpleBasePlayerमेंonAudioSessionIdChangedको मैनेज करने से जुड़ी समस्या को ठीक किया गया.
- ExoPlayer:
- ऑडियो सेशन आईडी जनरेट करने से जुड़ी रेस कंडिशन को ठीक किया गया. इसकी वजह से, टनलिंग मोड में
IllegalStateExceptionकी समस्या आ सकती थी. (#3099). - रेंडरर प्रीवॉर्मिंग की मदद से, डिकोडर की गड़बड़ियों को ठीक करते समय ऐप्लिकेशन के क्रैश होने की समस्या को ठीक किया गया.
- AV1 पर आधारित डॉल्बी विज़न कोडेक का इस्तेमाल करते समय, शुरू करने का डेटा देने की वजह से वीडियो आर्टफ़ैक्ट की समस्या को ठीक किया गया (#3153).
- ऑडियो सेशन आईडी जनरेट करने से जुड़ी रेस कंडिशन को ठीक किया गया. इसकी वजह से, टनलिंग मोड में
- ट्रैक चुनना:
- फ़ॉलबैक एमआईएमई टाइप की समस्या को हल करने के लिए,
VideoTrackInfoमें ट्रैक चुनने के लॉजिक में बदलाव किया गया. साथ ही, एचडीआर और कोडेक स्कोर की प्राथमिकताओं को क्वालिटी की प्राथमिकताओं (#3135) में शामिल किया गया.
- फ़ॉलबैक एमआईएमई टाइप की समस्या को हल करने के लिए,
- एक्सट्रैक्टर:
- एमपी3: अगर Xing डेटा की लंबाई, स्ट्रीम की लंबाई से ज़्यादा है, तो उसे अनदेखा करें (#3117).
FLAG_OMIT_TRACK_SAMPLE_TABLEसेट होने और ट्रैक में सिंक सैंपल (stss) बॉक्स न होने पर,Mp4ExtractorमेंArrayIndexOutOfBoundsExceptionको ठीक करें.
- ऑडियो:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, प्लेयर में कई ऑडियो रेंडरर जोड़ने पर, ऑडियो इवेंट गलत तरीके से रूट हो सकते हैं.
- वीडियो:
- एपीआई लेवल 30 से कम वाले डिवाइसों पर फ़्रेम रेट में बदलाव होने पर, कोडेक को फिर से इस्तेमाल करने के लॉजिक में बदलाव किया गया है. इससे कोडेक को रीसेट करने से बचा जा सकेगा, क्योंकि इससे कोई फ़ायदा नहीं होता (#3120).
- एपीआई 31 और इसके बाद के वर्शन के लिए,
queueSecureInputBufferमें फ़ोर्स सिंक्रनाइज़ेशन की सुविधा बंद करें. यह सुविधा, एक आर्टिफ़िशियल बॉटलनेक थी. इसकी वजह से, डिक्रिप्शन को क्रम से चलाना पड़ता था. इससे एपीआई 31 से पहले के फ़्रेमवर्क की समस्या की वजह से, वीडियो खराब होने से बच जाता था.
- इमेज:
- स्क्रबिंग मोड में आने वाली समस्या को ठीक किया गया. इस समस्या की वजह से, इमेज में किए गए बदलाव सिर्फ़ तब लागू होते थे, जब उपयोगकर्ता "स्क्रबिंग बंद करता था" (#2815).
- सेशन:
- उस गड़बड़ी को ठीक किया गया है जिसमें ऐप्लिकेशन थ्रेड के मुख्य थ्रेड न होने पर,
ForegroundServiceStartNotAllowedExceptionको थ्रेड की सीमाओं में लागू नहीं किया गया था (#2499). - उस गड़बड़ी को ठीक करें जिसकी वजह से, सिर्फ़ प्लैटफ़ॉर्म वाले सेशन से कनेक्ट करते समय,
COMMAND_SEEK_TO_MEDIA_ITEMMediaControllerमें उपलब्ध नहीं होता. यह सेशन, अन्य आइटम पर जाने की सुविधा देता है, लेकिन प्लेलिस्ट में बदलाव करने की अनुमति नहीं देता. - उस समस्या को ठीक किया गया है जिसमें
MediaController, प्लैटफ़ॉर्म के उन मीडिया सेशन पर मीडिया आइटम सेट नहीं कर पाता था जोPREPARE_FROMकार्रवाइयों की अनुमति नहीं देते थे. - उस गड़बड़ी को ठीक करें जिसमें प्लैटफ़ॉर्म कंट्रोलर के ज़रिए कनेक्ट करते समय, एपीआई 27 या उससे पहले के वर्शन पर, खुद की प्रोसेस को
Controller.isTrusted()से मार्क नहीं किया गया था.
- उस गड़बड़ी को ठीक किया गया है जिसमें ऐप्लिकेशन थ्रेड के मुख्य थ्रेड न होने पर,
- एचएलएस एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसमें स्ट्रीम फ़ॉलबैक के दौरान
ArrayIndexOutOfBoundsExceptionदिखता है. ऐसा तब होता है, जब ट्रैक का चुना गया विकल्प, उपलब्ध ट्रैक का सबसेट हो (#3161). - उस समस्या को ठीक किया गया है जिसमें मीडिया प्लेलिस्ट के अपडेट के दौरान, इनिशलाइज़ेशन सेगमेंट को आगे नहीं बढ़ाया जाता था. ऐसा तब होता था, जब बाद के अपडेट में
#EXT-X-MAPटैग को दोहराया नहीं जाता था (#3105).
- उस गड़बड़ी को ठीक किया गया है जिसमें स्ट्रीम फ़ॉलबैक के दौरान
- DASH एक्सटेंशन:
SampleQueueमें क्रैश होने की समस्या को ठीक करें. ऐसा तब होता है, जब किसी ऐसे चंक को खोजा जाता है जिसे फ़िलहाल रद्द किया जा रहा है.
1.10.0
26 मार्च, 2026
- कॉमन लाइब्रेरी:
Player.mute()औरPlayer.unmute()कोUnstableApiसे स्टेबल वर्शन में प्रमोट करें.Format.pcmEncodingऔरC.PcmEncodingकोUnstableApiसे स्टेबल वर्शन में प्रमोट करें.- एम्बेड किए गए
Formatइंस्टेंस के प्राइमरी ग्रुप की पहचान करने के लिए,Format.primaryTrackGroupIdजोड़ें (#294).
- ExoPlayer:
AdsMediaSourceमें क्लिपिंग की सुविधाएं जोड़ें.MediaCodecVideoRendererमें डाइनैमिक शेड्यूलिंग की सुविधा जोड़ी गई, ताकि शेड्यूलिंग और सीपीयू के वेक-साइकल को बेहतर तरीके से अलाइन किया जा सके. इससे वीडियो फ़्रेम को प्रोसेस करने में मदद मिलती है.DefaultRenderersFactoryमेंexperimentalSetEnableMediaCodecVideoRendererDurationToProgressUs()का इस्तेमाल करके, इसे चालू किया जा सकता है.DefaultPreloadManager.Builderमें कस्टमDataSource.Factoryसेट करने की अनुमति दें.- कुछ डिफ़ॉल्ट कॉन्सटैंट को
ExoPlayer.Builderमें ले जाकर, Robolectric के बिनाExoPlayerको मॉक करने की अनुमति दें. इस जटिल इंटरफ़ेस का मॉकअप बनाने का सुझाव आम तौर पर नहीं दिया जाता. ऐसा सिर्फ़ तब किया जाता है, जब इसका इस्तेमाल कम/आसान/अचानक होने वाला हो (#2985).- इसके लिए,
DEFAULT_STUCK_PLAYING_DETECTION_TIMEOUT_MSकोExoPlayerसेExoPlayer.Builderपर माइग्रेट करना ज़रूरी था. हालांकि, इस दौरान को बंद नहीं किया गया.
- इसके लिए,
- उस गड़बड़ी को ठीक किया गया है जिसमें
ProgressiveMediaSource, प्लेयर को टाइमलाइन की पुरानी जानकारी भेजता है. साथ ही, सूची में शामिल पीरियड अचानक हट जाते हैं (#3016). - उस समस्या को ठीक किया गया है जिसमें फ़ोन कॉल के दौरान वीडियो चलाने का अनुरोध करने पर, ExoPlayer देरी से ऑडियो फ़ोकस का अनुरोध नहीं करता था.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मांग पर उपलब्ध कॉन्टेंट से लाइव कॉन्टेंट पर स्विच करने पर, मांग पर उपलब्ध कॉन्टेंट के आखिर में फिर से बफ़रिंग हो सकती है (#3052).
- Dolby Vision प्रोफ़ाइल 10 के लिए सहायता जोड़ी गई (#2830).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, वीडियो शुरू होने से पहले दिखने वाले विज्ञापन के शुरू न होने पर,
ArrayIndexOutOfBoundsException(#3125) गड़बड़ी का मैसेज दिखता था.
- CompositionPlayer:
EditedMediaItem.removeVideoके साथ काम करने की सुविधा जोड़ें.
- ट्रांसफ़ॉर्मर:
EditedMediaItem.Builder.setFrameRate()अब वीडियो के लिए, ज़्यादा से ज़्यादा आउटपुट फ़्रेम रेट सेट कर सकता है. यह सुविधा खास तौर पर तब मददगार होती है, जबsetSpeed()की मदद से मीडिया की स्पीड बढ़ाई जाती है.
- ट्रैक चुनना:
DefaultTrackSelector.selectAllTracksके सिग्नेचर में बदलाव करें, ताकि आउटपुट कलेक्शन को पैरामीटर के तौर पर शामिल किया जा सके. इसमें ट्रैक ओवरराइड की जानकारी पहले से भरी होती है.- उस समस्या को ठीक किया गया है जिसमें एम्बेड किए गए मेटाडेटा ट्रैक चुने जाते हैं. भले ही, उनसे जुड़ा मुख्य ट्रैक चुना गया हो या नहीं (#294).
preferredVideoLanguages,preferredVideoLabels,preferredAudioLabels,preferredTextLabels, औरselectTextByDefaultके लिए,TrackSelectionParametersके विकल्पों को स्टेबल करें.
- एक्सट्रैक्टर:
- MP4:
moovजैसे अन्य बॉक्स से पहले, बड़ेuuidबॉक्स वाली फ़ाइलों के साथ काम करता है (#3046). - MP4: MP4 कंटेनर में, वर्सटाइल वीडियो कोडिंग (वीवीसी) ट्रैक के लिए सहायता जोड़ी गई.
- MP4:
- इंस्पेक्टर:
- नुकसान पहुंचा सकने वाला बदलाव:
FrameExtractorको हटाएं. उपयोगकर्ताओं को अब नए:media3-inspector-frameमॉड्यूल पर निर्भर रहना चाहिए और इंपोर्ट कोandroidx.media3.inspector.frame.FrameExtractorपर अपडेट करना चाहिए. - डिकोड किए गए वीडियो फ़्रेम को निकालने और प्रोसेस करने के लिए, एक नया मॉड्यूल पेश किया गया है.
- नुकसान पहुंचा सकने वाला बदलाव:
- ऑडियो:
- IAMF डिकोडर एक्सटेंशन के लिए, डिकोडिंग लाइब्रेरी को
libiamfसे बदलकरiamf_toolsपर सेट करें. - आईएएमएफ़ डिकोडिंग, डिकोडर (आईएएमएफ़ डिकोडर एक्सटेंशन का इस्तेमाल करते समय) या Android Spatializer के ज़रिए, बाइनॉरल आउटपुट के साथ काम करता है.
- ऑटोमोटिव के मामलों में AC-4 डिकोडर की सुविधा का आकलन करते समय,
AC4Profile22और अन्य लेगसी प्रोफ़ाइलों के लिए सहायता को सही तरीके से हटाएं (#2609). DefaultAudioSinkमेंAudioOutputको शुरू करने के लिए, फिर से कोशिश करने के लॉजिक को बेहतर बनाया गया (#2905).- IAMF को डिकोड करते समय, स्पीकर (या लागू होने पर, स्पेशलाइज़र) के आउटपुट लेआउट को मैच करने की कोशिश करें. इसके लिए, IAMF एक्सटेंशन और मीडिया कोडेक डिकोडर, दोनों का इस्तेमाल करें. इन्हें AudioCapabilities और AudioCapabilitiesReceiver में नए फ़ील्ड और लॉजिक के साथ इस्तेमाल किया जा सकता है.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से कंप्रेस्ड ऑफ़लोड मोड में, बिना गैप वाले ऑडियो की प्लेलिस्ट चलाते समय ऑडियो रुक जाता था.
- IAMF डिकोडर एक्सटेंशन के लिए, डिकोडिंग लाइब्रेरी को
- टेक्स्ट:
- VobSub: क्यू की अवधि तय करने के लिए,
STARTऔरSTOPएसपीयू कंट्रोल कमांड का इस्तेमाल करें. इससे, क्यू की अवधि हमेशा पांच सेकंड पर डिफ़ॉल्ट रूप से सेट नहीं होगी (#2935).
- VobSub: क्यू की अवधि तय करने के लिए,
- मेटाडेटा:
- मेटाडेटा रेंडरर की डिफ़ॉल्ट संख्या को बढ़ाकर चार कर दिया गया है, ताकि एचएलएस वैरिएंट और रेंडर किए गए वर्शन से पब्लिश किए गए सभी संभावित मेटाडेटा ट्रैक को कवर किया जा सके (#3043).
- असर:
LottieOverlayको नए:media3-effect-lottieमॉड्यूल में ले जाएं. इसके लिए, इसका नामandroidx.media3.effect.LottieOverlayसे बदलकरandroidx.media3.effect.lottie.LottieOverlayकरना होगा.
- इफ़ेक्ट Lottie:
:media3-effect-lottieका एक नया मॉड्यूल लॉन्च किया गया है. इसकी मदद से, वीडियो फ़्रेम पर Lottie इफ़ेक्ट लागू किए जा सकते हैं.
- आईएमए एक्सटेंशन:
- विज्ञापन मीडिया की जानकारी देने वाले नए एपीआई को ऐक्सेस करने के लिए, IMA SDK टूल के वर्शन को 3.39.0 पर अपडेट करें.
- उस गड़बड़ी को ठीक करना जिसकी वजह से विज्ञापन का एमआईएमई टाइप, IMA LOADED इवेंट में दिए गए एमआईएमई टाइप से मैच नहीं होता था. अब आईएमए से मिली विज्ञापन मीडिया की जानकारी का इस्तेमाल करके, विज्ञापन के एमआईएमई टाइप को मैप किया जाता है.
setEnableCustomTabsकोImaAdsLoaderऔरImaServerSideAdInsertionMediaSourceमें जोड़ें. इससे उपयोगकर्ता यह कंट्रोल कर सकते हैं कि विज्ञापन के क्लिक-थ्रू यूआरएल, कस्टम टैब का इस्तेमाल करके लॉन्च किए जाएं या नहीं.ImaAdTagUriBuilderजोड़ें. यह एक ऐसी क्लास है जोadTagUriबनाने का दूसरा तरीका उपलब्ध कराती है. इसमेंsetPreferredLinearOrientationएपीआई शामिल है. यह ऐल्फ़ा टेस्टिंग में मौजूद एक एपीआई है. इसकी मदद से, लीनियर विज्ञापनों के लिए अपनी पसंद का ओरिएंटेशन सेट किया जा सकता है. अगर आपको ऐल्फ़ा टेस्टिंग ग्रुप में शामिल होना है, तो कृपया अपने खाता पार्टनर से संपर्क करें.
- सेशन:
- उस गड़बड़ी को ठीक करना जिसकी वजह से
MediaMetadata.artworkDataमें बड़े कलेक्शन, ऐप्लिकेशन को क्रैश कर सकते हैं. ActionFactoryइंटरफ़ेस (#2933) में@Player.Commandआर्ग्युमेंट के लिए, int टाइप का इस्तेमाल करें.MediaSessionServiceऔरMediaLibraryServiceकोLifecycleServiceबनाएं. इससे, लाइफ़साइकल के बारे में जानकारी देने वाले ऑपरेशन को सेवा के लाइफ़साइकल से अटैच किया जा सकता है (#187).- लोकल प्लेबैक के लिए,
MediaControllerऔरMediaBrowserसे डिवाइस की आवाज़ बदलने के निर्देश देना बंद करें. ऐप्लिकेशन को डिवाइस के वॉल्यूम में बदलाव नहीं करना चाहिए. अगर ज़रूरी हो, तो इसके लिएAudioManagerएपीआई का इस्तेमाल किया जा सकता है. Intentके ऐसे पुराने इंस्टेंस का पता लगाना जिन्होंने सेवा को फ़ोरग्राउंड सेवा के तौर पर शुरू किया था. इससे सिस्टम कोForegroundServiceDidNotStartInTimeExceptionथ्रो करने से रोका जा सकता है. यह किसी अस्थिर एपीआई पर नुकसान पहुंचा सकने वाला बदलाव है. यह उन ऐप्लिकेशन के लिए है जो कस्टमMediaNotification.Providerको लागू करते हैं, क्योंकि इसमें एक नया ज़रूरी तरीका शामिल है.- होम स्क्रीन विजेट (#2933) के साथ इस्तेमाल किए जाने वाले
PendingIntentइंस्टेंस के लिए बिल्डर जोड़ें. - Compose पर आधारित होम स्क्रीन विजेट के लिए,
Intentइंस्टेंस बनाने के लिए स्टैटिक तरीके जोड़े गए (#2933). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मीडिया आइटम के ट्रांज़िशन की जानकारी कंट्रोलर को नहीं दी जाती थी. ऐसा तब होता था, जब मीडिया आइटम के इंडेक्स से दूसरे इंडेक्स पर ट्रांज़िशन किया जाता था. इसमें, 'AUTO' और 'SEEK' (#2997) की वजह से, मीडिया आइटम के ट्रांज़िशन में रुकावट आती थी.
- सिस्टम यूज़र इंटरफ़ेस (यूआई) के बटन की जगह बदलने से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, Android Auto या मैन्युफ़ैक्चरर जैसे अन्य यूज़र इंटरफ़ेस (यूआई) प्लैटफ़ॉर्म पर बुरा असर पड़ता था. हालांकि, इन प्लैटफ़ॉर्म को इस समस्या को ठीक करने की ज़रूरत नहीं थी (#3041).
- उस समस्या को ठीक किया गया है जिसकी वजह से सदस्यताओं का ऐक्सेस सिंक नहीं हो रहा था (#3056).
- एपीआई 29 पर सिस्टम यूज़र इंटरफ़ेस की गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से, किसी खास साइज़ में मीडिया सेशन की आर्टवर्क, सिस्टम यूज़र इंटरफ़ेस को क्रैश कर सकती थी और डिवाइस को रीबूट करने के लिए मजबूर कर सकती थी (#3118).
- Android Q पर सूचना आर्टवर्क आइकॉन के साइज़ को ठीक किया गया (#3084).
- उस गड़बड़ी को ठीक करना जिसकी वजह से
- यूज़र इंटरफ़ेस (यूआई):
- वीडियो चलाने की स्पीड दिखाने और उसमें बदलाव करने के लिए,
media3-ui-composeमेंPlaybackSpeedControlComposable जोड़ें. - वीडियो चलाने की स्पीड को कंट्रोल करने के लिए,
media3-ui-compose-material3मेंPlaybackSpeedToggleButtonComposable जोड़ें. - खिलाड़ी की प्रोग्रेस दिखाने और ड्रैग और टैप करके खोजने के लिए,
media3-ui-compose-material3मेंProgressSliderकंपोज़ेबल जोड़ें (#2288). - PlayerControlView को ऐनिमेट करते समय, बड़े ऑफ़स्क्रीन बफ़र से बचें.
media3-ui-compose-material3मेंPlayerकंपोज़ेबल जोड़ें. यहContentFrameको पसंद के मुताबिक बनाए जा सकने वाले कंट्रोल के साथ जोड़ता है. ये कंट्रोल सबसे ऊपर, बीच में, और सबसे नीचे अलाइन किए जा सकते हैं.PlayerControlViewदिखने पर, लगातार सूचना अपडेट होने से रोकने के लिए, सुलभता सेवा से वीडियो चलाने की जगह की जानकारी छिपाएं.
- वीडियो चलाने की स्पीड दिखाने और उसमें बदलाव करने के लिए,
- एचएलएस एक्सटेंशन:
- एचएलएस इंटरस्टीशियल के साथ X-PLAYOUT-LIMIT के लिए सहायता जोड़ी गई (#2484).
#EXT-X-DEFINEके साथQUERYPARAMएट्रिब्यूट का इस्तेमाल करें (#1854).- रेगुलर एक्सप्रेशन मैचर को कैश मेमोरी में सेव करके, एचएलएस प्लेलिस्ट की पार्सिंग को ऑप्टिमाइज़ करें (#3008).
- ऑडियो रेंडर में ID3 (EMSG) मेटाडेटा ट्रैक को एक्सपोज़ करें (#3043).
- लोड होने से जुड़ी गड़बड़ियां होने पर, जगह की जानकारी के फ़ॉलबैक की अनुमति दें. ऐसा तब करें, जब अलग-अलग जगहों से ग़ैर-ज़रूरी स्ट्रीम उपलब्ध हों (#1988).
- एचएलएस इंटरस्टीशियल के लिए X-SNAP के व्यवहार को ठीक किया गया, ताकि शुरू होने और फिर से शुरू होने की पोज़िशन का सही तरीके से हिसाब लगाया जा सके (#3013).
- DASH एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसमें सेगमेंट के शुरू होने के समय के साथ अलाइन न होने वाले ट्रैक की वजह से, वीडियो चलाने की शुरुआत में देरी होती है या सैंपल छूट जाते हैं (#3057).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, इनबैंड ईएमएसजी v0 मेटाडेटा के टाइमस्टैंप सही तरीके से सेट नहीं होते थे (#3024).
- आरटीएसपी एक्सटेंशन:
- H.264 और H.265 स्ट्रीमिंग में रिग्रेशन को ठीक किया गया है. इसकी वजह से, एक ही ऐक्सेस यूनिट के सैंपल गलत तरीके से पार्स हो जाते थे. ये सैंपल, कई आरटीपी पैकेट में फैले होते थे. इस वजह से, वीडियो में विज़ुअल आर्टफ़ैक्ट और गड़बड़ी की समस्या आई (#3121).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- MPEG-H डिकोडर एक्सटेंशन में, MPEG-H यूज़र इंटरफ़ेस (यूआई) मैनेजर की सुविधा जोड़ी गई (#3066).
- Cast एक्सटेंशन:
RemoteCastPlayer.Builder#setTrackSelectorतरीका जोड़ें, जिससे कास्ट प्लेबैक के लिए ट्रैक चुनने की सुविधा चालू हो सके.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
ExperimentalFrameExtractorहटाएं. इसके बजाय,androidx.media3.inspector.frame.FrameExtractorका इस्तेमाल करें.ChannelMixingMatrix.create()हटाएं. इसके बजाय,ChannelMixingMatrix.createForConstantGain()का इस्तेमाल करें.androidx.media3.extractor.metadata.flac.VorbisCommentहटाएं. इसके बजाय,androidx.media3.extractor.metadata.vorbis.VorbisCommentका इस्तेमाल करें.MediaSource.prepareSource(MediaSourceCaller, TransferListener)हटाएं. इसके बजाय,MediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId)का इस्तेमाल करें.
1.10.0-rc03
25 मार्च, 2026
1.10.0 स्टेबल वर्शन का इस्तेमाल करें.
1.10.0-rc02
16 मार्च, 2026
1.10.0 स्टेबल वर्शन का इस्तेमाल करें.
1.10.0-rc01
10 मार्च, 2026
1.10.0 स्टेबल वर्शन का इस्तेमाल करें.
1.10.0-beta01
25 फ़रवरी, 2026
1.10.0 स्टेबल वर्शन का इस्तेमाल करें.
1.10.0-alpha01
6 फ़रवरी, 2026
1.10.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.9.0
1.9.4
16 मई, 2026
वर्शन 1.9.4 में ये कमिट शामिल हैं.
- असर:
- सरफ़ेसलेस कॉन्टेक्स्ट से ट्रांज़िशन करते समय,
GL_DRAW_BUFFERऔरGL_READ_BUFFERको साफ़ तौर पर सेट करें.
- सरफ़ेसलेस कॉन्टेक्स्ट से ट्रांज़िशन करते समय,
1.9.3
16 मार्च, 2026
वर्शन 1.9.3 में ये कमिट शामिल हैं.
- ऑडियो:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से कंप्रेस्ड ऑफ़लोड मोड में, बिना गैप वाले ऑडियो की प्लेलिस्ट चलाते समय ऑडियो रुक जाता था.
1.9.2
6 फ़रवरी, 2026
वर्शन 1.9.2 में ये कमिट शामिल हैं.
- ExoPlayer:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
ProgressiveMediaSource, प्लेयर को टाइमलाइन की पुरानी जानकारी भेजता है. साथ ही, सूची में जोड़े गए पीरियड अचानक हट जाते हैं (#3016).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
- सेशन:
- सिस्टम यूज़र इंटरफ़ेस (यूआई) के बटन की जगह से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, Android Auto या मैन्युफ़ैक्चरर जैसे अन्य यूज़र इंटरफ़ेस (यूआई) प्लैटफ़ॉर्म पर नेगेटिव असर पड़ता था. हालांकि, इन प्लैटफ़ॉर्म को इस समस्या को ठीक करने की ज़रूरत नहीं थी (#3041).
- Cast एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, Cast से लोकल प्लेबैक पर ट्रांसफ़र करने की सुविधा काम नहीं कर रही थी.
1.9.1
26 जनवरी, 2026
वर्शन 1.9.1 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
- तारीख-समय की ऐसी स्ट्रिंग इस्तेमाल की जा सकती हैं जिनमें टाइमज़ोन ऑफ़सेट में सिर्फ़ घंटे शामिल हों (#2929).
- ExoPlayer:
- ऑडियो शुरू होने के बाद ही, डाइनैमिक शेड्यूलिंग को
doSomeWorkइंटरवल को धीमा करने की अनुमति दें. इससे वीडियो चलाने की शुरुआत में, ऑडियो/वीडियो को बेहतर तरीके से सिंक किया जा सकेगा. DefaultLoadErrorHandlingPolicyमें मौजूद गड़बड़ी को ठीक किया गया. इसकी वजह से,FileNotFoundExceptionऔर इसी तरह के अन्य अपवादों को कई बार फिर से आज़माया जा रहा था.- डाइनैमिक शेड्यूलिंग से जुड़ी गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से, अगले
doSomeWorkके लिए तय किए गए समय में से,doSomeWorkके मौजूदा इटरेशन में बीत चुका समय गलती से कम हो जाता था. उम्मीद है कि इस समस्या को ठीक करने से, सीपीयू के इस्तेमाल में न होने का समय बढ़ जाएगा और बिजली की बचत होगी. - उस समस्या को ठीक किया गया है जिसमें फ़ॉलबैक एवीसी या एचईवीसी कोडेक का इस्तेमाल करने पर, Dolby Vision फ़ाइलों के कुछ प्लेबैक काम नहीं करते थे.
- उस गड़बड़ी को ठीक किया गया है जिसमें प्लेलिस्ट से मौजूदा आइटम को हटाने पर, वीडियो खत्म होने के बाद भी लोड होता रहता था (#2873).
- एक ही आइटम पर
ExoPlayer.replaceMediaItemका बार-बार इस्तेमाल करते समय,MediaItemइंस्टेंस लीक होने से बचा जा सकता है (#2993). - इमरजेंसी वेक लॉक रिलीज़ की वजह से होने वाले संभावित एएनआर को रोकना (#2979).
- ऑडियो शुरू होने के बाद ही, डाइनैमिक शेड्यूलिंग को
- एक्सट्रैक्टर:
- एमपी3: LAME ReplayGain डेटा को पार्स करना (#2840).
- ऑडियो:
- ऑटोमोटिव के मामलों में AC-4 डिकोडर की सुविधा का आकलन करते समय,
AC4Profile22और अन्य लेगसी प्रोफ़ाइलों के लिए सहायता को सही तरीके से हटाएं (#2609).
- ऑटोमोटिव के मामलों में AC-4 डिकोडर की सुविधा का आकलन करते समय,
- वीडियो:
- एपीआई 30 से पहले के वर्शन वाले डिवाइसों पर, कॉन्टेंट का फ़्रेम रेट बदलने पर वीडियो कोडेक को खारिज कर दिया जाता है, ताकि वीडियो रुक-रुककर न चले (#2941).
- टेक्स्ट:
- VobSub: कुछ सबटाइटल न दिखने की समस्या को ठीक किया गया. इसके लिए, उन एसपीयू को सही तरीके से मैनेज किया गया जिनमें सिर्फ़ एक कंट्रोल सीक्वेंस होता है या जिनमें ज़रूरी जानकारी को कई कंट्रोल सीक्वेंस में बांटा गया होता है (#2935).
- आईएमए एक्सटेंशन:
- गड़बड़ी ठीक की गई: उस समस्या को ठीक किया गया है जिसकी वजह से विज्ञापन का एमआईएमई टाइप, IMA LOADED इवेंट में दिए गए एमआईएमई टाइप से मैच नहीं होता था. अब विज्ञापनों के पॉड इंडेक्स और विज्ञापन के क्रम का इस्तेमाल करके, विज्ञापन के एमआईएमई टाइप को मैप किया जाता है.
getAdsManager()औरAdEvent.getAd()के नतीजे को ऐक्सेस करने से पहले, शून्य की जांच जोड़ें.
- सेशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, विज्ञापन चलने के दौरान प्लैटफ़ॉर्म सेशन से कनेक्ट किए गए
MediaControllerको रोकने पर ऐप्लिकेशन क्रैश हो जाता था (#2948). - अलग-अलग क्लास में
extrasBundleइंस्टेंस पर पुष्टि करने के अतिरिक्त तरीके जोड़ें, ताकि अन्य प्रोसेस से भेजे गए गलतBundleइंस्टेंस से बचा जा सके. - उस समस्या को ठीक किया गया है जिसमें
COMMAND_SEEK_NEXTयाCOMMAND_SEEK_BACKके लिए कमांड मौजूद न होने की वजह से, सिस्टम मीडिया की सूचना में गैप हो सकता है (#2976). - सूचना आइकॉन के लिए बिटमैप स्केलिंग को मुख्य थ्रेड से हटा दिया गया है (#2829).
- हमने उस गड़बड़ी को ठीक कर दिया है जिसमें लेगसी
MediaMetadataCompatऔरMediaDescriptionCompatसे कन्वर्ट करते समय, लेखक, राइटर, और कंपोज़र को फ़ॉलबैक के तौर पर इस्तेमाल नहीं किया जा रहा था (#3018).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, विज्ञापन चलने के दौरान प्लैटफ़ॉर्म सेशन से कनेक्ट किए गए
- डाउनलोड:
- जब
SegmentDownloader,PriorityTooLowExceptionको मैनेज करता है, तो संभावित इनफ़ाइनाइट लूप को ठीक करें (DASH, HLS, और SmoothStreaming के लिए). सुरक्षितexecuteतरीके का इस्तेमाल करके,SegmentDownloaderके कस्टम ओवरराइड को अपना टास्कSupplierमें रैप करके देना होगा, ताकि उसे फिर से बनाया जा सके (#2931).
- जब
- एचएलएस एक्सटेंशन:
- रॉ ऐसेट लिस्ट के JSON दस्तावेज़ को
Listener.onAssetListLoadCompletedकॉलबैक में पास करें. यह एक नुकसान पहुंचा सकने वाला बदलाव है जो अस्थिर एपीआई में है. इसके लिए, इस कॉलबैक को लागू करने वाले ऐप्लिकेशन कोJSONObjectटाइप का एक अतिरिक्त आर्ग्युमेंट जोड़ना होगा (#2950).
- रॉ ऐसेट लिस्ट के JSON दस्तावेज़ को
- आरटीएसपी एक्सटेंशन:
- रैप अराउंड वाले टाइमस्टैंप के साथ आरटीपी पैकेट को सही तरीके से मैनेज करें (#2930).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- पहले वीडियो फ़्रेम को प्रोसेस करने से पहले, वीडियो को आगे-पीछे करने पर होने वाली संभावित
NullPointerExceptionको ठीक किया गया (#2965).
- पहले वीडियो फ़्रेम को प्रोसेस करने से पहले, वीडियो को आगे-पीछे करने पर होने वाली संभावित
- Cast एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया जिसकी वजह से, प्लेलिस्ट को बदलने पर
RemoteCastPlayerकी टाइमलाइन सही तरीके से अपडेट नहीं हो पा रही थी.
- उस गड़बड़ी को ठीक किया गया जिसकी वजह से, प्लेलिस्ट को बदलने पर
1.9.0
17 दिसंबर, 2025
- कॉमन लाइब्रेरी:
minSdkको23में अपडेट करें, ताकि यह अन्य AndroidX लाइब्रेरी के साथ काम कर सके.PlayerTransferStateजोड़ें. इससेPlayerइंस्टेंस के बीच, वीडियो चलाने की स्थिति को ट्रांसफ़र करने में मदद मिलती है.- प्लेयर में
void mute()औरvoid unmute()तरीके जोड़ें, जो प्लेयर की आवाज़ को शून्य पर सेट करने से पहले और बाद में, उसे सेव और रीस्टोर करते हैं. WakeLockManager,WifiLockManager,AudioFocusManager,AudioBecomingNoisyManager, औरStuckPlayerDetectorजैसी यूटिलिटी क्लास पब्लिश करें. इनका इस्तेमाल पहलेExoPlayerने इंटरनल तौर पर किया था, ताकि अन्य प्लेयर के लिए इन्हें फिर से इस्तेमाल किया जा सके (#1893).ForwardingPlayerलिसनर को हैंडल करने से जुड़ी समस्या को ठीक किया गया. यह समस्या तब आती थी, जब डेलिगेट प्लेयर, लिसनर इंस्टेंस की तुलना करने के लिए रेफ़रंस इक्वलिटी का इस्तेमाल करता था (#2675).media3-common-ktxलाइब्रेरी में,Player.listenToको निलंबित करने वाला एक्सटेंशन फ़ंक्शन जोड़ें. इससे, उस खासPlayer.Eventsके बारे में पता चलता है जिस पर कार्रवाई की जानी चाहिए.BasePlayer.getBufferedPercentageमें क्रैश होने की समस्या को ठीक किया गया. यह समस्या, पूर्णांक ओवरफ़्लो की वजह से होती थी. ऐसा तब होता था, जब बफ़र की गई पोज़िशन, रिपोर्ट की गई अवधि से बहुत ज़्यादा होती थी (#2750).TrackGroupट्रैक टाइप की अपने-आप पहचान होने की सुविधा को ठीक किया गया. इसके लिए, कस्टम सैंपल एमआईएमई टाइप को अनदेखा नहीं किया गया और कंटेनर एमआईएमई टाइप से संभावित तौर पर गलत ट्रैक टाइप का इस्तेमाल किया गया (#2860).
- ExoPlayer:
- प्लेयर के अटकने का पता लगाने की सुविधा जोड़ें. इससे प्लेयर के अटकने पर,
StuckPlayerExceptionप्लेयर की गड़बड़ी ट्रिगर होती है. ऐसा इन मामलों में होता है. इनमें से हर डिफ़ॉल्ट टाइम आउट को ज़रूरत पड़ने पर,ExoPlayer.Builderमें कॉन्फ़िगर किया जा सकता है:- वीडियो चलाने की कोशिश करने के 10 मिनट बाद भी
STATE_BUFFERINGऔर बफ़रिंग में कोई प्रोग्रेस न होना. - वीडियो चलाने की कोशिश करने के 10 सेकंड बाद,
STATE_READYऔर वीडियो न चलने पर. - आइटम के खत्म होने से पहले, तय की गई अवधि से 1 मिनट ज़्यादा
STATE_READYहोने के बाद. - वीडियो चलाने की कोशिश करने के दौरान, वीडियो न चलने की वजह के साथ 10 मिनट बाद.
- वीडियो चलाने की कोशिश करने के 10 मिनट बाद भी
- बैकग्राउंड में वीडियो चलाने के दौरान बफ़रिंग की समस्याओं को ठीक करने के लिए, वेक लॉक हैंडलिंग को डिफ़ॉल्ट रूप से चालू करें. यह
ExoPlayer.Builder.setWakeModeकोC.WAKE_MODE_LOCALपर सेट करने के बराबर है. - वर्चुअल डिवाइस आईडी को अपने-आप अपडेट करने के लिए, लिसनिंग लॉजिक जोड़ें. ऐसा तब करें, जब
ExoPlayer.Builderको पास किए गए ओरिजनलContextमें बदलाव की सूचना दी जाए. - वर्चुअल डिवाइस को मैन्युअल तरीके से अपडेट करने के लिए,
ExoPlayer.setVirtualDeviceIdजोड़ें. यह आईडी,Contextसे मिला है और इसेExoPlayer.Builderको पास किया गया है. - पक्का करें कि रेंडरर, प्लेलिस्ट के मौजूदा आइटम के खत्म होने से 10 सेकंड पहले, अगले आइटम का डेटा इस्तेमाल न करें.
- कंस्ट्रक्शन के बाद इन सेटिंग को अपडेट करने के लिए,
ExoPlayerमेंsetSeekBackIncrementMs,setSeekForwardIncrementMs, औरsetMaxSeekToPreviousPositionMsजोड़ें (#2736). DefaultPreloadManagerमें प्री-कैशिंग की सुविधा जोड़ें. अब ऐप्लिकेशन,TargetPreloadStatusControl.getTargetPreloadStatus(T rankingData)के ज़रिएDefaultPreloadManager.PreloadStatus.specifiedRangeCached(startPositionMs, durationMs)याDefaultPreloadManager.PreloadStatus.specifiedRangeCached(durationMs)दिखा सकते हैं. इससे यह पता चलता है कि किसी मीडिया आइटम को प्री-कैशिंग करना ज़रूरी है.- शॉर्टफ़ॉर्म डेमो ऐप्लिकेशन में,
DefaultPreloadManagerकी प्री-कैशिंग सुविधा का इस्तेमाल करें. - लोकल प्लेबैक के लिए
DefaultLoadControl.Builderसेटर जोड़ें औरDefaultLoadControlकी डिफ़ॉल्ट वैल्यू में बदलाव करें, ताकि यह कई तरह की लोकल फ़ाइलों के साथ अच्छी तरह से काम कर सके. - उस गड़बड़ी को ठीक करें जिसकी वजह से खाली प्लेलिस्ट सेट करने पर, प्लेयर
STATE_READYयाSTATE_BUFFERINGमें रह सकता है. - प्रीलोड मैनेजर एपीआई को बेहतर बनाना:
addMediaItems(List<MediaItem>, List<T>)औरaddMediaSources(List<MediaSource>, List<T>)जोड़ें, जो मीडिया आइटम या मीडिया सोर्स को बैच में जोड़ते हैं. इसके बाद,invalidate()को अपने-आप कॉल करते हैं.removeMediaItems((List<MediaItem>)औरremoveMediaSources(List<MediaSource>)जोड़ें, जो मीडिया आइटम या मीडिया सोर्स को बैच में हटाते हैं. साथ ही, पक्का करें कि प्रीलोड मैनेजर, हटाए जाने के बाद उनमें से किसी को भी पहले से लोड करना शुरू न करे या पहले से लोड करना जारी न रखे.DefaultPreloadManager.setCurrentPlayingIndex(int)को खुद को अपने-आप अमान्य करने की अनुमति दें. मौजूदा इंडेक्स को अपडेट करने के बाद, ऐप्लिकेशन को अब साफ़ तौर परinvalidate()को कॉल करने की ज़रूरत नहीं है.
- स्क्रबिंग मोड में, फ़ोटो के एक ही ग्रुप में आगे की ओर जाने के लिए, कीफ़्रेम रीसेट को स्किप करने की सुविधा जोड़ें.
- ऐप्लिकेशन के लिए
DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int)जोड़ें, ताकि तय किए गएplayerNameवाले प्लेयर के लिए, टारगेट बफ़र बाइट की वैल्यू सेट की जा सके.DefaultLoadControlअब हर प्लेयर के लिए अलग-अलग फ़ैसले ले सकता है. इसके लिए, वह प्लेयर को असाइन किए गए बाइट और टारगेट बफ़र बाइट का इस्तेमाल करता है. - विज्ञापन ग्रुप में मौजूद हर विज्ञापन को स्किप करने की जानकारी देने के लिए,
AdPlaybackState.AdGroupमेंSkipInfoजोड़ें. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से वीडियो खत्म होने के बाद विज्ञापन चलने के दौरान,
removeMediaItems(List)को कॉल करने पर क्रैश हो जाता था (#2746). - प्लेलिस्ट चलाने के दौरान, वीडियो के रुक-रुककर चलने की समस्या को ठीक किया गया. इस समस्या की वजह से, फ़्रेम को गलती से हमेशा आखिरी सैंपल के तौर पर सेट किया जाता था और रेंडर किया जाता था.
- अगर प्लेयर ऑडियो सेशन आईडी जनरेट नहीं कर पाता है, तो फिर से कोशिश करने की सुविधा चालू करें (#2382, #2678).
DefaultPreloadManagerमें सोर्स के लिए, कुल बफ़र बाइट को कंट्रोल करने की सुविधा जोड़ी गई है. इससे, पहले से लोड होने के लिए कुल बफ़र बाइट को मनचाहे तरीके से बढ़ने से रोका जा सकता है. डिफ़ॉल्ट कंट्रोल लॉजिक का इस्तेमाल करने के लिए, ऐप्लिकेशनDefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int)के ज़रिए पहले से लोड करने के लिए टारगेट बफ़र बाइट सेट कर सकते हैं. ऐसाPlayerId.Preload.name("पहले से लोड करना") केplayerNameके लिए किया जा सकता है. साथ ही,DefaultPreloadManager.Builder.setLoadControl(LoadControl)के ज़रिए बनाए गएDefaultLoadControlको इंजेक्ट किया जा सकता है.- डिफ़ॉल्ट तौर पर लागू होने वाली सुविधा (#2834) के साथ,
cloneAndSet(int, int)कोShuffleOrderमें जोड़ें. - सीक अडजस्टमेंट या ऑटो ट्रांज़िशन के बाद, विज्ञापन प्लेबैक को स्किप करते समय कॉन्टेंट फिर से शुरू करने का ऑफ़सेट जोड़ें (#2484).
- ऑडियो और वीडियो ट्रैक के लिए, कोडेक पैरामीटर सेट करने और उन पर नज़र रखने के लिए एपीआई जोड़ें.
यह सुविधा,
MediaCodecपर आधारित रेंडरर के लिए लागू की गई है. इसके लिए, एपीआई 29 या इसके बाद का वर्शन ज़रूरी है.- पैरामीटर लागू करने के लिए,
ExoPlayer.setAudioCodecParameters()औरExoPlayer.setVideoCodecParameters()का इस्तेमाल करें. - बदलावों को सुनने के लिए,
ExoPlayer.addAudioCodecParametersChangeListener()औरExoPlayer.addVideoCodecParametersChangeListener()का इस्तेमाल करें. वेंडर के हिसाब से कुंजियों को मॉनिटर करने के लिए, एपीआई 31 या इसके बाद का वर्शन होना ज़रूरी है.
- पैरामीटर लागू करने के लिए,
- किसी नॉन-ज़ीरो पोज़िशन पर जाने के बाद, खाली मीडिया सोर्स सेट करने और फिर प्लेयर को नॉन-एम्प्टी मीडिया सोर्स के साथ तैयार करने की वजह से होने वाली
IllegalStateExceptionगड़बड़ी को ठीक किया गया. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, स्क्रबिंग मोड में अन्य मीडिया आइटम पर जाने से
IllegalStateExceptionहो सकता था. DefaultPlaybackSessionManagerमें संभावितNullPointerExceptionको ठीक किया गया (#2885).- ज़रूरी शर्तें पूरी करने वाले वीडियो के लिए, वीडियो को आगे-पीछे करने की परफ़ॉर्मेंस को बेहतर बनाने की सुविधा चालू करें.
- एपीआई 36 और इसके बाद के वर्शन पर, MediaCodec में एसिंक्रोनस डिक्रिप्शन की सुविधा फिर से चालू करें. इन वर्शन पर, इस प्लैटफ़ॉर्म एपीआई के साथ टाइम आउट की समस्याएं ठीक कर दी गई हैं (#1641).
MediaCodecVideoRenderer.experimentalSetLateThresholdToDropDecoderInputUsकी डिफ़ॉल्ट वैल्यू को बदलकर 15 मि॰से॰ करें. साथ ही, ज़रूरी शर्तें पूरी करने वाले वीडियो के लिए, डिकोड करने से पहले वीडियो फ़्रेम को ज़्यादा बेहतर तरीके से ड्रॉप करने की सुविधा चालू करें.DefaultLoadControlमें, अपने-आप मेमोरी का हिसाब लगाने की सुविधा में, मेमोरी की ज़्यादा से ज़्यादा सीमा जोड़ें. यह सिर्फ़ तब लागू होना चाहिए, जब बहुत ज़्यादा ट्रैक चुने जाएं (#2860).- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, प्लेलिस्ट या रिपीट मोड में मीडिया चलाते समय, स्क्रब मोड में मीडिया के आखिर में जाने पर, अगला मीडिया आइटम चलने लगता था.
- प्लेयर के अटकने का पता लगाने की सुविधा जोड़ें. इससे प्लेयर के अटकने पर,
- CompositionPlayer:
CompositionPlayerको नए@ExperimentalApiएनोटेशन के तहत पब्लिश करें, ताकि यह पता चल सके कि यह एक्सपेरिमेंट के लिए उपलब्ध है, लेकिन अब भी डेवलपमेंट फ़ेज़ में है. आने वाले समय में, कुछ एपीआई में काफ़ी बदलाव हो सकते हैं. साथ ही, इस्तेमाल के कुछ उदाहरणों में समस्याएं और सीमाएं हो सकती हैं. इनमें से कुछ के बारे में जानकारी नहीं दी गई है.CompositionPlayerमें,COMMAND_SET_AUDIO_ATTRIBUTESऔर ऑडियो फ़ोकस को मैनेज करने की सुविधा जोड़ें.CompositionPlayerमें सेकंडरी सीक्वेंस की स्पीड बदलने की सुविधा जोड़ें.EditedMediaItem.removeVideoके साथ काम करने की सुविधा जोड़ें.
- ट्रांसफ़ॉर्मर:
InAppMp4Muxerको डिफ़ॉल्ट मक्सर के तौर पर इस्तेमाल करें.EditedMediaItem.Builder#setSpeed()को जोड़ें औरEffects#createExperimentalSpeedChangingEffects()को बंद करें.EditedMediaItemSequenceमेंforceAudioTrackऔरforceVideoTrackकोtrackTypesसे बदलें.
- ट्रैक चुनना:
- किसी खास प्राथमिकता को तय किए बिना, किसी भी टेक्स्ट ट्रैक को चुनने के लिए
TrackSelectionParameters.selectTextByDefaultजोड़ें. preferredVideoLabels,preferredAudioLabels, औरpreferredTextLabelsकोTrackSelectionParametersमें जोड़ें, ताकि किसी खास लेबल वाले ट्रैक के लिए प्राथमिकता तय की जा सके. उदाहरण के लिए, एचएलएस NAME टैग (#1666) से पढ़े गए ट्रैक.
- किसी खास प्राथमिकता को तय किए बिना, किसी भी टेक्स्ट ट्रैक को चुनने के लिए
- एक्सट्रैक्टर:
- FLAC: हेडर की पहचान करने की प्रोसेस को बेहतर बनाया गया है, ताकि एन्कोड किए गए FLAC डेटा में नकली हेडर मिलने की संभावना कम हो सके. इससे डिकोड करने से जुड़ी गड़बड़ियां कम होंगी (#558).
- MP3: MP3 फ़ाइलों की शुरुआत में, ID3 टैग के बीच में और उनसे पहले गैप की अनुमति दें (#811, #5718).
- MP3: सिंक बाइट के लिए, मौजूदा सर्च लिमिट से मैच करने के लिए, स्निफ़िंग लिमिट को बढ़ाकर 128 केबी किया गया (#2713).
- MP3:
FLAG_ENABLE_INDEX_SEEKINGको बदलें, ताकि उपलब्ध होने पर Xing और VBRI जैसे मेटाडेटा हेडर से जानकारी पाने को प्राथमिकता दी जा सके. अगर जानकारी पाने का कोई और तरीका मौजूद नहीं है, तो इंडेक्स के आधार पर जानकारी पाने के तरीके का इस्तेमाल करें. इससे, मेटाडेटा खोजने वाली फ़ाइलों की परफ़ॉर्मेंस बेहतर होती है (#2839). - MP3:
Mp3Extractorको डिफ़ॉल्ट रूप से कॉन्स्टेंट बिटरेट (सीबीआर) पर सेट करें.ऐसा तब करें, जब कोई सीकिंग मेटाडेटा (जैसे, Xing, VBRI) न मिले. भले ही,FLAG_ENABLE_INDEX_SEEKINGसेट हो. यह एमपी3 स्पेसिफ़िकेशन के इतिहास पर आधारित है. इसमें सीबीआर स्टैंडर्ड था और वीबीआर के लिए साफ़ तौर पर हेडर की ज़रूरत होती है. इससे, बिना मेटाडेटा वाली फ़ाइलों को तुरंत खोजा जा सकता है. हालांकि, हेडर के बिना वाली वीबीआर फ़ाइलों के लिए, सटीक जानकारी मिलने की संभावना कम हो जाती है. अगर सीबीआर का अनुमान नहीं लगाया जा सकता, तो इंडेक्स सीकिंग का इस्तेमाल फ़ॉलबैक के तौर पर किया जाता है. उदाहरण के लिए, ऐसी स्ट्रीम के लिए जिनकी लंबाई की जानकारी नहीं है (#2848). - MP4: एक्सट्रैक्टर से ट्रैक फ़ॉर्मैट को एमिट करने से पहले, पहले सैंपल की लेयर वैल्यू को देखकर,
audio/mpeg(MP3),audio/mpeg-L1, औरaudio/mpeg-L2एमआईएमई टाइप के बीच अंतर करें (#2683). - MP4: बहुत बड़ी फ़ाइलों को स्निफ़ करने की क्षमता को बेहतर बनाया गया है. इसके लिए, यह माना गया है कि 1 एमबी से बड़ा
stblबॉक्स होने का मतलब है कि फ़ाइल को फ़्रैगमेंट नहीं किया गया है (#2650). - MP4:
©mvn(मूवमेंट का नाम) और©mvi(मूवमेंट इंडेक्स) मेटाडेटा के लिए सहायता जोड़ी गई. इन्हें अबFormat.metadataमेंTextInformationFrameऑब्जेक्ट के तौर पर दिखाया जाता है. इनके आईडी क्रमशःMVNMऔरMVINहैं (#2754). - MP4: उन ट्रैक को अनदेखा करें जिनमें
stsdबॉक्स मौजूद नहीं है. ऐसा करने से, पूरी फ़ाइल को पार्स करने में समस्या नहीं आएगी. - Matroska: डीटीएस-एचडी की पहचान करने की सुविधा जोड़ी गई (#6225).
MatroskaExtractorमें मौजूद उस समस्या को ठीक किया गया है जिसकी वजह से, एक से ज़्यादा ट्रैक वाली फ़ाइलों को सटीक तरीके से नहीं खोजा जा सकता था. क्यू पॉइंट अब अपने-अपने ट्रैक से सही तरीके से जुड़े हैं. इससे वीडियो के किसी भी हिस्से पर ज़्यादा सटीक तरीके से पहुंचा जा सकता है.- MPEG-TS:
ReorderingBufferQueueसेIllegalArgumentExceptionको ठीक किया गया. यह गड़बड़ी, बिना टाइमस्टैंप वाले पीईएस पैकेट की वजह से हुई थी (#2764). - HEIC मोशन फ़ोटो को एक्सट्रैक्ट करने की सुविधा जोड़ी गई.
HeifExtractorअब एम्बेड किए गए वीडियो और ऑडियो ट्रैक वाली HEIC फ़ाइलों को पार्स कर सकता है.
- इंस्पेक्टर:
- एक नया
:media3-inspectorमॉड्यूल लॉन्च किया गया है, जो मीडिया की जांच करने वाली यूटिलिटी के लिए खास तौर पर काम करता है. इस मॉड्यूल में अब एक नयाandroidx.media3.inspector.MetadataRetrieverहै. यह मेटाडेटा और फ़्रेम निकालने, दोनों के लिए एक यूनिफ़ाइड एपीआई उपलब्ध कराएगा. मौजूदाandroidx.media3.exoplayer.MetadataRetrieverको अब इस नए वर्शन के लिए बंद कर दिया गया है. - हमने
androidx.media3.inspector.FrameExtractorको लॉन्च किया है. यह फ़्रेम एक्सट्रैक्शन के लिए एक नया सार्वजनिक एपीआई है. इसAutoCloseableक्लास की मदद से, एचडीआर वीडियो, वीडियो इफ़ेक्ट, और कस्टम डिकोडर चुनने की सुविधा के साथ फ़्रेम निकाले जा सकते हैं. इसे किसी खासMediaItemके लिए, उसकेBuilderसे बनाया जाना चाहिए. - FrameExtractor: किसी मीडिया फ़ाइल से थंबनेल फ़्रेम निकालने के लिए,
getThumbnail()जोड़ें. इसके लिए, किसी खास टाइमस्टैंप की ज़रूरत नहीं होती. androidx.media3.inspector.MediaExtractorCompatजोड़ें. यह प्लैटफ़ॉर्म केandroid.media.MediaExtractorकी जगह इस्तेमाल किया जा सकता है. इससे किसी मीडिया फ़ाइल से रॉ, कोड में बदले गए मीडिया सैंपल को निकाला जा सकता है. मौजूदाandroidx.media3.exoplayer.MediaExtractorCompatको अब इस नई क्लास के लिए बंद कर दिया गया है.
- एक नया
- ऑडियो:
AudioProcessorइंस्टेंस को सीकिंग के बारे में जानकारी दें.- कस्टम ऑडियो आउटपुट पाथ के साथ काम करने के लिए,
DefaultAudioSink.Builderमें नएAudioOutputProviderइंटरफ़ेस को इंजेक्ट करने की अनुमति दें. डिफ़ॉल्ट रूप से, यहAudioTrackAudioOutputProviderपर सेट होता है. GainProcessorमें हैंडल को आगे-पीछे करें.- ट्रैक फ़ॉर्मैट के साथ काम करने की क्षमता का आकलन करने के लिए, AC-4 डिकोडर प्रोफ़ाइल और लेवल की सुविधाओं का इस्तेमाल करें (#2580).
- वीडियो चलाने की शुरुआत में, रूटिंग में बदलाव के कॉलबैक को मैनेज करने की वजह से होने वाली संभावित देरी से बचें (#2646).
- EAC3, EAC3-JOC, और AC-4 फ़ॉर्मैट के लिए, कोडेक को फिर से इस्तेमाल करने की अनुमति दी गई (#1346).
Sonicमें फ़्लोट पीसीएम सैंपल के लिए सहायता जोड़ी गई.ToFloatPcmAudioProcessorमें 16 बिट वाले पीसीएम सैंपल के लिए सहायता जोड़ें.
- वीडियो:
- अलग-अलग प्रोफ़ाइलों वाले Dolby-Vision कॉन्टेंट के लिए, कोडेक को फिर से इस्तेमाल करने की सुविधा बंद करें.
- सुरक्षित कोडेक के लिए, गलत तरीके से रिपोर्ट किए गए परफ़ॉर्मेंस पॉइंट के लिए, समस्या हल करने का तरीका फिर से चालू करें (#2856).
- टेक्स्ट:
- Dolby Vision कॉन्टेंट में CEA-6/708 सबटाइटल को पार्स करने की समस्या को ठीक किया गया (#2775).
- इमेज:
- ScrubbingMode से जुड़ी समस्या को ठीक किया गया. इसमें DASH थंबनेल ट्रैक को स्क्रब करते समय प्लेयर अटक जाता था (#2815).
- डीआरएम:
MediaDrmCallbackतरीकों के रिटर्न टाइप कोbyte[]से बदलकर नएMediaDrmCallback.Responseटाइप में बदलें, ताकि वैकल्पिक जानकारी को वापस किया जा सके. यह सोर्स कोड में नुकसान पहुंचा सकने वाला बदलाव है. हालांकि, इससे होने वाली गड़बड़ियों को आसानी से ठीक किया जा सकता है. इसके लिए, रिटर्न करने से पहले, पिछलीbyte[]रिटर्न वैल्यू कोnew Responseके साथ रैप करें.AnalyticsListener.onDrmKeysLoaded(#1001) में यूआरएल और इंतज़ार का समय जैसी मुख्य अनुरोध जानकारी जोड़ें.- प्रोविज़निंग अनुरोध के डेटा को यूआरएल पैरामीटर से POST बॉडी में ले जाएं.
- असर:
- जब
Presentationको एक साइड की लंबाई के साथ बनाया जाता है, तो सेट नहीं किए गए आउटपुट साइड को राउंड करने के लिएPresentation.copyWithUnsetSideRoundedToजोड़ें.
- जब
- मक्सर:
MediaMuxerCompatजोड़ें, जो फ़्रेमवर्कMediaMuxerके लिए ड्रॉप-इन रिप्लेसमेंट है.- मोशन फ़ोटो बनाने की अनुमति देने के लिए,
MuxerUtil.createMotionPhotoFromJpegImageAndBmffVideo()जोड़ें. WebmMuxerजोड़ें, ताकिOPUS,VORBIS,VP8, औरVP9मीडिया स्ट्रीम कोwebmफ़ाइल फ़ॉर्मैट में मक्स किया जा सके.
- आईएमए एक्सटेंशन:
- कस्टम प्रोगार्ड नियमों को हटाना, ताकि ऐप्लिकेशन IMA Android संग्रह में रिलीज़ किए गए नियमों का इस्तेमाल कर सकें.
ImaServerSideAdInsertionUriBuilder.setNetworkCodeको जोड़ें. यह एक नया एपीआई है, जिसकी मदद से IMA SDK के लिए Google Ad Manager नेटवर्क कोड सेट किया जाता है. इससे, Google Ad Manager की सेटिंग में बताए गए विज्ञापन आइडेंटिफ़ायर को मैनेज किया जा सकता है. नेटवर्क कोड डालना ज़रूरी नहीं है. हालांकि, फ़ुल सर्विस स्ट्रीम के अनुरोधों के लिए, नेटवर्क कोड डालने का सुझाव दिया जाता है. नेटवर्क कोड ढूंढने के लिए, यह लेख पढ़ें.- आईएमए डिपेंडेंसी को 3.37.0 पर बंप करें. इसके लिए, कोर लाइब्रेरी की डिशुगरिंग को चालू करना ज़रूरी है. इस पर निर्भर ऐप्लिकेशन के लिए भी इसे चालू करना ज़रूरी है. आईएमए के कॉन्फ़िगरेशन नोट देखें. * एसएसएआई यूआरआई बिल्डर में, आईएमए डीएआई के कस्टम यूज़र इंटरफ़ेस (यूआई) के विकल्पों के लिए सहायता. सर्वर साइड विज्ञापन इंसर्शन के लिए कस्टम यूज़र इंटरफ़ेस (यूआई) के विकल्पों में, "स्किप किया जा सकने वाला" और "इस विज्ञापन के बारे में जानकारी" रेंडरिंग की सुविधा शामिल है. फ़िलहाल, यह सुविधा अनुमति वाली सूची में शामिल चुनिंदा पब्लिशर के लिए उपलब्ध है. इस बदलाव से, IMA SDK का वर्शन भी 3.38.0 (रिलीज़ नोट) पर अपग्रेड हो जाता है. इससे कस्टम यूज़र इंटरफ़ेस (यूआई) के विकल्पों वाले एपीआई को ऐक्सेस किया जा सकता है.
- उस समस्या को ठीक किया गया है जिसमें विज्ञापन के बाद कॉन्टेंट तैयार करने में होने वाली गड़बड़ी को, विज्ञापन चलाने में होने वाली गड़बड़ी के तौर पर गलत तरीके से रिपोर्ट किया जाता था (#2656).
- सेशन:
MediaSession.Callback.onPlaybackResumptionमें नया पैरामीटर जोड़ें, ताकि यह पता चल सके कि कॉल सिर्फ़ जानकारी इकट्ठा करने के लिए किया गया है या वीडियो चलाना शुरू करने के लिए (#1764).MediaSession.ControllerInfo.isTrustedको अपडेट करें, ताकि अपने ऐप्लिकेशन के कंट्रोलर को भी भरोसेमंद के तौर पर एलान किया जा सके (#2542).- सूचना के अपडेट को मैन्युअल तरीके से ट्रिगर करने के लिए,
MediaSessionService.triggerNotificationUpdateजोड़ें (#1833). - कस्टम कमांड के तरीकों में
ProgressListenerजोड़ें. MediaLibrarySession.Builder.setLibraryErrorReplicationModeकी डिफ़ॉल्ट वैल्यू को नॉन-फ़ेटल में बदलें.MediaButtonReceiver.onForegroundServiceStartNotAllowedExceptionमेंContextपैरामीटर जोड़ा गया (#2625).- बाइंडर के ज़रिए फ़ेच करने के बजाय, प्लैटफ़ॉर्म
PlaybackInfoसे वॉल्यूम कंट्रोल आईडी को रीड करें. इससे यह पक्का होता है कि प्लेबैक टाइप और वॉल्यूम कंट्रोल आईडी को एक साथ पढ़ा जाए और वे एक-दूसरे से मेल खाएं. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कस्टम हैंडलिंग के लिए कॉलबैक को पास करने से पहले,
ACTION_UPमुख्य इवेंट फ़िल्टर हो जाते थे. इससे, media1 और प्लैटफ़ॉर्म के बीच समानता आती है (#2637). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, निर्देश उपलब्ध न होने पर भी
PlayerWrapper,getCurrentTimeline()को कॉल करता था (#2665). - उस गड़बड़ी को ठीक किया गया जिसकी वजह से, मुख्य लूपर के मैसेज की सूची में एक मैसेज रह गया था. इस वजह से, सेवा बंद होने के बाद मेमोरी लीक हो गई थी (#2692).
MediaBrowserवाले लेगसी सेशन ऐप्लिकेशन से कनेक्ट होने पर, कस्टम कमांड सेशन को सिर्फ़ तब भेजे जाते हैं, जब कस्टम ऐक्शन को लेगसी सेशन केPlaybackStateCompatमें कस्टम ऐक्शन के तौर पर दिखाया जाता है. अन्य सभी कस्टम ऐक्शन, सेवा को भेजे जाते हैं.- जब सेशन के ज़रिए ऑडियो सेशन आईडी सेट किया जाता है, तब मीडिया कंट्रोलर को सूचना देने के लिए
onAudioSessionIdChangedको लागू किया गया (#244). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
KEYCODE_HEADSETHOOK,onStartCommand()में मीडिया बटन इवेंटIntentमिलने पर प्लेयर को चालू नहीं करता था. इस समस्या को ठीक करने के लिए, 'KEYCODE_HEADSETHOOK' कोKEYCODE_MEDIA_PLAY_PAUSE(#2816) की तरह हैंडल किया गया है. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से सेशन और कंट्रोलर के बीच, Surface के साइज़ की जानकारी शेयर नहीं हो पा रही थी. इस वजह से, demo-session में वीडियो इफ़ेक्ट लागू नहीं हो पा रहे थे. अगर कंट्रोलर का इस्तेमाल किया जा रहा है, तो यह नुकसान पहुंचा सकने वाला बदलाव हो सकता है. ऐसा तब होगा, जब आपका प्लेयर
setVideoSurfaceHolderकॉल को हैंडल न कर पाए. StringCharSequenceके अलावा, अन्य मेटाडेटा वैल्यू के प्रोपेगेशन को ठीक किया गया. जैसे, स्पैन-स्टाइल वाली स्ट्रिंग (#2853).CommandButton.executeActionजोड़ें, ताकि कंट्रोलर आसानी से अपनी कार्रवाई ट्रिगर कर सकें. साथ ही, प्लेयर और सेशन के कुछ निर्देशों के लिए पैरामीटर तय करने की अनुमति दें, ताकि यह तय किया जा सके कि कौनसा ऐक्शन ट्रिगर करना है.CommandButtonके इंस्टेंस के लिए, पुराने सिस्टम के साथ काम करने की सुविधा जोड़ें. इसके लिए,Player.Commandया कस्टम नहीं किए गएSessionCommandका इस्तेमाल करके, उनकी कार्रवाई तय करें. अब इन्हें प्लैटफ़ॉर्म के मीडिया सेशन में सही तरीके से दिखाया जाता है. उदाहरण के लिए, सिस्टम यूज़र इंटरफ़ेस (यूआई) या Android Auto के लिए.- उस समस्या को ठीक किया गया है जिसमें
MediaControllerको प्लैटफ़ॉर्म मीडिया सेशन से कनेक्ट करने पर, एक हीBitmapको कई बार कंप्रेस किया जाता है.
- यूज़र इंटरफ़ेस (यूआई):
media3-ui-composeमॉड्यूल मेंProgressStateWithTickIntervalक्लास और उससे जुड़ाrememberProgressStateWithTickIntervalकंपोज़ेबल जोड़ें. इस स्टेट होल्डर का इस्तेमालdemo-composeमें किया जाता है, ताकि मौजूदा पोज़िशन और अवधि को टेक्स्ट के तौर पर दिखाया जा सके.ui-composeमेंMuteButtonStateजोड़ें, जोPlayerवॉल्यूम को म्यूट करने की सुविधा देता है. इस स्टेट होल्डर का इस्तेमालdemo-composeमें, म्यूट/अनम्यूट करने का टॉगल बटन दिखाने के लिए किया जाता है.media3-ui-composeमॉड्यूल मेंProgressStateWithTickCountक्लास और उससे जुड़ीrememberProgressStateWithTickCountकंपोज़ेबल जोड़ें. इस स्टेट होल्डर का इस्तेमालdemo-composeमें किया जाता है, ताकि प्रोग्रेस को हॉरिज़ॉन्टल रीड-ओनली प्रोग्रेस बार के तौर पर दिखाया जा सके.media3-ui-composeमेंContentFrameComposable जोड़ें. यहPlayerSurfaceमैनेजमेंट को आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के साइज़ में बदलाव करने और शटर से कवर करने के साथ जोड़ता है.- एपीआई 34 प्लैटफ़ॉर्म के उस बग को ठीक किया गया है जिसकी वजह से, Compose
AndroidViewमेंSurfaceViewका इस्तेमाल करने पर वीडियो स्ट्रेच या क्रॉप हो जाते थे. इस वजह से,SURFACE_TYPE_SURFACE_VIEWवालेContentFrameऔरPlayerSurfaceकंपोज़ेबल पर असर पड़ता था (#1237, #2811). - एक नया
media3-ui-compose-material3मॉड्यूल बनाएं और उसमें Material3 थीम वाले कंपोज़ेबल जोड़ें. जैसे, PlayPauseButton, NextButton, PreviousButton, SeekBackButton, SeekForwardButton, RepeatButton, ShuffleButton, MuteButton. - प्लेयर की प्रोग्रेस को टेक्स्ट के तौर पर दिखाने के लिए,
media3-ui-compose-material3मेंTimeTextकंपोज़ेबल जोड़ें. इसे मौजूदा पोज़िशन, अवधि या बचा हुआ समय दिखाने के लिए कॉन्फ़िगर किया जा सकता है. PlayerViewमें मीडिया रूट बटन जोड़ने की सुविधा जोड़ी गई.- दाईं से बाईं ओर लिखे जाने वाले टेक्स्ट के सबटाइटल में विराम चिह्न सही तरीके से दिखाने के लिए,
BidiFormatterका इस्तेमाल करें (#11214).
- एचएलएस एक्सटेंशन:
- एचएलएस इंटरस्टीशियल स्किप एट्रिब्यूट को पार्स करना.
- एचएलएस प्लेलिस्ट और ऐसेट लिस्ट वाले दस्तावेज़ से, स्किप कंट्रोल एट्रिब्यूट को
AdPlaybackStateमें मैप करें, ताकि उन्हें सार्वजनिक तौर पर ऐक्सेस किया जा सके. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से प्लेलिस्ट के शुरू होने का समय हट जाता था. ऐसा तब होता था, जब प्लेलिस्ट से EXT-X-PROGRAM-START-DATE टैग को हटा दिया जाता था. इस टैग से प्लेलिस्ट के शुरू होने का समय तय होता था (#2760).
- प्लेलिस्ट में किसी दी गई पोज़िशन का सेगमेंट इंडेक्स ढूंढने के लिए, बाइनरी सर्च का इस्तेमाल करें (#2826).
HlsInterstitialsAdsLoader.skipCurrentAd()औरskipCurrentAdGroup()जोड़ें. साथ ही, इंडेक्स के हिसाब से विज्ञापनों और विज्ञापन ग्रुप को स्किप करने के लिए, उनसे जुड़े तरीके जोड़ें.- विज्ञापन की अवधि शुरू होने की जानकारी देने के लिए,
HlsInterstitialsAdsLoader.Listener.onAdStartedजोड़ें (#2859). - ISO 8601 तारीख-समय स्ट्रिंग में, तारीख/समय सेपरेटर के तौर पर स्पेस को स्वीकार करें.
- बिना सेगमेंट वाले
HlsMediaPlaylistके लिए, अगले चंक को फ़ेच करने की प्रोसेस को सही तरीके से मैनेज करें (#2821). - लाइव स्ट्रीम के दौरान, वीडियो शुरू होने से पहले दिखने वाले विज्ञापनों के लिए, डिफ़ॉल्ट स्टार्ट पोज़िशन का इस्तेमाल करें.
- DASH एक्सटेंशन:
- नॉन-हैरारकीकल
data:यूआरआई मेनिफ़ेस्ट के साथ DASH स्ट्रीम चलाते समय,UnsupportedOperationExceptionको ठीक किया गया (#2688). LiveConfigurationकोDashMediaSourceकेMediaItemसे मिली वैल्यू पर रीसेट करें. ऐसा तब करें, जब मीडिया आइटम को रिलीज़ किया जाए और उपयोगकर्ता उसे अपडेट करे (#2606).- मेनिफ़ेस्ट में अमान्य अपडेट की वजह से होने वाली क्रैश की समस्या को ठीक किया गया. इस समस्या को प्लेयर की गड़बड़ी के तौर पर रिपोर्ट नहीं किया गया था (#2805).
- नॉन-हैरारकीकल
- आरटीएसपी एक्सटेंशन:
- H264 और H265 के लिए, फ़्रैगमेंट की गई एनएएल यूनिट को प्रोसेस करते समय, आरटीपी पैकेट मौजूद न होने की गड़बड़ी को ठीक किया गया (#2613).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- AV1 एक्सटेंशन: AV1 सॉफ़्टवेयर डिकोडर अब बेहतर परफ़ॉर्मेंस वाली
dav1dलाइब्रेरी का इस्तेमाल करता है. इससे डिकोडिंग की स्पीड को बेहतर बनाने के लिए, पिछलेlibgav1वर्शन को बदल दिया गया है. - FFmpeg एक्सटेंशन: कुछ FLAC फ़ाइलों को चलाने से रोकने वाली समस्या को ठीक किया गया. इसके लिए, यह पक्का किया गया कि
STREAMINFOब्लॉक को सही तरीके से पार्स किया गया हो और डिकोडर को पास किया गया हो (#2887).
- AV1 एक्सटेंशन: AV1 सॉफ़्टवेयर डिकोडर अब बेहतर परफ़ॉर्मेंस वाली
- Cast एक्सटेंशन:
CastPlayer.Builderजोड़ें, जिससेCastPlayerको लोकल और Cast, दोनों तरह से वीडियो चलाने की सुविधा मिलती है. अगर आपकोCastPlayerकी पुरानी सुविधा को जारी रखना है, तोRemoteCastPlayerका इस्तेमाल करें. इससे सिर्फ़ कास्ट किए गए वीडियो चलाए जा सकेंगे. पहले से मौजूदCastPlayerकंस्ट्रक्टर, अपने पुराने तरीके से काम करते हैं. हालांकि, अब इनका इस्तेमाल नहीं किया जाता. इसके बजाय,CastPlayerयाRemoteCastPlayerबिल्डर का इस्तेमाल किया जाता है.DefaultMediaItemConverterमें, नॉन-नल एमआईएमई टाइप को लागू करना बंद करें.MediaItem.mediaMetadata.mediaTypeका इस्तेमाल करके, Cast MEDIA_TYPE का अनुमान लगाएं. इससे, उपलब्ध होने परDefaultCastOptionsProvider#toMediaQueueItemमें इसका इस्तेमाल किया जा सकेगा.DefaultCastOptionsProviderमें, रिमोट से लोकल ट्रांसफ़र की सुविधा चालू करें.- सेशन के डेमो में, कास्ट करने की सुविधा जोड़ें.
- कंपोज़ेबल यूज़र इंटरफ़ेस (यूआई) पर मीडिया रूट बटन दिखाने की सुविधा जोड़ें.
- कार्रवाई बार मेन्यू पर मीडिया रूट बटन दिखाने की सुविधा जोड़ें.
- मीडिया रूट बटन को व्यू यूआई के तौर पर दिखाने की सुविधा जोड़ें.
- टेस्ट यूटिलिटी:
FakeClockके लिए, एजेंडा के अगले विषय पर अपने-आप जाने की सुविधा के व्यवहार के लिए, समय के बीच ज़्यादा से ज़्यादा अंतर जोड़ें. यह डिफ़ॉल्ट रूप से एक सेकंड पर सेट होता है. हालांकि, इसेFakeClock.Builderकी मदद से कॉन्फ़िगर किया जा सकता है.RobolectricUtil.runMainLooperUntil(औरrunLooperUntil) के लिए, मैसेज के बीच ज़्यादा से ज़्यादा समय का अंतर जोड़ें. यह डिफ़ॉल्ट रूप से एक सेकंड पर सेट होता है. हालांकि, इन तरीकों के नए ओवरलोड की मदद से इसे कॉन्फ़िगर किया जा सकता है.test-utilsसेCapturingRenderersFactoryकोtest-utils-robolectricमें ट्रांसफ़र करें.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
- इस्तेमाल से बाहर हो चुके
DefaultPreloadManagerकंस्ट्रक्टर को हटाएं. इसके बजाय,DefaultPreloadManager.Builderका इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
EditedMediaItemSequenceकंस्ट्रक्टर हटाए गए. इसके बजाय,EditedMediaItemSequence.Builderका इस्तेमाल करें. BitmapFactoryImageDecoder.BitmapDecoderहटाएं. इसके बजाय,ExternallyLoadedImageDecoderका इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके
ShadowMediaCodecConfig.forAllSupportedMimeTypes()को हटाएं. इसके बजाय,ShadowMediaCodecConfig.withAllDefaultSupportedCodecs()का इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
ShadowMediaCodecConfig.withNoDefaultSupportedMimeTypes()को हटाएं. इसके बजाय,ShadowMediaCodecConfig.withNoDefaultSupportedCodecs()का इस्तेमाल करें.
- इस्तेमाल से बाहर हो चुके
1.9.0-rc01
1 दिसंबर, 2025
1.9.0 स्टेबल वर्शन का इस्तेमाल करें.
1.9.0-beta01
20 नवंबर, 2025
1.9.0 स्टेबल वर्शन का इस्तेमाल करें.
1.9.0-alpha01
22 अक्टूबर, 2025
1.9.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.8.0
1.8.1
21 मई, 2026
वर्शन 1.8.1 में ये कमिट शामिल हैं.
- असर:
- सरफ़ेसलेस कॉन्टेक्स्ट से ट्रांज़िशन करते समय,
GL_DRAW_BUFFERऔरGL_READ_BUFFERको साफ़ तौर पर सेट करें.
- सरफ़ेसलेस कॉन्टेक्स्ट से ट्रांज़िशन करते समय,
वर्शन 1.8.0
30 जुलाई, 2025
वर्शन 1.8.0 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
ForwardingSimpleBasePlayerमें प्लेयर को बदलने की सुविधा जोड़ें.
- ExoPlayer:
ExoPlayerइंटरफ़ेस में शफ़ल मोड के लिए गेटर जोड़ें (#2522).- अगर
DefaultAudioSinkको कई थ्रेड से ऐक्सेस किया जाता है, तो साफ़ तौर पर अपवाद दिखाएं. अगर ऐसा प्लेयर के बाहरRendererCapabilities.getFormatSupportको कॉल करने की वजह से होता है, तो पक्का करें कि इस तरीके को ExoPlayer के प्लेबैक थ्रेड की तरह ही कॉल किया जाए या प्लेबैक के लिए इस्तेमाल किए गए इंस्टेंस के बजाय किसी दूसरे इंस्टेंस का इस्तेमाल किया जाए (#1191). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से टीवी पर नॉन-स्टीरियो ऑडियो फ़ॉर्मैट को
DefaultTrackSelectorके साथ काम न करने वाले फ़ॉर्मैट के तौर पर मार्क किया जा सकता था. - पक्का करें कि MediaCodec के
DECODE_ONLYफ़्लैग का इस्तेमाल करते समय, आखिरी फ़्रेम सही तरीके से रेंडर हो. यह फ़्लैग, स्क्रबिंग मोड में डिफ़ॉल्ट रूप से चालू होता है. ContextसेExoPlayer.Builderको पास किए गए वर्चुअल डिवाइस आईडी का इस्तेमाल करने की सुविधा जोड़ें.- स्क्रबिंग मोड में, डाइनैमिक शेड्यूलिंग की सुविधा डिफ़ॉल्ट रूप से चालू करें.
- किसी आइटम के आखिर तक पहुंचने पर, सोर्स को बेवजह फिर से लोड करने से बचें.
- स्क्रबिंग मोड में, डिफ़ॉल्ट रूप से
MediaCodec.BUFFER_FLAG_DECODE_ONLYका इस्तेमाल करें. - जब
PreloadMediaSourceकोExoPlayerसे चलाया जाता है, तोIllegalStateExceptionको थ्रो करें. इसके लिए, प्रीलोड थ्रेड (#2495) से अलग प्लेबैक थ्रेड का इस्तेमाल करें. - डिफ़ॉल्ट तौर पर लागू होने वाली सुविधा के साथ,
cloneAndMoveकोShuffleModeमें जोड़ें (#2226). - अगर
renderको कॉल करने की ज़रूरत नहीं है, तोRenderer.getMinDurationToProgressUsके डिफ़ॉल्ट ऐक्शन और सेटिंग को बदलें, ताकि बड़ी वैल्यू रिटर्न की जा सके. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, वीडियो को रोककर आखिरी फ़्रेम पर जाने पर, इंटरनल शेड्यूलिंग की वजह से आखिरी फ़्रेम दिखने में देरी होती थी. फ़िलहाल, गड़बड़ी ठीक करने की सुविधा सिर्फ़ तब काम करती है, जब
ExoPlayer.Builder.experimentalSetDynamicSchedulingEnabledचालू हो. ExoPlayer.setScrubbingModeEnabled(boolean)तरीका जोड़ें. इससे प्लेयर को कई बार वीडियो आगे-पीछे करने के लिए ऑप्टिमाइज़ किया जाता है. उदाहरण के लिए, जब कोई उपयोगकर्ता स्क्रबर बार को इधर-उधर खींचता है. स्क्रबिंग मोड के काम करने के तरीके कोsetScrubbingModeParameters(..)परExoPlayerऔरExoPlayer.Builderकी मदद से, अपनी पसंद के मुताबिक बनाया जा सकता है.- स्क्रबिंग मोड में, फ़्रैक्शनल सीक टॉलरेंस को पसंद के मुताबिक बनाने की अनुमति दें.
- स्क्रबिंग मोड में कोडेक ऑपरेटिंग रेट बढ़ाएं.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से,
AdsMediaSourceके कॉन्टेंट में मौजूद गड़बड़ियों की जानकारी कभी नहीं दी जाती थी (#2337). MergingMediaSourceमें मेमोरी लीक की समस्या को ठीक किया गया. उदाहरण के लिए, सबटाइटल को अनजान सोर्स से इंस्टॉल करते समय इस्तेमाल किया जाता है (#2338).CmcdConfiguration.Factoryकोnullदिखाने की अनुमति दें, ताकि चुनिंदा मीडिया आइटम के लिए सीएमसीडी लॉगिंग को बंद किया जा सके (#2386).- इमेज के डिफ़ॉल्ट बफ़र साइज़ को 128 केबी से बढ़ाकर 26 एमबी किया गया. यह साइज़, 50 एमपी वाली अल्ट्रा एचडीआर इमेज के लिए काफ़ी है. पहले, टेक्स्ट ट्रैक से कॉपी-पेस्ट करने की गड़बड़ी की वजह से, बफ़र साइज़ 128 केबी था (#2417).
PreCacheHelperजोड़ें. इससे ऐप्लिकेशन, किसी एक मीडिया को प्री-कैशिंग कर सकते हैं. साथ ही, मीडिया के शुरू होने की जगह और अवधि तय कर सकते हैं.DefaultPreloadManagerमें, तय की गई पोज़िशन से पहले से लोड करने की सुविधा जोड़ें.
- ट्रांसफ़ॉर्मर:
CodecDbLiteजोड़ें. इससे, वीडियो एन्कोडिंग की सेटिंग को चिपसेट के हिसाब से ऑप्टिमाइज़ किया जा सकता है.- CodecDB Lite की सेटिंग ऑप्टिमाइज़ेशन की सुविधा चालू करने के लिए,
DefaultEncoderFactoryमेंsetEnableCodecDbLiteफ़्लैग जोड़ें. डिफ़ॉल्ट रूप से, यह फ़्लैग false पर सेट होता है. addGap()की मदद से जोड़े गए शुरुआती गैप को साइलेंट ऑडियो से भरने के लिए, अबEditedMediaItemSequence.BuilderमेंexperimentalSetForceAudioTrack(true)को साफ़ तौर पर सेट करना ज़रूरी है. अगर गैप क्रम के बीच में है, तो इस फ़्लैग की ज़रूरत नहीं है.Muxerइंटरफ़ेस कोmedia3-transformerसेmedia3-muxerमें ट्रांसफ़र करें.- किसी मीडिया आइटम को इमेज के तौर पर इंपोर्ट करने के लिए,
MediaItem.Builder().setImageDuration(long)सेटिंग को चालू करना ज़रूरी है. Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean)जोड़ें. इसमें वीडियो काटते समय MP4 एडिट लिस्ट शामिल होती है. इससे प्लेयर को निर्देश मिलता है कि वे वीडियो काटने के शुरुआती पॉइंट से पहले के की-फ़्रेम और वीडियो काटने के शुरुआती पॉइंट के बीच के सैंपल को अनदेखा करें.- Kotlin और Jetpack Compose का इस्तेमाल करने के लिए, Composition Demo ऐप्लिकेशन को अपडेट करें. साथ ही, सीक्वेंस को 2x2 या पीआईपी लेआउट में व्यवस्थित करने के लिए, कस्टम
VideoCompositorSettingsजोड़ें.
- एक्सट्रैक्टर:
- फ़्रैगमेंट की गई MP4 फ़ाइलों से मेटाडेटा पार्स करना (#2084).
- JPEG: ऐसी मोशन फ़ोटो के लिए सहायता उपलब्ध है जिनके शुरू में Exif सेगमेंट नहीं होता (#2552).
- एक से ज़्यादा
sidxऐटम वाले फ़्रैगमेंटेड MP4 में, वीडियो को आगे-पीछे करने की सुविधा जोड़ी गई. इस सुविधा कोFragmentedMp4ExtractorपरFLAG_MERGE_FRAGMENTED_SIDXफ़्लैग का इस्तेमाल करके चालू किया जा सकता है (#9373). - FLAC फ़ाइलों में खाली सीक टेबल को अनदेखा करें. इनमें सिर्फ़ प्लेसहोल्डर सीक पॉइंट वाली टेबल भी शामिल हैं. साथ ही, अगर फ़ाइल की अवधि पता है, तो बाइनरी सर्च सीकिंग पर वापस जाएं (#2327).
- H.265 एसईआई यूनिट की पार्सिंग को ठीक किया गया, ताकि ऐसे एसईआई टाइप को पूरी तरह से छोड़ा जा सके जिनकी पहचान नहीं की जा सकी है (#2456).
WavExtractorको अपडेट करें, ताकिWAVE_FORMAT_EXTENSIBLEटाइप की फ़ाइल को पार्स करते समय, ऑडियो फ़ॉर्मैट के लिए हेडर एक्सटेंशन के सबफ़ॉर्मैट डेटा का इस्तेमाल किया जा सके.- MP4: रॉ पीसीएम ऑडियो ट्रैक तय करने वाले
ipcmऔरfpcmबॉक्स के लिए सहायता जोड़ी गई. हालांकि, 64-बिट फ़्लोटिंग पॉइंट पीसीएम के लिए सहायता नहीं जोड़ी गई. - MP4:
tkhdट्रांसफ़ॉर्मेशन मैट्रिक्स के रोटेशन वाले हिस्से को हैंडल करें. इससे वीडियो को घुमाया और रिफ़्लेक्ट किया जा सकता है. इससे यह पक्का होता है कि iPhone के फ़्रंट कैमरे से लिए गए रिफ़्लेक्टेड वीडियो, सही तरीके से दिखें. हालांकि, ये y-ऐक्सिस में गलत तरीके से रिफ़्लेक्ट होते हैं (#2012). - MP3:
FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS)की वजह से, कॉन्स्टेंट बिटरेट पर वापस जाने पर, Xing, VBRI, और इसी तरह के वैरिएबल बिटरेट मेटाडेटा से अवधि और डेटा साइज़ का इस्तेमाल करें (#2194).
- ऑडियो:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मीडिया के खत्म होने के करीब ऑडियो प्लेबैक शुरू होने पर,
AnalyticsListener.onAudioPositionAdvancingको कॉल नहीं किया जाता. ChannelMappingAudioProcessorऔरTrimmingAudioProcessorमें सभी लीनियर पीसीएम सैंपल फ़ॉर्मैट के लिए सहायता जोड़ी गई.CompositionPlayerमें ऑडियो गैप के लिए सहायता जोड़ें.BaseAudioProcessor#reset()सेBaseAudioProcessor#flush()को किए गए नकली कॉल को हटाएं.- DefaultAudioMixer में, लगातार पावर अपमिक्सिंग/डाउनमिक्सिंग की अनुमति दें.
ChannelMappingAudioProcessor,TrimmingAudioProcessor, औरToFloatPcmAudioProcessorको सार्वजनिक करें (#2339).DefaultAudioSinkमें अंडररन का पता लगाने के लिए,AudioTrackPositionTrackerमेंAudioTrack#getUnderrunCount()का इस्तेमाल करें. इससे, आपको अनुमान लगाने के बजाय सटीक जानकारी मिलेगी.- ऑडियो आउटपुट डिवाइस से अचानक होने वाले पोज़िशन ड्रिफ़्ट के लिए, ऑडियो टाइमस्टैंप को बेहतर बनाएं.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से ब्लूटूथ डिवाइसों से कनेक्ट होने पर, वीडियो को रोके जाने के बाद फिर से शुरू करने पर, पहले 10 सेकंड तक ऑडियो और वीडियो सिंक नहीं होता था.
- उस गड़बड़ी को ठीक किया गया जिसकी वजह से
AnalyticsListener.onAudioPositionAdvancing, ऑडियो के आगे बढ़ने का समय नहीं, बल्कि पहली बार मेज़रमेंट का समय रिपोर्ट कर रहा था. - कुछ डिवाइसों पर स्टीरियो ऑडियो पर फ़ॉलबैक करने के बाद, मल्टीचैनल ऑडियो को वापस लाने की समस्या को ठीक किया गया (#2258).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मीडिया के खत्म होने के करीब ऑडियो प्लेबैक शुरू होने पर,
- वीडियो:
- "lenovo" और "motorola" डिवाइसों के लिए, डिटैच किए गए प्लैटफ़ॉर्म की समस्या को हल करने के तरीके को बढ़ाएं (#2059).
- वीडियो शुरू होने पर, वीडियो फ़्रेम को आसानी से रिलीज़ करने की सुविधा को बेहतर बनाएं. ऐसा तब करें, जब ऑडियो सैंपल ठीक उसी जगह से शुरू न हों जहां से शुरू करने का अनुरोध किया गया है.
- "realme" डिवाइसों के लिए, अलग किए गए सरफ़ेस की समस्या को हल करने के तरीके को बेहतर बनाया गया (#2059).
- सिर्फ़ डिकोड करने वाले इनपुट बफ़र को सूची में शामिल करते समय,
MediaCodec.BUFFER_FLAG_DECODE_ONLYफ़्लैग को शामिल करने के लिए, एक्सपेरिमेंट के तौर पर उपलब्धExoPlayerएपीआई जोड़ें. यह फ़्लैग, डिकोडर को डिकोड-ओनली बफ़र को स्किप करने का सिग्नल देगा. इससे, वीडियो को तेज़ी से आगे-पीछे किया जा सकेगा.DefaultRenderersFactory.experimentalSetEnableMediaCodecBufferDecodeOnlyFlagकी मदद से, इसे चालू करें. * सॉफ़्टवेयर वीडियो कोडेक के लिए, कोडेक की परफ़ॉर्मेंस की जांच को बेहतर बनाना. इस वजह से, कुछ और ट्रैक कोEXCEEDS_CAPABILITIESके तौर पर मार्क किया जा सकता है. - कुछ डिवाइसों पर VP9 Widevine वीडियो चलाने से जुड़ी गड़बड़ियां ठीक की गईं (#2408).
- टेक्स्ट:
- MP4 फ़ाइलों में VobSub ट्रैक के लिए सहायता जोड़ी गई (#2510).
- वीडियो चलाने के दौरान आने वाली उस रुकावट को ठीक किया गया है जो सबटाइटल सेगमेंट के लोड न होने पर आती थी. साथ ही, सबटाइटल सेगमेंट के लोड होने के बाद, कई खाली सबटाइटल सेगमेंट दिखने की समस्या को भी ठीक किया गया है (#2517).
- सबटाइटल चालू करने पर, प्रोग्रेस में चल रहे क्यू को दिखाने के लिए, एसएसए और SubRip को ठीक किया गया (#2309).
- सबटाइटल की गड़बड़ी वाली स्ट्रीम से, खाली सबटाइटल ट्रैक वाली लाइव स्ट्रीम पर स्विच करने पर, वीडियो चलाने में आने वाली समस्या को ठीक किया गया (#2328).
- B-फ़्रेम वाली H.262 स्ट्रीम चलाते समय, CEA-608 सबटाइटल के खराब होने की समस्या को ठीक किया गया (#2372).
- Matroska फ़ाइलों में
CodecId = S_TEXT/SSAके साथ एसएसए सबटाइटल के लिए सहायता जोड़ी गई. पहलेMatroskaExtractorसिर्फ़CodecId = S_TEXT/ASSके साथ काम करता था. इसका मकसद, SubStation Alpha सबटाइटल के 'ऐडवांस' (v4+) वैरिएंट को दिखाना है. हालांकि, ExoPlayer का पार्सिंग लॉजिक दोनों वैरिएंट के लिए एक जैसा है (#2384). - SubStation Alpha (SSA) सबटाइटल फ़ाइलों में
layerप्रॉपर्टी के लिए सहायता जोड़ी गई है. इसका इस्तेमाल, स्क्रीन पर एक ही समय में एक से ज़्यादा क्यू दिखाए जाने पर, उनके z-ऑर्डर को तय करने के लिए किया जाता है (#2124).
- मेटाडेटा:
MetadataRetrieverमें, मीडिया की अवधि औरTimelineको वापस पाने की सुविधा जोड़ी गई. साथ ही, इसे इंस्टेंस पर आधारितAutoCloseableएपीआई पर माइग्रेट किया गया.MediaItemके लिए इंस्टेंस बनाने के लिए, नएBuilderका इस्तेमाल करें. इसके बाद, मेटाडेटा के लिएListenableFutureपाने के लिए,retrieveTrackGroups(),retrieveTimeline(), औरretrieveDurationUs()को कॉल करें. पहले के स्टैटिक तरीके अब बंद कर दिए गए हैं (#2462).
- इमेज:
BitmapFactoryImageDecoderमें डिकोड किए गए बिटमैप को डिसप्ले साइज़ तक सीमित करें, ताकि बहुत बड़ी (जैसे, 50 एमपी) इमेज दिखाने की कोशिश करते समय,PlayerViewसेCanvas: trying to draw too large bitmap.की वजह से ऐप्लिकेशन क्रैश न हो.Contextपैरामीटर लेने के लिए,DefaultRenderersFactory.getImageDecoderFactory()के सिग्नेचर में बदलाव करें.CompositionPlayerमें इस्तेमाल किए गए बिटमैप आउटपुट के ज़्यादा से ज़्यादा साइज़ को,Transformerमें पहले से इस्तेमाल किए गए साइज़ के साथ अलाइन करें. इसका मतलब है किExoPlayerके उलट,CompositionPlayerबिटमैप को डिकोड करते समय डिसप्ले के साइज़ को ध्यान में नहीं रखता.
- डीआरएम:
OfflineLicenseHelper.newWidevineInstanceका नया ओवरलोड जोड़ें, जोMediaItem.DrmConfigurationको स्वीकार करता हो, ताकि एचटीटीपी अनुरोध के हेडर सही तरीके से लागू किए जा सकें (#2169).
- असर:
Presentation.createForShortSide(int)जोड़ें, जोPresentationबनाता है. इससे यह पक्का होता है कि इनपुट ओरिएंटेशन चाहे जो भी हो, सबसे छोटी साइड हमेशा दी गई वैल्यू से मैच करे.
- मक्सर:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, फ़्रैगमेंट किए गए MP4 में ऑडियो सैंपल के लिए सही सैंपल फ़्लैग सेट नहीं किए गए थे.
writeSampleData()एपीआई अबMediaCodec.BufferInfoके बजाय, मक्सर के लिए खास तौर पर बनाई गईBufferInfoक्लास का इस्तेमाल करता है.Muxer.Factory#supportsWritingNegativeTimestampsInEditListजोड़ें. यह डिफ़ॉल्ट तौर पर, 'गलत' पर सेट होता है.
- आईएमए एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसमें एक विज्ञापन लोड न होने पर, गलती से दूसरे विज्ञापन ग्रुप को अमान्य कर दिया जाता था.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से वीओडी विंडो खत्म होने के बाद, विज्ञापन ग्रुप की वजह से वीडियो रुक जाता था.
जिन विज्ञापन ग्रुप के शुरू होने का समय, विंडो के बाद का है उन्हें अब
MediaPeriodQueueमें सूची में नहीं रखा जाएगा (#2215).
- सेशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, तीसरे पक्ष के ऐसे Media3 कंट्रोलर के कनेक्शन को अनदेखा कर दिया जाता था जिनके पास खास अधिकार नहीं होते थे.
- लेगसी
MediaBrowserServiceCompatको कस्टम निर्देश भेजते समय, उपलब्ध निर्देशों की जांच करने की सुविधा हटाएं. यह लेगसी ऐप्लिकेशन से कनेक्ट होने पर, लेगसी कंट्रोलर/ब्राउज़र के व्यवहार के जैसा ही है. - उस गड़बड़ी को ठीक करना जिसकी वजह से, प्लेयर में वीडियो चलाने से जुड़ी पहली गड़बड़ी को गलती से कस्टम अपवाद के तौर पर माना जाता है. इससे ऐप्लिकेशन को रिकवर होने से रोका जाता है.
- उस गड़बड़ी को ठीक करें जिसकी वजह से कंट्रोलर में किए गए कुछ बदलाव, सेशन के दौरान मैनेज नहीं किए जा सकते. इससे
IllegalStateExceptionsहो सकता है. - उस गड़बड़ी को ठीक करें जिसकी वजह से, सेशन से मैनेज न की जाने वाली कंट्रोलर कार्रवाइयां, कंट्रोलर को अमान्य स्थिति में छोड़ सकती हैं.
- StrictMode में असुरक्षित लॉन्च के उल्लंघन की चेतावनी को ठीक किया गया (#2330).
- उस गड़बड़ी को ठीक किया गया है जिसमें प्लेयर को मुख्य थ्रेड के बजाय किसी अन्य ऐप्लिकेशन थ्रेड से चलाने पर, मुख्य थ्रेड से
setSessionExtrasको कॉल करने परIllegalStateException(#2265) होता था. - अगर किसी प्लेयर को मीडिया आइटम के साथ सेट अप किया गया है, तो उसे तैयार किए बिना या चलाए बिना, सूचना अपने-आप न दिखाएं (#2423https://github.com/androidx/media/issues/2423). इस व्यवहार को
MediaSessionService.setShowNotificationForIdlePlayerकी मदद से कॉन्फ़िगर किया जा सकता है. - सभी या चुने गए कंट्रोलर के लिए, कस्टम
PlaybackExceptionजोड़ें. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
MediaControllerपर लाइव स्ट्रीम में आगे-पीछे जाने पर,IllegalArgumentExceptionहो सकता है. - लाइव स्ट्रीम के लिए, वीडियो चलाने की पोज़िशन पब्लिश करना बंद करें. साथ ही, प्लैटफ़ॉर्म के मीडिया कंट्रोलर के लिए, मौजूदा आइटम में आगे-पीछे जाने की सुविधा बंद करें. इससे Android Auto के यूज़र इंटरफ़ेस (यूआई) में पोज़िशन आर्टफ़ैक्ट से बचा जा सकता है. साथ ही, प्लैटफ़ॉर्म के मीडिया सेशन से इस जानकारी का इस्तेमाल करने वाले अन्य कंट्रोलर में भी पोज़िशन आर्टफ़ैक्ट से बचा जा सकता है (#1758).
getLibraryRootमें null पास करने पर, लेगसीMediaBrowserServiceCompatसे कनेक्ट किए गएMediaBrowserमेंNullPointerExceptionजनरेट होने की गड़बड़ी को ठीक किया गया.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से कस्टम ऐक्शन, खोज के नतीजे या getItem का अनुरोध भेजने पर, लेगसी सेशन ऐप्लिकेशन
ClassNotFoundExceptionके साथ क्रैश हो जाता था. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से,
MediaItem.LocalConfiguration.uriको प्लैटफ़ॉर्म सेशन केMediaMetadataके साथ शेयर किया गया था. अगर आपको जान-बूझकर कोई यूआरआई शेयर करना है, ताकि कंट्रोलर मीडिया के लिए फिर से अनुरोध कर सकें, तो इसके बजायMediaItem.RequestMetadata.mediaUriसेट करें.
- यूज़र इंटरफ़ेस (यूआई):
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, फिर से इस्तेमाल किए जा सकने वाले कॉम्पोनेंट में मौजूद
PlayerSurface, जैसे किLazyColumnसही तरीके से काम नहीं करता था (#2493). - Compose की उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, बटन की शुरुआती स्थितियों को सेट करने और स्थिति में बदलाव को देखने के बीच अंतर होता था. जैसे, आइकॉन के आकार या चालू होने की स्थिति. ऑब्ज़र्वेशन पीरियड के बाहर, प्लेयर में किए गए किसी भी बदलाव को अब कैप्चर किया जाता है (#2313).
SeekBackButtonStateऔरSeekForwardButtonStateके लिए,media3-ui-composeमॉड्यूल में स्टेट होल्डर और कंपोज़ेबल जोड़ें.PlayerControlViewमें, ExoPlayer के स्क्रबिंग मोड की सुविधा जोड़ें. इस सुविधा के चालू होने पर, जब उपयोगकर्ता स्क्रबर बार को खींचना और छोड़ना शुरू करता है, तो प्लेयर स्क्रबिंग मोड में चला जाता है. साथ ही, हर मूवमेंट के लिएplayer.seekToकॉल करता है. इसके बाद, स्क्रीन से टच हटाए जाने पर स्क्रबिंग मोड से बाहर निकल जाता है. इस इंटिग्रेशन को एक्सएमएल मेंtime_bar_scrubbing_enabled = trueया Java/Kotlin मेंsetTimeBarScrubbingEnabled(boolean)तरीके से चालू किया जा सकता है.PlayerSurfaceको ऐसा बनाएं कि वह शून्य वैल्यू वालेPlayerआर्ग्युमेंट को स्वीकार करे.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, फिर से इस्तेमाल किए जा सकने वाले कॉम्पोनेंट में मौजूद
- डाउनलोड:
- प्रोग्रेसिव स्ट्रीम के लिए, कुछ हिस्सा डाउनलोड करने की सुविधा जोड़ी गई. ऐप्लिकेशन,
DownloadHelperकी मदद से प्रोग्रेसिव स्ट्रीम तैयार कर सकते हैं. साथ ही, हेल्पर सेDownloadRequestका अनुरोध कर सकते हैं. इसके लिए, उन्हें समय के हिसाब से मीडिया के शुरू और खत्म होने की पोज़िशन बतानी होगी, जिसे डाउनलोड करना है. लौटाए गएDownloadRequestमें, रिज़ॉल्व की गई बाइट रेंज होती है. इसकी मदद से,ProgressiveDownloaderबनाया जा सकता है और उसके हिसाब से कॉन्टेंट डाउनलोड किया जा सकता है. DownloadHelper.Factoryजोड़ें, जिससे स्टैटिकDownloadHelper.forMediaItem()तरीकों को बदला जाता है.SegmentDownloaderको लागू करने के लिए,Factoryजोड़ें.- अडैप्टिव स्ट्रीम के लिए, कुछ हिस्सा डाउनलोड करने की सुविधा जोड़ें. ऐप्लिकेशन,
DownloadHelperकी मदद से अडैप्टिव स्ट्रीम तैयार कर सकते हैं. साथ ही, हेल्पर सेDownloadRequestका अनुरोध कर सकते हैं. इसके लिए, उन्हें मीडिया के शुरू और खत्म होने का समय बताना होगा, ताकि हेल्पर को पता चल सके कि उसे कितने समय का मीडिया डाउनलोड करना है. लौटाए गएDownloadRequestमें, तय की गई समयसीमा की जानकारी होती है. इसकी मदद से, एक सटीकSegmentDownloaderबनाया जा सकता है और उसके हिसाब से कॉन्टेंट डाउनलोड किया जा सकता है.
- प्रोग्रेसिव स्ट्रीम के लिए, कुछ हिस्सा डाउनलोड करने की सुविधा जोड़ी गई. ऐप्लिकेशन,
- Cronet एक्सटेंशन:
- कुकी को अपने-आप मैनेज करने की सुविधा जोड़ें (#5975).
- एचएलएस एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसमें बफ़र में कोई चंक उपलब्ध न होने पर,
HlsSampleStreamWrapperबफ़र में खोजने की कोशिश करता है #2598. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कम इंतज़ार के समय वाले हिस्सों को लोड करने के बाद ट्रैक का चुना गया विकल्प बदल जाता था. साथ ही, प्रीलोड हिंट की वजह से वीडियो रुक जाता था या फ़्रीज़ हो जाता था (#2299).
- जब सर्वर
CAN-BLOCK-RELOAD=YESका पालन नहीं करता है, तो टारगेट की गई अवधि के आधे समय तक इंतज़ार करके, बार-बार रीलोड होने से रोकें (#2317). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, वीडियो के बीच में दिखने वाले विज्ञापन से पहले इंटरस्टीशियल स्ट्रीम शुरू करने पर, वीडियो रुक जाता था. साथ ही, गलत विज्ञापन के लिए ऐसेट लिस्ट रिज़ॉल्यूशन की कोशिश की जाती थी (#2558).
- कोट की गई स्ट्रिंग एट्रिब्यूट की वैल्यू में
\f(फ़ॉर्म फ़ीड) को स्वीकार करने के लिए, प्लेलिस्ट पार्स करने की सुविधा को ठीक किया गया (#2420). - एक ही आईडी से इंटरस्टीशियल अपडेट करने की सुविधा जोड़ी गई (#2427).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, लाइव स्ट्रीम के सेगमेंट खत्म होने पर, प्लेलिस्ट लोड होने से जुड़ी गड़बड़ियां कभी-कभी नहीं दिखती थीं (#2401https://github.com/androidx/media/issues/2401).
- सबटाइटल रेंडरेशन को NAME टैग के हिसाब से ग्रुप करें. ठीक उसी तरह जैसे ऑडियो रेंडरेशन को पहले से ग्रुप किया गया है (#1666).
HlsInterstitialsAdsLoaderके साथ X-ASSET-LIST और लाइव स्ट्रीम की सुविधा.
- उस गड़बड़ी को ठीक किया गया है जिसमें बफ़र में कोई चंक उपलब्ध न होने पर,
- DASH एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसमें ट्रिक-प्ले अडैप्टेशन सेट को उसके मुख्य अडैप्टेशन सेट के साथ मर्ज करके, एक अमान्य
TrackGroupबनाया जाता है (#2148). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, डीएएसएच पीरियड की अवधि को छोटा करने पर अपवाद दिख सकता है. ऐसा तब होता है, जब रेंडरिंग पाइपलाइन ने नई अवधि के बाद के सैंपल पहले ही पढ़ लिए हों (#2440).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, सीएमसीडी क्वेरी पैरामीटर का इस्तेमाल करने पर रीडायरेक्ट नहीं किया जा रहा था (#2475).
- उस समस्या को ठीक किया गया है जिसमें ट्रिक-प्ले अडैप्टेशन सेट को उसके मुख्य अडैप्टेशन सेट के साथ मर्ज करके, एक अमान्य
- आरटीएसपी एक्सटेंशन:
- आरएफ़सी 7798#4.4.2 (#2413) के मुताबिक, H265 के लिए आरटीपी एग्रीगेशन पैकेट के साथ काम करने की सुविधा जोड़ी गई.
- एचटीटीपी 302 रिस्पॉन्स को प्रोसेस करते समय, जगह की जानकारी के यूआरआई का इस्तेमाल करने के लिए,
RtspClientको ठीक किया गया (#2398). - SessionDescriptions के लिए पार्सिंग की सुविधा जोड़ी गई. इसमें ऐसी लाइनें शामिल हैं जिनके आखिर में खाली सफ़ेद जगह वाले वर्ण हैं (#2357).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ऑडियो डिकोडर एक्सटेंशन के लिए,
DefaultTrackSelector.setAllowInvalidateSelectionsOnRendererCapabilitiesChangeका कोई असर नहीं होता था (#2258).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ऑडियो डिकोडर एक्सटेंशन के लिए,
- Cast एक्सटेंशन:
- टेस्ट यूटिलिटी:
- खिलाड़ी को आगे बढ़ाने के लिए,
advance(player).untilPositionAtLeastऔरuntilMediaItemIndexकोTestPlayerRunHelperमें जोड़ें. ऐसा तब तक करें, जब तक कि वह तय की गई जगह पर न पहुंच जाए. ज़्यादातर मामलों में, ये तरीकेuntilPositionऔरuntilStartOfMediaItemके मौजूदा तरीकों से ज़्यादा भरोसेमंद होते हैं. FakeDownloaderकोtest-utils-robolectricमॉड्यूल में ले जाएं, ताकि अन्य टेस्ट में इसका फिर से इस्तेमाल किया जा सके.transformer.TestUtil.addAudioDecoders(String...),transformer.TestUtil.addAudioEncoders(String...), औरtransformer.TestUtil.addAudioEncoders(ShadowMediaCodec.CodecConfig, String...)को हटाया गया. इसके बजाय, शैडो एन्कोडर और डिकोडर को कॉन्फ़िगर करने के लिए,ShadowMediaCodecConfigका इस्तेमाल करें.ShadowMediaCodecConfigसे रिपोर्ट किए गए कोडेक के नामों में, "exotest" प्रीफ़िक्स को "media3" से बदल दिया गया है.
- खिलाड़ी को आगे बढ़ाने के लिए,
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
- इस्तेमाल से बाहर हो चुके
SegmentDownloaderकंस्ट्रक्टरSegmentDownloader(MediaItem, Parser<M>, CacheDataSource.Factory, Executor)और इसकी सबक्लासDashDownloader,HlsDownloader, औरSsDownloaderमें मौजूद संबंधित कंस्ट्रक्टर को हटा दिया गया है. Player.hasNext(),Player.hasNextWindow()को हटा दिया गया है, क्योंकि अब इनका इस्तेमाल नहीं किया जाता. इसके बजाय,Player.hasNextMediaItem()का इस्तेमाल करें.Player.next()को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता. इसके बजाय,Player.seekToNextMediaItem()का इस्तेमाल करें.Player.seekToPreviousWindow()को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता. इसके बजाय,Player.seekToPreviousMediaItem()का इस्तेमाल करें.Player.seekToNextWindow()को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता. इसके बजाय,Player.seekToNextMediaItem()का इस्तेमाल करें.exoplayerमॉड्यूल से, अब इस्तेमाल नहीं किए जा रहेBaseAudioProcessorको हटाया गया.commonमॉड्यूल में जाकर,BaseAudioProcessorका इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके
MediaCodecVideoRendererकंस्ट्रक्टर को हटाएंMediaCodecVideoRenderer(Context, MediaCodecAdapter.Factor, MediaCodecSelector, long, boolean, @Nullable Handler, @Nullable VideoRendererEventListener, int, float, @Nullable VideoSinkProvider).
- इस्तेमाल से बाहर हो चुके
वर्शन 1.8.0-rc02
24 जुलाई, 2025
1.8.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.8.0-rc01
16 जुलाई, 2025
1.8.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.8.0-beta01
2 जुलाई, 2025
1.8.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.8.0-alpha01
19 मई, 2025
1.8.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.7.0
वर्शन 1.7.1
16 मई, 2025
इस रिलीज़ का कोड 1.6.1 जैसा ही है. इसे इसलिए रिलीज़ किया जा रहा है, ताकि यह 1.7.0 से 'नए' रिलीज़ के तौर पर दिखे. 1.7.0 एक ऐल्फ़ा रिलीज़ थी, जिसे गलती से स्टेबल के तौर पर टैग कर दिया गया था (नीचे देखें).
वर्शन 1.7.0
16 मई, 2025
यह रिलीज़ 1.7.0-alpha01 होनी चाहिए थी, लेकिन maven.google.com पर इसे गलती से 1.7.0 (यानी कि स्टेबल) के तौर पर टैग कर दिया गया. कृपया इसका इस्तेमाल न करें. 1.6.1 का इस्तेमाल जारी रखें या 1.7.1 पर अपग्रेड करें. इसमें 1.6.1 जैसा ही कोड है.
वर्शन 1.6.0
1.6.1
14 अप्रैल, 2025
androidx.media3:media3-*:1.6.1 रिलीज़ हो गया है. वर्शन 1.6.1 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
PlaybackParameters.withPitch(float)तरीका जोड़ा गया, ताकि नईpitchवैल्यू के साथPlaybackParametersको आसानी से कॉपी किया जा सके (#2257).
- ExoPlayer:
- उस समस्या को ठीक किया गया है जिसकी वजह से, अगले मीडिया आइटम को शुरू करने के दौरान रेंडरर की गड़बड़ी की वजह से, मीडिया आइटम ट्रांज़िशन नहीं हो पाता था. हालांकि, इस गड़बड़ी को ठीक किया जा सकता है (#2229).
- उस समस्या को ठीक किया गया है जिसमें
ProgressiveMediaPeriod,IllegalStateExceptionको थ्रो करता है, क्योंकिPreloadMediaSource,getBufferedDurationUs()को तैयार होने से पहले कॉल करने की कोशिश करता है (#2315). - DASH, HLS, और SmoothStreaming के लिए मेनिफ़ेस्ट अनुरोधों में
CmcdDataभेजने की समस्या को ठीक किया गया (#2253). - पक्का करें कि विज्ञापन ग्रुप हटाए जाने के बाद,
AdPlaybackState.withAdDurationsUs(long[][])का इस्तेमाल किया जा सके. उपयोगकर्ता को अब भी हटाए गए विज्ञापन ग्रुप के लिए, अवधि का कलेक्शन पास करना होगा. यह कलेक्शन खाली या शून्य हो सकता है (#2267).
- एक्सट्रैक्टर:
- MP4:
tkhdबॉक्स सेalternate_groupको पार्स करें और इसे हर ट्रैक केFormat.metadataमेंMp4AlternateGroupDataएंट्री के तौर पर दिखाएं (#2242).
- MP4:
- ऑडियो:
- ऑफ़लोड से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, कम अवधि वाले कॉन्टेंट की प्लेलिस्ट चलाते समय, वीडियो की पोज़िशन अटक सकती थी (#1920).
- सेशन:
- प्लैटफ़ॉर्म
MediaSessionके कॉलबैक के लिए, एग्रीगेशन टाइम आउट को 500 से घटाकर 100 मिलीसेकंड करें. साथ ही, ऐप्लिकेशन को इस वैल्यू को कॉन्फ़िगर करने की अनुमति देने के लिए, एक्सपेरिमेंट के तौर पर सेटर जोड़ें. - उस समस्या को ठीक किया गया है जिसमें उपयोगकर्ता के खारिज करने के बाद भी सूचनाएं फिर से दिखती थीं (#2302).
- उस गड़बड़ी को ठीक किया गया है जिसमें रैप किया गया प्लेयर खाली होने पर, सेशन में एक आइटम वाली टाइमलाइन दिखती थी. ऐसा तब होता है, जब रैप किए गए प्लेयर में
COMMAND_GET_TIMELINEउपलब्ध न हो, लेकिनCOMMAND_GET_CURRENT_MEDIA_ITEMउपलब्ध हो और रैप किया गया प्लेयर खाली हो (#2320). - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, सेवा के साथ अन्य इंटरैक्शन के बाद,
MediaSessionService.setMediaNotificationProviderको कॉल करने पर, बिना किसी सूचना के उसे अनदेखा कर दिया जाता था. जैसे,setForegroundServiceTimeoutMs(#2305).
- प्लैटफ़ॉर्म
- यूज़र इंटरफ़ेस (यूआई):
ExoPlayer.setVideoEffectsऔरCompositionPlayerके साथ काम करने के लिए,PlayerSurfaceको चालू करें.- उस गड़बड़ी को ठीक करना जिसकी वजह से,
PlayerSurfaceको नएPlayerके साथ फिर से कंपोज़ नहीं किया जा सकता.
- एचएलएस एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसमें एचएलएस मीडिया के लिए,
CmcdDataमें चंक की अवधि सेट नहीं की गई थी. इसकी वजह से, एन्क्रिप्ट किए गए मीडिया सेगमेंट को प्रोसेस करते समय, दावा पूरा नहीं हो पा रहा था (#2312).
- उस समस्या को ठीक किया गया है जिसमें एचएलएस मीडिया के लिए,
- आरटीएसपी एक्सटेंशन:
- टीसीपी का इस्तेमाल करने के लिए, आरटीएसपी सेशन को कॉन्फ़िगर करने के तरीके के तौर पर, आरटीएसपीटी स्कीम वाले यूआरआई के लिए सहायता जोड़ी गई (#1484).
- Cast एक्सटेंशन:
- प्लेलिस्ट के मेटाडेटा के लिए सहायता जोड़ी गई (#2235).
1.6.0
26 मार्च, 2025
androidx.media3:media3-*:1.6.0 रिलीज़ हो गया है. वर्शन 1.6.0 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
androidx.mediaमें मौजूद मिलती-जुलती कैटगरी को बदलने के लिए,AudioManagerCompatऔरAudioFocusRequestCompatजोड़ें.- Kotlin को 1.9.20 से 2.0.20 पर अपग्रेड करें और Compose कंपाइलर Gradle प्लग इन का इस्तेमाल करें. KotlinX Coroutines लाइब्रेरी को 1.8.1 से 1.9.0 पर अपग्रेड किया गया.
Format.toBundle(boolean excludeMetadata)तरीका हटाएं. इसके बजाय,Format.toBundle()का इस्तेमाल करें.SimpleBasePlayerमें मौजूद गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से,nullMediaMetadataके साथsetPlaylistके बाद,Stateमें नयाcurrentMediaItemIndexसेट करने पर, मेटाडेटा का फिर से आकलन नहीं होता था (#1940).SimpleBasePlayer.Stateके ऐक्सेस को सुरक्षित से सार्वजनिक में बदलें, ताकि अन्य क्लास में अपडेट को मैनेज करना आसान हो सके (#2128).
- ExoPlayer:
MediaExtractorCompatजोड़ें. यह एक नई क्लास है, जो प्लैटफ़ॉर्मMediaExtractorके जैसी सुविधाएं उपलब्ध कराती है.MediaCodecVideoRendererका इस्तेमाल करके वीडियो चलाने के लिए, एक्सपेरिमेंट के तौर पर 'ExoPlayer' को पहले से वॉर्म करने की सुविधा जोड़ी गई.DefaultRenderersFactoryकोexperimentalSetEnableMediaCodecVideoRendererPrewarmingके ज़रिए कॉन्फ़िगर किया जा सकता है, ताकिExoPlayerको सेकंडरीMediaCodecVideoRendererउपलब्ध कराया जा सके. अगर यह सुविधा चालू है, तोExoPlayerवीडियो चलाते समय, लगातार आने वाले मीडिया आइटम के वीडियो को पहले से प्रोसेस कर लेता है. इससे मीडिया आइटम के ट्रांज़िशन में लगने वाला समय कम हो जाता है.DefaultLoadControlमेंbufferForPlaybackMsऔरbufferForPlaybackAfterRebufferMsकी डिफ़ॉल्ट वैल्यू को कम करके, क्रमशः 1000 और 2000 मिलीसेकंड करें.DeviceInfoऔर डिवाइस के वॉल्यूम को एसिंक्रोनस तरीके से शुरू करें. ऐसा तब करें, जबsetDeviceVolumeControlEnabledका इस्तेमाल करके इसे चालू किया गया हो.ExoPlayer.Builder.build()के बाद, ये वैल्यू तुरंत उपलब्ध नहीं होती हैं. साथ ही,Player.Listener,onDeviceInfoChangedऔरonDeviceVolumeChangedके ज़रिए बदलावों की सूचना देता है.- प्लेयर बनाने के बाद, शुरुआती ऑडियो सेशन आईडी तुरंत उपलब्ध नहीं होता. अगर ज़रूरी हो, तो शुरुआती अपडेट सुनने के लिए,
AnalyticsListener.onAudioSessionIdChangedका इस्तेमाल किया जा सकता है. - वीडियो ट्रैक चुनते समय भाषा का ध्यान रखें. डिफ़ॉल्ट रूप से, चुने गए ऑडियो ट्रैक की भाषा से मैच करने वाला 'मुख्य' वीडियो ट्रैक चुनें. हालांकि, ऐसा तब ही करें, जब वह उपलब्ध हो. वीडियो की भाषा से जुड़ी साफ़ तौर पर बताई गई प्राथमिकताओं को
TrackSelectionParameters.Builder.setPreferredVideoLanguage(s)की मदद से दिखाया जा सकता है. DefaultTrackSelector.selectVideoTrack()तरीके मेंselectedAudioLanguageपैरामीटर जोड़ो.MediaSourceEventListener.onLoadStartedमेंretryCountपैरामीटर और उससे जुड़ेMediaSourceEventListener.EventDispatcherतरीके जोड़ें.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मल्टी-पीरियड DASH स्ट्रीम में प्लेलिस्ट के आइटम या पीरियड की अवधि, असल कॉन्टेंट से मैच नहीं होने पर, आइटम के आखिर में फ़्रेम फ़्रीज़ हो जाते थे (#1698).
BasePreloadManager.Listenerको टॉप-लेवलPreloadManagerListenerमें ले जाएं.RenderersFactory.createSecondaryRendererको लागू करके, प्री-वॉर्मिंग के लिए सेकंडरी रेंडरर उपलब्ध कराए जा सकते हैं. प्री-वॉर्मिंग की सुविधा से, वीडियो चलाने के दौरान मीडिया आइटम के बीच तेज़ी से ट्रांज़िशन किया जा सकता है.- अडैप्टिव स्ट्रीमिंग फ़ॉर्मैट DASH, HLS, और SmoothStreaming में मेनिफ़ेस्ट अनुरोधों के लिए,
CmcdDataभेजने की सुविधा चालू करें (#1951). MediaCodecInfoकोडेक उपलब्ध कराएं, जिसेMediaCodecRenderer.onReadyToInitializeCodecमें शुरू किया जाएगा (#1963).- विज्ञापन ग्रुप जोड़कर
AdPlaybackStatesको बढ़ाने के लिए,AdsMediaSourceको बदलें. अमान्य बदलावों का पता चलता है और एक अपवाद दिखता है. - उस समस्या को ठीक किया गया है जिसमें वीडियो के बीच में दिखने वाले विज्ञापन के बाद, कॉन्टेंट मीडिया पर ट्रांज़िशन करते समय, डिकोड-ओनली फ़्रेम एक के बाद एक तेज़ी से दिख सकते थे.
DefaultRenderersFactoryकोMetadataRendererके दो इंस्टेंस जोड़ने होंगे, ताकि ऐप्लिकेशन डिफ़ॉल्ट रूप से मेटाडेटा की दो अलग-अलग स्कीमें पा सकें.- वीडियो चलाना रोके जाने पर, चंक के मौजूदा लोड को रद्द किया जाना चाहिए या नहीं, इसका फिर से आकलन करें (#1785).
ClippingMediaSourceमें, ऐसे मीडिया से क्लिप बनाने की अनुमति देने का विकल्प जोड़ें जिसे आगे-पीछे करके नहीं देखा जा सकता.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, प्री-वॉर्मिंग के साथ मीडिया आइटम को आगे-पीछे करने पर, अगले मीडिया आइटम पर ट्रांज़िशन ब्लॉक हो सकता था.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
ExoPlayer.isLoading(),STATE_IDLEयाSTATE_ENDEDमें ट्रांज़िशन होने के बाद भीtrueबना रहता है (#2133). LoadControl.ParameterमेंlastRebufferRealtimeMsजोड़ा गया (#2113).
- ट्रांसफ़ॉर्मर:
- पुराने सिस्टम के साथ काम करने वाले अन्य फ़ॉर्मैट में ट्रांसमक्स करने की सुविधा जोड़ें.
- Dolby Vision (प्रोफ़ाइल 8) फ़ॉर्मैट को ट्रांसकोड और ट्रांसमक्स करने की सुविधा जोड़ी गई.
Formatका इस्तेमाल करने के लिए,VideoFrameProcessor.registerInputStreamऔरVideoFrameProcessor.Listener.onInputStreamRegisteredके पैरामीटर अपडेट करें.DefaultEncoderFactoryका इस्तेमाल करते समय, एचडीआर स्टैटिक मेटाडेटा जनरेट करें.MediaMetricsManagerका इस्तेमाल करके, Android प्लैटफ़ॉर्म के डाइग्नोस्टिक्स के लिए सहायता चालू करें. Transformer, प्लैटफ़ॉर्म पर एडिटिंग इवेंट और परफ़ॉर्मेंस डेटा भेजता है. इससे डिवाइस पर सिस्टम की परफ़ॉर्मेंस और डीबग करने की जानकारी मिलती है. अगर डिवाइस का इस्तेमाल करने वाले व्यक्ति ने इस्तेमाल और गड़बड़ी की जानकारी शेयर करने की सुविधा चालू की है, तो Google भी यह डेटा इकट्ठा कर सकता है. ऐप्लिकेशन,Transformer.Builder.setUsePlatformDiagnostics(false)का इस्तेमाल करके, Transformer के लिए प्लैटफ़ॉर्म डाइग्नोस्टिक्स में योगदान देने से बाहर हो सकते हैं.InAppMuxerकोInAppMp4MuxerऔरInAppFragmentedMp4Muxerमें बांटें.InAppMp4Muxerका इस्तेमाल, बिना फ़्रैगमेंट वाली MP4 फ़ाइल बनाने के लिए किया जाता है. वहीं,InAppFragmentedMp4Muxerका इस्तेमाल, फ़्रैगमेंट वाली MP4 फ़ाइल बनाने के लिए किया जाता है.Muxerइंटरफ़ेस कोmedia3-muxerसेmedia3-transformerमें ट्रांसफ़र करें.MediaProjectionAssetLoaderजोड़ें, जो स्क्रीन रिकॉर्डिंग के लिएMediaProjectionसे मीडिया उपलब्ध कराता है. साथ ही, ट्रांसफ़ॉर्मर डेमो ऐप्लिकेशन में स्क्रीन रिकॉर्डिंग की सुविधा जोड़ें.#getInputFormat()कोCodecइंटरफ़ेस में जोड़ें.DefaultVideoFrameProcessorऔरDefaultVideoCompositorमें, जब भी मुमकिन हो,GlObjectsProviderको रिलीज़ करने की ज़िम्मेदारी कॉल करने वाले व्यक्ति को दें.
- एक्सट्रैक्टर:
- AVI: कॉन्स्टेंट बिटरेट वाले कंप्रेस किए गए ऑडियो वाली फ़ाइलों को हैंडल करने की समस्या को ठीक किया गया. इसमें स्ट्रीम हेडर, चंक की संख्या के बजाय बाइट की संख्या को सेव करता है.
- एनएएल यूनिट को हैंडल करने की समस्या को ठीक किया गया. इसमें लंबाई को चार के बजाय एक या दो बाइट में दिखाया जाता था.
- MP4 की बदलाव सूचियों में
ArrayIndexOutOfBoundsExceptionको ठीक किया गया. ऐसा तब किया गया, जब बदलाव सूची किसी ऐसे नॉन-सिंक फ़्रेम से शुरू होती है जिसके पहले कोई सिंक फ़्रेम नहीं होता (#2062). - उस समस्या को ठीक किया गया है जिसकी वजह से कुछ डिवाइसों पर टीएस स्ट्रीम रुक सकती हैं (#2069).
- FLAC: 32-बिट FLAC फ़ाइलों के लिए सहायता जोड़ें. पहले,
IllegalStateException: Playback stuck buffering and not loading(#2197) के साथ ये वीडियो नहीं चलते थे.
- ऑडियो:
onAudioPositionAdvancingको ठीक किया गया, ताकि वीडियो फिर से शुरू होने पर इसे कॉल किया जा सके. पहले, वीडियो रोके जाने पर इसे कॉल किया जाता था.- जब
SpeedChangingAudioProcessorको डिफ़ॉल्ट पैरामीटर के साथ कॉन्फ़िगर किया गया हो, तबSonicAudioProcessorको बायपास न करें. Sonic#getOutputSize()में अंडरफ़्लो की समस्या को ठीक किया गया है. इसकी वजह से,DefaultAudioSinkरुक सकता था.MediaCodecAudioRenderer.getDurationToProgressUs()औरDecoderAudioRenderer.getDurationToProgressUs()को ठीक करें, ताकि सीक करने पर, दी गई अवधि सही तरीके से रीसेट हो जाए.androidx.media3.common.audio.SonicAudioProcessorको फ़ाइनल करें.ChannelMappingAudioProcessorऔरTrimmingAudioProcessorमें, फ़्लोट पीसीएम के लिए सहायता जोड़ी गई.
- वीडियो:
MediaCodecVideoRenderer.shouldUsePlaceholderSurfaceको protected में बदलें, ताकि ऐप्लिकेशन, प्लेसहोल्डर सरफ़ेस के इस्तेमाल को ब्लॉक करने के लिए, इसे बदल सकें (#1905).- सीकिंग की स्पीड बढ़ाने के लिए, एक्सपेरिमेंट के तौर पर
ExoPlayerAV1 सैंपल डिपेंडेंसी पार्सिंग की सुविधा जोड़ी गई. इसे नएDefaultRenderersFactory.experimentalSetParseAv1SampleDependenciesAPI की मदद से चालू करें. - देरी से मिले
MediaCodecVideoRendererडिकोडर इनपुट बफ़र को हटाने के लिए, एक्सपेरिमेंट के तौर परExoPlayerएपीआई जोड़ें. ये बफ़र, किसी पर निर्भर नहीं होते.DefaultRenderersFactory.experimentalSetLateThresholdToDropDecoderInputUsकी मदद से, इसे चालू करें. * उस समस्या को ठीक किया गया है जिसमें बिना सरफ़ेस वाला प्लेयर तुरंत तैयार हो जाता था और बाकी बचे फ़्रेम को डिकोड करने में बहुत ज़्यादा समय लेता था (#1973). - स्क्रीन फ़्लिकरिंग की समस्या से बचने के लिए, Xiaomi और OPPO डिवाइसों को डिटैच्ड सरफ़ेस मोड से बाहर रखें (#2059).
- टेक्स्ट:
- VobSub सबटाइटल के लिए सहायता जोड़ी गई (#8260).
MediaItem.Builder.setSubtitleConfigurationsके साथ कॉन्फ़िगर की गई सभी सबटाइटल फ़ाइलों को तेज़ी से लोड करना बंद करें. इसके बजाय, सिर्फ़ एक फ़ाइल लोड करें, अगर उसे ट्रैक चुनने की सुविधा (#1721) से चुना गया है.- टीटीएमएल:
style(#2953) का इस्तेमाल करके,tts:originऔरtts:extentको रेफ़रंस के तौर पर इस्तेमाल करने की सुविधा जोड़ी गई. - WebVTT और SubRip टाइमस्टैंप को दशमलव के बाद सिर्फ़ तीन अंकों तक सीमित रखें. पहले, हम दशमलव के बाद के अंकों की संख्या को गलत तरीके से पार्स करते थे. हालांकि, हम हमेशा यह मानते थे कि वैल्यू मिलीसेकंड में है. इस वजह से, टाइमस्टैंप गलत होते थे (#1997).
- उस समस्या को ठीक किया गया है जिसमें CEA-608 या CEA-708 कैप्शन वाली क्लिप वाली प्लेलिस्ट चलाने पर, वीडियो रुक जाता था.
- जब किसी एसएसए फ़ाइल में शून्य अवधि वाला संकेत (शुरू और खत्म होने का समय बराबर) शामिल हो, तो
IllegalStateExceptionको ठीक किया गया (#2052). - सबटाइटल को पार्स करने से जुड़ी गड़बड़ियों को दबाएं (और लॉग करें). ऐसा तब करें, जब सबटाइटल को ऑडियो और वीडियो वाले कंटेनर में ही मक्स किया गया हो (#2052).
- सीआर लाइन एंडिंग (#2167) का इस्तेमाल करके, WebVTT फ़ाइलों में मल्टी-बाइट UTF-8 वर्णों को मैनेज करने की समस्या को ठीक किया गया.
- डीआरएम:
- एपीआई < 27 वाले डिवाइसों पर ClearKey कॉन्टेंट चलाते समय होने वाली
MediaCodec$CryptoException: Operation not supported in this configurationगड़बड़ी को ठीक किया गया (#1732).
- एपीआई < 27 वाले डिवाइसों पर ClearKey कॉन्टेंट चलाते समय होने वाली
- असर:
OverlaySettingsकी सुविधा कोStaticOverlaySettingsमें शामिल किया गया.OverlaySettingsको सबक्लास किया जा सकता है, ताकि डाइनैमिक ओवरले सेटिंग की अनुमति दी जा सके.
- मक्सर:
MuxerExceptionकोMuxerइंटरफ़ेस से बाहर ले जाया गया, ताकि पूरी तरह से क्वालिफ़ाइड नाम बहुत लंबा न हो.Mp4Muxer.BuilderऔरFragmentedMp4Muxer.Builder, दोनों मेंsetSampleCopyEnabled()तरीके का नाम बदलकरsetSampleCopyingEnabled()किया गया.Mp4Muxer.addTrack()औरFragmentedMp4Muxer.addTrack()अबTrackTokenके बजाय,intट्रैक आईडी दिखाते हैं.Mp4MuxerऔरFragmentedMp4MuxerअबMuxerइंटरफ़ेस को लागू नहीं करते.Mp4Muxerसैंपल की बैचिंग और कॉपी करने की सुविधा को डिफ़ॉल्ट रूप से बंद करें.FragmentedMp4Muxerमें मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, सिर्फ़ ऑडियो ट्रैक लिखे जाने पर कई फ़्रैगमेंट बन जाते थे.
- सेशन:
- वीडियो चलाना रुकने, बंद होने या न चलने पर, फ़ोरग्राउंड सेवा की स्थिति को 10 मिनट तक बनाए रखें. इससे उपयोगकर्ता, इस टाइम आउट के अंदर वीडियो चलाना फिर से शुरू कर सकते हैं. साथ ही, उन्हें अलग-अलग डिवाइसों पर फ़ोरग्राउंड सर्विस से जुड़ी पाबंदियों का जोखिम नहीं उठाना पड़ता. ध्यान दें कि
onTaskRemovedको ओवरराइड करते समय,stopSelf()से पहले फ़ोरग्राउंड सेवा को रोकने के लिए, सिर्फ़player.pause()को कॉल करने का इस्तेमाल नहीं किया जा सकता. इसके बजाय,MediaSessionService.pauseAllPlayersAndStopSelf()का इस्तेमाल करें. - वीडियो चलाने के दौरान कोई गड़बड़ी होने या वीडियो रुकने पर, सूचना को स्क्रीन पर बनाए रखें. यह सूचना सिर्फ़ तब हटती है, जब प्लेलिस्ट को खाली कर दिया जाता है या प्लेयर को बंद कर दिया जाता है.
- Android प्लैटफ़ॉर्म पर MediaSession की कार्रवाइयों ACTION_PLAY और ACTION_PAUSE को बेहतर तरीके से मैनेज करें. इसके लिए, उपलब्ध निर्देशों के हिसाब से इनमें से सिर्फ़ एक कार्रवाई सेट करें. साथ ही, अगर इनमें से सिर्फ़ एक कार्रवाई सेट की गई है, तो उसे स्वीकार करें.
MediaButtonReceiver.shouldStartForegroundServiceमेंContextको पैरामीटर के तौर पर जोड़ें (#1887).- उस गड़बड़ी को ठीक किया गया है जिसमें लेगसी सेशन से कनेक्ट किए गए
MediaControllerपरPlayerमेथड को कॉल करने पर, बाकी बचे अपडेट से बदलावों को हटा दिया जाता था. MediaSession.setSessionActivity(PendingIntent)को शून्य स्वीकार करने लायक बनाएं (#2109).- प्लेलिस्ट को खाली करने पर, पुरानी सूचना दिखने की गड़बड़ी को ठीक किया गया (#2211).
- वीडियो चलाना रुकने, बंद होने या न चलने पर, फ़ोरग्राउंड सेवा की स्थिति को 10 मिनट तक बनाए रखें. इससे उपयोगकर्ता, इस टाइम आउट के अंदर वीडियो चलाना फिर से शुरू कर सकते हैं. साथ ही, उन्हें अलग-अलग डिवाइसों पर फ़ोरग्राउंड सर्विस से जुड़ी पाबंदियों का जोखिम नहीं उठाना पड़ता. ध्यान दें कि
- यूज़र इंटरफ़ेस (यूआई):
PlayerSurface,PresentationState,PlayPauseButtonState,NextButtonState,PreviousButtonState,RepeatButtonState,ShuffleButtonState, औरPlaybackSpeedStateके लिए,media3-ui-composeमॉड्यूल में स्टेट होल्डर और कंपोज़ेबल जोड़ें.
- डाउनलोड:
CacheWriterमें मौजूद गड़बड़ी को ठीक किया गया. इसकी वजह से, डेटा सोर्स खुले रह जाते थे और कैश मेमोरी वाले हिस्से लॉक हो जाते थे. ऐसा तब होता था, जब डेटा सोर्सIOExceptionके अलावा कोई औरExceptionदिखाता था (#9760).
- एचएलएस एक्सटेंशन:
HlsInterstitialsAdsLoaderका पहला वर्शन जोड़ें. विज्ञापन लोडर, एचएलएस मीडिया प्लेलिस्ट के एचएलएस इंटरस्टीशियल को पढ़ता है और उन्हेंAdPlaybackStateपर मैप करता है. इसके बाद, उन्हेंAdsMediaSourceको पास किया जाता है. यह शुरुआती वर्शन, सिर्फ़X-ASSET-URIएट्रिब्यूट वाली एचएलएस वीओडी स्ट्रीम के साथ काम करता है.HlsInterstitialsAdsLoader.AdsMediaSourceFactoryजोड़ें. ऐप्लिकेशन इसका इस्तेमाल करके,AdsMediaSourceके ऐसे इंस्टेंस बना सकते हैं जोHlsInterstitialsAdsLoaderका इस्तेमाल आसान और सुरक्षित तरीके से करते हैं.- डॉल्बी विज़न फ़ॉर्मैट (#1785) का पता लगाने के लिए, एचएलएस प्लेलिस्ट से
SUPPLEMENTAL-CODECSटैग को पार्स करें. - एचएलएस स्ट्रीम में पोज़िशन सिंक करने के लिए, सीक करने की शर्त को आसान बनाया गया (#2209).
- DASH एक्सटेंशन:
- DASH के लिए AC-4 लेवल-4 फ़ॉर्मैट की सुविधा जोड़ी गई (#1898).
- मल्टी-पीरियड लाइव स्ट्रीम में विज्ञापन डालने के लिए, अपडेट इंटरवल का हिसाब लगाने से जुड़ी समस्या को ठीक किया गया (#1698).
- Dolby Vision फ़ॉर्मैट का पता लगाने के लिए, DASH मेनिफ़ेस्ट से
scte214:supplementalCodecsएट्रिब्यूट को पार्स करें (#1785). - लाइव स्ट्रीम में पीरियड ट्रांज़िशन को मैनेज करने की सुविधा को बेहतर बनाया गया है. ऐसा तब होता है, जब पीरियड में तय की गई अवधि से ज़्यादा के मीडिया सैंपल शामिल हों (#1698).
- उस समस्या को ठीक किया गया है जिसमें
adaptation-set-switchingके तौर पर मार्क किए गए अडैप्टेशन सेट, अलग-अलग भाषाओं या रोल फ़्लैग के साथ मर्ज हो जाते थे (#2222).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- MPEG-H ऑडियो को डिकोड करने के लिए, MPEG-H डिकोडर मॉड्यूल जोड़ा गया है. यह पहले से मौजूद MPEG-H डिकोडर का इस्तेमाल करता है (#1826).
- एमआईडीआई एक्सटेंशन:
MidiRendererमें कस्टमAudioSinkऔरAudioRendererEventListenerइंस्टेंस जोड़ें.
- Cast एक्सटेंशन:
play-services-cast-frameworkडिपेंडेंसी को 21.5.0 पर बंप करें, ताकि एपीआई 34 और इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन मेंFLAG_MUTABLEक्रैश की समस्या को ठीक किया जा सके. यह समस्या उन डिवाइसों पर आती है जिनमें Google Play services इंस्टॉल है, लेकिन बंद है (#2178).
- डेमो ऐप्लिकेशन:
- अतिरिक्त बटन जोड़कर
demo-composeको बेहतर बनाएं. साथ ही, स्केलिंग और शटर की सुविधा के साथPlayerSurfaceइंटिग्रेशन को बेहतर बनाएं.
- अतिरिक्त बटन जोड़कर
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
- बंद किए गए
AudioMixer.create()तरीके को हटाएं. इसके बजाय,DefaultAudioMixer.Factory().create()का इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
Transformer.Builderके इन तरीकों को हटाएं:setTransformationRequest(), इसके बजायsetAudioMimeType(),setVideoMimeType(), औरsetHdrMode()का इस्तेमाल करें.setAudioProcessors(), ऑडियो प्रोसेसर कोEditedMediaItem.Builder.setEffects()में सेट करें और इसेTransformer.start()में पास करें.setVideoEffects(), वीडियो इफ़ेक्ट कोEditedMediaItem.Builder.setEffects()में सेट करें और इसके बजाय, इसेTransformer.start()को पास करें.setRemoveAudio(),EditedMediaItemसे ऑडियो हटाने के लिए,EditedMediaItem.Builder.setRemoveAudio()का इस्तेमाल करें. इसके बाद, इसेTransformer.start()को पास करें.setRemoveVideo(),EditedMediaItem.Builder.setRemoveVideo()का इस्तेमाल करके,EditedMediaItemसे वीडियो हटाएं. इसके बाद, इसेTransformer.start()में पास करें.setFlattenForSlowMotion(),Transformer.start()को पास किए गएEditedMediaItemको फ़्लैट करने के लिए,EditedMediaItem.Builder.setFlattenForSlowMotion()का इस्तेमाल करें.setListener(), इसके बजायaddListener(),removeListener()याremoveAllListeners()का इस्तेमाल करें.
- इस्तेमाल से बाहर हो चुके
Transformer.Listenerके इन तरीकों को हटाएं:onTransformationCompleted(MediaItem), इसके बजायonCompleted(Composition, ExportResult)का इस्तेमाल करें.onTransformationCompleted(MediaItem, TransformationResult), इसके बजायonCompleted(Composition, ExportResult)का इस्तेमाल करें.onTransformationError(MediaItem, Exception), इसके बजायonError(Composition, ExportResult, ExportException)का इस्तेमाल करें.onTransformationError(MediaItem, TransformationException), इसके बजायonError(Composition, ExportResult, ExportException)का इस्तेमाल करें.onTransformationError(MediaItem, TransformationResult, TransformationException), इसके बजायonError(Composition, ExportResult, ExportException)का इस्तेमाल करें.onFallbackApplied(MediaItem, TransformationRequest, TransformationRequest), इसके बजायonFallbackApplied(Composition, TransformationRequest, TransformationRequest)का इस्तेमाल करें.
- इस्तेमाल से बाहर हो चुकी
TransformationResultक्लास को हटाएं. इसके बजाय,ExportResultका इस्तेमाल करें. - इस्तेमाल से बाहर हो चुकी
TransformationExceptionक्लास को हटाएं. इसके बजाय,ExportExceptionका इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
Transformer.PROGRESS_STATE_NO_TRANSFORMATIONको हटाएं. इसके बजाय,Transformer.PROGRESS_STATE_NOT_STARTEDका इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
Transformer.setListener()को हटाएं. इसके बजाय,Transformer.addListener(),Transformer.removeListener()याTransformer.removeAllListeners()का इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
Transformer.startTransformation()को हटाएं. इसके बजाय,Transformer.start(MediaItem, String)का इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
SingleFrameGlShaderProgramको हटाएं. इसके बजाय,BaseGlShaderProgramका इस्तेमाल करें. Transformer.flattenForSlowMotionहटाएं. इसके बजाय,EditedMediaItem.flattenForSlowMotionका इस्तेमाल करें.ExoPlayer.VideoComponent,ExoPlayer.AudioComponent,ExoPlayer.TextComponent, औरExoPlayer.DeviceComponentको हटाया गया.androidx.media3.exoplayer.audio.SonicAudioProcessorको हटाया गया.- इस्तेमाल से बाहर किए गए
DownloadHelperके इन तरीकों को हटाया गया:- कंस्ट्रक्टर
DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilities[]), इसके बजायDownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilitiesList)का इस्तेमाल करें. getRendererCapabilities(RenderersFactory),RenderersFactoryके साथDefaultRendererCapabilitiesListबनाकर औरDefaultRendererCapabilitiesList.getRendererCapabilities()को कॉल करके, इसके जैसी ही फ़ंक्शनैलिटी हासिल की जा सकती है.PlayerNotificationManager.setMediaSessionToken(MediaSessionCompat)तरीका हटाया गया. इसके बजाय,PlayerNotificationManager.setMediaSessionToken(MediaSession.Token)का इस्तेमाल करें और(MediaSession.Token) compatToken.getToken()पास करें.
- कंस्ट्रक्टर
- बंद किए गए
1.6.0-rc02
19 मार्च, 2025
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
1.6.0-rc01
12 मार्च, 2025
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
1.6.0-beta01
26 फ़रवरी, 2025
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.6.0-alpha03
6 फ़रवरी, 2025
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.6.0-alpha02
30 जनवरी, 2025
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.6.0-alpha01
20 दिसंबर, 2024
1.6.0 स्टेबल वर्शन का इस्तेमाल करें.
संस्करण 1.5
संस्करण 1.5.1
19 दिसंबर, 2024
androidx.media3:media3-*:1.5.1 रिलीज़ हो गया है. वर्शन 1.5.1 में ये बदलाव शामिल हैं.
- ExoPlayer:
- MediaCodec में एसिंक्रोनस डिक्रिप्शन की सुविधा बंद करें, ताकि इस प्लैटफ़ॉर्म एपीआई के साथ कोडेक टाइम आउट की समस्याओं से बचा जा सके (#1641).
- एक्सट्रैक्टर:
- MP3: जब किसी
VBRIफ़्रेम की विषय सूची में, किसी फ़ाइल का पूरा MP3 डेटा शामिल न हो, तो वीडियो को जल्दी चलाना बंद न करें (#1904).
- MP3: जब किसी
- वीडियो:
onOutputFormatChangedको प्रोसेस करते समय,MediaCodecAdapterके लिए दी गई पिक्सल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की वैल्यू का इस्तेमाल करने की सुविधा को वापस लाया गया (#1371).
- टेक्स्ट:
ReplacingCuesResolver.discardCuesBeforeTimeUsमें मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह सेtimeUsपर चालू क्यू (पहले शुरू हुआ, लेकिन अब तक खत्म नहीं हुआ) को गलत तरीके से खारिज कर दिया गया था (#1939).
- मेटाडेटा:
- Vorbis टिप्पणियों से डिस्क/ट्रैक नंबर और शैली को
MediaMetadataमें एक्सट्रैक्ट करें (#1958).
- Vorbis टिप्पणियों से डिस्क/ट्रैक नंबर और शैली को
वर्शन 1.5.0
27 नवंबर, 2024
androidx.media3:media3-*:1.5.0 रिलीज़ हो गया है. वर्शन 1.5.0 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
ForwardingSimpleBasePlayerको जोड़ें, जो छोटे-मोटे बदलावों के साथ दूसरे प्लेयर को फ़ॉरवर्ड करने की अनुमति देता है. साथ ही, यह पक्का करता है कि पूरी तरह से एक जैसा अनुभव मिले और सुनने वाले को हैंडल किया जा सके (#1183).SimpleBasePlayer.State.playlistकोgetPlaylist()तरीके से बदलें.- प्लेलिस्ट का स्ट्रक्चर बनाने के बजाय, सीधे तौर पर
Timelineऔर मौजूदाTracksऔरMetadataकी जानकारी देने के लिए,SimpleBasePlayer.State.Builder.setPlaylist()के लिए ओवरराइड जोड़ें. minSdkको बढ़ाकर 21 (Android Lollipop) करें. यह अन्य सभी AndroidX लाइब्रेरी के साथ अलाइन है.androidx.media3:media3-common-ktxआर्टफ़ैक्ट जोड़ें. यह आर्टफ़ैक्ट, Kotlin के लिए खास तौर पर बनाई गई ऐसी सुविधाएं उपलब्ध कराता है जो कॉमन लाइब्रेरी के ऊपर बनाई गई हैंmedia3-common-ktxलाइब्रेरी मेंPlayer.Eventsको सुनने के लिए, कोरूटीन को स्पिन करने के लिएPlayer.listenसस्पेंडिंग एक्सटेंशन फ़ंक्शन जोड़ें.- मैन्युअल तरीके से आउट-ऑफ़-लाइन की गई इनर क्लास से
@DoNotInlineएनोटेशन हटाएं. इन क्लास को इस तरह डिज़ाइन किया गया है कि रनटाइम क्लास की पुष्टि न हो पाने की समस्या से बचा जा सके. R8 के नए वर्शन, अब इस तरह के कॉल को अपने-आप आउट-ऑफ़-लाइन कर देते हैं, ताकि रनटाइम के दौरान गड़बड़ियां न हों. इसलिए, अब मैन्युअल तरीके से आउट-ऑफ़-लाइन करने की ज़रूरत नहीं है. लाइब्रेरी के सभी Gradle उपयोगकर्ताओं को पहले से ही Android Gradle प्लगिन के ऐसे वर्शन का इस्तेमाल करना चाहिए जो R8 के ऐसे वर्शन का इस्तेमाल करता हो जो ऐसा करता हो. ऐसाcompileSdk = 35की वजह से होता है. नॉन-ग्रैडल बिल्ड सिस्टम वाली लाइब्रेरी के उपयोगकर्ताओं को यह पक्का करना होगा कि R8 के बराबर, कोड को छोटा करने/छिपाने का चरण, अपने-आप आउट-ऑफ़-लाइनिंग की प्रोसेस को पूरा करता हो. इससे रनटाइम क्लास की पुष्टि न होने की समस्या से बचा जा सकता है. यह बदलाव अन्य AndroidX लाइब्रेरी में पहले ही किया जा चुका है.
- ExoPlayer:
MediaCodecRenderer.onProcessedStreamChange()को अब हर मीडिया आइटम के लिए कॉल किया जा सकता है. पहले, पहले वाले के लिए इसे नहीं कहा जाता था. इसे चालू करने के लिए,MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart()का इस्तेमाल करें.PreloadMediaSource.PreloadControl.onPreloadErrorजोड़ें, ताकि गड़बड़ी होने परPreloadMediaSource.PreloadControlलागू करने की प्रोसेस कार्रवाई कर सके.- ऐप्लिकेशन में प्रीलोड इवेंट को लागू करने के लिए,
BasePreloadManager.Listenerजोड़ें. - एसएनटीपी क्लाइंट के टाइम आउट में बदलाव करने और टाइम आउट होने पर अन्य पतों को फिर से आज़माने की अनुमति दें (#1540).
MediaCodecAdapter.Configuration.flagsको हटा दिया गया है, क्योंकि इस फ़ील्ड की वैल्यू हमेशा शून्य थी.- उपयोगकर्ता को Wear OS API 35 और इसके बाद के वर्शन पर, ऑडियो चलाने के लिए पहले से मौजूद स्पीकर चुनने की अनुमति दें. हालांकि, इसके लिए ज़रूरी है कि डिवाइस में यह सुविधा उपलब्ध हो.
- ऑडियो फ़ोकस हैंडलिंग की सुविधा चालू होने तक,
Context.getSystemService(Context.AUDIO_SERVICE)को ब्लॉक करने वाले कॉल को रोकें. इससे यह पक्का होता है कि अगर ऑडियो फ़ोकस हैंडलिंग की सुविधा चालू नहीं है, तो ब्लॉकिंग कॉल नहीं किया जाएगा (#1616). - लोड न होने पर, बफ़र की अवधि के बावजूद वीडियो चलाने की अनुमति दें (#1571).
AnalyticsListener.onRendererReadyChanged()को जोड़ें, ताकि यह सिग्नल मिल सके कि अलग-अलग रेंडरर, वीडियो चलाने के लिए कब तैयार हैं.MediaCodec.CryptoExceptionको कभी-कभी "रनटाइम से जुड़ी गड़बड़ी" के तौर पर रिपोर्ट किए जाने की समस्या को ठीक किया गया. ऐसा तब होता है, जबMediaCodecको एसिंक्रोनस मोड में इस्तेमाल किया जाता है. एपीआई 31 और इसके बाद के वर्शन पर, यह डिफ़ॉल्ट तौर पर सेट होता है.PreloadMediaSource.PreloadControl.onContinueLoadingRequested()के साथ,bufferedPositionUsके बजायbufferedDurationUsपास करें. साथ ही,DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MSकोDefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MSमें बदलता है. इसके बाद, ऐप्लिकेशन को डिफ़ॉल्ट शुरुआती पोज़िशन से किसी खास अवधि को दिखाने वाली वैल्यू पास करनी होगी. इसके लिए, मीडिया सोर्स को पोज़िशन के बजाय, इस IntDef के साथ पहले से लोड करना होगा.ForwardingRendererको लागू करने का तरीका जोड़ें, जो सभी मेथड कॉल को दूसरे रेंडरर पर फ़ॉरवर्ड करता है (1703).- प्लेलिस्ट में मौजूद अगले आइटम के लिए, प्लेलिस्ट प्रीलोडिंग की सुविधा जोड़ें. ऐप्लिकेशन,
ExoPlayer.setPreloadConfiguration(PreloadConfiguration)को कॉल करके, पहले से लोड करने की सुविधा चालू कर सकते हैं. डिफ़ॉल्ट रूप से, पहले से लोड करने की सुविधा बंद होती है. ऑप्ट-इन करने पर,DefaultLoadControlवीडियो चलाने में रुकावट न डालने के लिए, प्रीलोडिंग को सिर्फ़ तब शुरू और जारी रखता है, जब प्लेयर वीडियो चलाने के लिए लोड न हो रहा हो. ऐप्लिकेशन,LoadControl.shouldContinuePreloading()को लागू करके इस व्यवहार को बदल सकते हैं. जैसे,DefaultLoadControlमें इस तरीके को ओवरराइड करते समय. अगर कोई ऐप्लिकेशनLoadControlके कस्टम तरीके का इस्तेमाल कर रहा है, तोLoadControlका डिफ़ॉल्ट तरीका, प्रीलोडिंग को बंद कर देता है. - सबक्लास लिसनर के इवेंट को शुरू करने की अनुमति देने के लिए,
MediaSourceEventListener.EventDispatcher.dispatchEvent()तरीका जोड़ें (1736). DefaultPreloadManager.Builderजोड़ें, जो एक जैसी शेयर की गई कॉन्फ़िगरेशन के साथDefaultPreloadManagerऔरExoPlayerइंस्टेंस बनाता है.LoadControl.onTracksSelected()सेRenderer[]पैरामीटर हटाएं, क्योंकिDefaultLoadControlको लागू करने पर,ExoTrackSelection[]से स्ट्रीम टाइप वापस पाए जा सकते हैं.DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[])को बंद कर दिया गया है और ओवरराइड को रोकने के लिए, मेथड को फ़ाइनल के तौर पर मार्क किया गया है. इसके बजाय, नएDefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[])का इस्तेमाल किया जाना चाहिए.MergingMediaSourceमें, दूसरे सोर्स से मिलेMediaSourceEventListenerइवेंट की शिकायत करें. इसकी वजह से, साइडलोड किए गए सबटाइटल (MediaItem.LocalConfiguration.subtitleConfigurationsकी मदद से जोड़े गए सबटाइटल) के लिए, लोड शुरू होने/गड़बड़ी होने/रद्द होने/पूरा होने के इवेंट की जानकारी दी जाएगी. ये इवेंट,AnalyticsListenerसे भेजे गए डुप्लीकेट लोड इवेंट के तौर पर दिख सकते हैं.- सबटाइटल और मेटाडेटा से जुड़ी गड़बड़ियों की वजह से, वीडियो को पूरी तरह से रुकने से रोकना.
इसके बजाय, समस्या वाले ट्रैक को बंद कर दिया जाता है और बाकी ट्रैक चलते रहते हैं (#1722).
- सबटाइटल को हैंडल करने के नए तरीके (एक्सट्रैक्शन के दौरान) में, पार्स करने से जुड़ी गड़बड़ियां (जैसे, सबटाइटल का अमान्य डेटा) और लोड करने से जुड़ी गड़बड़ियां (जैसे, एचटीटीपी 404)
onLoadErrorकॉलबैक के ज़रिए भेजी जाती हैं. - सबटाइटल हैंडल करने के लेगसी तरीके (रेंडरिंग के दौरान) में, सिर्फ़ लोड होने से जुड़ी गड़बड़ियां
onLoadErrorकॉलबैक के ज़रिए भेजी जाती हैं. वहीं, पार्स करने से जुड़ी गड़बड़ियों को अनदेखा कर दिया जाता है. यह पहले से मौजूद व्यवहार है.
- सबटाइटल को हैंडल करने के नए तरीके (एक्सट्रैक्शन के दौरान) में, पार्स करने से जुड़ी गड़बड़ियां (जैसे, सबटाइटल का अमान्य डेटा) और लोड करने से जुड़ी गड़बड़ियां (जैसे, एचटीटीपी 404)
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मल्टी-पीरियड DASH स्ट्रीम में प्लेलिस्ट के आइटम या पीरियड की अवधि, असल कॉन्टेंट से मैच नहीं होने पर, आइटम के आखिर में फ़्रेम फ़्रीज़ हो जाते थे (#1698).
SntpClientमें एक सेटर जोड़ा गया, ताकि आखिरी अपडेट के बाद बीतने वाले ज़्यादा से ज़्यादा समय को सेट किया जा सके. इसके बाद, क्लाइंट को फिर से शुरू किया जाता है (#1794).
- ट्रांसफ़ॉर्मर:
SurfaceAssetLoaderजोड़ें. यहSurfaceकी मदद से, ट्रांसफ़ॉर्मर में वीडियो डेटा को सूची में जोड़ने की सुविधा देता है.ImageAssetLoader,IllegalStateExceptionको थ्रो करने के बजाय,AssetLoader.onErrorके ज़रिए ऐसे इनपुट की रिपोर्ट करता है जो काम नहीं करता.- इमेज एक्सपोर्ट करने के लिए,
MediaItem.Builder.setImageDurationMsका इस्तेमाल करके इमेज की अवधि सेट करना ज़रूरी है. - ऑडियो EditedMediaItems के क्रम में मौजूद गैप को एक्सपोर्ट करने की सुविधा जोड़ी गई.
- ट्रैक चुनना:
DefaultTrackSelector: अगर अन्य फ़ैक्टर एक जैसे हैं, तो चैनल-आधारित ऑडियो के बजाय ऑब्जेक्ट-आधारित ऑडियो को प्राथमिकता दें.
- एक्सट्रैक्टर:
Mp4ExtractorऔरFragmentedMp4Extractorको H264 सैंपल की पहचान करने की अनुमति दें. ये ऐसे सैंपल होते हैं जिनका इस्तेमाल, बाद के सैंपल के लिए रेफ़रंस के तौर पर नहीं किया जाता.AmrExtractorमें, इंडेक्स के आधार पर खोजने की सुविधा चालू करने का विकल्प जोड़ें.- मान्य फ़्रेम के बीच 128 केबी से ज़्यादा साइज़ वाली MP3 फ़ाइलों को अमान्य के बजाय, अधूरी फ़ाइलें माना जाता है. इसका मतलब है कि जिन फ़ाइलों के आखिर में MP3 के अलावा कोई और डेटा मौजूद होता है और MP3 बाइट की लंबाई बताने वाला कोई अन्य मेटाडेटा नहीं होता है, वे अब MP3 डेटा के आखिर में वीडियो चलाना बंद कर देती हैं. ऐसा होने पर,
ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1}(#1563) गड़बड़ी नहीं दिखती. - MP4 फ़ाइलों में बदलाव की सूचियों को प्रोसेस करते समय, नॉन-कीफ़्रेम मीडिया की शुरुआती पोज़िशन के लिए, प्रीरोल सैंपल को मैनेज करने से जुड़ी समस्या को ठीक किया गया (#1659).
Mp4ExtractorऔरFragmentedMp4Extractorमेंmdhdबॉक्स से मीडिया की अवधि का इस्तेमाल करके, फ़्रेम रेट का बेहतर कैलकुलेशन (#1531).- MP4 एडिट लिस्ट में
media_timeकी गलत स्केलिंग को ठीक किया गया. मूवी टाइमस्केल का इस्तेमाल करके,segment_durationको पहले ही सही तरीके से स्केल किया जा चुका था. अब ट्रैक टाइमस्केल का इस्तेमाल करके,media_timeको सही तरीके से स्केल किया गया है. ऐसा MP4 फ़ॉर्मैट स्टैंडर्ड (#1792) के मुताबिक किया गया है. - एडिट लिस्ट (#1797) वाले MP4 के लिए,
endIndicesकैलकुलेशन में आउट-ऑफ़-ऑर्डर फ़्रेम को हैंडल करें. -1वैल्यू को हैंडल करने के लिए, MP4 फ़ाइलों केmdhdबॉक्स में मीडिया की अवधि को पार्स करने की समस्या को ठीक किया गया (#1819).- H.263 वीडियो के लिए, MP4 फ़ाइलों में
h263बॉक्स की पहचान करने की सुविधा जोड़ी गई है (#1821). - AC-4 लेवल-4 आईएसओ बेस मीडिया फ़ाइल फ़ॉर्मैट के लिए सहायता जोड़ी गई (#1265).
- डेटा सोर्स:
HttpEngineDataSourceको अपडेट करें, ताकि एपीआई लेवल 34 के बजाय, S एक्सटेंशन 7 या इसके बाद के वर्शन से इसका इस्तेमाल किया जा सके (#1262).DataSourceContractTest: पक्का करें किDataSource.getUri(), रिज़ॉल्व किया गया यूआरआई दिखाता हो (जैसा कि दस्तावेज़ में बताया गया है). अगर यह अनुरोध किए गए यूआरआई से अलग है, तो टेस्ट में नएDataSourceContractTest.TestResource.Builder.setResolvedUri()तरीके का इस्तेमाल करके यह जानकारी दी जा सकती है.DataSourceContractTest: यह पक्का करें किDataSource.getUri()औरgetResponseHeaders(),open()को कॉल करने में मिली गड़बड़ी ('नहीं मिला' रिसॉर्स की वजह से) के बाद औरclose()को कॉल करने से पहले, अपनी 'open' वैल्यू दिखाएं.DataSourceContractTest.getNotFoundResources()को बदलने से, टेस्ट सब-क्लास को 'नहीं मिला' वाले कई संसाधन उपलब्ध कराने की अनुमति मिलती है. साथ ही, इससे उम्मीद के मुताबिक कोई भी हेडर उपलब्ध कराने की अनुमति मिलती है. इससे एचटीटीपी 404 (हेडर के साथ) और "सर्वर नहीं मिला" (बिना हेडर के) के बीच अंतर करने में मदद मिलती है.
- ऑडियो:
- अगर मीडिया में CTA-2075 लाउडनेस मेटाडेटा मौजूद है, तो कोडेक पर इसे अपने-आप कॉन्फ़िगर होने की सुविधा.
- सीक करने पर, आवाज़ को धीरे-धीरे कम करें.
- वीडियो को आगे-पीछे करने पर सुनाई देने वाली पॉप साउंड की समस्या को ठीक किया गया.
- सोनिक के टाइम-स्ट्रेचिंग/पिच-शिफ़्टिंग एल्गोरिदम के लिए, ट्रंकेशन की गड़बड़ी को ठीक करना.
SpeedChangingAudioProcessorमें मौजूद उस गड़बड़ी को ठीक करना जिसकी वजह से आउटपुट फ़्रेम ड्रॉप हो जाते हैं.
- वीडियो:
MediaCodecVideoRenderer, ऐसे सैंपल को डिकोड नहीं करता जो न तो रेंडर किए गए हैं और न ही अन्य सैंपल के रेफ़रंस के तौर पर इस्तेमाल किए गए हैं.- एपीआई 35 और इसके बाद के वर्शन पर,
MediaCodecAdapterको अबconfigureमेंnullSurfaceमिल सकता है. साथ ही, पहले से सेट किए गएSurfaceको हटाने के लिए, नए तरीकेdetachOutputSurfaceको कॉल किया जा सकता है. हालांकि, ऐसा तब ही किया जा सकता है, जब कोडेक इसका (MediaCodecInfo.detachedSurfaceSupported) इस्तेमाल करने की अनुमति देता हो. onOutputFormatChangedको प्रोसेस करते समय, अगरMediaCodecAdapterपिक्सल के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की वैल्यू दी गई हैं, तो उनका इस्तेमाल करें (#1371).- Galaxy Tab S7 FE पर डिवाइस से जुड़ी समस्या को हल करने के लिए, कोई दूसरा तरीका जोड़ें. इस समस्या की वजह से, 60 एफ़पीएस (फ़्रेम प्रति सेकंड) वाली सुरक्षित H264 स्ट्रीम को 'काम नहीं करती' के तौर पर मार्क किया जाता है (#1619).
- उन कोडेक के लिए समस्या हल करने का तरीका जोड़ें जो आखिरी सैंपल के बाद अटक जाते हैं और एंड-ऑफ़-स्ट्रीम सिग्नल नहीं दिखाते.
- टेक्स्ट:
- कस्टम
VoiceSpanजोड़ें और उसे WebVTT वॉइस स्पैन के लिए पॉप्युलेट करें (#1632). - यह पक्का करें कि एचएलएस में WebVTT, सबटाइटल के बहुत बड़े टाइमस्टैंप के साथ दिखे. ये टाइमस्टैंप, माइक्रोसेकंड के तौर पर दिखाए जाने और
90,000MPEG टाइमबेस से गुणा करने पर, 64-बिटlongसे ज़्यादा हो जाते हैं (#1763). - Dolby Vision कॉन्टेंट में CEA-608 सबटाइटल के साथ काम करता है (#1820).
- सीईए-608 सबटाइटल चालू होने पर, DASH मल्टी-पीरियड स्ट्रीम में वीडियो चलाने के दौरान हैंग होने की समस्या को ठीक किया गया (#1863).
- कस्टम
- मेटाडेटा:
C.TRACK_TYPE_METADATAटाइप को ऐसे ट्रैक असाइन करें जिनमें icy या vnd.dvb.ait कॉन्टेंट शामिल हो.
- इमेज:
- Glide या Coil जैसी बाहरी इमेज लोड करने वाली लाइब्रेरी के साथ इंटिग्रेशन को आसान बनाने के लिए,
ExternallyLoadedImageDecoderजोड़ें.
- Glide या Coil जैसी बाहरी इमेज लोड करने वाली लाइब्रेरी के साथ इंटिग्रेशन को आसान बनाने के लिए,
- डेटा सोर्स:
FileDescriptorDataSourceको जोड़ें. यह एक नयाDataSourceहै, जिसका इस्तेमालFileDescriptorसे पढ़ने के लिए किया जा सकता है (#3757).
- असर:
DefaultVideoFrameProcessorको स्केल करने से जुड़ी छोटी-मोटी समस्या को ठीक करने के लिए,SurfaceTextureको जोड़ा गया.SurfaceTextureमें छोटा स्केलिंग शामिल हो सकता है, जो क्रॉप किए गए बफ़र के किनारे के आस-पास 1-टेक्सल बॉर्डर को काटता है. अब इसे इस तरह से हैंडल किया जाता है कि आउटपुट, उम्मीद के मुताबिक हो.DefaultVideoFrameProcessor.queueInputBitmap()की स्पीड बढ़ाएं. इस वजह से,Transformerकी मदद से इमेज को वीडियो में एक्सपोर्ट करने की प्रोसेस तेज़ हो जाती है.
- आईएमए एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से प्लेलिस्ट को मिटाने पर,
ImaServerSideAdInsertionMediaSourceमेंArrayIndexOutOfBoundsExceptionहो सकता है. - उस गड़बड़ी को ठीक किया गया है जिसमें सर्वर-साइड पर इंसर्ट की गई डीएआई स्ट्रीम में प्रीरोल न होने पर, आखिरी मिडरोल के बाद वीडियो चलाने पर
ArrayIndexOutOfBoundsExceptionदिख सकता है (#1741).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से प्लेलिस्ट को मिटाने पर,
- सेशन:
MediaButtonReceiver.shouldStartForegroundService(Intent)को जोड़ें, ताकि ऐप्लिकेशन, जहां छोड़ा था वहीं से प्लेबैक की सुविधा के लिए आने वाले प्ले कमांड को दबा सकें. इसके लिए, इस तरीके को बदलें. डिफ़ॉल्ट रूप से, सेवा हमेशा चालू रहती है. साथ ही, सिस्टम केForegroundServiceDidNotStartInTimeException(#1528) के साथ सेवा को क्रैश किए बिना, वीडियो चलाने की सुविधा को बंद नहीं किया जा सकता.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, लेगसी सेवा से कनेक्ट होने पर,
MediaBrowserसे भेजे गए कस्टम निर्देश, तरीके केMediaBrowserServiceCompatवैरिएंट के बजायMediaSessionCompat.Callbackपर भेजे जाते थे. इस वजह से,MediaBrowserको लेगसी सेवा से भेजी गई असल रिटर्न वैल्यू नहीं मिल पाई (#1474). - मीडिया बटन इंटेंट (#1730) के लिए ब्रॉडकास्ट रिसीवर सेट करते समय, कुछ मैन्युफ़ैक्चरर के डिवाइसों से मिलने वाले
IllegalArgumentExceptionको मैनेज करें. - मीडिया आइटम के लिए कमांड बटन जोड़ें. इससे Media3 API जुड़ जाता है. इसे लेगसी लाइब्रेरी में
Custom browse actionsके तौर पर जाना जाता था. साथ ही, इसमेंMediaBrowserCompatभी शामिल है. ध्यान दें कि Media3 के साथ, मीडिया आइटम के लिए कमांड बटन,MediaBrowserऔरMediaController, दोनों के लिए उपलब्ध हैं. ब्राउज़ करने के लिए कस्टम कार्रवाइयां लागू करना लेख पढ़ें. * उस गड़बड़ी को ठीक किया गया है जिसकी वजह से Media3 कंट्रोलर,play()का अनुरोध करने के बाद, कभी-कभी सेशन ऐप्लिकेशन को फ़ोरग्राउंड सेवा शुरू करने की अनुमति नहीं दे पाता था. CommandButton.Builder.setIconUriको सिर्फ़ कॉन्टेंट यूआरआई स्वीकार करने के लिए सीमित करें.- किसी लेगसी
MediaBrowserCompatसे कनेक्ट करते समय, Media3 ब्राउज़र के कनेक्शन हिंट को शुरुआतीMediaBrowserCompatको पास करें. सेवा को कनेक्शन के संकेत मिल सकते हैं. ये संकेत,onGetRoot()को किए गए पहले कॉल के साथ रूट हिंट के तौर पर पास किए जाते हैं. - उस गड़बड़ी को ठीक किया गया है जिसमें लेगसी ब्राउज़र सेवा से कनेक्ट किए गए
MediaBrowserको, ब्राउज़र केparentidकी सदस्यता लेने के बाद, सेवा से भेजी गई गड़बड़ी की जानकारी नहीं मिली. - इंटरऑपरेबिलिटी के व्यवहार को बेहतर बनाएं, ताकि लेगसी
MediaBrowserServiceसे कनेक्ट किया गया Media3 ब्राउज़र, पैरंट की सदस्यता लेते समयparentIdके चाइल्ड के लिए दो बार अनुरोध न करे.
- यूज़र इंटरफ़ेस (यूआई):
- एक्सएमएल पर आधारित शेयर किए गए ट्रांज़िशन से जुड़ी समस्याओं की वजह से,
PlayerView-in-Compose-AndroidViewमें स्ट्रेच/क्रॉप किए गए वीडियो को ऑप्ट-इन करें.PlayerViewका इस्तेमाल करने वाले ऐप्लिकेशन कोAndroidViewमें शामिल होने के लिए,PlayerView.setEnableComposeSurfaceSyncWorkaroundको कॉल करना होगा (#1237, #1594). PlayerViewमेंsetFullscreenButtonStateजोड़ें, ताकि ज़रूरत के हिसाब से फ़ुलस्क्रीन बटन के आइकॉन के अपडेट की अनुमति दी जा सके. इसका मतलब है कि आउट-ऑफ़-बैंड और क्लिक इंटरैक्शन पर प्रतिक्रिया न देने वाले अपडेट (#1590, #184).- उस गड़बड़ी को ठीक किया गया है जिसमें टेक्स्ट चुनने के दौरान "कोई नहीं" विकल्प काम नहीं करता है. ऐसा तब होता है, जब ऐप्लिकेशन में टेक्स्ट ट्रैक चुनने की प्राथमिकताएं तय की गई हों.
- एक्सएमएल पर आधारित शेयर किए गए ट्रांज़िशन से जुड़ी समस्याओं की वजह से,
- DASH एक्सटेंशन:
- किसी सेगमेंट के बीच में शुरू होने वाले पीरियड के लिए सहायता जोड़ें (#1440).
- स्मूद स्ट्रीमिंग एक्सटेंशन:
- टेक्स्ट ट्रैक वाली SmoothStreaming स्ट्रीम चलाते समय,
Bad magic number for Bundleगड़बड़ी को ठीक किया गया (#1779).
- टेक्स्ट ट्रैक वाली SmoothStreaming स्ट्रीम चलाते समय,
- आरटीएसपी एक्सटेंशन:
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
- IAMF डिकोडर मॉड्यूल जोड़ें. यह मॉड्यूल, libiamf नेटिव लाइब्रेरी का इस्तेमाल करके, IAMF ट्रैक वाली MP4 फ़ाइलों को चलाने की सुविधा देता है. इससे ऑडियो को सिंथेसाइज़ किया जा सकता है.
- स्टीरियो लेआउट के साथ-साथ, 5.1 ऑडियो और स्पेशल ऑडियो की सुविधा के साथ वीडियो चलाया जा सकता है. साथ ही, हेड ट्रैकिंग की सुविधा को चालू किया जा सकता है. हालांकि, फ़िलहाल बाइनॉरल प्लेबैक की सुविधा उपलब्ध नहीं है.
- Android 15 पर डिकोडर एक्सटेंशन के लिए, 16 केबी वाले पेज के साइज़ के साथ काम करने की सुविधा जोड़ी गई (#1685).
- IAMF डिकोडर मॉड्यूल जोड़ें. यह मॉड्यूल, libiamf नेटिव लाइब्रेरी का इस्तेमाल करके, IAMF ट्रैक वाली MP4 फ़ाइलों को चलाने की सुविधा देता है. इससे ऑडियो को सिंथेसाइज़ किया जा सकता है.
- Cast एक्सटेंशन:
- CastSession के डिसकनेक्ट होने के बाद, टाइमलाइन को साफ़ करना बंद करें. इससे, डिसकनेक्ट होने के बाद, भेजने वाले ऐप्लिकेशन को स्थानीय तौर पर वीडियो चलाना फिर से शुरू करने में मदद मिलती है.
Contextदिए जाने पर, CastPlayer केDeviceInfoको पॉप्युलेट करें. इससेMediaSessionकोRoutingSessionसे लिंक किया जा सकता है. आउटपुट स्विचर (#1056) को इंटिग्रेट करने के लिए, ऐसा करना ज़रूरी है.
- टेस्ट यूटिलिटी:
DataSourceContractTestमें अब इन चीज़ों की पुष्टि करने के लिए टेस्ट शामिल हैं:- इनपुट स्ट्रीम
read positionको अपडेट कर दिया गया है. - आउटपुट बफ़र
offsetको सही तरीके से लागू किया गया है.
- इनपुट स्ट्रीम
- डेमो ऐप्लिकेशन
- डेमो शॉर्ट-फ़ॉर्म ऐप्लिकेशन में मेमोरी लीक की समस्या को ठीक किया गया (#1839).
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
Player.hasPrevious,Player.hasPreviousWindow()को हटाएं, क्योंकि अब इनका इस्तेमाल नहीं किया जाता. इसके बजाय,Player.hasPreviousMediaItem()का इस्तेमाल करें.- बंद किए गए
Player.previous()तरीके को हटाएं. इसके बजाय,Player.seekToPreviousMediaItem()का इस्तेमाल करें. - बंद किए गए
DrmSessionEventListener.onDrmSessionAcquiredतरीके को हटाएं. - इस्तेमाल से बाहर हो चुके
DefaultEncoderFactoryकंस्ट्रक्टर हटाएं. इसके बजाय,DefaultEncoderFactory.Builderका इस्तेमाल करें.
वर्शन 1.5.0-rc02
19 नवंबर, 2024
1.5.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.5.0-rc01
13 नवंबर, 2024
1.5.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.5.0-beta01
30 अक्टूबर, 2024
1.5.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.5.0-alpha01
10 सितंबर, 2024
1.5.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.4.0
वर्शन 1.4.1
27 अगस्त, 2024
androidx.media3:media3-*:1.4.1 रिलीज़ हो गया है. वर्शन 1.4.1 में ये बदलाव शामिल हैं.
- ExoPlayer:
- एक्सट्रैक्टर:
- MP3:
Infoफ़्रेम में लंबाई वाले फ़ील्ड के आधार पर, आखिर में मौजूद नॉन-एमपी3 डेटा को सही तरीके से अनदेखा करके,Searched too many bytesगड़बड़ी को ठीक किया गया (#1480).
- MP3:
- टेक्स्ट:
- टीटीएमएल: प्रतिशत
tts:fontSizeवैल्यू को मैनेज करने की सुविधा को ठीक किया गया, ताकि यह पक्का किया जा सके कि वे प्रतिशतtts:fontSizeवैल्यू वाले पैरंट नोड से सही तरीके से इनहेरिट की गई हों. LegacySubtitleUtilमेंIndexOutOfBoundsExceptionको ठीक किया गया. ऐसा इसलिए किया गया, क्योंकि अनुरोध किए गए आउटपुट के शुरू होने का समय,Subtitleमें आखिरी इवेंट के समय से ज़्यादा या उसके बराबर होने पर, उसे गलत तरीके से हैंडल किया जा रहा था (#1516).
- टीटीएमएल: प्रतिशत
- डीआरएम:
- एपीआई 31 और इसके बाद के वर्शन वाले डिवाइसों पर, L1 Widevine कॉन्टेंट चलाने के दौरान आने वाली
android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLEगड़बड़ी को ठीक किया गया. यह गड़बड़ी, फ़्रेमवर्क केMediaDrm.requiresSecureDecoderतरीके (#1603) को पूरी तरह से लागू न करने की वजह से होती है.
- एपीआई 31 और इसके बाद के वर्शन वाले डिवाइसों पर, L1 Widevine कॉन्टेंट चलाने के दौरान आने वाली
- असर:
GlObjectsProviderमेंrelease()का तरीका जोड़ें.
- सेशन:
KEYCODE_HEADSETHOOKपर दो बार टैप करने की सुविधा को 'अगले पर जाएं' कार्रवाई में बदलें, जैसा कि दस्तावेज़ (#1493) में बताया गया है.MediaButtonReceiverमेंKEYCODE_HEADSETHOOKको 'चलाएं' निर्देश के तौर पर हैंडल करें. ऐसा तब करें, जब यह तय करना हो किForegroundServiceDidNotStartInTimeExceptionसे बचने के लिए इसे अनदेखा करना है या नहीं (#1581).
- आरटीएसपी एक्सटेंशन:
- एसडीपी पार्सिंग में, अमान्य मीडिया ब्यौरों को स्किप करना (#1087).
वर्शन 1.4.0
25 जुलाई, 2024
androidx.media3:media3-*:1.4.0 रिलीज़ हो गया है. वर्शन 1.4.0 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
- सीक कॉल को अनदेखा करने के बजाय, सुरक्षित
BasePlayer.seekTo()औरSimpleBasePlayer.handleSeek()तरीकों पर फ़ॉरवर्ड करें. अगर इन तरीकों को किसी कस्टम प्लेयर में लागू किया जा रहा है, तो आपकोmediaItemIndex == C.INDEX_UNSETकी मदद से इन अतिरिक्त कॉल को मैनेज करना पड़ सकता है. - बेहतर Java 8 डिशुगरिंग पर कंपाइल डिपेंडेंसी हटाएं (#1312).
- पक्का करें कि
MediaItem.Builder.setImageDurationMs()को पास की गई अवधि को, बिना इमेज वालेMediaItemके लिए अनदेखा किया गया हो (जैसा कि दस्तावेज़ में बताया गया है). Formatइंस्टेंस के बारे में, ऐप्लिकेशन से मिली कस्टम जानकारी को स्टोर करने के लिए,Format.customDataजोड़ें.
- सीक कॉल को अनदेखा करने के बजाय, सुरक्षित
- ExoPlayer:
BasePreloadManagerजोड़ें, जोrankingDataकी तय की गई प्राथमिकताओं के आधार पर, कई सोर्स के लिए पहले से लोड करने को कोऑर्डिनेट करता है. इस क्लास को एक्सटेंड करके, इसे पसंद के मुताबिक बनाया जा सकता है.DefaultPreloadManagerजोड़ें, जो सोर्स के मीडिया सैंपल को मेमोरी में पहले से लोड करने के लिए,PreloadMediaSourceका इस्तेमाल करता है. साथ ही, यह एक पूर्णांकrankingDataका इस्तेमाल करता है, जो यूज़र इंटरफ़ेस (यूआई) पर किसी आइटम के इंडेक्स को दिखाता है.LoadControlके ज़्यादातर तरीकों मेंPlayerIdजोड़ें, ताकिLoadControlको लागू करके कई खिलाड़ियों को सपोर्ट किया जा सके.Buffer.isDecodeOnly()औरC.BUFFER_FLAG_DECODE_ONLYको हटाएं. इस फ़्लैग को सेट करने की ज़रूरत नहीं है, क्योंकि रेंडरर और डिकोडर, टाइमस्टैंप के आधार पर बफ़र को स्किप करने का फ़ैसला लेंगे.Rendererको कस्टम तरीके से लागू करने पर, यह जांच की जानी चाहिए कि बफ़र टाइम कम से कमBaseRenderer.getLastResetPositionUs()है या नहीं. इससे यह तय किया जा सकेगा कि सैंपल दिखाया जाना चाहिए या नहीं. कस्टमSimpleDecoderलागू करने की सुविधा, ज़रूरत पड़ने परisAtLeastOutputStartTimeUs()की जांच कर सकती है या अन्य बफ़र कोDecoderOutputBuffer.shouldBeSkippedके साथ मार्क कर सकती है, ताकि उन्हें छोड़ा जा सके.TargetPreloadStatusControl.getTargetPreloadStatus(T)को शून्य वैल्यू दिखाने की अनुमति दें, ताकि यह पता चल सके कि दिए गएrankingDataके साथMediaSourceको पहले से लोड नहीं करना है.BasePreloadManagerमेंremove(MediaSource)जोड़ें.- प्रीलोड मैनेजर इंस्टेंस को बनाए रखते हुए, होल्ड किए गए सभी सोर्स को रिलीज़ करने के लिए,
reset()कोBasePreloadManagerमें जोड़ें. ExoPlayer.setPriority()(औरBuilder.setPriority()) जोड़ें, ताकिPriorityTaskManagerमें इस्तेमाल की गई प्राथमिकता वैल्यू को तय किया जा सके. साथ ही, एपीआई 35 से MediaCodec की अहमियत के लिए भी ऐसा किया जा सके.- रीबफ़र के आखिरी समय को अपडेट करने से जुड़ी समस्या को ठीक किया गया. इसकी वजह से, सीएमसीडी में गलत
bs(बफ़र स्टार्वेशन) कुंजी दिखती थी (#1124). PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource)जोड़ें, ताकि यह पता चल सके कि सोर्स पूरा लोड हो गया है. इससेDefaultPreloadManagerऔर कस्टमPreloadMediaSource.PreloadControlको अगले सोर्स को पहले से लोड करने या अन्य कार्रवाइयां करने की अनुमति मिलती है.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, आइटम के आखिर में साइलेंस स्किप करने पर, वीडियो चलाने में समस्या आ सकती है.
- प्रीलोडिंग की अवधि को खारिज करने के लिए,
PreloadMediaSourceमेंclearजोड़ें. - गड़बड़ी का नया कोड
PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMEDजोड़ें. इसका इस्तेमाल तब किया जाता है, जब ज़्यादा प्राथमिकता वाले टास्क के लिए कोडेक रिसॉर्स को फिर से हासिल किया जाता है. AdsMediaSourceको शुरुआती कॉन्टेंट मीडिया की तैयारी पूरी होने से पहले, प्रीरोल विज्ञापन लोड करने की अनुमति दें (#1358).- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मेनिफ़ेस्ट से ओरिजनल पीरियड को हटाने के बाद, मल्टी-पीरियड DASH लाइव स्ट्रीम को फिर से तैयार करने पर, वीडियो चलाना
STATE_ENDEDपर चला जाता था. PreloadMediaSource.PreloadControlमें,onTimelineRefreshed()का नाम बदलकरonSourcePrepared()औरonPrepared()का नाम बदलकरonTracksSelected()करें. इसके हिसाब से,DefaultPreloadManager.Stageमें IntDefs का नाम भी बदलें.- डाइनैमिक शेड्यूलिंग के लिए, एक्सपेरिमेंट के तौर पर सहायता जोड़ी गई है. इससे, सीपीयू के वेक-साइकल के साथ काम को बेहतर तरीके से अलाइन किया जा सकता है. साथ ही, रेंडरर के आगे बढ़ने तक, वेक अप में देरी की जा सकती है.
ExoPlayer इंस्टेंस को सेट अप करते समय,
experimentalSetDynamicSchedulingEnabled()का इस्तेमाल करके इसे चालू किया जा सकता है. 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). ExoPlayer.setVideoEffect()मेंEffectsको रेंडरर ऑफ़सेट हटाए जाने के साथ टाइमस्टैंप मिलेंगे (#1098).- प्लेलिस्ट के किसी अन्य आइटम को पहले से पढ़ते समय, प्लेयर की गड़बड़ी को मैनेज करते समय होने वाली संभावित
IllegalArgumentExceptionको ठीक किया गया (#1483).
- ट्रांसफ़ॉर्मर:
ExportResultमेंaudioConversionProcessऔरvideoConversionProcessजोड़ें. इससे यह पता चलता है कि आउटपुट फ़ाइल में मौजूद ट्रैक को कैसे बनाया गया.- ट्रिम ऑप्टिमाइज़ेशन के लिए, H.264 लेवल की जांच को आसान बनाएं.
- एक क्रम में एसडीआर और एचडीआर इनपुट मीडिया के बीच स्विच करने की सुविधा जोड़ें.
- कंपोज़िशन-लेवल के ऑडियो इफ़ेक्ट के लिए सहायता जोड़ें.
- अल्ट्रा एचडीआर इमेज को एचडीआर वीडियो में ट्रांसकोड करने की सुविधा जोड़ें.
- उस समस्या को ठीक किया गया है जिसमें
DefaultAudioMixerको रीसेट करने और फिर से इस्तेमाल करने पर, बाइट की सही संख्या आउटपुट नहीं होती थी. - डिकोडर की गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से, पीसीएम इनपुट को हैंडल करते समय ऑडियो चैनल की संख्या स्टीरियो तक सीमित हो जाती थी.
ExoPlayerAssetLoaderमें ट्रैक चुनते समय, ऑडियो चैनल की संख्या से जुड़ी पाबंदियों को अनदेखा करें. ऐसा इसलिए, क्योंकि ये पाबंदियां सिर्फ़ वीडियो चलाने पर लागू होती हैं.androidx.media3.transformer.Muxerइंटरफ़ेस कोandroidx.media3.muxer.Muxerसे बदलें औरandroidx.media3.transformer.Muxerको हटाएं.- कॉन्टेंट यूआरआई स्कीम से HEIC इमेज लोड होने की समस्या को ठीक किया गया. (#1373).
- एवी सिंक को बेहतर बनाने के लिए,
AudioGraphInputमें ऑडियो ट्रैक की अवधि में बदलाव करें. ExportResult.processedInputsफ़ील्ड हटाएं. अगर कोडेक की जानकारी के लिए इस फ़ील्ड का इस्तेमाल किया जाता है, तो इसके बजायDefaultDecoderFactory.listenerका इस्तेमाल करें. कोडेक से जुड़ी गड़बड़ी होने पर, कोडेक की जानकारीExportException.codecInfoमें उपलब्ध होगी.
- एक्सट्रैक्टर:
- MPEG-TS: बदलाव को रोल फ़ॉरवर्ड करें. इससे यह पक्का किया जा सकेगा कि आखिरी फ़्रेम को रेंडर किया गया है. इसके लिए, स्ट्रीम की आखिरी ऐक्सेस यूनिट को सैंपल सूची में पास करें (#7909). सिर्फ़ आई-फ़्रेम वाली एचएलएस स्ट्रीम (#1150) और H.262 एचएलएस स्ट्रीम (#1126) में आने वाली समस्याओं को ठीक किया गया.
- MP3: डेटा साइज़ के लिए, स्ट्रीम से मिले साइज़ (जैसे, फ़ाइल का साइज़ या एचटीटीपी
Content-Lengthहेडर) के बजाय,Infoफ़्रेम से मिले साइज़ को प्राथमिकता दें. इससे, कॉन्स्टेंट बिटरेट सीकिंग कैलकुलेशन से, न चलाए जा सकने वाले ट्रेलर डेटा (जैसे, एल्बम आर्टवर्क) को बाहर रखने में मदद मिलती है. इससे सीक ज़्यादा सटीक हो जाते हैं (#1376). - MP3: कॉन्स्टेंट बिटरेट खोजने के लिए, औसत बिटरेट का हिसाब लगाते समय
Infoफ़्रेम (अगर मौजूद हो) में मौजूद फ़्रेम की संख्या और अन्य डेटा का इस्तेमाल करें. इसके लिए,Infoफ़्रेम के बाद वाले फ़्रेम के बिटरेट से अनुमान न लगाएं. ऐसा इसलिए, क्योंकि यह बिटरेट आर्टिफ़िशियल तौर पर छोटा हो सकता है. उदाहरण के लिए,PCUTफ़्रेम (#1376). - AVI कंटेनर में, पीसीएम ऑडियो फ़ॉर्मैट को एक्सट्रैक्ट करने से जुड़ी समस्या को ठीक किया गया.
- ऑडियो:
- पासथ्रू प्लेबैक के लिए, DTS:X प्रोफ़ाइल 2 के एन्कोडिंग एट्रिब्यूट को ठीक किया गया (#1299).
- ऑफ़लोड किए गए प्लेबैक के लिए,
AudioTrack.stop()को कॉल करने से पहलेDefaultAudioSinkमें स्ट्रीम पूरी होने के लिए ट्रैकिंग फ़ील्ड को रीसेट करें, ताकि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को लागू किया जा सके. साथ ही,SubtitleDecoderFactoryके बजायSubtitleParser.Factoryको लागू किया जा सके.
- PGS: रन-लेंथ डिकोडिंग को ठीक किया गया, ताकि
0को कलर वैल्यू के बजाय कलर इंडेक्स के तौर पर रिज़ॉल्व किया जा सके (#1367). - सीईए-708:
rowLockवैल्यू को अनदेखा करें. CEA-708-E S-2023 की खास जानकारी के मुताबिक,rowLockऔरcolumnLock, दोनों को सही माना जाना चाहिए. भले ही, स्ट्रीम में कोई भी वैल्यू मौजूद हो. हालांकि,columnLockकी सुविधा लागू नहीं की गई है. इसलिए, इसे हमेशा गलत माना जाता है.- इसे मूल रूप से
1.3.0-alpha01के रिलीज़ नोट में शामिल किया गया था, लेकिन1.3.0-rc01रिलीज़ से पहले, गलती से बदलाव को पहले जैसा कर दिया गया था. अब इस समस्या को ठीक कर दिया गया है. इसलिए, यह बदलाव फिर से लागू हो गया है.
- इसे मूल रूप से
- CEA-708: ExoPlayer के 'सेट पेन लोकेशन' कमांड को हैंडल करने के आसान तरीके की वजह से, डुप्लीकेट नई लाइनें जोड़ने से बचें (#1315).
LegacySubtitleUtilसेIllegalArgumentExceptionको ठीक किया गया.ऐसा तब किया गया, जब WebVTT सबटाइटल के सैंपल में कोई संकेत नहीं था. उदाहरण के लिए, DASH स्ट्रीम के हिस्से के तौर पर (#1516).
- मेटाडेटा:
- MP4 को ID3 सॉर्ट टैग से मैप करने से जुड़ी समस्या को ठीक किया गया. पहले, 'album sort' (
soal), 'artist sort' (soar), और 'album artist sort' (soaa) MP4 टैग,TSO2,TSOA, औरTSOPID3 टैग (#1302) के साथ गलत तरीके से मैप किए गए थे. - जब वैल्यू एक बाइट से ज़्यादा लंबी हो, तो MP4 (/iTunes) न्यूमेरिक
gnre(शैली) औरtmpo(टेम्पो) टैग को पढ़ने की समस्या को ठीक किया गया. - ID3
TCONफ़्रेम कोMediaMetadata.genreमें प्रोपेगेट करें (#1305).
- MP4 को ID3 सॉर्ट टैग से मैप करने से जुड़ी समस्या को ठीक किया गया. पहले, 'album sort' (
- इमेज:
- नॉन-स्क्वेयर DASH थंबनेल ग्रिड के लिए सहायता जोड़ें (#1300).
- एपीआई 34 और इसके बाद के वर्शन के लिए, AVIF फ़ॉर्मैट को इस्तेमाल किए जा सकने वाले फ़ॉर्मैट की सूची में जोड़ें.
- पहले से सेट किए गए
ImageOutputको हटाने के लिए,ExoPlayer.setImageOutput()के पैरामीटर के तौर परnullको अनुमति दें.
- डेटा सोर्स:
android.resource://package/idरॉ रिसॉर्स यूआरआई के लिए सहायता लागू करें, जहांpackageमौजूदा ऐप्लिकेशन के पैकेज से अलग है. पहले, इस तरीके को काम करने के लिए दस्तावेज़ में शामिल नहीं किया गया था. हालांकि, यह किसी दूसरे पैकेज में मौजूद संसाधनों को नाम के बजाय, आईडी से ऐक्सेस करने का ज़्यादा असरदार तरीका है.- Eagerly check
url,DataSpecकंस्ट्रक्टर में नॉन-नुल है. इस पैरामीटर को पहले ही एनोटेट किया जा चुका है, ताकि यह शून्य न हो. ByteArrayDataSourceको अनुमति दें कि वहopen()के दौरान, यूआरआई को बाइट कलेक्शन में बदल सके. इसके लिए, उसे कंस्ट्रक्शन के दौरान हार्ड-कोड करने की ज़रूरत नहीं है (#1405).
- डीआरएम:
DefaultDrmSessionManagerProviderपरLoadErrorHandlingPolicyसेट करने की अनुमति दें (#1271).
- असर:
SpeedChangeEffectमें, एक हीEditedMediaItemयाCompositionमें स्पीड में कई बदलाव करने की सुविधा.- अल्ट्रा एचडीआर बिटमैप इनपुट से, एचएलजी और पीक्यू आउटपुट के लिए सहायता.
- EGL_GL_COLORSPACE_BT2020_HLG_EXT के लिए सहायता जोड़ी गई है. इससे ExoPlayer.setVideoEffect और Transformer के डीबग SurfaceView में, एचएलजी सर्फ़ेस आउटपुट को बेहतर बनाया जा सकता है.
- ओवरले मैट्रिक्स के लागू होने के तरीके को अपडेट करें, ताकि यह दस्तावेज़ के मुताबिक हो. इसके लिए,
setOverlayFrameAnchor()में लागू की गई x और y वैल्यू को फ़्लिप करें.OverlaySettings.Builder.setOverlayFrameAnchor()का इस्तेमाल करने पर, x और y की वैल्यू को-1से गुणा करके फ़्लिप करें. TimestampWrapperकोExoPlayer#setVideoEffectsके साथ इस्तेमाल करने पर क्रैश होने की गड़बड़ी को ठीक किया गया (#821).- डिफ़ॉल्ट एसडीआर कलर वर्किंग स्पेस को लीनियर कलर से बदलकर, इलेक्ट्रिकल BT 709 एसडीआर वीडियो पर सेट करें. साथ ही, ओरिजनल कलरस्पेस को बनाए रखने के लिए तीसरा विकल्प भी दें.
- EditedMediaItemSequences के लिए, तय न किए गए z-ऑर्डर को तय करने की अनुमति दी गई (#1055).
- एचडीआर कॉन्टेंट के अलग-अलग हिस्सों में, ल्यूमिनेंस की रेंज को एक जैसा रखें. इसके लिए, एचएलजी रेंज का इस्तेमाल करें.
- एचडीआर कॉन्टेंट पर अल्ट्रा एचडीआर (बिटमैप) ओवरले के लिए सहायता जोड़ें.
- एपीआई 26 से पहले,
SeparableConvolutionइफ़ेक्ट इस्तेमाल करने की अनुमति दें. - इस्तेमाल नहीं किए गए
OverlaySettings.useHdrको हटाएं, क्योंकि ओवरले और फ़्रेम की डाइनैमिक रेंज मैच होनी चाहिए. TextOverlayके लिए, एचडीआर की सुविधा जोड़ें. टेक्स्ट ओवरले की चमक कोOverlaySettings.Builder.setHdrLuminanceMultiplier()की मदद से अडजस्ट किया जा सकता है.
- आईएमए एक्सटेंशन:
- ऐप्लिकेशन में डीएआई विज्ञापन स्ट्रीम चलाने के लिए ज़रूरी एपीआई को स्टेबल वर्शन में प्रमोट करें.
replaceAdTagParameters(Map <String, String>)कोImaServerSideAdInsertionMediaSource.AdLoaderमें जोड़ें. इससे रनटाइम के दौरान, विज्ञापन टैग के पैरामीटर बदले जा सकते हैं.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, विज्ञापन चलने के दौरान प्लेयर में गड़बड़ी होने पर,
VideoAdPlayer.VideoAdPlayerCallback.onError()को कॉल नहीं किया जाता था (#1334). data://विज्ञापन टैग यूआरआई का इस्तेमाल करते समय,NullPointerExceptionको ठीक करने के लिए, IMA SDK टूल के वर्शन को 3.33.0 पर बंप करें (#700).
- सेशन:
CommandButton.enabledकी डिफ़ॉल्ट वैल्यू को बदलकरtrueकरें. साथ ही, पक्का करें कि कंट्रोलर के लिए वैल्यू को 'गलत है' पर सेट किया जा सके. भले ही, उससे जुड़ा निर्देश उपलब्ध हो.CommandButtonके लिए आइकॉन कॉन्स्टेंट जोड़ें. इनका इस्तेमाल, पसंद के मुताबिक आइकॉन के संसाधनों के बजाय किया जाना चाहिए.MediaSessionService.isPlaybackOngoing()जोड़ें, ताकि ऐप्लिकेशन यह क्वेरी कर सकें किonTaskRemoved()में सेवा को बंद करने की ज़रूरत है या नहीं (#1219).MediaSessionService.pauseAllPlayersAndStopSelf()जोड़ें. इससे सभी सेशन के प्लेबैक को आसानी से रोका जा सकता है. साथ ही,MediaSessionServiceकी लाइफ़साइकल को खत्म करने के लिए,stopSelf()को कॉल किया जा सकता है.MediaSessionService.onTaskRemoved(Intent)को ओवरराइड करें, ताकि डिफ़ॉल्ट रूप से सुरक्षित तरीके से लागू किया जा सके. इससे, वीडियो चलने पर सेवा फ़ोरग्राउंड में चलती रहती है या फिर सेवा बंद हो जाती है.- प्लैटफ़ॉर्म सेशन के मेटाडेटा में अवधि सेट न करके, लाइव स्ट्रीम के लिए मीडिया सूचना में सीकबार छिपाएं (#1256).
MediaMetadataके कन्वर्ज़न कोMediaDescriptionCompatके साथ अलाइन करें, ताकि मेटाडेटा प्रॉपर्टी चुनते समय, मीडिया1 की तरह ही पसंदीदा क्रम और लॉजिक का इस्तेमाल किया जा सके.MediaSession.sendError()जोड़ें, ताकि Media3 कंट्रोलर को नुकसान न पहुंचाने वाली गड़बड़ियां भेजी जा सकें. सूचना कंट्रोलर (MediaSession.getMediaNotificationControllerInfo()देखें) का इस्तेमाल करते समय, कस्टम गड़बड़ी का इस्तेमाल करके, प्लैटफ़ॉर्म सेशन केPlaybackStateको गड़बड़ी की स्थिति में अपडेट किया जाता है. इसके लिए, गड़बड़ी की जानकारी (#543) का इस्तेमाल किया जाता है.MediaSession.Callback.onPlayerInteractionFinished()को जोड़ें, ताकि सेशन को यह जानकारी दी जा सके कि किसी खास कंट्रोलर से प्लेयर के इंटरैक्शन की सीरीज़ कब खत्म हुई.- गड़बड़ी के बारे में ज़्यादा जानकारी देने के लिए, गड़बड़ी के कोड के बजाय
SessionErrorजोड़ें और उसेSessionResultऔरLibraryResultमें इस्तेमाल करें. साथ ही, अगर हो सके, तो गड़बड़ी को ठीक करने का तरीका बताएं. - Media3 Controller Test ऐप्लिकेशन के लिए कोड पब्लिश करें. इसका इस्तेमाल, मीडिया सेशन पब्लिश करने वाले ऐप्लिकेशन के साथ इंटरैक्शन की जांच करने के लिए किया जा सकता है.
- Media3 के
MediaSession[Builder].setSessionExtras()में पास किए गए अतिरिक्त डेटा को, media1 कंट्रोलर केPlaybackStateCompat.getExtras()में भेजें. - प्लैटफ़ॉर्म सेशन में, नुकसान पहुंचाने वाली और नुकसान न पहुंचाने वाली गड़बड़ियों को मैप करना.
PlaybackExceptionकोPlaybackStateCompatकी गंभीर गड़बड़ी वाली स्थिति के साथ मैप किया गया है.MediaSession.sendError(ControllerInfo, SessionError)के साथ मीडिया सूचना कंट्रोलर को भेजा गयाSessionError,PlaybackStateCompatमें ऐसी गड़बड़ी के तौर पर मैप किया जाता है जो गंभीर नहीं है. इसका मतलब है कि गड़बड़ी का कोड और मैसेज सेट किया गया है, लेकिन प्लैटफ़ॉर्म सेशन की स्थितिSTATE_ERRORसे अलग रहती है. - ग्लोबल सेशन गतिविधि को बदलने के लिए, हर कंट्रोलर के हिसाब से सेशन गतिविधि सेट करने की अनुमति दें. कनेक्शन के समय, कंट्रोलर के लिए सेशन की गतिविधि तय की जा सकती है. इसके लिए,
AcceptedResultBuilder.setSessionActivivty(PendingIntent)के साथConnectionResultबनाएं. कनेक्ट होने के बाद, सेशन की गतिविधि कोMediaSession.setSessionActivity(ControllerInfo, PendingIntent)से अपडेट किया जा सकता है. MediaLibrarySession.Callbackको किए जाने वाले कॉल में गड़बड़ी की समस्या को बेहतर तरीके से दोहराना. गड़बड़ी की जानकारी को दोहराने की सुविधा को अबMediaLibrarySession.Builder.setLibraryErrorReplicationMode()का इस्तेमाल करके कॉन्फ़िगर किया जा सकता है. इससे गड़बड़ी का टाइप चुना जा सकता है या गड़बड़ी की जानकारी को दोहराने की सुविधा से ऑप्ट-आउट किया जा सकता है. यह सुविधा डिफ़ॉल्ट रूप से चालू होती है.
- यूज़र इंटरफ़ेस (यूआई):
ExoPlayerसे कनेक्ट होने पर,PlayerViewमें इमेज दिखाने की सुविधा जोड़ी गई (#1144).- एक्सएमएल एट्रिब्यूट की मदद से,
PlayerControlViewमें अलग-अलग आइकॉन को पसंद के मुताबिक बनाने की सुविधा जोड़ी गई है. इससे, ग्लोबल ओवरराइड के बजाय, हरPlayerViewइंस्टेंस के लिए अलग-अलग ड्रॉएबल इस्तेमाल किए जा सकते हैं (#1200). - एपीआई 34 पर, Compose
AndroidViewमेंSurfaceViewका इस्तेमाल करने पर, वीडियो के स्ट्रेच/क्रॉप होने की समस्या को ठीक किया गया (#1237).
- डाउनलोड:
- पक्का करें कि
DownloadHelper, रिलीज़ नहीं किए गएRendererइंस्टेंस को लीक न करे. इससे ऐप्लिकेशन क्रैश हो सकता है औरIllegalStateException: Too many receivers, total of 1000, registered for pid(#1224) गड़बड़ी आ सकती है.
- पक्का करें कि
- Cronet एक्सटेंशन:
CronetDataSourceमेंSocketTimeoutExceptionको ठीक करें. Cronet के कुछ वर्शन में, कॉलबैक से मिला अनुरोध हमेशा एक जैसा नहीं होता. इस वजह से, कॉलबैक पूरा नहीं हो पाता और अनुरोध का टाइम आउट हो जाता है (https://issuetracker.google.com/328442628).
- एचएलएस एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, डिसकंटीन्यूइटी के लिए इंतज़ार कर रहे ईएमएसजी सैंपल, गलत ऑफ़सेट के साथ
HlsSampleStreamWrapperमें डेलिगेट किए गए थे. इससेIndexOutOfBoundsExceptionयाIllegalArgumentException(#1002) की समस्या आ रही थी. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से एलएल-एचएलएस स्ट्रीम के लिए, नॉन-प्राइमरी प्लेलिस्ट बार-बार फिर से लोड होती रहती हैं (#1240).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, इनिशलाइज़ेशन सेगमेंट के साथ एचएलएस के लिए सीएमसीडी चालू करने पर,
Source ErrorऔरIllegalArgumentExceptionकी गड़बड़ी होती थी. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से लाइव प्लेबैक के दौरान, नॉन-प्राइमरी प्लेलिस्ट रीफ़्रेश नहीं होती थीं (#1240).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, एचएलएस लाइव स्ट्रीम के लिए सीएमसीडी चालू करने पर,
ArrayIndexOutOfBoundsException(#1395) की समस्या आती थी.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, डिसकंटीन्यूइटी के लिए इंतज़ार कर रहे ईएमएसजी सैंपल, गलत ऑफ़सेट के साथ
- DASH एक्सटेंशन:
- Cast एक्सटेंशन:
- Media3 मीडिया आइटम में,
MediaQueueItemके एल्बम टाइटल को कलाकार के नाम में बदलने वाली गड़बड़ी को ठीक किया गया (#1255).
- Media3 मीडिया आइटम में,
- टेस्ट यूटिलिटी:
FakeRendererमेंonInit()औरonRelease()को लागू करें.TestPlayerRunHelper.runUntil()/playUntil()के तरीकों को बदलें, ताकि वे गंभीर नहीं होने वाली गड़बड़ियों (जैसे,AnalyticsListener.onVideoCodecError()को रिपोर्ट की गई गड़बड़ियां) पर काम न करें. इस व्यवहार को बंद करने के लिए, नएTestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX()मेथड चेन का इस्तेमाल करें.
- डेमो ऐप्लिकेशन:
- शॉर्ट फ़ॉर्म डेमो ऐप्लिकेशन में
DefaultPreloadManagerका इस्तेमाल करें. - कमांड लाइन से
Intentआर्ग्युमेंट के साथ रिपीट मोड सेट करने की अनुमति दें (#1266). - डिवाइस पर काम करने पर,
HttpEngineDataSourceकोHttpDataSourceके तौर पर इस्तेमाल करें.
- शॉर्ट फ़ॉर्म डेमो ऐप्लिकेशन में
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
CronetDataSourceFactoryहटाएं. इसके बजाय,CronetDataSource.Factoryका इस्तेमाल करें.DataSpecके कुछ कंस्ट्रक्टर हटाएं. इसके बजाय,DataSpec.Builderका इस्तेमाल करें.DefaultHttpDataSource,OkHttpDataSource, औरCronetDataSourceसेsetContentTypePredicate(Predicate)को हटाएं. इसके बजाय, हरXXXDataSource.Factoryपर इसके बराबर के तरीके का इस्तेमाल करें.OkHttpDataSourceकंस्ट्रक्टर औरOkHttpDataSourceFactoryको हटाएं. इसके बजाय,OkHttpDataSource.Factoryका इस्तेमाल करें.PlayerMessage.setHandler(Handler)हटाएं. इसके बजाय,setLooper(Looper)का इस्तेमाल करें.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.FormatSupportIntDef औरFORMAT_HANDLED,FORMAT_EXCEEDS_CAPABILITIES,FORMAT_UNSUPPORTED_DRM,FORMAT_UNSUPPORTED_SUBTYPE,FORMAT_UNSUPPORTED_TYPEकॉन्सटैंट हटाएं. इसके बजाय,androidx.media3.common.Cमें इसके बराबर के IntDef और कॉन्सटेंट का इस्तेमाल करें. उदाहरण के लिए,C.FORMAT_HANDLED.Bundleableइंटरफ़ेस हटाएं. इसमें सभीBundleable.Creator<Foo> CREATORकॉन्स्टेंट फ़ील्ड हटाना शामिल है. इसके बजाय, कॉलर को हर टाइप परBundle toBundle()औरstatic Foo fromBundle(Bundle)तरीकों का इस्तेमाल करना चाहिए.
वर्शन 1.4.0-rc01
10 जुलाई, 2024
1.4.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.4.0-beta01
26 जून, 2024
1.4.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.4.0-alpha02
7 जून, 2024
1.4.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.4.0-alpha01
17 अप्रैल, 2024
1.4.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.3.0
वर्शन 1.3.1
11 अप्रैल, 2024
androidx.media3:media3-*:1.3.1 रिलीज़ हो गया है. वर्शन 1.3.1 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
- स्थानीय भाषा में या अन्य वैकल्पिक लेबल जोड़ने के लिए,
Format.labelsजोड़ें.
- स्थानीय भाषा में या अन्य वैकल्पिक लेबल जोड़ने के लिए,
- ExoPlayer:
- उस समस्या को ठीक किया गया है जिसमें
PreloadMediaPeriodको फिर से प्रीलोड करने पर, वह स्ट्रीम को सेव नहीं रख पाता था. - ट्रैक को फिर से चुनने के दौरान, वीडियो चलने की अवधि के हिसाब से सही
TrackSelectionResultलागू करें. - मीडिया आइटम के बीच ट्रांज़िशन करते समय, रेंडरर को पहले से चालू करने की सुविधा का इस्तेमाल, वीडियो चलाने की अवधि को आगे बढ़ाने के बाद ही करें (#1017).
DefaultVideoFrameProcessor.Factory.Builder.build()के लिए, ProGuard-keepclasseswithmembersनियम में मौजूद, छूटे हुए रिटर्न टाइप को जोड़ें (#1187).
- उस समस्या को ठीक किया गया है जिसमें
- ट्रांसफ़ॉर्मर:
- एपीआई 30 से पहले, नेगेटिव प्रज़ेंटेशन टाइमस्टैंप के साथ काम न करने वाले
MediaMuxerकी वजह से होने वाली गड़बड़ी को ठीक करने के लिए, कोई दूसरा तरीका जोड़ें.
- एपीआई 30 से पहले, नेगेटिव प्रज़ेंटेशन टाइमस्टैंप के साथ काम न करने वाले
- ट्रैक चुनना:
DefaultTrackSelector: कम या सेट नहीं किए गए फ़्रेम रेट वाले वीडियो ट्रैक के बजाय, 'सही' फ़्रेम रेट (>=10 एफ़पीएस) वाले वीडियो ट्रैक को प्राथमिकता दें. इससे यह पक्का होता है कि प्लेयर, मोशन फ़ोटो से निकाली गई MP4 फ़ाइलों में 'असली' वीडियो ट्रैक चुनता है. इन फ़ाइलों में दो HEVC ट्रैक हो सकते हैं. इनमें से एक का रिज़ॉल्यूशन ज़्यादा होता है, लेकिन फ़्रेम की संख्या बहुत कम होती है (#1051).
- एक्सट्रैक्टर:
- उस समस्या को ठीक किया गया है जिसमें WAV फ़ाइलों (#1117) से ऑड-साइज़ के चंक को पढ़ते समय, पैडिंग को स्किप नहीं किया जाता था.
- MP3:
Format.averageBitrateकोXINGऔरVBRIजैसे मेटाडेटा फ़्रेम से पॉप्युलेट करें. - MPEG-TS: उस बदलाव को पहले जैसा किया गया जिसका मकसद यह पक्का करना था कि आखिरी फ़्रेम रेंडर हो. इसके लिए, स्ट्रीम की आखिरी ऐक्सेस यूनिट को सैंपल सूची में पास किया गया (#7909). इस बदलाव की वजह से, सिर्फ़ आई-फ़्रेम वाली एचएलएस स्ट्रीम (#1150) और H.262 एचएलएस स्ट्रीम (#1126) में नई समस्याएं आ रही हैं.
- ऑडियो:
- अगर ऑडियो ट्रैक, ऑफ़लोड मोड में शुरू नहीं हो पाता है, तो ऑफ़लोड को बंद करके रेंडरर को वापस चालू करने की अनुमति दें.
- वीडियो:
- Galaxy Tab S7 FE, Chromecast with Google TV, और Lenovo M10 FHD Plus पर डिवाइस से जुड़ी समस्या को हल करने के लिए, वर्कअराउंड जोड़ें. इस समस्या की वजह से, 60fps H265 स्ट्रीम को 'इस्तेमाल नहीं किया जा सकता' के तौर पर मार्क किया जाता है
- ऐसा समाधान जोड़ें जिससे यह पक्का हो सके कि टनलिंग के दौरान पहला फ़्रेम हमेशा रेंडर हो. भले ही, डिवाइस एपीआई (#1169) की ज़रूरत के मुताबिक ऐसा अपने-आप न करता हो. (#966).
- उस समस्या को ठीक किया गया है जिसमें एचडीआर कलर की जानकारी को हैंडल करने की वजह से, कोडेक सही तरीके से काम नहीं करता था. साथ ही, एसडीआर वीडियो ट्रैक के लिए, अडैप्टिव फ़ॉर्मैट स्विच करने की सुविधा काम नहीं करती थी (#1158).
- टेक्स्ट:
- WebVTT:
WebvttParser.parseसेCuesWithTimingके अतिरिक्त इंस्टेंस बनाने से, सीधे तौर पर लगातार आने वाले संकेतों को रोकें (#1177).
- WebVTT:
- डीआरएम:
- Android 14 वाले कुछ डिवाइसों पर,
ResourceBusyExceptionयाNotProvisionedExceptionके बजायMediaDrmफ़्रेमवर्क से मिलने वालेNoSuchMethodErrorको ठीक करें (#1145).
- Android 14 वाले कुछ डिवाइसों पर,
- असर:
- कलर स्पेस को बदलकर, पीक्यू से एसडीआर टोन-मैपिंग को बेहतर बनाया गया है.
- सेशन:
- यूज़र इंटरफ़ेस (यूआई):
- अगर
Localeडिसप्ले नेम की पहचान नहीं कर पाता है, तो ऑडियो ट्रैक की भाषा का नाम शामिल करने के लिए फ़ॉलबैक करें (#988).
- अगर
- DASH एक्सटेंशन:
- मेनिफ़ेस्ट के सभी
Labelएलिमेंट कोFormat.labelsमें भरें (#1054).
- मेनिफ़ेस्ट के सभी
- आरटीएसपी एक्सटेंशन:
- एसडीपी पार्सिंग में, सेशन की जानकारी की खाली वैल्यू (i-टैग) को स्किप करना (#1087).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1, MIDI वगैरह):
- MIDI एक्सटेंशन को डिफ़ॉल्ट रूप से लोकल डिपेंडेंसी के तौर पर बंद करें, क्योंकि इसके लिए एक और Maven रिपॉज़िटरी को कॉन्फ़िगर करना ज़रूरी है. जिन उपयोगकर्ताओं को लोकल डिपेंडेंसी से इस मॉड्यूल की ज़रूरत है वे इसे फिर से चालू कर सकते हैं.
वर्शन 1.3.0
6 मार्च, 2024
androidx.media3:media3-*:1.3.0 रिलीज़ हो गया है. वर्शन 1.3.0 में ये बदलाव शामिल हैं.
- कॉमन लाइब्रेरी:
android.resource://package/[type/]nameरॉ रिसॉर्स यूआरआई के लिए सहायता लागू करें, जहांpackageमौजूदा ऐप्लिकेशन के पैकेज से अलग है. यह सुविधा हमेशा से काम करती थी, लेकिन अब तक इसे सही तरीके से लागू नहीं किया गया था.- ऐप्लिकेशन कोड से सेट किए गए या मीडिया से पढ़े गए एमआईएमई टाइप को नॉर्मलाइज़ करें, ताकि वे पूरी तरह से लोअर-केस में हों.
AdPlaybackStateमें एकUriके बजाय, पूरेMediaItemके साथ विज्ञापनों को तय करें.minSdkको बढ़ाकर 19 (Android KitKat) करें. यह AndroidX की अन्य सभी लाइब्रेरी के साथ अलाइन है. साथ ही, हमें AndroidX की डिपेंडेंसी के नए वर्शन पर अपग्रेड करने के लिए इसकी ज़रूरत है.MediaMetadata.Builder.populate(MediaMetadata)मेंartworkUriऔरartworkData, दोनों को पॉप्युलेट करें. ऐसा तब करें, जब इनमें से कम से कम एक वैल्यू शून्य न हो (#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की मदद से, अडैप्टिव मीडिया सोर्स इस्तेमाल करें.- HttpEngine एपीआई का इस्तेमाल करके,
HttpEngineDataSourceको लागू करें. यह एकHttpDataSourceहै. CompositeSequenceableLoaderको सबक्लास करने से रोकें. इस कॉम्पोनेंट को पहले एक्सटेंसिबल बनाया गया था, लेकिन लाइब्रेरी में इसे कभी सबक्लास नहीं किया गया. डेकोरेटर पैटर्न का इस्तेमाल करके, किसी इंस्टेंस को रैप करके और कस्टमCompositeSequenceableLoaderFactoryको लागू करके, पसंद के मुताबिक बदलाव किए जा सकते हैं.- उस समस्या को ठीक किया गया है जिसमें एक ही समय को दोहराने पर, इस आइटम का मेटाडेटा मिट जाता था (#1007).
BundledChunkExtractor.FactoryऔरDefaultHlsExtractorFactoryपर मौजूदexperimentalSetSubtitleParserFactoryतरीकों का नाम बदलकरsetSubtitleParserFactoryकरें औरnullको पास करने की अनुमति न दें. पार्स करने के तरीके को कंट्रोल करने के लिए, नएexperimentalParseSubtitlesDuringExtraction(boolean)तरीकों का इस्तेमाल करें.- एक्सट्रैक्शन के दौरान इस्तेमाल किए जाने वाले
SubtitleParser.Factoryको पसंद के मुताबिक बनाने की सुविधा जोड़ें. अभिभावकों की सहमति लेने के लिए,MediaSource.Factory.setSubtitleParserFactory()का इस्तेमाल करें. MergingMediaSourceसे जनरेट किए गए सभीFormat.idफ़ील्ड में सोर्स प्रीफ़िक्स जोड़ें. इससे यह पता लगाने में मदद मिलती है कि किस सोर्स नेFormat(#883) जनरेट किया है.- कस्टम कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) की कुंजी के नामों की पुष्टि करने के लिए इस्तेमाल किए गए रेगुलर एक्सप्रेशन को ठीक किया गया. इसके लिए, उसमें बदलाव करके सिर्फ़ हाइफ़न (#1028) की जांच करने की सुविधा जोड़ी गई.
- सीएमसीडी क्वेरी पैरामीटर को दो बार एन्कोड करने की सुविधा बंद की गई (#1075).
- ट्रांसफ़ॉर्मर:
- H.265/HEVC SEF स्लो मोशन वीडियो को फ़्लैट करने की सुविधा जोड़ी गई.
- ट्रांसमक्सिंग की स्पीड बढ़ाएं. खास तौर पर, 'वीडियो हटाएं' बदलावों के लिए.
- यह पक्का करने के लिए एपीआई जोड़ें कि आउटपुट फ़ाइल, वीडियो फ़्रेम से शुरू हो. इससे, ट्रिम किए गए वीडियो का आउटपुट, उन प्लेयर के साथ बेहतर तरीके से काम कर सकता है जो वीडियो के पहले फ़्रेम को तब तक नहीं दिखाते, जब तक कि उसका प्रज़ेंटेशन टाइमस्टैंप (#829) न हो.
- सिंगल ऐसेट MP4 ट्रिम ऑपरेशन को ऑप्टिमाइज़ करने के लिए सहायता जोड़ी गई.
- आउटपुट फ़ाइल में वीडियो फ़्रेम का पहला टाइमस्टैंप जोड़ने की सुविधा जोड़ी गई. iOS पर आधारित प्लेयर में, ब्लैक फ़्रेम से शुरू होने वाली आउटपुट फ़ाइलों को ठीक किया गया (#829).
- ट्रैक चुनना:
- इमेज ट्रैक चुनने की सुविधा चालू करने के लिए,
DefaultTrackSelector.selectImageTrackजोड़ें. TrackSelectionParameters.isPrioritizeImageOverVideoEnabledजोड़ें, ताकि यह तय किया जा सके कि इमेज ट्रैक और वीडियो ट्रैक, दोनों उपलब्ध होने पर इमेज ट्रैक को चुनना है या नहीं. डिफ़ॉल्ट वैल्यूfalseहोती है. इसका मतलब है कि वीडियो ट्रैक चुनने को प्राथमिकता दी जाती है.
- इमेज ट्रैक चुनने की सुविधा चालू करने के लिए,
- एक्सट्रैक्टर:
ColorInfo.colorSpace,ColorInfo.colorTransfer, औरColorInfo.colorRangeवैल्यू पाने के लिए, MP4 एक्सट्रैक्टर में अतिरिक्त AV1C पार्सिंग जोड़ी गई (#692).- MP3:
Infoहेडर वाली फ़ाइलों के लिए, कॉन्स्टेंट बिटरेट (सीबीआर) का इस्तेमाल करें. यहXingहेडर के सीबीआर के बराबर होता है. पहले हमInfoहेडर से सीक टेबल का इस्तेमाल करते थे. हालांकि, इससे वीडियो के किसी भी हिस्से पर जाने की सुविधा उतनी सटीक नहीं होती जितनी कि इसे अनदेखा करने और फ़ाइल को सीबीआर मानने पर होती है. - MPEG2-TS: DTS, DTS-LBR, और DTS:X Profile2 के लिए सहायता जोड़ी गई (#275).
- टीएस डिस्क्रिप्टर से ऑडियो टाइप निकालें और उन्हें रोल फ़्लैग पर मैप करें. इससे उपयोगकर्ता, ऑडियो ट्रैक के बेहतर विकल्प चुन सकते हैं (#973).
- ऑडियो:
- वीडियो:
MediaCodecVideoRendererकंस्ट्रक्टर को बदलें, जोVideoFrameProcessor.Factoryआर्ग्युमेंट लेता है. साथ ही, इसे ऐसे कंस्ट्रक्टर से बदलें जोVideoSinkProviderआर्ग्युमेंट लेता है. कस्टमVideoFrameProcessor.Factoryको इंजेक्ट करने वाले ऐप्लिकेशन,CompositingVideoSinkProviderको इंस्टैंशिएट कर सकते हैं. यह कस्टमVideoFrameProcessor.Factoryका इस्तेमाल करता है और वीडियो सिंक प्रोवाइडर कोMediaCodecVideoRendererमें पास करता है.
- टेक्स्ट:
DefaultExtractorsFactory.setTextTrackTranscodingEnabledका इस्तेमाल करते समय,Tried to marshall a Parcel that contained Binder objectsगड़बड़ी को ठीक करने के लिए, बिटमैप क्यू के सीरियलाइज़ेशन को ठीक किया गया (#836).- सीईए-708:
rowLockवैल्यू को अनदेखा करें. CEA-708-E S-2023 की खास जानकारी के मुताबिक,rowLockऔरcolumnLock, दोनों को सही माना जाना चाहिए. भले ही, स्ट्रीम में कोई भी वैल्यू मौजूद हो. हालांकि,columnLockकी सुविधा लागू नहीं की गई है. इसलिए, इसे हमेशा गलत माना जाता है.
- इमेज:
- DASH थंबनेल के लिए सहायता जोड़ें. ग्रिड इमेज को काट-छांटकर, अलग-अलग थंबनेल बनाए जाते हैं. इन्हें
ImageOutputको उनके प्रज़ेंटेशन के समय के आस-पास उपलब्ध कराया जाता है.
- DASH थंबनेल के लिए सहायता जोड़ें. ग्रिड इमेज को काट-छांटकर, अलग-अलग थंबनेल बनाए जाते हैं. इन्हें
- डीआरएम:
- डीआरएम कॉन्टेंट में, एन्क्रिप्ट (सुरक्षित) नहीं किए गए 'क्लियर लीड' सैंपल को डिफ़ॉल्ट रूप से तुरंत चलाएं. भले ही, बाद में एन्क्रिप्ट किए गए सैंपल के लिए कुंजियां अभी तक तैयार न हों. अगर एन्क्रिप्ट किए गए सैंपल तक पहुंचने पर भी कुंजियां तैयार नहीं होती हैं, तो वीडियो बीच में रुक सकता है. हालांकि, पहले इस पॉइंट पर वीडियो शुरू ही नहीं होता था. इस सुविधा को बंद करने के लिए,
MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKeyयाDefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeysका इस्तेमाल करें.- आईएमए एक्सटेंशन:
- उस समस्या को ठीक किया गया है जिसकी वजह से सही फ़ाइल एक्सटेंशन के बिना, DASH और एचएलएस विज्ञापन नहीं चलाए जा सकते थे.
- डीआरएम कॉन्टेंट में, एन्क्रिप्ट (सुरक्षित) नहीं किए गए 'क्लियर लीड' सैंपल को डिफ़ॉल्ट रूप से तुरंत चलाएं. भले ही, बाद में एन्क्रिप्ट किए गए सैंपल के लिए कुंजियां अभी तक तैयार न हों. अगर एन्क्रिप्ट किए गए सैंपल तक पहुंचने पर भी कुंजियां तैयार नहीं होती हैं, तो वीडियो बीच में रुक सकता है. हालांकि, पहले इस पॉइंट पर वीडियो शुरू ही नहीं होता था. इस सुविधा को बंद करने के लिए,
- सेशन:
- टीवी ऐप्लिकेशन के लिए, दो बार क्लिक करने की सुविधा बंद करें (#962).
- उस समस्या को ठीक किया गया है जिसमें सिर्फ़ नॉन-नल एक्स्ट्रा वाले
MediaItem.RequestMetadataको मीडिया कंट्रोलर और सेशन के बीच ट्रांसमिट नहीं किया जाता था. MediaLibrarySession.Builderमें कंस्ट्रक्टर जोड़ा गया, जोMediaLibraryServiceके बजाय सिर्फ़Contextलेता है.
- एचएलएस एक्सटेंशन:
HlsMediaPeriodको पैकेज-प्राइवेट विज़िबिलिटी पर सेट करें. इस टाइप पर, एचएलएस पैकेज के बाहर से सीधे तौर पर निर्भर नहीं होना चाहिए.- सेगमेंट की शुरुआत में बेहतर तरीके से जाने की सुविधा जोड़ी गई (#1031).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1, MIDI वगैरह):
- MIDI डिकोडर: SysEx इवेंट मैसेज को अनदेखा करें (#710).
- टेस्ट यूटिलिटी:
TestPlayerRunHelper.playUntilPositionमें वीडियो चलाना न रोकें. टेस्ट, वीडियो को चलने की स्थिति में रखता है. हालांकि, यह प्रोग्रेस को तब तक निलंबित रखता है, जब तक टेस्ट में दावे और आगे की कार्रवाइयां नहीं जोड़ी जातीं.
- डेमो ऐप्लिकेशन:
- शॉर्ट वीडियो के इस्तेमाल के उदाहरण के साथ,
PreloadMediaSourceके इस्तेमाल को दिखाने के लिए, शॉर्ट वीडियो का डेमो मॉड्यूल जोड़ें.
- शॉर्ट वीडियो के इस्तेमाल के उदाहरण के साथ,
वर्शन 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पर अडजस्ट हो जाता है. - उस समस्या को ठीक किया गया है जिसमें 3, 5, 6, 7, और 8 चैनलों के लिए, OPUS और VORBIS चैनल के लेआउट गलत थे (#8396).
- उस समस्या को ठीक किया गया है जिसमें लाइव स्ट्रीम में ट्रैक को शून्य पर सेट करने के बाद, स्ट्रीम अपनी डिफ़ॉल्ट पोज़िशन से शुरू हो जाती थी (#9347).
- उस समस्या को ठीक किया गया है जिसमें
CmcdData.Factoryके नए इंस्टेंस को चंक सोर्स सेbufferedDurationUsके लिए नेगेटिव वैल्यू मिल रही थीं. इस वजह से,IllegalArgumentException(#888) हो रहा था.
- उस समस्या को ठीक करना जिसमें
- ट्रांसफ़ॉर्मर:
- उस समस्या को ठीक करना जिसमें ऑपरेटिंग रेट ज़्यादा सेट करने की वजह से, कॉन्फ़िगरेशन के समय एन्कोडर गड़बड़ी दिखाता था.
- एक्सट्रैक्टर:
- JPEG मोशन फ़ोटो में मौजूद सेकंडरी (चलाए न जा सकने वाले) HEVC ट्रैक को
ROLE_FLAG_ALTERNATEके तौर पर मार्क करें. इससे, ज़्यादा रिज़ॉल्यूशन की वजह से उन्हें वीडियो चलाने के लिए अपने-आप चुने जाने से रोका जा सकेगा. - TS H264 स्ट्रीम के लिए, गलत कीफ़्रेम की पहचान करने की समस्या को ठीक किया गया (#864).
- 47,721 सेकंड से लंबी टीएस स्ट्रीम की अवधि के अनुमान को ठीक किया गया (#855).
- JPEG मोशन फ़ोटो में मौजूद सेकंडरी (चलाए न जा सकने वाले) HEVC ट्रैक को
- ऑडियो:
- कई बार कॉल किए जाने पर,
SilenceSkippingAudioProcessorके लिए ईओएस को मैनेज करने से जुड़ी समस्या को ठीक किया गया (#712).
- कई बार कॉल किए जाने पर,
- वीडियो:
- Galaxy Tab S7 FE, Chromecast with Google TV, और Lenovo M10 FHD Plus पर डिवाइस से जुड़ी समस्या को हल करने के लिए, कोई दूसरा तरीका जोड़ें. इस समस्या की वजह से, 60fps एवीसी स्ट्रीम को 'काम नहीं करता' के तौर पर मार्क किया जाता है (#693).
- मेटाडेटा:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से,
MediaMetadataको सिर्फ़ Vorbis टिप्पणियों से पॉप्युलेट किया जाता था. साथ ही, इसमें कैपिटल लेटर वाली कुंजियां होती थीं (#876). - बहुत बड़े ID3 फ़्रेम को पार्स करते समय
OutOfMemoryErrorको कैच करें. इसका मतलब है कि वीडियो चलाना पूरी तरह से बंद होने के बजाय, टैग की जानकारी के बिना भी वीडियो चलाना जारी रखा जा सकता है.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से,
- डीआरएम:
- एपीआई 33 और इसके बाद के वर्शन के लिए, ClearKey
https://default.urlलाइसेंस के नकली यूआरएल की समस्या को हल करने के लिए, पहले से मौजूद तरीके को बेहतर बनाया गया है. पहले यह तरीका सिर्फ़ एपीआई 33 पर लागू होता था (#837). - एन्क्रिप्ट किए गए कॉन्टेंट से बिना एन्क्रिप्ट किए गए कॉन्टेंट पर स्विच करते समय,
ERROR_DRM_SESSION_NOT_OPENEDको ठीक करें. ऐसा तब करें, जब प्लेयर से कोई सरफ़ेस अटैच न हो. यह गड़बड़ी, बिना एन्क्रिप्ट किए गए कॉन्टेंट को चलाने के लिए, सुरक्षित डिकोडर का गलत तरीके से इस्तेमाल करने की वजह से हुई.
- एपीआई 33 और इसके बाद के वर्शन के लिए, ClearKey
- सेशन:
- कस्टम कुंजियों और वैल्यू को
MediaMetadataCompatसेMediaMetadata.extrasऔरMediaMetadata.extrasसेMediaMetadataCompatमें डालें (#756, #802). - लेगसी कंट्रोलर के लिए, ब्रॉडकास्टिंग
notifyChildrenChangedको ठीक किया गया (#644). - एक गड़बड़ी को ठीक किया गया है. इसमें, सूचना के बंद किए गए
setWhenटाइमर के लिए नेगेटिव टाइम सेट करने पर, कुछ डिवाइसों पर ऐप्लिकेशन क्रैश हो जाता था (#903). IllegalStateExceptionको ठीक किया गया. ऐसा तब होता है, जब पहली सूचना के अपडेट का अनुरोध किए जाने पर, मीडिया सूचना कंट्रोलर का कनेक्शन पूरा नहीं होता (#917).
- कस्टम कुंजियों और वैल्यू को
- यूज़र इंटरफ़ेस (यूआई):
- DASH एक्सटेंशन:
- DASH मेनिफ़ेस्ट में Dolby के लिए, "f800" को चैनल की संख्या 5 के तौर पर पार्स करें (#688).
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1, MIDI वगैरह):
- Cast एक्सटेंशन:
Timelineबनाने की प्रोसेस को सैनिटाइज़ करें, ताकि कास्ट डिवाइस पर मीडिया लोड न होने पर ऐप्लिकेशन क्रैश न हो (#708).
वर्शन 1.2.0
15 नवंबर, 2023
- कॉमन लाइब्रेरी:
Log.Loggerइंटरफ़ेस में मौजूद तरीकों में@Nullable Throwableपैरामीटर जोड़ें. इन तरीकों केmessageपैरामीटर में, अबLog.{d,i,w,e}()तरीकों को पास किए गएThrowableके बारे में कोई जानकारी नहीं होती. इसलिए, अगर आपको यह जानकारी चाहिए, तो आपको इसे मैन्युअल तरीके से जोड़ना होगा. इसके लिए,Logger.appendThrowableString(String, Throwable)का इस्तेमाल किया जा सकता है.- Kotlin के साथ काम करने से जुड़ी समस्या को ठीक किया गया. इसमें, शून्य वैल्यू वाले जेनरिक टाइप पैरामीटर और शून्य वैल्यू वाले कलेक्शन एलिमेंट टाइप को शून्य वैल्यू वाले के तौर पर नहीं पहचाना जाता था. उदाहरण के तौर पर,
TrackSelectorResultऔरSimpleDecoder, तरीके के पैरामीटर हैं (#6792). Util.shouldShowPlayButtonमें डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) और सूचना के व्यवहार को बदलें, ताकि वीडियो चलाने की सुविधा कुछ समय के लिए बंद होने पर, "चलाएं" बटन दिखे. उदाहरण के लिए, कुछ समय के लिए ऑडियो फ़ोकस न होने की वजह से.PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false)याMediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false)(#11213) का इस्तेमाल करके, लेगसी व्यवहार को बनाए रखा जा सकता है.- https://issuetracker.google.com/251172715 को ठीक करने के लिए,
androidx.annotation:annotation-experimentalको1.3.1पर अपग्रेड करें. ExoPlayer.setAudioAttributesकोPlayerइंटरफ़ेस पर ले जाएं.
- ExoPlayer:
- AC4 स्ट्रीम में, सिर्फ़ डिकोड किए जाने वाले सैंपल की सही तरीके से पहचान न होने की वजह से, सीक करने में आने वाली समस्याएं ठीक की गईं (#11000).
ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutputके ज़रिए इस सुविधा को चालू करने पर, ऑडियो आउटपुट डिवाइसों पर ऑडियो चलाने की सुविधा बंद कर दी जाती है जो इसके लिए सही नहीं हैं. जैसे, Wear OS डिवाइसों पर मौजूद स्पीकर. अगर ऑडियो चलाने की कोशिश की जाती है और कोई सही ऑडियो आउटपुट उपलब्ध नहीं होता है या ऑडियो चलाने के दौरान सभी सही आउटपुट डिसकनेक्ट हो जाते हैं, तो ऑडियो न चलने की वजह कोPlayer.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUTके तौर पर अपडेट कर दिया जाएगा. सही आउटपुट कनेक्ट होने पर, ऑडियो बंद होने की वजह हट जाएगी.Player.replaceMediaItem(s)की मदद से,MediaItemअपडेट स्वीकार करने के लिए,MediaSource.canUpdateMediaItemऔरMediaSource.updateMediaItemजोड़ें.Player.replaceMediaItem(s)की मदद से, लाइब्रेरी में मौजूद सभीMediaSourceक्लास के लिए,MediaItemके अपडेट की अनुमति दें (#33, #9978).MimeTypes.TEXT_EXOPLAYER_CUESका नाम बदलकरMimeTypes.APPLICATION_MEDIA3_CUESकरें.PngExtractorजोड़ें, जो पूरी PNG फ़ाइल को एक सैंपल के तौर परTrackOutputमें भेजता और पढ़ता है.SequenceableLoaderइंटरफ़ेस मेंSequenceableLoader.continueLoading(long)तरीके को बेहतर बनाएं, ताकिSequenceableLoader.continueLoading(LoadingInfo loadingInfo).LoadingInfoमें अतिरिक्त पैरामीटर शामिल हैं. इनमें मौजूदाplaybackPositionUsके अलावा,playbackSpeedऔरlastRebufferRealtimeMsभी शामिल हैं.ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder)के लिए,ChunkSourceइंटरफ़ेस मेंChunkSource.getNextChunk(long, long, List, ChunkHolder)तरीके को बेहतर बनाएं.- कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) लॉगिंग में अतिरिक्त फ़ील्ड जोड़ें: बफ़र
स्टार्वेशन (
bs), समयसीमा (dl), वीडियो चलाने की स्पीड (pr), और स्टार्टअप (su) (#8699). ColorInfoमें ल्यूमा और क्रोमा बिटडेप्थ जोड़ें (#491).- कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) लॉगिंग में अतिरिक्त फ़ील्ड जोड़े गए: अगला ऑब्जेक्ट अनुरोध (
nor) और अगला रेंज अनुरोध (nrr) (#8699). - क्वेरी पैरामीटर (#553) का इस्तेमाल करके, कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) को ट्रांसमिट करने की सुविधा जोड़ी गई.
ExperimentalBandwidthMeterमेंConcurrentModificationExceptionको ठीक किया गया (#612).CompositeMediaSource.getMediaTimeForChildMediaTimeमेंMediaPeriodIdपैरामीटर जोड़ें.ConcatenatingMediaSource2मेंClippingMediaSource(और पीरियड/विंडो टाइम ऑफ़सेट वाले अन्य सोर्स) के लिए सहायता जोड़ी गई (#11226).BaseRenderer.onStreamChanged()को बदलें, ताकिMediaPeriodIdआर्ग्युमेंट भी मिल सके.
- ट्रांसफ़ॉर्मर:
- इमेज इनपुट के लिए, EXIF रोटेशन डेटा को पार्स करें.
TransformationRequest.HdrModeएनोटेशन टाइप और उससे जुड़े कॉन्सटैंट हटाएं. इसके बजाय,Composition.HdrModeऔर इससे जुड़े कॉन्सटेंट का इस्तेमाल करें.- रोटेशन से जुड़ी समस्याएं ठीक करने के लिए,
OverlaySettingsको आसान बनाएं. SampleConsumer.queueInputBitmapकेframeRateऔरdurationUsपैरामीटर को बदलकरTimestampIteratorकिया गया.
- ट्रैक चुनना:
DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptivenessको जोड़ें, ताकि साफ़ तौर पर यह बताया जा सके कि नॉन-सीमलेस अडैप्टेशन की अनुमति है या नहीं. डिफ़ॉल्ट सेटिंग,trueपर सेट रहती है.
- एक्सट्रैक्टर:
- MPEG-TS: पक्का करें कि आखिरी फ़्रेम रेंडर हो गया हो. इसके लिए, स्ट्रीम की आखिरी ऐक्सेस यूनिट को सैंपल सूची में पास करें (#7909).
rotationDegreesतय करते समय, टाइपिंग की गड़बड़ी को ठीक करें.projectionPosePitchको बदलकरprojectionPoseRollकिया गया (#461).- यह अनुमान हटा दिया गया है कि
Extractorइंस्टेंस की जांच, सीधे तौर परinstanceofसे की जा सकती है. अगर आपको किसीExtractorको लागू करने की जानकारी का रनटाइम ऐक्सेस चाहिए, तो आपको पहलेExtractor.getUnderlyingInstanceको कॉल करना होगा. BmpExtractorजोड़ें.WebpExtractorजोड़ें.HeifExtractorजोड़ें.Mp4Extractorमें QuickTime classic के काम करने की सुविधा जोड़ें.
- ऑडियो:
- MP4 और Matroska में 24/32-बिट बिग-एंडियन पीसीएम के लिए सहायता जोड़ें. साथ ही, MP4 में
lpcmके लिए पीसीएम एन्कोडिंग को पार्स करें. - MP4 में Vorbis ऑडियो को एक्सट्रैक्ट करने की सुविधा जोड़ी गई.
AudioSink.getFormatOffloadSupport(Format)जोड़ें, जो सिंक के लिए ऑफ़लोड सहायता के लेवल को वापस लाता है. सिंक,DefaultAudioOffloadSupportProviderके ज़रिए फ़ॉर्मैट के लिए ऑफ़लोड सहायता दे सकता है. यह नयाAudioOffloadSupportदिखाता है, जिसमेंisFormatSupported,isGaplessSupported, औरisSpeedChangeSupportedशामिल हैं.AudioSink.setOffloadMode()जोड़ें. इसकी मदद से, ऑडियो सिंक पर ऑफ़लोड कॉन्फ़िगरेशन को कॉन्फ़िगर किया जाता है. डिफ़ॉल्ट रूप से, यह कार्रवाईAudioSink.OFFLOAD_MODE_DISABLEDपर सेट रहती है.TrackSelectionParametersमेंsetAudioOffloadPreferenceकी मदद से, ऑफ़लोड की सुविधा चालू की जा सकती है. अगर सेट की गई प्राथमिकता को चालू करना है, तो डिवाइस फ़ॉर्मैट के लिए ऑफ़लोड की सुविधा के साथ काम करता है. साथ ही, ट्रैक का विकल्प एक ऑडियो ट्रैक है, तो ऑडियो ऑफ़लोड की सुविधा चालू हो जाएगी.- अगर
audioOffloadModePreferenceकोAUDIO_OFFLOAD_MODE_PREFERENCE_REQUIREDपर सेट किया जाता है, तोDefaultTrackSelectorसिर्फ़ ऑडियो ट्रैक को चुनेगा. ऐसा सिर्फ़ तब होगा, जब उस ट्रैक का फ़ॉर्मैट ऑफ़लोड में काम करता हो. अगर ऑफ़लोड में कोई ऑडियो ट्रैक काम नहीं करता है, तो कोई ट्रैक नहीं चुना जाएगा. - ट्रैक ट्रांज़िशन के बाद, वीडियो चलाने की पोज़िशन से जुड़ी समस्या की वजह से, एपीआई लेवल 33 से पहले के वर्शन के लिए, ऑफ़लोड के लिए गैपलेस सपोर्ट की सुविधा बंद की जा रही है.
DefaultRenderersFactory.buildAudioSinkमेथड सिग्नेचर सेenableOffloadपैरामीटर हटाएं.DefaultAudioSink.Builder.setOffloadModeको हटाएं.- intdef वैल्यू हटाएं
DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED. - ऑफ़लोड प्लेबैक के दौरान, Opus गैपलेस मेटाडेटा के लिए सहायता जोड़ें.
- पहली बार लिखने में गड़बड़ी होने पर, ऑफ़लोड को बंद करके रेंडरर को वापस चालू करने की अनुमति दें (#627).
- सिर्फ़ ऑडियो वाले ऑफ़लोड किए गए प्लेबैक के लिए, डिफ़ॉल्ट रूप से ऑफ़लोड शेड्यूलिंग की सुविधा चालू करें.
ExoPlayer.experimentalSetOffloadSchedulingEnabledऔरAudioOffloadListener.onExperimentalOffloadSchedulingEnabledChangedको मिटाएं.onExperimentalSleepingForOffloadChangedका नाम बदलकरonSleepingForOffloadChangedऔरonExperimentalOffloadedPlaybackका नाम बदलकरonOffloadedPlaybackकिया गया.- ऑडियो ऑफ़लोड मोड से जुड़े
TrackSelectionParametersइंटरफ़ेस और परिभाषाओं को इनरAudioOffloadPreferencesक्लास में ले जाएं. AnalyticsListener,AudioRendererEventListener, औरAudioSink.ListenerमेंonAudioTrackInitializedऔरonAudioTrackReleasedकॉलबैक जोड़ें.- डीटीएस एक्सप्रेस ऑडियो बफ़र अंडरफ़्लो की समस्या को ठीक किया गया (#650).
- उस गड़बड़ी को ठीक किया गया जिसकी वजह से, E-AC3-JOC की क्षमताओं की जांच करने पर,
IllegalArgumentException(#677) दिखता था.
- MP4 और Matroska में 24/32-बिट बिग-एंडियन पीसीएम के लिए सहायता जोड़ें. साथ ही, MP4 में
- वीडियो:
MediaCodecVideoRendererको पसंद के मुताबिकVideoFrameProcessor.Factoryइस्तेमाल करने की अनुमति दें.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ऑडियो स्ट्रीम के नेगेटिव टाइमस्टैंप से शुरू होने पर पहला फ़्रेम रेंडर नहीं हो पाता था (#291).
- टेक्स्ट:
ExoplayerCuesDecoderहटाएं.sampleMimeType = application/x-media3-cuesवाले टेक्स्ट ट्रैक अब सीधेTextRendererसे मैनेज किए जाते हैं. इसके लिए,SubtitleDecoderइंस्टेंस की ज़रूरत नहीं होती.
- मेटाडेटा:
- "सिर्फ़ डिकोड" सैंपल के लिए,
MetadataDecoder.decodeको अब कॉल नहीं किया जाएगा. ऐसा इसलिए, क्योंकि लागू करने पर हर हाल में शून्य वैल्यू दिखनी चाहिए.
- "सिर्फ़ डिकोड" सैंपल के लिए,
- असर:
VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>)टाइमस्टैंप के हिसाब से बिटमैप इनपुट को सूची में जोड़ने की सुविधा जोड़ी गई.VideoFrameProcessor.registerInputStream()को नॉन-ब्लॉकिंग में बदलें. ऐप्लिकेशन मेंVideoFrameProcessor.Listener#onInputStreamRegistered()को लागू करना ज़रूरी है.VideoFrameProcessor.queueInputBitmapकेframeRateऔरdurationUsपैरामीटर को बदलकरTimestampIteratorकिया गया.
- आईएमए एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मल्टी-पीरियड DASH लाइव स्ट्रीम के लिए अपवाद थ्रो किया जा सकता है. ऐसा तब होता है, जब वह लाइव स्ट्रीम प्लेलिस्ट का पहला आइटम न हो (#571).
AdsLoader.destroy()को कॉल करने से पहले, StreamManager को रिलीज़ करें- IMA SDK टूल के वर्शन को 3.31.0 पर अपडेट किया गया.
- सेशन:
DefaultMediaNotificationProviderमें सूचनाओं की फ़ोरग्राउंड सेवा के व्यवहार कोFOREGROUND_SERVICE_IMMEDIATEपर सेट करें (#167).- Samsung डिवाइसों पर, बंद किए जा चुके एपीआई से जुड़ी समस्याओं से बचने के लिए, सिर्फ़
android.media.session.MediaSession.setMediaButtonBroadcastReceiver()एपीआई 31 से ऊपर के वर्शन का इस्तेमाल करें (#167). - मीडिया सूचना कंट्रोलर को प्रॉक्सी के तौर पर इस्तेमाल करें, ताकि उपलब्ध कमांड और कस्टम लेआउट सेट किया जा सके. इसका इस्तेमाल, सूचना और प्लैटफ़ॉर्म सेशन को भरने के लिए किया जाता है.
- Media3 में
MediaSessionService.onStartCommand()को मिलने वाले मीडिया बटन इवेंट को कन्वर्ट करें. इसके लिए, उन्हें प्लैटफ़ॉर्म सेशन पर रूट करने और फिर Media3 पर वापस भेजने के बजाय, Media3 में ही कन्वर्ट करें. इससे, कॉलर कंट्रोलर हमेशा मीडिया नोटिफ़िकेशन कंट्रोलर होता है. साथ ही, ऐप्लिकेशन सभी एपीआई लेवल पर, नोटिफ़िकेशन से आने वाले कॉल को आसानी से पहचान सकते हैं. - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, लेगसी
MediaSessionCompatसे कनेक्ट होने परMediaController.getCurrentPosition()आगे नहीं बढ़ रहा था. - सुविधा के लिए
MediaLibrarySession.getSubscribedControllers(mediaId)जोड़ें. MediaLibrarySession.Callback.onSubscribe()को बदलें, ताकि उस पैरंट आईडी की उपलब्धता की पुष्टि की जा सके जिसकी सदस्यता कंट्रोलर ने ली है. अगर यह प्रोसेस पूरी हो जाती है, तो सदस्यता स्वीकार कर ली जाती है और ब्राउज़र को सूचना देने के लिए,notifyChildrenChanged()को तुरंत कॉल किया जाता है (#561).- Automotive OS के लिए सेशन डेमो मॉड्यूल जोड़ें और Android Auto के लिए सेशन डेमो चालू करें.
- जब मीडिया सूचना कंट्रोलर के लिए
COMMAND_GET_TIMELINEउपलब्ध न हो, तब फ़्रेमवर्क सेशन की सूची सेट न करें. Android Auto, क्लाइंट कंट्रोलर के तौर पर फ़्रेमवर्क सेशन से डेटा को पढ़ता है. इस वजह से, Android Auto के यूज़र इंटरफ़ेस (यूआई) मेंqueueबटन नहीं दिखता (#339). SimpleBitmapLoaderके बजाय, डिफ़ॉल्ट रूप सेDataSourceBitmapLoaderका इस्तेमाल करें (#271, #327).MediaSession.Callback.onMediaButtonEvent(Intent)जोड़ें, ताकि ऐप्लिकेशन, मीडिया बटन इवेंट को हैंडल करने के डिफ़ॉल्ट तरीके को बदल सकें.
- यूज़र इंटरफ़ेस (यूआई):
- Wear OS डिवाइसों के लिए,
Player.Listenerलागू करें.इससेPlayer.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUTकी वजह से ऑडियो न चलने की समस्या को ठीक किया जा सकता है. इसके लिए, सिस्टम डायलॉग लॉन्च करें, ताकि उपयोगकर्ता सही ऑडियो आउटपुट (जैसे, ब्लूटूथ हेडफ़ोन) कनेक्ट कर सके. अगर कॉन्फ़िगर किए जा सकने वाले टाइम आउट (डिफ़ॉल्ट रूप से पांच मिनट) के अंदर कोई सही डिवाइस कनेक्ट हो जाता है, तो लिसनर अपने-आप वीडियो चलाना फिर से शुरू कर देगा.
- Wear OS डिवाइसों के लिए,
- डाउनलोड:
DownloadServiceको Android 14 के साथ काम करने लायक बनाने के लिए, "डेटा सिंक" फ़ोरग्राउंड सेवा टाइप का एलान करें. इस सेवा का इस्तेमाल करते समय, ऐप्लिकेशन को मेनिफ़ेस्ट मेंdataSyncकोforegroundServiceTypeके तौर पर जोड़ना होगा. साथ ही,FOREGROUND_SERVICE_DATA_SYNCअनुमति (#11239) जोड़नी होगी.
- एचएलएस एक्सटेंशन:
- एचएलएस लाइव प्लेलिस्ट को रीफ़्रेश करने के लिए, लोड होने के आखिरी समय के बजाय, लोड होने के आखिरी शुरू होने के समय से कैलकुलेट किए गए इंटरवल का इस्तेमाल करें (#663).
- DASH एक्सटेंशन:
- सेगमेंट टेंप्लेट यूआरएल में, एक ही DASH आइडेंटिफ़ायर को कई बार इस्तेमाल करने की अनुमति दें.
- एक्सट्रैक्शन के दौरान सबटाइटल पार्स करने के लिए, एक्सपेरिमेंट के तौर पर सहायता जोड़ें. इसमें, ओवरलैप होने वाले सबटाइटल को मर्ज करने के लिए बेहतर सहायता मिलती है. इसमें सबटाइटल सेगमेंट के बीच ट्रांज़िशन के दौरान, फ़्लिकरिंग की समस्या को हल करना भी शामिल है.
DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction()(#288) का इस्तेमाल करके, इस सुविधा को चालू किया जा सकता है.
- आरटीएसपी एक्सटेंशन:
- हमने एक ऐसी रेस कंडिशन को ठीक किया है जिसकी वजह से टीसीपी पर वापस जाने पर,
IndexOutOfBoundsExceptionकी समस्या आ सकती थी या कुछ मामलों में वीडियो रुक सकता था. RtspMediaPeriod(#577) की लोडिंग स्थिति को वापस करते समय, आरटीएसपी सेटअप में स्थिति की जांच करें.- विकल्पों के जवाब के सार्वजनिक हेडर में, कस्टम आरटीएसपी अनुरोध के तरीकों को अनदेखा करें (#613).
- आरटीएसपी सेटअप रिस्पॉन्स टाइम आउट वैल्यू का इस्तेमाल, कीप-अलाइव आरटीएसपी विकल्प के अनुरोध भेजने के समयांतराल में करें (#662).
- हमने एक ऐसी रेस कंडिशन को ठीक किया है जिसकी वजह से टीसीपी पर वापस जाने पर,
- डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1, MIDI वगैरह):
- एमआईडीआई डिकोडर मॉड्यूल को रिलीज़ करें. यह मॉड्यूल, ऑडियो को सिंथेसाइज़ करने के लिए Jsyn लाइब्रेरी का इस्तेमाल करके, स्टैंडर्ड एमआईडीआई फ़ाइलों को चलाने की सुविधा देता है.
DecoderOutputBuffer.shouldBeSkippedजोड़ें, ताकि उन आउटपुट बफ़र को सीधे तौर पर मार्क किया जा सके जिन्हें दिखाने की ज़रूरत नहीं है. इसे के मुकाबले ज़्यादा प्राथमिकता दी जाती है.C.BUFFER_FLAG_DECODE_ONLYको बंद कर दिया जाएगा.Decoder.setOutputStartTimeUsऔरSimpleDecoder.isAtLeastOutputStartTimeUsजोड़ें, ताकि डिकोडर, शुरू होने के समय से पहले सिर्फ़ डिकोड किए जाने वाले सैंपल को हटा सकें. के बजाय, इस एट्रिब्यूट का इस्तेमाल करना चाहिए.Buffer.isDecodeOnlyएट्रिब्यूट को बंद कर दिया जाएगा.- Maven रिपॉज़िटरी में एमआईडीआई डिकोडर आर्टफ़ैक्ट पब्लिश करने से जुड़ी गड़बड़ी को ठीक किया गया. आर्टफ़ैक्ट का नाम बदलकर
media3-exoplayer-midiकिया गया (#734).
- लीनबैक एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, किसी प्लैटफ़ॉर्म को बंद करने पर Leanback कोड (#617) में
ArithmeticExceptionहो सकता है.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, किसी प्लैटफ़ॉर्म को बंद करने पर Leanback कोड (#617) में
- टेस्ट यूटिलिटी:
TestExoPlayerBuilderऔरFakeClockको Espresso यूज़र इंटरफ़ेस (यूआई) टेस्ट और 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 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.2.0-beta01
19 अक्टूबर, 2023
1.2.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.2.0-alpha02
29 सितंबर, 2023
1.2.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.2.0-alpha01
17 अगस्त, 2023
1.2.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.1.0
वर्शन 1.1.1
16 अगस्त, 2023
- कॉमन लाइब्रेरी:
- सभी मॉड्यूल से गलती से जोड़ी गई
multidexडिपेंडेंसी को हटाया गया (#499).
- सभी मॉड्यूल से गलती से जोड़ी गई
- ExoPlayer:
PlaybackStatsListenerमें मौजूद उस समस्या को ठीक किया गया है जिसकी वजह से प्लेलिस्ट को मिटाने के बाद, नकलीPlaybackStatsबन जाते थे.- कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) लॉगिंग में अतिरिक्त फ़ील्ड जोड़े गए: स्ट्रीमिंग फ़ॉर्मैट (sf), स्ट्रीम टाइप (st), वर्शन (v), टॉप बिटरेट (tb), ऑब्जेक्ट की अवधि (d), मेज़र्ड थ्रूपुट (mtp), और ऑब्जेक्ट टाइप (ot) (#8699).
- ऑडियो:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से बहुत छोटी फ़ाइलें चलाने पर,
Player.getState()कभी भीSTATE_ENDEDमें ट्रांज़िशन नहीं होता था (#538).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से बहुत छोटी फ़ाइलें चलाने पर,
- ऑडियो ऑफ़लोड:
- आरएफ़सी 7845 के मुताबिक, ऑफ़लोड किए गए Opus प्लेबैक के लिए, बिटस्ट्रीम में Ogg आईडी हेडर और टिप्पणी हेडर पेज जोड़ें.
- वीडियो:
- H.265/HEVC: एसपीएस की कम और ज़्यादा अवधि वाली रेफ़रंस पिक्चर की जानकारी को पार्स करने से जुड़ी समस्या को ठीक किया गया.
- टेक्स्ट:
- CEA-608: कैप्शन के कटने से जुड़े लॉजिक में बदलाव किया गया है, ताकि सिर्फ़ दिखने वाले टेक्स्ट को ही ध्यान में रखा जाए. पहले, क्यू की लंबाई को 32 वर्णों तक सीमित करते समय, इंडेंट और टैब ऑफ़सेट को शामिल किया जाता था. तकनीकी तौर पर, यह स्पेसिफ़िकेशन के हिसाब से सही था (#11019).
- आईएमए एक्सटेंशन:
- IMA SDK टूल के वर्शन को 3.30.3 पर बंप करें.
- सेशन:
- कंट्रोलर की स्थिति में कस्टम लेआउट जोड़ें और उसे ऐक्सेस करने के लिए, एक गेटर उपलब्ध कराएं. कस्टम लेआउट में बदलाव होने पर,
MediaController.Listener.onCustomLayoutChangedको कॉल किया जाता है. अगर किसी ऐप्लिकेशन को अलग-अलग Media3 कंट्रोलर को अलग-अलग कस्टम लेआउट भेजने हैं, तो वहMediaSession.Callback.onConnectमें ऐसा कर सकता है. इसके लिए, उसेAcceptedResultBuilderका इस्तेमाल करना होगा. इससे यह पक्का किया जा सकेगा कि कनेक्शन पूरा होने पर, कंट्रोलर के लिए कस्टम लेआउट उपलब्ध हो. - उन मामलों को ठीक किया गया जिनमें
MediaLibraryServiceLegacyStubने किसी ऐसेResultको गड़बड़ी का मैसेज भेजा जो इसे सपोर्ट नहीं करता था. इसकी वजह से,UnsupportedOperationException(#78) गड़बड़ी हुई. PlayerWrapperकेVolumeProviderCompatबनाने के तरीके को ठीक किया गया. इसके लिए, लेगसी कमांड (COMMAND_ADJUST_DEVICE_VOLUMEऔरCOMMAND_SET_DEVICE_VOLUME) और नए कमांड (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGSऔरCOMMAND_SET_DEVICE_VOLUME_WITH_FLAGS), दोनों के ज़रिएvolumeControlTypeतय किया गया (#554).
- कंट्रोलर की स्थिति में कस्टम लेआउट जोड़ें और उसे ऐक्सेस करने के लिए, एक गेटर उपलब्ध कराएं. कस्टम लेआउट में बदलाव होने पर,
वर्शन 1.1.0
5 जुलाई, 2023
- कॉमन लाइब्रेरी:
- ऑडियो रूट सही न होने पर, ऑडियो को दबाने की वजह जोड़ें और तैयार होने पर चलाएं. ऑडियो को दबाने की वजह बदलें. #15.
- प्लेयर में निर्देश जोड़ना:
COMMAND_GET_METADATACOMMAND_SET_PLAYLIST_METADATACOMMAND_SET_DEVICE_VOLUME_WITH_FLAGSCOMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
- प्लेयर में ओवरलोड किए गए तरीके जोड़ें, ताकि उपयोगकर्ता वॉल्यूम फ़्लैग तय कर सकें:
void setDeviceVolume(int, int)void increaseDeviceVolume(int)void decreaseDeviceVolume(int)void setDeviceMuted(boolean, int)
DeviceInfoके लिएBuilderजोड़ा गया और मौजूदा कंस्ट्रक्टर को बंद किया गया.- रिमोट प्लेबैक के लिए, रूटिंग कंट्रोलर आईडी की जानकारी देने के लिए
DeviceInfo.routingControllerIdजोड़ें. - एक ही जगह पर आइटम जोड़ने और हटाने के लिए,
Player.replaceMediaItem(s)को शॉर्टकट के तौर पर जोड़ें (#8046).
- ExoPlayer:
- ExoPlayer को डिवाइस के वॉल्यूम को कंट्रोल करने की अनुमति सिर्फ़ तब दें, जब साफ़ तौर पर इसके लिए ऑप्ट इन किया गया हो.
ExoPlayer.Builder.setDeviceVolumeControlEnabledका इस्तेमाल करके, इन्हें ऐक्सेस करें:getDeviceVolume()isDeviceMuted()setDeviceVolume(int)औरsetDeviceVolume(int, int)increaseDeviceVolume(int)औरincreaseDeviceVolume(int, int)decreaseDeviceVolume(int)औरdecreaseDeviceVolume(int, int)
FilteringMediaSourceजोड़ें, जोMediaSourceसे उपलब्ध ट्रैक टाइप को फ़िल्टर करने की अनुमति देता है.- अडैप्टिव स्ट्रीमिंग फ़ॉर्मैट DASH, HLS, और SmoothStreaming के आउटगोइंग अनुरोधों में, कॉमन मीडिया क्लाइंट डेटा (सीएमसीडी) शामिल करने की सुविधा जोड़ी गई है. इन फ़ील्ड को शामिल किया गया है:
br,bl,cid,rtp, औरsid(#8699). एपीआई का स्ट्रक्चर और एपीआई के तरीके:- सीएमसीडी लॉगिंग की सुविधा डिफ़ॉल्ट रूप से बंद होती है. इसे चालू करने के लिए,
MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory)का इस्तेमाल करें. - डिफ़ॉल्ट रूप से, सभी बटन चालू होते हैं.
CmcdConfiguration.RequestConfig.isKeyAllowed(String key)को ओवरराइड करके, यह फ़िल्टर किया जा सकता है कि कौनसे बटन लॉग किए जाएं. - कस्टम की लॉगिंग की सुविधा चालू करने के लिए,
CmcdConfiguration.RequestConfig.getCustomData()को बदलें.
- सीएमसीडी लॉगिंग की सुविधा डिफ़ॉल्ट रूप से बंद होती है. इसे चालू करने के लिए,
- कस्टम
*.exolist.jsonफ़ाइल (#439) की मदद से, डेमो ऐप्लिकेशन को आसानी से शुरू करने के लिए, मुख्य डेमो के मेनिफ़ेस्ट में अतिरिक्त कार्रवाई जोड़ें. - वीडियो चलाने के दौरान
Effectका इस्तेमाल करने के लिए,ExoPlayer.setVideoEffects()जोड़ें. SampleQueueको अपडेट करें, ताकिsourceIdकोlongके तौर पर सेव किया जा सके, न किintके तौर पर. इससे सार्वजनिक तरीकोंSampleQueue.sourceIdऔरSampleQueue.peekSourceIdके सिग्नेचर बदल जाते हैं.LoadControlतरीकोंshouldStartPlaybackऔरonTracksSelectedमें पैरामीटर जोड़ें, ताकि इन तरीकों को काम केMediaPeriodसे जोड़ा जा सके.ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>)के सिग्नेचर को बदलें. इसके लिए, टाइमलाइन पैरामीटर जोड़ें. इसमें मैप में कुंजियों के तौर पर इस्तेमाल किए गए यूआईडी के साथ-साथ, समयावधियां भी शामिल होनी चाहिए. एक से ज़्यादा पीरियड वाली लाइव स्ट्रीम में, एक साथ कई अनुरोधों को प्रोसेस करने से जुड़ी समस्याओं से बचने के लिए, ऐसा करना ज़रूरी है.EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs)औरBaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs)का बहिष्कार करें. इसके बजाय,mediaTimeOffsetUsके बिना तरीकों के वैरिएंट को कॉल किया जा सकता है. ध्यान दें कि अब काम न करने वाले वैरिएंट के लिए भी, ऑफ़सेट को डिस्पैचर से भेजे गएMediaLoadDataऑब्जेक्ट केstartTimeUsऔरendTimeUsमें नहीं जोड़ा जाता है.ExoTrackSelection.blacklistका नाम बदलकरexcludeTrackऔरisBlacklistedका नाम बदलकरisTrackExcludedकरें.- खाली प्लेलिस्ट पर कॉल किए जाने पर,
ExoPlayer.setMediaItem(s)औरaddMediaItem(s)के बीच के अलग-अलग व्यवहार को ठीक करें.
- ExoPlayer को डिवाइस के वॉल्यूम को कंट्रोल करने की अनुमति सिर्फ़ तब दें, जब साफ़ तौर पर इसके लिए ऑप्ट इन किया गया हो.
- ट्रांसफ़ॉर्मर:
Transformer.Builder.setMediaSourceFactory(MediaSource.Factory)हटाएं. इसके बजाय,ExoPlayerAssetLoader.Factory(MediaSource.Factory)औरTransformer.Builder.setAssetLoaderFactory(AssetLoader.Factory)का इस्तेमाल करें.Transformer.startTransformation(MediaItem, ParcelFileDescriptor)हटाएं.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, वीडियो स्ट्रीम के खत्म होने का सिग्नल मिलने पर, ट्रांसफ़ॉर्मेशन की प्रोसेस रुक सकती थी. ऐसा तब होता था, जब इनपुट फ़्रेम को प्रोसेस किया जाना बाकी हो. इसकी वजह से, मक्सर टाइम आउट हो जाता था.
- ज़्यादा डिवाइसों पर काम करने के लिए,
findDecoder/EncoderForFormatयूटिलिटी के बजायMediaCodecListकी मदद से कोडेक के बारे में क्वेरी करें. DefaultEncoderFactoryमें बी-फ़्रेम कॉन्फ़िगरेशन हटाएं, क्योंकि यह कुछ डिवाइसों पर काम नहीं करता.
- ट्रैक चुनना:
DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChangeजोड़ें, जो डिफ़ॉल्ट रूप से बंद है. चालू होने पर, रेंडरर की क्षमताओं में बदलाव होने परDefaultTrackSelectorएक नया ट्रैक चुनने की प्रोसेस को ट्रिगर करेगा.
- एक्सट्रैक्टर:
- ऑडियो:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से टनलिंग चालू होने और
AudioProcessorsके चालू होने पर, कुछ वीडियो नहीं चलते. उदाहरण के लिए, गैपलेस ट्रिमिंग के लिए (#10847). - डायरेक्ट प्लेबैक (ऑफ़लोड) में, Ogg पैकेट में Opus फ़्रेम को शामिल करें.
- स्लीप मोड के दौरान, ऑफ़लोड शेड्यूलिंग की मदद से मौजूदा पोज़िशन का अनुमान लगाना.
- प्लेयर के लाइफ़साइकल के आखिर में संसाधनों को रिलीज़ करने के लिए,
Renderer.release()औरAudioSink.release()जोड़ें. DefaultAudioSinkमें ऑडियो की सुविधाओं में हुए बदलावों को सुनें.DefaultAudioSinkके कंस्ट्रक्टर में ज़रूरी पैरामीटरcontextजोड़ें. इससेDefaultAudioSink,AudioCapabilitiesReceiverके लिसनर के तौर पर रजिस्टर हो जाएगा. साथ ही, क्षमताओं में बदलाव की सूचना मिलने पर, इसकीaudioCapabilitiesप्रॉपर्टी अपडेट हो जाएगी.onAudioCapabilitiesChangedमेंAudioSink.Listenerइंटरफ़ेस में नए इवेंट के ज़रिए, ऑडियो की सुविधाओं में हुए बदलावों को लागू करें. साथ ही, नया इंटरफ़ेसRendererCapabilities.Listener, जोonRendererCapabilitiesChangedइवेंट को ट्रिगर करता है.- ऑडियो चैनलों को स्केल/मिक्स करने के लिए,
ChannelMixingAudioProcessorजोड़ें. DecoderDiscardReasonsमें नई इंट वैल्यूDISCARD_REASON_AUDIO_BYPASS_POSSIBLEजोड़ें, ताकि ऑडियो की क्षमताएं बदलने के बाद, बायपास मोड चालू होने पर ऑडियो डिकोडर को खारिज किया जा सके.- DTS Express और DTS:X के लिए, डायरेक्ट प्लेबैक की सुविधा जोड़ी गई (#335).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से टनलिंग चालू होने और
- वीडियो:
- रेंडरर के बंद होने पर,
MediaCodecVideoRendererको 0 चौड़ाई और ऊंचाई वालाVideoSizeरिपोर्ट करने के लिए कहें.Player.getVideoSize()में बदलाव होने पर,Player.Listener.onVideoSizeChangedको कॉल किया जाता है. इस बदलाव के बाद,MediaCodecVideoRendererके साथ ExoPlayer के वीडियो साइज़ की चौड़ाई और ऊंचाई 0 होगी. ऐसा तब होगा, जबPlayer.getCurrentTracksवीडियो के साथ काम न करता हो या वीडियो ट्रैक का साइज़ तय न किया गया हो.
- रेंडरर के बंद होने पर,
- डीआरएम:
DefaultDrmSessionपर, सिर्फ़ अंदरूनी तौर पर इस्तेमाल होने वाले कई तरीकों की विज़िबिलिटी कम करें. ऐसा इसलिए, क्योंकि डीआरएम पैकेज के बाहर से इन्हें कॉल किए जाने की उम्मीद नहीं है:void onMediaDrmEvent(int)void provision()void onProvisionCompleted()onProvisionError(Exception, boolean)
- मक्सर:
- एक नई मक्सर लाइब्रेरी जोड़ें, जिसका इस्तेमाल MP4 कंटेनर फ़ाइल बनाने के लिए किया जा सके.
- आईएमए एक्सटेंशन:
- डीएआई के लिए, मल्टी-पीरियड लाइव DASH स्ट्रीम चालू करें. #10912: कृपया ध्यान दें कि मौजूदा वर्शन में, लाइव स्ट्रीम में आगे-पीछे जाने की सुविधा अब भी काम नहीं करती.
- उस गड़बड़ी को ठीक करना जिसकी वजह से लाइव स्ट्रीम में नया विज्ञापन ग्रुप जुड़ जाता है. ऐसा इसलिए होता है, क्योंकि लगातार टाइमलाइन में कॉन्टेंट की कैलकुलेट की गई पोज़िशन में थोड़ा अंतर होता है.
- सेशन:
MediaSession.getControllerForCurrentRequestहेल्पर मेथड जोड़ें, ताकि उस कंट्रोलर के बारे में जानकारी मिल सके जो फ़िलहालPlayerमेथड को कॉल कर रहा है.androidx.media3.session.MediaButtonReceiverको जोड़ें, ताकि ऐप्लिकेशन, जहां छोड़ा था वहीं से प्लेबैक की सुविधा लागू कर सकें. इसके लिए, ब्लूटूथ हेडसेट जैसे किसी डिवाइस से भेजे गए मीडिया बटन इवेंट का इस्तेमाल किया जा सकता है (#167).MediaSession.Callback.onAddMediaItemsमें डिफ़ॉल्ट इंप्लिमेंटेशन जोड़ें, ताकि अनुरोध किए गएMediaItemsकोPlayerमें पास किया जा सके. ऐसा तब किया जा सकता है, जब उनके पासLocalConfiguration(जैसे, यूआरआई) हो (#282).- Android 12 और इससे पहले के वर्शन के लिए, डिफ़ॉल्ट रूप से कॉम्पैक्ट मीडिया सूचना व्यू में "पिछले पर जाएं" और "अगले पर जाएं" कमांड बटन जोड़ें (#410).
MediaSession.Callback.onAddMediaItemsमें डिफ़ॉल्ट इंप्लिमेंटेशन जोड़ें, ताकि अनुरोध किए गएMediaItemsकोPlayerमें पास किया जा सके. ऐसा तब किया जा सकता है, जब उनके पासLocalConfiguration(जैसे, यूआरआई) हो (#282).- Android 12 और इससे पहले के वर्शन के लिए, डिफ़ॉल्ट रूप से मीडिया सूचना के कॉम्पैक्ट व्यू में "पिछले आइटम पर जाएं" और "अगले आइटम पर जाएं" कमांड बटन जोड़ें (#410).
- यूज़र इंटरफ़ेस (यूआई):
- प्ले/पॉज़ बटन के साथ कस्टम यूज़र इंटरफ़ेस (यूआई) एलिमेंट लिखने के लिए, Util तरीके
shouldShowPlayButtonऔरhandlePlayPauseButtonActionजोड़ें.
- प्ले/पॉज़ बटन के साथ कस्टम यूज़र इंटरफ़ेस (यूआई) एलिमेंट लिखने के लिए, Util तरीके
- आरटीएसपी एक्सटेंशन:
- DASH एक्सटेंशन:
- मल्टी पीरियड DASH स्ट्रीम के लिए,
MediaLoadData.startTimeMsऔरMediaLoadData.endTimeMsसे मीडिया टाइम ऑफ़सेट हटाएं. - उस गड़बड़ी को ठीक किया गया है जिसमें कई समयावधि वाले लाइव डैश मीडिया सोर्स को फिर से तैयार करने पर,
IndexOutOfBoundsException(#10838) जनरेट होता था.
- मल्टी पीरियड DASH स्ट्रीम के लिए,
- एचएलएस एक्सटेंशन:
HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long)जोड़ें, ताकि लोडिंग थ्रेड के लिए टाइम आउट सेट किया जा सके. इससे,TimestampAdjusterके शुरू होने तक इंतज़ार किया जा सकेगा. अगर टाइम आउट से पहले, इनिशलाइज़ेशन पूरा नहीं होता है, तो वीडियो को लगातार रुकने से बचाने के लिए,PlaybackExceptionको थ्रो किया जाता है. टाइम आउट को डिफ़ॉल्ट रूप से शून्य पर सेट किया गया है (#323).
- टेस्ट यूटिलिटी:
DataSourceContractTestमें यूआरआई स्कीम के केस इनसेंसिटिविटी की जांच करें.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
DefaultAudioSinkकंस्ट्रक्टर हटाएं. इसके बजाय,DefaultAudioSink.Builderका इस्तेमाल करें.HlsMasterPlaylistको हटाएं और इसके बजायHlsMultivariantPlaylistका इस्तेमाल करें.Player.stop(boolean)हटाएं. इसके बजाय,Player.stop()औरPlayer.clearMediaItems()(अगरreset,trueहै) का इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके दो
SimpleCacheकंस्ट्रक्टर हटाएं. बेहतर परफ़ॉर्मेंस के लिए, इस्तेमाल में मौजूद ऐसे कंस्ट्रक्टर का इस्तेमाल करें जोDatabaseProviderलेता हो. DefaultBandwidthMeterकंस्ट्रक्टर को हटाएं और इसके बजाय,DefaultBandwidthMeter.Builderका इस्तेमाल करें.DefaultDrmSessionManagerकंस्ट्रक्टर हटाएं. इसके बजाय,DefaultDrmSessionManager.Builderका इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके दो
HttpDataSource.InvalidResponseCodeExceptionकंस्ट्रक्टर हटाएं. इसके बजाय, इस्तेमाल में मौजूद ऐसे कंस्ट्रक्टर का इस्तेमाल करें जो गड़बड़ी की जानकारी को बेहतर तरीके से लॉग करने के लिए, अतिरिक्त फ़ील्ड (cause,responseBody) स्वीकार करता हो. DownloadHelper.forProgressive,DownloadHelper.forHls,DownloadHelper.forDash, औरDownloadHelper.forSmoothStreamingको हटाएं. इसके बजाय,DownloadHelper.forMediaItemका इस्तेमाल करें.- अब काम न करने वाले
DownloadServiceकंस्ट्रक्टर को हटाएं. इसके बजाय, ऐसे कंस्ट्रक्टर का इस्तेमाल करें जो अब भी काम करता हो और जिसमेंchannelDescriptionResourceIdपैरामीटर देने का विकल्प शामिल हो. - चारसेट के लिए, अब काम न करने वाले स्ट्रिंग कॉन्सटैंट (
ASCII_NAME,UTF8_NAME,ISO88591_NAME,UTF16_NAME, औरUTF16LE_NAME) हटाएं. इसके बजाय,kotlin.textपैकेज,java.nio.charset.StandardCharsetsयाcom.google.common.base.Charsetsसे Kotlin चारसेट का इस्तेमाल करें. - अब काम न करने वाले
WorkManagerSchedulerकंस्ट्रक्टर को हटाएं. इसके बजाय, ऐसे कंस्ट्रक्टर का इस्तेमाल करें जो अब भी काम करता हो और जिसमेंContextपैरामीटर देने का विकल्प शामिल हो. createVideoSampleFormat,createAudioSampleFormat,createContainerFormat, औरcreateSampleFormatजैसे अब इस्तेमाल नहीं किए जा रहे तरीकों को हटाएं. इनका इस्तेमाल,Formatक्लास को इंस्टैंशिएट करने के लिए किया जाता था. इसके बजाय,Formatके इंस्टेंस बनाने के लिएFormat.Builderका इस्तेमाल करें.- अब इस्तेमाल नहीं किए जा रहे तरीके
copyWithMaxInputSize,copyWithSubsampleOffsetUs,copyWithLabel,copyWithManifestFormatInfo,copyWithGaplessInfo,copyWithFrameRate,copyWithDrmInitData,copyWithMetadata,copyWithBitrate, औरcopyWithVideoSizeहटाएं. इसके बजाय,Format.buildUpon()और सेटर तरीके इस्तेमाल करें. - इस्तेमाल से बाहर हो चुके
ExoPlayer.retry()को हटाएं और इसके बजायprepare()का इस्तेमाल करें. - अब इस्तेमाल नहीं किए जा रहे ज़ीरो-आर्ग्युमेंट
DefaultTrackSelectorकंस्ट्रक्टर को हटाएं. इसके बजाय,DefaultTrackSelector(Context)का इस्तेमाल करें. OfflineLicenseHelperकंस्ट्रक्टर को हटाएं, क्योंकि इसके इस्तेमाल पर रोक लगा दी गई है. इसके बजाय,OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)का इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके
DownloadManagerकंस्ट्रक्टर को हटाएं. इसके बजाय, उस कंस्ट्रक्टर का इस्तेमाल करें जोExecutorलेता है. Cueके बंद हो चुके कंस्ट्रक्टर हटाएं और इसके बजायCue.Builderका इस्तेमाल करें.OfflineLicenseHelperकंस्ट्रक्टर को हटाएं, क्योंकि इसके इस्तेमाल पर रोक लगा दी गई है. इसके बजाय,OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)का इस्तेमाल करें.AnalyticsListenerके इस्तेमाल से बाहर हो चुके चार तरीके हटाएं:onDecoderEnabled, इसके बजायonAudioEnabledऔर/याonVideoEnabledका इस्तेमाल करें.onDecoderInitialized, इसके बजायonAudioDecoderInitializedऔर/याonVideoDecoderInitializedका इस्तेमाल करें.onDecoderInputFormatChanged, इसके बजायonAudioInputFormatChangedऔर/याonVideoInputFormatChangedका इस्तेमाल करें.onDecoderDisabled, इसके बजायonAudioDisabledऔर/याonVideoDisabledका इस्तेमाल करें.
- इस्तेमाल से बाहर हो चुके
Player.Listener.onSeekProcessedऔरAnalyticsListener.onSeekProcessedको हटाएं. इसके बजाय,onPositionDiscontinuityके साथDISCONTINUITY_REASON_SEEKका इस्तेमाल करें. ExoPlayer.setHandleWakeLock(boolean)को हटाएं और इसके बजाय,setWakeMode(int)का इस्तेमाल करें.- इस्तेमाल से बाहर हो चुके
DefaultLoadControl.Builder.createDefaultLoadControl()को हटाएं और इसके बजायbuild()का इस्तेमाल करें. MediaItem.PlaybackPropertiesको हटाएं, क्योंकि इसके इस्तेमाल पर रोक लगा दी गई है. इसके बजाय,MediaItem.LocalConfigurationका इस्तेमाल करें.MediaItem.playbackPropertiesएट्रिब्यूट की वैल्यू के तौर पर दिया गया फ़ील्ड अब काम नहीं करता. अब इसकी जगहMediaItem.LocalConfigurationएट्रिब्यूट का इस्तेमाल करें.
वर्शन 1.1.0-rc01
21 जून, 2023
1.1.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.1.0-beta01
7 जून, 2023
1.1.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.1.0-alpha01
10 मई, 2023
1.1.0 स्टेबल वर्शन का इस्तेमाल करें.
वर्शन 1.0.0
वर्शन 1.0.2
18 मई, 2023
androidx.media3:media3-*:1.0.2 रिलीज़ हो गया है. वर्शन 1.0.2 में ये कमिट शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.7 रिलीज़ से जुड़ी है.
इस रिलीज़ में, 1.0.1 रिलीज़ के बाद से ये बदलाव किए गए हैं:
- कोर लाइब्रेरी:
Buffer.isLastSample()जोड़ें, जो यह बताता है किBufferमें फ़्लैगC.BUFFER_FLAG_LAST_SAMPLEशामिल है या नहीं.- उस समस्या को ठीक किया गया है जिसमें फ़्रेम वाले आखिरी सैंपल को 'स्ट्रीम के आखिर' वाले सैंपल को पढ़े बिना सूची से हटाए जाने पर, आखिरी फ़्रेम रेंडर नहीं हो पाता था. (#11079).
- एक्सट्रैक्टर:
- MPEG-TS फ़ाइलों में H.265 एसपीएस को पार्स करने की समस्या को ठीक किया गया. इसके लिए, आरटीएसपी और MP4 एक्सट्रैक्टर (#303) के इस्तेमाल किए गए पार्सिंग लॉजिक को फिर से इस्तेमाल किया गया.
- टेक्स्ट:
- SSA: UTF-16 फ़ाइलों के लिए सहायता जोड़ी गई. हालांकि, इसके लिए ज़रूरी है कि वे बाइट ऑर्डर मार्क (#319) से शुरू हों.
- सेशन:
- उस समस्या को ठीक करना जिसमें
MediaController, उपलब्ध निर्देशों को अपडेट नहीं करता है. ऐसा तब होता है, जब वह किसी ऐसे लेगसीMediaSessionCompatसे कनेक्ट होता है जो अपनी कार्रवाइयों को अपडेट करता है. - उस गड़बड़ी को ठीक किया गया जिसकी वजह से, एपीआई 30 पर
params.isRecent == trueके साथ सिस्टम यूज़र इंटरफ़ेस (यूआई) सेCallback.onGetLibraryRootको किए गए कॉल के लिए,MediaLibraryServiceको शून्य वैल्यू दिखाने से रोका जा रहा था (#355). MediaSessionServiceयाMediaLibraryServiceकी मेमोरी लीक की समस्या को ठीक किया गया (#346).- उस गड़बड़ी को ठीक किया गया है जिसमें
MediaSessionमेंTimelineऔर पोज़िशन को एक साथ अपडेट करने पर,MediaControllerमेंIllegalStateExceptionदिख सकता है.
- उस समस्या को ठीक करना जिसमें
वर्शन 1.0.1
18 अप्रैल, 2023
androidx.media3:media3-*:1.0.1 रिलीज़ हो गया है. वर्शन 1.0.1 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.6 रिलीज़ के मुताबिक है.
- कोर लाइब्रेरी:
- डिफ़ॉल्ट पोज़िशन पर जाने के दौरान, टारगेट लाइव स्ट्रीम ओवरराइड को रीसेट करें (#11051).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मीडिया में खाली सैंपल स्ट्रीम होने पर वीडियो रुक जाता था.
- सेशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, लेगसी
MediaSessionCompatसे पब्लिश किए गए एक जैसे कई सूची आइटम,MediaControllerमें अपवाद के तौर पर दिखते थे (#290). MediaSession.broadcastCustomCommandके लिए, लेगसीMediaControllerCompat.Callback.onSessionEventपर फ़ॉरवर्ड करने की सुविधा जोड़ें (#293).- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
MediaSession.setPlayerको कॉल करने पर, उपलब्ध कमांड अपडेट नहीं होते थे. TrackSelectionOverrideसे भेजे गए इंस्टेंस को अनदेखा करने की समस्या को ठीक किया गया. ऐसा तब होता है, जब वेFormat.metadataवाले ग्रुप को रेफ़र करते हैं (#296).MediaController- उस समस्या को ठीक किया गया जिसमें लेगसी
MediaSessionCompatके ज़रिए मेटाडेटा ऐक्सेस करने के लिए,Player.COMMAND_GET_CURRENT_MEDIA_ITEMका उपलब्ध होना ज़रूरी था. - उस समस्या को ठीक किया गया है जिसमें बैकग्राउंड थ्रेड पर
MediaSessionके इंस्टेंस की वजह से,MediaSessionServiceमें इस्तेमाल किए जाने पर क्रैश होने की समस्या आती थी (#318). - उस समस्या को ठीक किया गया है जिसमें लाइब्रेरी ने मीडिया बटन रिसीवर का एलान किया था, लेकिन ऐप्लिकेशन का ऐसा कोई इरादा नहीं था (#314).
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, लेगसी
- DASH:
- खाली सेगमेंट की टाइमलाइन को मैनेज करने से जुड़ी समस्या को ठीक किया गया (#11014).
- आरटीएसपी:
- अगर यूडीपी के साथ आरटीएसपी सेटअप, आरटीएसपी गड़बड़ी 461 UnsupportedTransport (#11069) की वजह से काम नहीं करता है, तो टीसीपी के साथ फिर से कोशिश करें.
वर्शन 1.0.0
22 मार्च, 2023
androidx.media3:media3-*:1.0.0 रिलीज़ हो गया है. वर्शन 1.0.0 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.5 रिलीज़ से जुड़ी है.
1.0.0-rc02 के बाद से कोई बदलाव नहीं किया गया है.
वर्शन 1.0.0-rc02
2 मार्च, 2023
androidx.media3:media3-*:1.0.0-rc02 रिलीज़ हो गया है. वर्शन 1.0.0-rc02 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.4 रिलीज़ से जुड़ी है.
- कोर लाइब्रेरी:
- डाउनलोड:
- मर्ज किए जाने वाले दो सेगमेंट के शुरू होने के समय के बीच के ज़्यादा से ज़्यादा अंतर को
SegmentDownloaderऔर सबक्लास (#248) में कॉन्फ़िगर किया जा सकता है.
- मर्ज किए जाने वाले दो सेगमेंट के शुरू होने के समय के बीच के ज़्यादा से ज़्यादा अंतर को
- ऑडियो:
- वीडियो:
- HEVC HDR10 फ़ॉर्मैट को
HEVCProfileMain10के बजायHEVCProfileMain10HDR10पर मैप करें. - Chromecast with Google TV और Lenovo M10 FHD Plus पर डिवाइस से जुड़ी समस्या को हल करने का तरीका जोड़ें. इस समस्या की वजह से, 60fps एवीसी स्ट्रीम को 'इस्तेमाल नहीं किया जा सकता' के तौर पर मार्क किया जाता है (#10898).
- स्क्रीन के रीफ़्रेश रेट से ज़्यादा फ़्रेम रेट वाले मीडिया को चलाते समय, फ़्रेम रिलीज़ की परफ़ॉर्मेंस से जुड़ी समस्याएं ठीक करना.
- HEVC HDR10 फ़ॉर्मैट को
- कास्ट:
- एक मीडिया आइटम से दूसरे पर जाने के दौरान, कुछ समय के लिए दिखने वाले
STATE_IDLEको ठीक किया गया (#245).
- एक मीडिया आइटम से दूसरे पर जाने के दौरान, कुछ समय के लिए दिखने वाले
- आरटीएसपी:
- अमान्य आरटीएसपी को पार्स करने के दौरान, IllegalArgumentException को पकड़ें जवाब के मैसेज के बारे में बताएं (#10971).
- सेशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से प्लेयर की स्थिति के साथ, सूचना में मौजूद वीडियो चलाने/रोकने का बटन अपडेट नहीं होता था (#192).
- आईएमए एक्सटेंशन:
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, बिना किसी विज्ञापन वाली डीएआई स्ट्रीम शुरू नहीं हो पाती थीं. ऐसा इसलिए होता था, क्योंकि पहला (और बिना विज्ञापन वाले मामले में एकमात्र)
LOADEDइवेंट नहीं मिलता था.
- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, बिना किसी विज्ञापन वाली डीएआई स्ट्रीम शुरू नहीं हो पाती थीं. ऐसा इसलिए होता था, क्योंकि पहला (और बिना विज्ञापन वाले मामले में एकमात्र)
वर्शन 1.0.0-rc01
16 फ़रवरी, 2023
androidx.media3:media3-*:1.0.0-rc01 रिलीज़ हो गया है. वर्शन 1.0.0-rc01 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.3 रिलीज़ के मुताबिक है.
- कोर लाइब्रेरी:
- रेंडरर के डिकोडर के क्रम को तय करने वाले लॉजिक में बदलाव करें, ताकि
MediaCodecSelectorकी प्राथमिकताओं को बनाए रखा जा सके. भले ही, कोई डिकोडर यह रिपोर्ट करे कि वह मीडिया को बेहतर तरीके से नहीं चला सकता. उदाहरण के लिए, डिफ़ॉल्ट सिलेक्टर के साथ, सिर्फ़ फ़ंक्शनल सपोर्ट वाले हार्डवेयर डिकोडर को सॉफ़्टवेयर डिकोडर के मुकाबले प्राथमिकता दी जाएगी. सॉफ़्टवेयर डिकोडर, फ़ॉर्मैट (#10604) के साथ पूरी तरह काम करता है. ExoPlayer.Builder.setPlaybackLooperजोड़ें, जो ExoPlayer के नए इंस्टेंस के लिए, पहले से मौजूद प्लेबैक थ्रेड सेट करता है.- डाउनलोड मैनेजर हेल्पर को मिटाने की अनुमति दें (#10776).
BasePlayer.seekToमें पैरामीटर जोड़ें, ताकि यह भी पता चल सके कि वीडियो में आगे या पीछे जाने के लिए किस निर्देश का इस्तेमाल किया गया है.- एपीआई 21 और इसके बाद के वर्शन पर ड्रॉएबल लोड करते समय थीम का इस्तेमाल करें (#220).
ConcatenatingMediaSource2जोड़ें. इसकी मदद से, कई मीडिया आइटम को एक ही विंडो में जोड़ा जा सकता है (#247).
- रेंडरर के डिकोडर के क्रम को तय करने वाले लॉजिक में बदलाव करें, ताकि
- एक्सट्रैक्टर:
- अगर trak ऐटम को पार्स करते समय, सैंपल टेबल (stbl) में ज़रूरी सैंपल ब्यौरा (stsd) मौजूद नहीं है, तो
NullPointerExceptionके बजायParserExceptionथ्रो करें. - fMP4 में सीधे सिंक फ़्रेम पर जाने के दौरान, सैंपल को सही तरीके से स्किप करना (#10941).
- अगर trak ऐटम को पार्स करते समय, सैंपल टेबल (stbl) में ज़रूरी सैंपल ब्यौरा (stsd) मौजूद नहीं है, तो
- ऑडियो:
- डायरेक्ट प्लेबैक (पासथ्रू) में
AudioTrackके लिए, कम से कम बफ़र साइज़ का हिसाब लगाने के लिए, कंप्रेस किए गए ऑडियो फ़ॉर्मैट के बिटरेट का इस्तेमाल करें.
- डायरेक्ट प्लेबैक (पासथ्रू) में
- टेक्स्ट:
- अगर सबटाइटल फ़ाइल में कोई क्यू नहीं है, तो
Subtitle.getEventTimeको अमान्य (नेगेटिव) इंडेक्स पास करने वालीTextRendererगड़बड़ी को ठीक करें. - SubRip: UTF-16 फ़ाइलों के लिए सहायता जोड़ें, अगर वे बाइट ऑर्डर मार्क से शुरू होती हैं.
- अगर सबटाइटल फ़ाइल में कोई क्यू नहीं है, तो
- मेटाडेटा:
- ID3 फ़्रेम से, null से अलग की गई कई वैल्यू को पार्स करें. ऐसा ID3 v2.4 के तहत किया जा सकता है.
- मेटाडेटा में बताए गए कॉन्टेंट या फ़ोल्डर के टाइप को दिखाने के लिए,
MediaMetadata.mediaTypeजोड़ें. MediaMetadata.folderTypeकी जगहMediaMetadata.isBrowsableको जोड़ें. अगली रिलीज़ में, फ़ोल्डर टाइप को बंद कर दिया जाएगा.
- DASH:
- इमेज अडैप्टेशन सेट के लिए पूरी तरह से पार्स करने की सुविधा जोड़ी गई है. इसमें टाइल की संख्या भी शामिल है (#3752).
- यूज़र इंटरफ़ेस (यूआई):
- इस्तेमाल से बाहर किए गए
PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener)को ठीक करें, ताकि यह पक्का किया जा सके कि विज़िबिलिटी में हुए बदलाव, रजिस्टर किए गए लिसनर को पास किए जाएं (#229). - दाईं से बाईं ओर (आरटीएल) लेआउट का इस्तेमाल करते समय,
PlayerViewमें सेंटर प्लेयर कंट्रोल के क्रम को ठीक किया गया (#227).
- इस्तेमाल से बाहर किए गए
- सेशन:
- कस्टम प्लेयर के लिए
Playerइंटरफ़ेस को लागू करने में मदद करने के लिए, ऐब्स्ट्रैक्टSimpleBasePlayerजोड़ें. - प्लैटफ़ॉर्म सेशन टोकन को Media3 में बदलने के लिए, हेल्पर मेथड जोड़ें
SessionToken(#171). - प्लैटफ़ॉर्म मीडिया सेशन के अपडेट ट्रिगर करने के लिए,
onMediaMetadataChangedका इस्तेमाल करें (#219). - मीडिया सेशन को
DefaultMediaNotificationProviderकेgetMediaButtons()के आर्ग्युमेंट के तौर पर जोड़ें. साथ ही, साफ़ तौर पर जानकारी देने के लिए, ऐसी सूचियों का इस्तेमाल करें जिनमें बदलाव न किया जा सके (#216). onSetMediaItemsकॉलबैक लिसनर जोड़ें, ताकि प्लेयर (#156) पर सेट करने से पहले, सेशन के हिसाब सेMediaItemसूची, शुरुआती इंडेक्स, और पोज़िशन में बदलाव करने/सेट करने का विकल्प दिया जा सके.- बिना ब्लूटूथ वाले मीडिया बटन इवेंट के लिए, दो बार टैप करने की सुविधा का इस्तेमाल न करें (#233).
- लेगसी सेशन की स्थिति संदिग्ध होने पर,
QueueTimelineको ज़्यादा बेहतर बनाएं (#241).
- कस्टम प्लेयर के लिए
- मेटाडेटा:
- ID3 फ़्रेम से, null से अलग की गई कई वैल्यू को पार्स करें. ऐसा ID3 v2.4 के तहत किया जा सकता है.
- मेटाडेटा में बताए गए कॉन्टेंट या फ़ोल्डर के टाइप को दिखाने के लिए,
MediaMetadata.mediaTypeजोड़ें. MediaMetadata.folderTypeकी जगहMediaMetadata.isBrowsableको जोड़ें. अगली रिलीज़ में, फ़ोल्डर टाइप को बंद कर दिया जाएगा.
- Cast एक्सटेंशन:
- Cast SDK टूल के वर्शन को 21.2.0 पर अपडेट किया गया.
- आईएमए एक्सटेंशन:
- थ्रेडिंग से जुड़ी समस्याओं से बचने के लिए, ऐप्लिकेशन थ्रेड पर
ImaServerSideAdInsertionMediaSourceके प्लेयर लिसनर को हटाएं. ImaServerSideAdInsertionMediaSource.AdsLoader.BuilderमेंfocusSkipButtonWhenAvailableप्रॉपर्टी जोड़ें, ताकि टीवी डिवाइसों पर 'स्किप करें' बटन पर फ़ोकस करने का अनुरोध किया जा सके. साथ ही, इसे डिफ़ॉल्ट रूप से 'सही है' पर सेट करें.ImaServerSideAdInsertionMediaSource.AdsLoaderमेंfocusSkipButton()तरीका जोड़ें, ताकि प्रोग्राम के हिसाब से, 'स्किप करें' बटन पर फ़ोकस करने का अनुरोध किया जा सके.- IMA SDK टूल के वर्शन को 3.29.0 पर अपडेट किया गया.
- थ्रेडिंग से जुड़ी समस्याओं से बचने के लिए, ऐप्लिकेशन थ्रेड पर
- डेमो ऐप्लिकेशन:
- डाउनलोड की सूचनाओं के लिए, रनटाइम के दौरान सूचना की अनुमति का अनुरोध करना (#10884).
वर्शन 1.0.0-beta03
22 नवंबर, 2022
androidx.media3:media3-*:1.0.0-beta03 रिलीज़ हो गया है. वर्शन 1.0.0-beta03 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.2 रिलीज़ के मुताबिक है.
- कोर लाइब्रेरी:
ExoPlayer.isTunnelingEnabledको जोड़ें, ताकि यह पता लगाया जा सके कि चुने गए मौजूदा ट्रैक के लिए टनलिंग की सुविधा चालू है या नहीं (#2518).- एक
MediaSourceको रैप करने की प्रोसेस को आसान बनाने के लिए,WrappingMediaSourceको जोड़ें (#7279). - मेमोरी कम होने की वजह से, वीडियो रुकने से पहले बैक बफ़र को खारिज करें.
- ऑफ़लोड की सुविधा चालू होने पर, ट्रेसिंग "doSomeWork" ब्लॉक को बंद करें.
PlaybackStatsListenerमें तेज़ी से आगे-पीछे करने पर, सेशन ट्रैकिंग से जुड़ी समस्या को ठीक किया गया (#180).- एक आइटम वाली प्लेलिस्ट में
seekToNextयाseekToPreviousको कॉल करते समय, मौजूद नहीं होने वालाonMediaItemTransitionकॉलबैक भेजें (#10667). Player.getSurfaceSizeजोड़ें, जो उस प्लैटफ़ॉर्म का साइज़ दिखाता है जिस पर वीडियो रेंडर किया गया है.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से प्लेयर रिलीज़ के दौरान लिसनर हटाने पर,
IllegalStateException(#10758) हो सकता है.
- बनाएं:
- कंपाइलेशन से जुड़ी गड़बड़ियों से बचने के लिए, कम से कम
compileSdkVersionलागू करें (#10684). - किसी अन्य Gradle बिल्ड में शामिल होने पर, पब्लिशिंग ब्लॉक का इस्तेमाल करने से बचें.
- कंपाइलेशन से जुड़ी गड़बड़ियों से बचने के लिए, कम से कम
- ट्रैक चुनना:
- अगर डिसप्ले पर Dolby Vision की सुविधा काम नहीं करती है, तो Dolby Vision के बजाय अन्य ट्रैक को प्राथमिकता दें. (#8944).
- डाउनलोड:
- वीडियो:
- अगर डिसप्ले पर Dolby Vision की सुविधा काम नहीं करती है, तो इसके लिए कोई दूसरा डिकोडर आज़माएं. (#9794).
- ऑडियो:
- एक ही समय पर कई प्लेयर रिलीज़ करते समय, OutOfMemory गड़बड़ियों से बचने के लिए,
AudioTrackइंस्टेंस रिलीज़ करने के लिएSingleThreadExecutorका इस्तेमाल करें (#10057). - AudioTrack ऑफ़लोड की स्थिति के लिए,
AudioOffloadListener.onExperimentalOffloadedPlaybackको जोड़ता है. (#134). AudioTrackBufferSizeProviderको सार्वजनिक इंटरफ़ेस बनाएं.- पसंदीदा ऑडियो आउटपुट डिवाइस सेट करने के लिए,
ExoPlayer.setPreferredAudioDeviceजोड़ें (#135). androidx.media3.exoplayer.audio.AudioProcessorका नाम बदलकरandroidx.media3.common.audio.AudioProcessorकरें.- Android के सभी वर्शन पर, 8-चैनल और 12-चैनल वाले ऑडियो को क्रमशः 7.1 और 7.1.4 चैनल मास्क पर मैप करना होगा (#10701).
- एक ही समय पर कई प्लेयर रिलीज़ करते समय, OutOfMemory गड़बड़ियों से बचने के लिए,
- मेटाडेटा:
MetadataRendererको अब इस तरह कॉन्फ़िगर किया जा सकता है कि मेटाडेटा उपलब्ध होते ही रेंडर हो जाए.MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean)के साथ एक इंस्टेंस बनाएं, ताकि यह तय किया जा सके कि रेंडरर, मेटाडेटा को पहले आउटपुट करेगा या प्लेयर की पोज़िशन के साथ सिंक करेगा.
- डीआरएम:
- Android 13 के ClearKey लागू करने के तरीके में मौजूद गड़बड़ी को ठीक करना. इस गड़बड़ी की वजह से, लाइसेंस का यूआरएल खाली नहीं होता, लेकिन अमान्य होता है.
- प्लेलिस्ट में डीआरएम स्कीम के बीच स्विच करते समय,
setMediaDrmSession failed: session not openedगड़बड़ी को ठीक किया गया. जैसे, Widevine से ClearKey पर स्विच करते समय.
- टेक्स्ट:
- CEA-608: पक्का करें कि फ़ील्ड 2 पर सर्विस स्विच कमांड को सही तरीके से मैनेज किया गया हो (#10666).
- DASH:
- मेनिफ़ेस्ट से
EventStream.presentationTimeOffsetको पार्स करें (#10460).
- मेनिफ़ेस्ट से
- यूज़र इंटरफ़ेस (यूआई):
- प्लेयर के मौजूदा ओवरराइड का इस्तेमाल,
TrackSelectionDialogBuilder(#10429) में प्रीसेट के तौर पर करें.
- प्लेयर के मौजूदा ओवरराइड का इस्तेमाल,
- सेशन:
- पक्का करें कि निर्देश हमेशा सही क्रम में लागू हों. भले ही, कुछ निर्देशों को एसिंक्रोनस रिज़ॉल्यूशन की ज़रूरत हो (#85).
DefaultMediaNotificationProviderइंस्टेंस बनाने के लिए,DefaultMediaNotificationProvider.Builderजोड़ें. बिल्डर, सूचना आईडी, सूचना चैनल आईडी, और सूचना चैनल के नाम को कॉन्फ़िगर कर सकता है. इनका इस्तेमाल, सेवा देने वाली कंपनी करती है. साथ ही, सूचनाओं के छोटे आइकॉन को सेट करने के लिए,DefaultMediaNotificationProvider.setSmallIcon(int)तरीका जोड़ें. (#104).- पक्का करें कि
MediaController.release()से पहले भेजे गए निर्देश न छोड़े जाएं (#99). SimpleBitmapLoader,file://यूआरआई से बिटमैप लोड कर सकता है (#108).- उस दावे को ठीक किया गया है जो
MediaControllerको किसी समयावधि में विज्ञापन को आगे बढ़ाने से रोकता है (#122). - वीडियो चलना बंद होने पर, फ़ोरग्राउंड से
MediaSessionServiceको रोक दिया जाता है. साथ ही, पिछली बार चलाए गए मीडिया आइटम को फिर से चलाने के लिए एक सूचना दिखाई जाती है (#112). - रुके हुए इंटेंट के साथ फ़ोरग्राउंड सेवा शुरू न करें (#167).
- एपीआई 26 और एपीआई 27 पर,
DefaultNotificationProviderसे बनाई गई सूचना से जुड़े 'बैज' को मैन्युअल तरीके से छिपाएं. एपीआई 28 और इसके बाद के वर्शन पर, बैज अपने-आप छिप जाता है (#131). - उस गड़बड़ी को ठीक किया गया है जिसमें लेगसी MediaSession से Media3 MediaController के दूसरे बाइंडर कनेक्शन की वजह से, IllegalStateExceptions (#49) होता है.
- आरटीएसपी:
- आईएमए:
- विज्ञापन लोड होने में लगने वाले समय की सीमा जोड़ें, ताकि उन मामलों को मैनेज किया जा सके जिनमें IMA SDK, विज्ञापन लोड करने में अटक जाता है (#10510).
- कॉन्टेंट के आखिर में जाने पर, वीडियो के बीच में दिखने वाले विज्ञापनों को स्किप करने से रोकना (#10685).
- सर्वर साइड से डाले गए विज्ञापनों वाली लाइव स्ट्रीम के लिए, विंडो की अवधि का सही तरीके से हिसाब लगाया जाता है. उदाहरण के लिए, आईएमए डीएआई (#10764).
- FFmpeg एक्सटेंशन:
- FFmpeg लाइब्रेरी को एनडीके 23.1.7779620 और इसके बाद के वर्शन से लिंक करने के लिए, ज़रूरी नए फ़्लैग जोड़ें (#9933).
- AV1 एक्सटेंशन:
- CMake वर्शन को अपडेट करें, ताकि Android Studio के नए वर्शन के साथ काम न करने की समस्या से बचा जा सके (#9933).
- Cast एक्सटेंशन:
getDeviceInfo()को लागू करें, ताकिMediaControllerसे वीडियो चलाने की सुविधा को कंट्रोल करते समय,CastPlayerकी पहचान की जा सके (#142).
- ट्रांसफ़ॉर्मर:
- मक्सर वॉचडॉग टाइमर जोड़ें, ताकि यह पता लगाया जा सके कि आउटपुट सैंपल जनरेट होने में ज़्यादा समय कब लग रहा है.
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
Transformer.Builder.setOutputMimeType(String)हटाएं. इस सुविधा को हटा दिया गया है. डिफ़ॉल्ट मक्सर का इस्तेमाल करने पर, एमआईएमई टाइप हमेशा MP4 होगा.
वर्शन 1.0.0-beta02
21 जुलाई, 2022
androidx.media3:media3-*:1.0.0-beta02 रिलीज़ हो गया है. वर्शन 1.0.0-beta02 में ये बदलाव शामिल हैं.
यह रिलीज़, ExoPlayer 2.18.1 रिलीज़ से जुड़ी है.
- कोर लाइब्रेरी:
- पक्का करें कि
ShuffleOrderकोExoPlayer.setShuffleOrderसे बदलने पर,reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED(#9889) के साथPlayer.Listener#onTimelineChangedपर कॉल किया जाए. - प्रोग्रेसिव मीडिया के लिए, बफ़र की गई पोज़िशन में सिर्फ़ चुने गए ट्रैक शामिल करें (#10361).
- ExoPlayer के सभी लॉग आउटपुट के लिए, कस्टम लॉगर की अनुमति दें (#9752).
DefaultMediaSourceFactoryमेंsetDataSourceFactoryको लागू करने से जुड़ी समस्या को ठीक किया गया. कुछ मामलों में यह काम नहीं कर रहा था (#116).
- पक्का करें कि
- एक्सट्रैक्टर:
- DASH:
- मेनिफ़ेस्ट से ClearKey लाइसेंस यूआरएल को पार्स करना (#10246).
- यूज़र इंटरफ़ेस (यूआई):
- पक्का करें कि TalkBack, प्लेबैक कंट्रोल मेन्यू (#10298) में, फ़िलहाल चालू स्पीड के विकल्प की जानकारी दे.
- आरटीएसपी:
- VP8 फ़्रैगमेंटेड पैकेट हैंडलिंग जोड़ी गई (#110).
- लीनबैक एक्सटेंशन:
LeanbackAdapterमेंplayWhenReadyबदलावों के बारे में सुनें (10420).
- कास्ट:
वर्शन 1.0.0-beta01
16 जून, 2022
androidx.media3:media3-*:1.0.0-beta01 रिलीज़ हो गया है. वर्शन 1.0.0-beta01 में ये बदलाव शामिल हैं.
यह ExoPlayer 2.18.0 रिलीज़ से जुड़ा है.
- कोर लाइब्रेरी:
MediaMetricsManagerकी मदद से, Android प्लैटफ़ॉर्म के डाइग्नोस्टिक्स की सुविधा चालू करें. ExoPlayer, प्लैटफ़ॉर्म पर वीडियो चलाने से जुड़े इवेंट और परफ़ॉर्मेंस डेटा को फ़ॉरवर्ड करेगा. इससे डिवाइस पर सिस्टम की परफ़ॉर्मेंस और डीबग करने की जानकारी देने में मदद मिलती है. अगर डिवाइस का इस्तेमाल करने वाले व्यक्ति ने इस्तेमाल और गड़बड़ी की जानकारी शेयर करने की सुविधा चालू की है, तो Google भी यह डेटा इकट्ठा कर सकता है. ऐप्लिकेशन,ExoPlayer.Builder.setUsePlatformDiagnostics(false)का इस्तेमाल करके ExoPlayer के लिए, प्लैटफ़ॉर्म की गड़बड़ी की जानकारी देने वाली सुविधा में योगदान देने से बाहर हो सकते हैं.- उस गड़बड़ी को ठीक किया गया है जिसकी वजह से
MergingMediaSourceका इस्तेमाल करते समय, ट्रैक बार-बार रीसेट हो जाते थे. उदाहरण के लिए, वीडियो चलने के दौरान सबटाइटल को साइड-लोड करने और चुने गए सबटाइटल को बदलने पर ऐसा होता था (#10248). - एपीआई 29 और 30 पर 5G-NSA नेटवर्क टाइप का पता लगाना बंद करें. इन वीडियो को चलाने के लिए, 4G नेटवर्क का इस्तेमाल किया जाएगा.
- यह विकल्प
MediaSource.Factory.setDrmSessionManagerProviderऔरMediaSource.Factory.setLoadErrorHandlingPolicyकोnullपास करने की अनुमति नहीं देता. ज़रूरत पड़ने पर,DefaultDrmSessionManagerProviderऔरDefaultLoadErrorHandlingPolicyके इंस्टेंस को साफ़ तौर पर पास किया जा सकता है. MediaItem.RequestMetadataजोड़ें, ताकि मीडिया चलाने के लिए ज़रूरी मेटाडेटा को दिखाया जा सके. ऐसा तब करें, जब सटीकLocalConfigurationकी जानकारी न हो.MediaMetadata.mediaUrlको भी हटाएं, क्योंकि अब इसेRequestMetadataमें शामिल कर लिया गया है.Player.Command.COMMAND_SET_MEDIA_ITEMजोड़ें, ताकि खिलाड़ी एक आइटम सेट कर सकें.
- ट्रैक चुनना:
TrackSelectionOverridesक्लास कोTrackSelectionParametersमें फ़्लैट करें औरTrackSelectionOverrideको टॉप लेवल क्लास में प्रमोट करें.TracksInfoका नाम बदलकरTracksऔरTracksInfo.TrackGroupInfoका नाम बदलकरTracks.Groupकरें.Player.getCurrentTracksInfoऔरPlayer.Listener.onTracksInfoChangedका नाम बदलकर,Player.getCurrentTracksऔरPlayer.Listener.onTracksChangedकर दिया गया है. इसमेंPlayer.Listener.onTracksChangedतरीके के नाम को 'फिर से इस्तेमाल करने लायक बनाना' शामिल है. हालांकि, इसके लिए अलग-अलग पैरामीटर टाइप का इस्तेमाल किया जाता है.DefaultTrackSelector.buildUponParametersऔरDefaultTrackSelector.Parameters.buildUponमें बदलाव करें, ताकि अब काम न करने वालेDefaultTrackSelector.ParametersBuilderके बजायDefaultTrackSelector.Parameters.Builderको दिखाया जा सके.DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilitiesजोड़ें, जो डिफ़ॉल्ट रूप से चालू होता है. इस सुविधा के चालू होने पर,DefaultTrackSelectorउन ऑडियो ट्रैक को प्राथमिकता देगा जिनमें चैनल की संख्या, डिवाइस की आउटपुट क्षमता से ज़्यादा न हो. हैंडहेल्ड डिवाइसों पर,DefaultTrackSelectorमल्टीचैनल ऑडियो फ़ॉर्मैट के बजाय स्टीरियो/मोनो को प्राथमिकता देगा. हालांकि, अगर मल्टीचैनल फ़ॉर्मैट को स्पेशलाइज़ (Android 12L+) किया जा सकता है या वह डॉल्बी सराउंड साउंड फ़ॉर्मैट है, तो उसे प्राथमिकता दी जाएगी. इसके अलावा, ऑडियो स्पेशलाइज़ेशन की सुविधा वाले डिवाइसों पर,DefaultTrackSelectorस्पेशलाइज़र प्रॉपर्टी में होने वाले बदलावों पर नज़र रखेगा. साथ ही, इन बदलावों के आधार पर नया ट्रैक चुनने की प्रोसेस शुरू करेगा.televisionयूज़र इंटरफ़ेस मोड वाले डिवाइसों पर ये पाबंदियां लागू नहीं होती हैं. साथ ही, सबसे ज़्यादा चैनल वाले फ़ॉर्मैट को प्राथमिकता दी जाएगी. इस सुविधा को चालू करने के लिए,DefaultTrackSelectorइंस्टेंस कोContextके साथ बनाया जाना चाहिए.
- वीडियो:
DummySurfaceका नाम बदलकरPlaceholderSurfaceकरें.MediaCodecVideoRenderer.getCodecMaxInputSizeमें AV1 फ़ॉर्मैट के लिए सहायता जोड़ें.
- ऑडियो:
- LG AC3 ऑडियो डिकोडर का इस्तेमाल करना, जो स्टैंडर्ड एमआईएमई टाइप का इस्तेमाल नहीं करता.
AudioAttributes.getAudioAttributesV21()के रिटर्न टाइप कोandroid.media.AudioAttributesसे बदलकर, नईAudioAttributesV21रैपर क्लास पर सेट करें. इससे एपीआई < 21 पर एआरटी की पुष्टि करने की प्रोसेस धीमी नहीं होगी.- प्लैटफ़ॉर्म (एपीआई 29+) से क्वेरी करें या ऑडियो पासथ्रू के लिए ऑडियो एन्कोडिंग चैनल की संख्या का अनुमान लगाएं. ऐसा तब करें, जब फ़ॉर्मैट ऑडियो चैनल की संख्या सेट न हो. ऐसा एचएलएस चंकलेस प्रिपरेशन (10204) के साथ होता है.
- अगर डिकोडर 12 चैनल वाला पीसीएम ऑडियो आउटपुट करता है, तो
AudioTrackको चैनल मास्कAudioFormat.CHANNEL_OUT_7POINT1POINT4के साथ कॉन्फ़िगर करें (#10322.
- डीआरएम
- पक्का करें कि फ़ॉर्मैट में बदलाव के तुरंत बाद, वीडियो में आगे-पीछे जाने पर डीआरएम सेशन हमेशा सही तरीके से अपडेट हो (10274).
- टेक्स्ट:
Player.getCurrentCues()को बदलें, ताकिList<Cue>के बजायCueGroupदिखे.- SSA:
BorderStyle == 3होने पर,OutlineColourस्टाइल सेटिंग काम करती है. इसका मतलब है किOutlineColour, क्यू का बैकग्राउंड सेट करता है (#8435). - सीईए-708: डेटा को कई सर्विस ब्लॉक में पार्स करें और उन ब्लॉक को अनदेखा करें जो फ़िलहाल चुने गए सर्विस नंबर से जुड़े नहीं हैं.
RawCcExtractorको हटाएं. इसका इस्तेमाल सिर्फ़ Google के सबटाइटल फ़ॉर्मैट को मैनेज करने के लिए किया जाता था.
- एक्सट्रैक्टर:
- यूज़र इंटरफ़ेस (यूआई):
useController=falseहोने पर,PlayerViewपर सेट किए गएOnClickListenerको इवेंट डिलीवर करने से जुड़ी समस्या को ठीक किया गया (#9605). साथ ही, सभी व्यू कॉन्फ़िगरेशन के लिए,OnLongClickListenerको इवेंट की डिलीवरी से जुड़ी समस्या को ठीक करें.ACTION_UPसे पहलेPlayerViewकी सीमाओं से बाहर निकलने वाले टच इवेंट के क्रम को क्लिक के तौर पर गलत तरीके से इस्तेमाल करने की समस्या को ठीक किया गया (#9861).PlayerViewकी सुलभता से जुड़ी समस्या को ठीक किया गया. इसमें टैप करने पर, कंट्रोल छिपने के बजाय वीडियो रुक जाता था या फिर से चलने लगता था (#8627).TrackSelectionViewऔरTrackSelectionDialogBuilderको फिर से लिखें, ताकि वेExoPlayerके बजायPlayerइंटरफ़ेस के साथ काम कर सकें. इससे व्यू को अन्यPlayerइंप्लिमेंटेशन के साथ इस्तेमाल किया जा सकता है. साथ ही, यूज़र इंटरफ़ेस (यूआई) मॉड्यूल से ExoPlayer मॉड्यूल पर निर्भरता हट जाती है. यह नुकसान पहुंचा सकने वाला बदलाव है.PlayerViewट्रैक सिलेक्टर में, फ़ोर्स्ड टेक्स्ट ट्रैक न दिखाएं. साथ ही, अगर "कोई नहीं" चुना गया है, तो सही फ़ोर्स्ड टेक्स्ट ट्रैक को चुनकर रखें (#9432).
- DASH:
- डीटीएस
AudioChannelConfigurationएलिमेंट से चैनल की संख्या को पार्स करें. इससे डीटीएस स्ट्रीम के लिए, ऑडियो पासथ्रू की सुविधा फिर से चालू हो जाती है (#10159). DashMediaSource.Factory.setCompositeSequenceableLoaderFactoryकोnullपास करने की अनुमति न दें. ज़रूरत पड़ने पर,DefaultCompositeSequenceableLoaderFactoryके इंस्टेंस को साफ़ तौर पर पास किया जा सकता है.
- डीटीएस
- एचएलएस:
- अगर प्लेलिस्ट के CODECS एट्रिब्यूट में ऑडियो कोडेक (#10065) शामिल नहीं है, तो चंकफ़ुल प्रिपरेशन पर वापस जाएं.
- यह विकल्प
HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory,HlsMediaSource.Factory.setPlaylistParserFactory, औरHlsMediaSource.Factory.setPlaylistTrackerFactoryकोnullपास करने की अनुमति नहीं देता. अगर ज़रूरी हो, तोDefaultCompositeSequenceableLoaderFactory,DefaultHlsPlaylistParserFactoryके इंस्टेंस याDefaultHlsPlaylistTracker.FACTORYके रेफ़रंस को साफ़ तौर पर पास किया जा सकता है.
- स्मूद स्ट्रीमिंग:
SsMediaSource.Factory.setCompositeSequenceableLoaderFactoryकोnullपास करने की अनुमति न दें. ज़रूरत पड़ने पर,DefaultCompositeSequenceableLoaderFactoryके इंस्टेंस को साफ़ तौर पर पास किया जा सकता है.
- आरटीएसपी:
- H263 के लिए आरटीपी रीडर जोड़ें (#63).
- MPEG4 के लिए आरटीपी रीडर जोड़ा गया (#35).
- एचईवीसी के लिए आरटीपी रीडर जोड़ें (#36).
- एएमआर के लिए आरटीपी रीडर जोड़ें. फ़िलहाल, सिर्फ़ मोनो-चैनल और नॉन-इंटरलीव्ड एएमआर स्ट्रीम इस्तेमाल की जा सकती हैं. कंपाउंड एएमआर आरटीपी पेलोड का इस्तेमाल नहीं किया जा सकता. (#46)
- VP8 के लिए आरटीपी रीडर जोड़ा गया (#47).
- WAV के लिए आरटीपी रीडर जोड़ा गया (#56).
- आरटीएसपी के बेसिक ऑथराइज़ेशन हेडर को ठीक किया गया. (#9544).
- एसडीपी के ज़रूरी फ़ील्ड की जांच करना बंद कर दिया गया है, क्योंकि ExoPlayer को उनकी ज़रूरत नहीं होती (#10049).
- आरटीएसपी टाइमिंग को पार्स करते समय, चेक किए गए अपवाद को थ्रो करें (#10165).
- VP9 के लिए आरटीपी रीडर जोड़ा गया (#47).
- OPUS के लिए आरटीपी रीडर जोड़ा गया (#53).
- डेटा सोर्स:
DummyDataSourceका नाम बदलकरPlaceholderDataSourceकरें.- OkHttp इंटरप्ट हैंडलिंग को ठीक किया गया.
- सेशन:
- अनुरोधों के एसिंक्रोनस रिज़ॉल्यूशन की अनुमति देने के लिए,
MediaSession.MediaItemFillerकोMediaSession.Callback.onAddMediaItemsसे बदलें. - जब
MediaControllerकिसी लेगसी मीडिया सेशन से कनेक्ट होता है, तबsetMediaItems(s)के तरीकों का इस्तेमाल किया जा सकता है. MediaController.setMediaUriऔरMediaSession.Callback.onSetMediaUriको हटाएं.MediaController.setMediaItemऔरMediaSession.Callback.onAddMediaItemsका इस्तेमाल करके भी, यही काम किया जा सकता है.- मीडिया चलाने के लिए, लेगसी
MediaControllerकॉल कोonSetMediaUriके बजायMediaSession.Callback.onAddMediaItemsपर फ़ॉरवर्ड करें. - सूचना को पसंद के मुताबिक बनाने के लिए,
MediaNotification.ProviderऔरDefaultMediaNotificationProviderजोड़ें. - आर्टवर्क की इमेज डाउनलोड करने के लिए,
BitmapLoaderऔरSimpleBitmapLoaderजोड़ें. - लेगसी सेशन के साथ पुराने सिस्टम के साथ काम करने की सुविधा देने के लिए,
MediaSession.setCustomLayout()जोड़ें. MediaSession.setSessionExtras()को जोड़ें, ताकि लेगसी सेशन की तरह ही सुविधाएं मिल सकें.MediaSession.MediaSessionCallbackका नाम बदलकरMediaSession.Callback,MediaLibrarySession.MediaLibrarySessionCallbackका नाम बदलकरMediaLibrarySession.Callback, औरMediaSession.Builder.setSessionCallbackका नाम बदलकरsetCallbackकरें.MediaControllerImplLegacyमें एनपीई को ठीक किया गया (#59).- टाइमलाइन में बदलाव (#51) पर, सेशन की पोज़िशन की जानकारी अपडेट करें.
- कंट्रोलर रिलीज़ करने के बाद,
MediaControllerImplBaseमें एनपीई को ठीक किया गया (#74).
- अनुरोधों के एसिंक्रोनस रिज़ॉल्यूशन की अनुमति देने के लिए,
- विज्ञापन चलाना / आईएमए:
- विज्ञापन पोलिंग रेट को हर 100 मि॰से॰ से घटाकर हर 200 मि॰से॰ करें, ताकि Media Rating Council (एमआरसी) के सुझावों का पालन किया जा सके.
- FFmpeg एक्सटेंशन:
- CMake के वर्शन को
3.21.0+पर अपडेट करें, ताकि CMake की गड़बड़ी की वजह से AndroidStudio का Gradle सिंक न रुके (#9933).
- CMake के वर्शन को
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray)हटाएं. इसके बजाय,Player.Listener.onTracksChanged(Tracks)का इस्तेमाल करें.Player.getCurrentTrackGroupsऔरPlayer.getCurrentTrackSelectionsको हटाएं. इसके बजाय,Player.getCurrentTracksका इस्तेमाल करें.ExoPlayer.getCurrentTrackGroupsऔरExoPlayer.getCurrentTrackSelectionsका इस्तेमाल भी जारी रखा जा सकता है. हालांकि, ये तरीके अब काम नहीं करते.DownloadHelperDEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORTऔरDEFAULT_TRACK_SELECTOR_PARAMETERSकॉन्सटैंट हटाएं. अगर हो सके, तो इसके बजायgetDefaultTrackSelectorParameters(Context)का इस्तेमाल करें. अगर ऐसा नहीं है, तोDEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXTका इस्तेमाल करें.- कंस्ट्रक्टर
DefaultTrackSelector(ExoTrackSelection.Factory)को हटाएं. इसके बजाय,DefaultTrackSelector(Context, ExoTrackSelection.Factory)का इस्तेमाल करें. Transformer.Builder.setContextहटाएं.ContextकोTransformer.Builderकंस्ट्रक्टर को पास किया जाना चाहिए.
वर्शन 1.0.0-alpha03
14 मार्च, 2022
androidx.media3:media3-*:1.0.0-alpha03 रिलीज़ हो गया है. वर्शन 1.0.0-alpha03 में ये बदलाव शामिल हैं.
यह ExoPlayer 2.17.1 रिलीज़ के मुताबिक है.
- ऑडियो:
- एचएलएस में Dolby Atmos (E-AC3-JOC) के लिए, ऑडियो की सुविधाओं की जांच करने से जुड़ी गड़बड़ी को ठीक किया गया.
- एक्सट्रैक्टर:
- FMP4: उस समस्या को ठीक किया गया है जिसमें emsg सैंपल मेटाडेटा, v0 और v1, दोनों emsg ऐटम वाली स्ट्रीम के लिए गलत क्रम में आउटपुट हो सकता था (#9996).
- टेक्स्ट:
SingleSampleMediaSource.Factory.setTrackIdऔरMediaItem.SubtitleConfiguration.Builder.setIdके इंटरैक्शन को ठीक किया गया, ताकिSubtitleConfigurationफ़ील्ड को प्राथमिकता दी जा सके. साथ ही, अगर यह सेट नहीं है, तोFactoryवैल्यू पर वापस जाया जा सके (#10016).
- विज्ञापन चलाना:
- लाइव एचएलएस एसएसएआई स्ट्रीम में, विज्ञापन के बीच में ऑडियो अंडररन की समस्या को ठीक किया गया.
वर्शन 1.0.0-alpha02
2 मार्च, 2022
androidx.media3:media3-*:1.0.0-alpha02 रिलीज़ हो गया है. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.
यह ExoPlayer 2.17.0 रिलीज़ से जुड़ा है.
- कोर लाइब्रेरी:
- प्रोटेक्टेड मेथड
DefaultRenderersFactory.getCodecAdapterFactory()जोड़ें, ताकिDefaultRenderersFactoryकी सबक्लास, जोbuildVideoRenderers()याbuildAudioRenderers()को ओवरराइड करती हैं, कोडेक अडैप्टर फ़ैक्ट्री को ऐक्सेस कर सकें. साथ ही, उसे बनाए गएMediaCodecRendererइंस्टेंस में पास कर सकें. - ICY हेडर फ़ील्ड
nameऔरgenreको क्रमशःMediaMetadata.stationऔरMediaMetadata.genreपर भेजें, ताकि वेPlayer.Listener.onMediaMetadataChanged()(#9677) के ज़रिए ऐप्लिकेशन तक पहुंच सकें. DefaultHttpDataSource#getResponseHeadersसे शून्य वैल्यू वाली कुंजियां हटाएं.MediaCodecइंस्टेंस बनाने में गड़बड़ी होने पर, कुछ देर इंतज़ार करें और फिर से कोशिश करें. यह समस्या कुछ डिवाइसों पर तब आती है, जब किसी सरफ़ेस को सुरक्षित कोडेक से दूसरे कोडेक पर स्विच किया जाता है (#8696).MediaCodecAdapter.getMetrics()को जोड़ें, ताकि उपयोगकर्ताMediaCodecसे मेट्रिक डेटा हासिल कर सकें. (#9766).- Maven डिपेंडेंसी रिज़ॉल्यूशन को ठीक किया गया (#8353).
- उन लाइव स्ट्रीम के लिए, स्पीड अपने-आप अडजस्ट होने की सुविधा बंद कर दी गई है जिनमें न तो कम इंतज़ार के समय वाली सुविधाएं हैं और न ही उपयोगकर्ता ने स्पीड सेट करने का अनुरोध किया है (#9329).
DecoderCounters#inputBufferCountका नाम बदलकरqueuedInputBufferCountकरें.SimpleExoPlayer.renderersको निजी के तौर पर सेट करें. रेंडरर कोExoPlayer.getRendererसे ऐक्सेस किया जा सकता है.AnalyticsListener.EventFlagsकी कुछ कॉन्स्टेंट वैल्यू को अपडेट किया गया, ताकि वेPlayer.EventFlagsकी वैल्यू से मैच हो सकें.AnalyticsCollectorको इंटरफ़ेस और डिफ़ॉल्ट इंप्लिमेंटेशन में बांटें, ताकि अगर किसी ऐप्लिकेशन को इसकी ज़रूरत न हो, तो R8 इसे हटा सके.
- प्रोटेक्टेड मेथड
- ट्रैक चुनना:
- ट्रैक चुनने के दौरान, पसंदीदा वीडियो रोल फ़्लैग के लिए सहायता जोड़ी गई (#9402).
- वीडियो ट्रैक चुनने के लॉजिक को अपडेट किया गया, ताकि अडैप्टेशन के लिए कई वीडियो ट्रैक चुनते समय, पसंदीदा एमआईएमई टाइप और रोल फ़्लैग को ध्यान में रखा जा सके (#9519).
- वीडियो और ऑडियो ट्रैक चुनने के लॉजिक को अपडेट करें, ताकि अडैप्टिव सिलेक्शन के लिए सिर्फ़ ऐसे फ़ॉर्मैट चुने जा सकें जिनमें डिकोडर और हार्डवेयर सपोर्ट का लेवल एक जैसा हो (#9565).
- वीडियो ट्रैक चुनने के लॉजिक को अपडेट किया गया, ताकि ज़्यादा बेहतर कोडेक को प्राथमिकता दी जा सके. ऐसा तब होगा, जब हार्डवेयर की मदद से डिकोड करने वाले प्राइमरी डिकोडर, एक से ज़्यादा कोडेक के साथ काम करते हों (#4835).
- ऑडियो ट्रैक चुनने से जुड़ी तकनीकी पाबंदियों (उदाहरण के लिए, पसंदीदा एमआईएमई टाइप या चैनल की ज़्यादा से ज़्यादा संख्या) के बजाय, ऑडियो कॉन्टेंट की प्राथमिकताओं (उदाहरण के लिए, "डिफ़ॉल्ट" ऑडियो ट्रैक या सिस्टम की स्थानीय भाषा से मैच करने वाला ट्रैक) को प्राथमिकता दें.
- ट्रैक चुनने से जुड़ी समस्या को ठीक किया गया. इसमें एक ट्रैक ग्रुप को बदलने पर, उसी तरह के अन्य ट्रैक ग्रुप बंद नहीं होते थे (#9675).
- ट्रैक चुनने से जुड़ी समस्या को ठीक किया गया. इसमें खाली और खाली न होने वाले ट्रैक ओवरराइड का मिश्रण सही तरीके से लागू नहीं होता था (#9649).
TrackGroupArrayमें डुप्लीकेटTrackGroupको रोकें.TrackGroups को हमेशा अलग से पहचाना जा सकता है. इसके लिए,TrackGroupकंस्ट्रक्टर मेंidसेट करें. इससे, ऐप्लिकेशन को बैकग्राउंड में चलाने के बाद, वीडियो फिर से चलाने पर क्रैश होने की समस्या ठीक हो जाती है. ऐसा तब होता है, जब ऐप्लिकेशन में कोई ट्रैक चालू हो और उसे बदला गया हो (#9718).AdaptiveTrackSelectionमें लॉजिक में बदलाव करें, ताकि ज़रूरत के मुताबिक नेटवर्क बैंडविड्थ होने पर क्वालिटी को बढ़ाया जा सके. भले ही, वीडियो चलाना लाइव एज (#9784) के बहुत करीब हो.
- वीडियो:
- Dolby Vision के लिए डिकोडर फ़ॉलबैक लॉजिक को ठीक करें, ताकि ज़रूरत पड़ने पर, इसके साथ काम करने वाले H264/H265 डिकोडर का इस्तेमाल किया जा सके.
- ऑडियो:
- Dolby Atmos (E-AC3-JOC) के लिए, डिकोडर के फ़ॉलबैक लॉजिक को ठीक किया गया है, ताकि ज़रूरत पड़ने पर, इसके साथ काम करने वाले E-AC3 डिकोडर का इस्तेमाल किया जा सके.
AudioCapabilitiesएपीआई में बदलाव करें, ताकिnullके बजायAudioCapabilities.DEFAULT_AUDIO_CAPABILITIESको साफ़ तौर पर पास करना ज़रूरी हो.DefaultAudioSinkमेंAudioTrackBufferSizeProviderइंजेक्ट करके,AudioTrackके बफ़र साइज़ के कैलकुलेशन को पसंद के मुताबिक बनाने की अनुमति दें. (#8891).- अगर अनुरोध किया गया बफ़र साइज़ 1 एमबी से ज़्यादा था, तो
AudioTrackको फिर से बनाने की कोशिश करें. (#9712).
- एक्सट्रैक्टर:
- टेक्स्ट:
- डीआरएम:
DrmSessionManager.(pre)acquireSessionसेplaybackLooperको हटाएं. जब कोई ऐप्लिकेशन, कस्टमMediaSourceमेंDrmSessionManagerका इस्तेमाल करता है, तोplaybackLooperकोDrmSessionManager.setPlayerमें पास करना ज़रूरी होता है.
- विज्ञापन चलाना / आईएमए:
- आईएमए डाइनैमिक ऐड इंसर्शन (डीएआई) के लिए सहायता जोड़ी गई (#8213).
AdPlaybackStateमें एक ऐसा तरीका जोड़ें जिससे विज्ञापन ग्रुप को रीसेट किया जा सके, ताकि उसे फिर से चलाया जा सके (#9615).- विज्ञापन चलने के दौरान, वीडियो चलाने की स्पीड को 1.0 पर सेट करें (#9018).
- उस समस्या को ठीक किया गया है जिसकी वजह से विज्ञापन ग्रुप लोड न होने पर, वीडियो तुरंत रीसेट हो जाता था (#9929).
- यूज़र इंटरफ़ेस (यूआई):
- DASH:
- पार्स की गई ज़रूरी और अतिरिक्त प्रॉपर्टी को
Representationमें जोड़ें (#9579). forced-subtitleट्रैक की भूमिका (#9727) के लिए सहायता.mainट्रैक की भूमिका कोC.SELECTION_FLAG_DEFAULTके तौर पर समझना बंद करें.- उन मेनिफ़ेस्ट के लिए बेस यूआरएल को बाहर रखने के लॉजिक को ठीक किया गया है जो डीवीबी नेमस्पेस (#9856) का एलान नहीं करते.
- रिलेटिव
MPD.Locationयूआरएल के लिए सहायता (#9939).
- पार्स की गई ज़रूरी और अतिरिक्त प्रॉपर्टी को
- एचएलएस:
- सिर्फ़ ऑडियो वाली एचएलएस स्ट्रीम के लिए,
Format.labelको सही तरीके से भरें (#9608). - स्टार्ट अप टाइम को बेहतर बनाने के लिए, डिफ़ॉल्ट रूप से चंकलेस प्रिपरेशन का इस्तेमाल करें. अगर आपके रेंडर किए गए वीडियो में, मक्स किए गए सबटाइटल ट्रैक शामिल हैं और उन्हें मास्टर प्लेलिस्ट में शामिल नहीं किया गया है, तो आपको उन्हें मास्टर प्लेलिस्ट में जोड़ना चाहिए. इससे वे वीडियो चलाने के लिए उपलब्ध हो पाएंगे. इसके अलावा,
HlsMediaSource.Factory.setAllowChunklessPreparation(false)का इस्तेमाल करके, चंकलेस प्रिपरेशन की सुविधा को बंद किया जा सकता है. - एचएलएस में सटीक की-फ़्रेम खोजने की सुविधा जोड़ी गई (#2882).
- सिर्फ़ ऑडियो वाली एचएलएस स्ट्रीम के लिए,
- आरटीएसपी:
SocketFactoryको बदलने के लिए क्लाइंट एपीआई उपलब्ध कराएं. इसका इस्तेमाल किसी भी सर्वर कनेक्शन (#9606) के लिए किया जाता है.- अगर पुष्टि करने के दोनों तरीके उपलब्ध हैं, तो BASIC के बजाय DIGEST को प्राथमिकता दें (#9800).
- आरटीएसपी ट्रैक की टाइमिंग उपलब्ध न होने पर, उसे मैनेज करना (#9775).
- आरटीपी-जानकारी हेडर की अमान्य वैल्यू को अनदेखा करें (#9619).
- ट्रांसफ़ॉर्मर:
- एपीआई के ज़रूरी वर्शन को बढ़ाकर 21 करें.
TransformationExceptionका इस्तेमाल अब ट्रांसफ़ॉर्मेशन के दौरान होने वाली गड़बड़ियों के बारे में बताने के लिए किया जाता है.- ट्रांसफ़ॉर्मेशन के विकल्प तय करने के लिए,
TransformationRequestजोड़ें. - एक से ज़्यादा लिसनर को रजिस्टर करने की अनुमति दें.
- कोडेक आउटपुट को आंशिक रूप से पढ़े जाने पर, ट्रांसफ़ॉर्मर के अटकने की समस्या को ठीक किया गया.
- मक्सर थ्रो को रिलीज़ करते समय,
Transformer.getProgressमें संभावित एनपीई को ठीक करें. - ट्रांसफ़ॉर्मेशन लागू करने के लिए, कोई डेमो ऐप्लिकेशन जोड़ें.
- MediaSession एक्सटेंशन:
- डिफ़ॉल्ट रूप से,
MediaSessionConnectorअब संगीत बंद होने पर प्लेलिस्ट को हटा देता है. जिन ऐप्लिकेशन को प्लेलिस्ट को बनाए रखना है वे कनेक्टर परsetClearMediaItemsOnStop(false)को कॉल कर सकते हैं.
- डिफ़ॉल्ट रूप से,
- Cast एक्सटेंशन:
- FFmpeg एक्सटेंशन:
build_ffmpeg.shको GNU के बजाय, LLVM के बाइनरी यूटिलिटी पर निर्भर बनाएं (#9933).
- Android 12 के साथ काम करने की सुविधा:
- Cast एक्सटेंशन को अपग्रेड करें, ताकि वह
com.google.android.gms:play-services-cast-framework:20.1.0पर निर्भर रहे.play-services-cast-frameworkके पुराने वर्शन, Android 12 को टारगेट करने वाले ऐप्लिकेशन के साथ काम नहीं करते. साथ ही,PendingIntentबनाते समयIllegalArgumentExceptionके साथ क्रैश हो जाएंगे (#9528).
- Cast एक्सटेंशन को अपग्रेड करें, ताकि वह
- अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
Player.EventListenerहटाएं. इसके बजाय,Player.Listenerका इस्तेमाल करें.MediaSourceFactory#setDrmSessionManager,MediaSourceFactory#setDrmHttpDataSourceFactory, औरMediaSourceFactory#setDrmUserAgentको हटाएं. इसके बजाय,MediaSourceFactory#setDrmSessionManagerProviderका इस्तेमाल करें.MediaSourceFactory#setStreamKeysहटाएं. इसके बजाय,MediaItem.Builder#setStreamKeysका इस्तेमाल करें.MediaSourceFactory#createMediaSource(Uri)हटाएं. इसके बजाय,MediaSourceFactory#createMediaSource(MediaItem)का इस्तेमाल करें.DashMediaSource,HlsMediaSource, औरSsMediaSourceसेsetTagको हटाएं. इसके बजाय,MediaItem.Builder#setTagका इस्तेमाल करें.DashMediaSource#setLivePresentationDelayMs(long, boolean)हटाएं. मेनिफ़ेस्ट को बदलने के लिए,MediaItem.Builder#setLiveConfigurationऔरMediaItem.LiveConfiguration.Builder#setTargetOffsetMsका इस्तेमाल करें. इसके अलावा, फ़ॉलबैक वैल्यू देने के लिए,DashMediaSource#setFallbackTargetLiveOffsetMsका इस्तेमाल करें.(Simple)ExoPlayer.setThrowsWhenUsingWrongThreadहटाएं. अब थ्रेड को लागू करने की सुविधा से ऑप्ट आउट नहीं किया जा सकता.ActionFileऔरActionFileUpgradeUtilको हटाएं.ActionFileUpgradeUtilका इस्तेमाल करके, लेगसी ऐक्शन फ़ाइलों कोDefaultDownloadIndexमें मर्ज करने के लिए, ExoPlayer 2.16.1 या इससे पहले के वर्शन का इस्तेमाल करें.ProgressiveMediaSource#setExtractorsFactoryहटाएं. इसके बजाय,ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory)कंस्ट्रक्टर का इस्तेमाल करें.ProgressiveMediaSource.Factory#setTagऔरProgressiveMediaSource.Factory#setCustomCacheKeyको हटाएं. इसके बजाय,MediaItem.Builder#setTagऔरMediaItem.Builder#setCustomCacheKeyका इस्तेमाल करें.DefaultRenderersFactory(Context, @ExtensionRendererMode int)औरDefaultRenderersFactory(Context, @ExtensionRendererMode int, long)कंस्ट्रक्टर हटाएं. इसके बजाय,DefaultRenderersFactory(Context)कंस्ट्रक्टर,DefaultRenderersFactory#setExtensionRendererMode, औरDefaultRenderersFactory#setAllowedVideoJoiningTimeMsका इस्तेमाल करें.- सभी सार्वजनिक
CronetDataSourceकंस्ट्रक्टर हटाएं. इसके बजाय,CronetDataSource.Factoryका इस्तेमाल करें.
IntDefsको सिर्फ़@Target(TYPE_USE)में बदलें. इससे Kotlin में इस्तेमाल किए गए कोड का कंपाइलेशन टूट सकता है. इसे ठीक करने के लिए, एनोटेशन को टाइप (Int) पर एनोटेट करें.@AacAudioObjectType@Ac3Util.SyncFrameInfo.StreamType@AdLoadException.Type@AdtsExtractor.Flags@AmrExtractor.Flags@AspectRatioFrameLayout.ResizeMode@AudioFocusManager.PlayerCommand@AudioSink.SinkFormatSupport@BinarySearchSeeker.TimestampSearchResult.Type@BufferReplacementMode@C.BufferFlags@C.ColorRange@C.ColorSpace@C.ColorTransfer@C.CryptoMode@C.Encoding@C.PcmEncoding@C.Projection@C.SelectionReason@C.StereoMode@C.VideoOutputMode@CacheDataSource.Flags@CaptionStyleCompat.EdgeType@DataSpec.Flags@DataSpec.HttpMethods@DecoderDiscardReasons@DecoderReuseResult@DefaultAudioSink.OutputMode@DefaultDrmSessionManager.Mode@DefaultTrackSelector.SelectionEligibility@DefaultTsPayloadReaderFactory.Flags@EGLSurfaceTexture.SecureMode@EbmlProcessor.ElementType@ExoMediaDrm.KeyRequest.RequestType@ExtensionRendererMode@Extractor.ReadResult@FileTypes.Type@FlacExtractor.Flags(com.google.android.exoplayer2.ext.flacपैकेज में)@FlacExtractor.Flags(com.google.android.exoplayer2.extractor.flacके पैकेज में)@FragmentedMp4Extractor.Flags@HlsMediaPlaylist.PlaylistType@HttpDataSourceException.Type@IllegalClippingException.Reason@IllegalMergeException.Reason@LoadErrorHandlingPolicy.FallbackType@MatroskaExtractor.Flags@Mp3Extractor.Flags@Mp4Extractor.Flags@NotificationUtil.Importance@PlaybackException.FieldNumber@PlayerNotificationManager.Priority@PlayerNotificationManager.Visibility@PlayerView.ShowBuffering@Renderer.State@RendererCapabilities.AdaptiveSupport@RendererCapabilities.Capabilities@RendererCapabilities.DecoderSupport@RendererCapabilities.FormatSupport@RendererCapabilities.HardwareAccelerationSupport@RendererCapabilities.TunnelingSupport@SampleStream.ReadDataResult@SampleStream.ReadFlags@StyledPlayerView.ShowBuffering@SubtitleView.ViewType@TextAnnotation.Position@TextEmphasisSpan.MarkFill@TextEmphasisSpan.MarkShape@Track.Transformation@TrackOutput.SampleDataPart@Transformer.ProgressState@TsExtractor.Mode@TsPayloadReader.Flags@WebvttCssStyle.FontSizeUnit
वर्शन 1.0.0-alpha01
27 अक्टूबर, 2021
androidx.media3:media3-*:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
Media3, मीडिया सपोर्ट लाइब्रेरी के लिए नया होम है. इसमें ExoPlayer भी शामिल है. पहले ऐल्फ़ा वर्शन में, मीडिया से जुड़े इस्तेमाल के उदाहरणों को लागू करने के लिए, लाइब्रेरी के शुरुआती और काम करने वाले वर्शन शामिल हैं. इनमें ये शामिल हैं:
- ExoPlayer, Android के लिए ऐप्लिकेशन-लेवल का मीडिया प्लेयर है. इसे आसानी से पसंद के मुताबिक बनाया जा सकता है और इसमें नई सुविधाएं जोड़ी जा सकती हैं.
- मीडिया सेशन की सुविधा, ताकि प्लेबैक को दिखाया और कंट्रोल किया जा सके. यह नया सेशन मॉड्यूल, ExoPlayer की तरह ही
Playerइंटरफ़ेस का इस्तेमाल करता है. - मीडिया चलाने के लिए यूज़र इंटरफ़ेस बनाने के लिए यूआई कॉम्पोनेंट.
- ExoPlayer के साथ इस्तेमाल करने के लिए, अन्य लाइब्रेरी में रैपिंग फ़ंक्शन वाले मॉड्यूल. उदाहरण के लिए, IMA SDK की मदद से विज्ञापन डालना.
ज़्यादा जानकारी के लिए, Media3 GitHub प्रोजेक्ट देखें.
ExoPlayer को पहले एक अलग ExoPlayer GitHub प्रोजेक्ट में होस्ट किया जाता था. Media3 में इसके पैकेज का नाम androidx.media3.exoplayer है. हम ExoPlayer GitHub प्रोजेक्ट को कुछ समय तक बनाए रखेंगे और रिलीज़ करते रहेंगे, ताकि ऐप्लिकेशन को Media3 पर माइग्रेट करने का समय मिल सके.
Media3 में ExoPlayer के सभी मॉड्यूल के विकल्प मौजूद हैं. हालांकि, इसमें लेगसी media2 और mediasession एक्सटेंशन के विकल्प मौजूद नहीं हैं. इनकी जगह, नए media3-session मॉड्यूल का इस्तेमाल किया जाता है. इससे प्लेयर और मीडिया सेशन के बीच सीधे तौर पर इंटिग्रेशन की सुविधा मिलती है. इसके लिए, अडैप्टर/कनेक्टर क्लास का इस्तेमाल करने की ज़रूरत नहीं होती.