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 में mlpa RFC 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) जोड़ें. यह एन्कोडर की क्वालिटी के मेज़र किए गए डेटा के आधार पर, मौजूदा डिवाइस के लिए वीडियो एन्कोडर के कॉन्फ़िगरेशन (कोडेक, एन्कोडर की सेटिंग, और बिटरेट) का सुझाव देता है.
  • एक्सट्रैक्टर:
    • एडीटीएस: पहले फ़्रेम के कुछ हिस्से के पेलोड में, गलत सिंक वर्ड से ऑडियो फ़ॉर्मैट को हासिल करने की समस्या को ठीक किया गया. इसकी वजह से, फ़्रेम के बीच में शामिल की गई लाइव एएसी स्ट्रीम को चलाने में समस्या आ सकती थी या वह रुक सकती थी (#3464).AdtsExtractor
    • FragmentedMp4Extractor में ArrayIndexOutOfBoundsException को ठीक किया गया. ऐसा तब किया गया, जब फ़्रैगमेंट में बिना सैंपल वाला trun बॉक्स मौजूद था (#3471).
    • ADTS: AdtsExtractor में FLAG_DISABLE_ID3_METADATA जोड़ें, ताकि स्ट्रीम में मौजूद ID3 डेटा को application/id3 ट्रैक के तौर पर आउटपुट न किया जाए.
    • MP4: एएसी ट्रैक के गैपलेस प्लेबैक को ठीक किया गया. इन ट्रैक का मक्सर (जैसे, FFmpeg), एन्कोडर पैडिंग को हटाने के लिए आखिरी stts एंट्री को छोटा कर देता है. इसकी वजह से, elst की बदलाव सूची से पैडिंग को 0 के तौर पर लिया जाता है और आखिरी फ़्रेम के आखिर तक चलाया जाता है (#3489).
    • ID3 से शुरू होने वाली खराब या बिना मीडिया वाली फ़ाइलों को स्निफ़ करते समय, बड़े अपफ़्रंट पीक बफ़र ऐलोकेशन और OutOfMemoryError को ठीक करें (#3502).
  • इंस्पेक्टर:
    • उस समस्या को ठीक किया गया है जिसमें 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) अब काम नहीं करता).
  • सेशन:
    • मीडिया बटन की प्राथमिकताओं वाले एपीआई को बेहतर बनाया गया है.
    • 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 में पहले से तय Cast MediaMetadata फ़ील्ड के लिए सहायता उपलब्ध कराएं. इसके लिए, 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 से पॉप्युलेट करें. साथ ही, रिसीवर से रिज़ॉल्व की गई अवधि और लाइव स्ट्रीम की स्थिति को सूची में मौजूद सभी आइटम के लिए बनाए रखें.
  • डेमो ऐप्लिकेशन:
    • सेशन डेमो ऐप्लिकेशन में, प्लेलिस्ट के आइटम को खींचकर और छोड़कर उनके क्रम को बदलने की अनुमति दें.
  • अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
    • 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 शामिल है.

वर्शन 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 में होने वाली गड़बड़ी को ठीक किया गया. यह गड़बड़ी तब होती थी, जब वर्शन 1 tfdt बॉक्स, नेगेटिव 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 आईडी और टिप्पणी हेडर पैकेट को अनदेखा किया गया.
  • इंस्पेक्टर:
    • 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 को लागू करें.
  • मक्सर:
    • 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 पर सेट करें.

वर्शन 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).
  • एचएलएस एक्सटेंशन:
    • जब स्नैप करने के लिए टारगेट सेगमेंट, प्लेलिस्ट में मौजूद न हो, तो कॉन्टेंट को फिर से शुरू करने के ऑफ़सेट की गिनती को ठीक किया गया (#3322).
    • उस समस्या को ठीक किया गया है जिसमें एक्सट्रैक्टर से EOFException मिलने पर, पूरी तरह से इस्तेमाल हो चुका HlsMediaChunk फिर से लोड होने की कोशिश करता है (#3350).
  • DASH एक्सटेंशन:
    • इमेज ट्रैक के लिए, सैंपल के गलत टाइमस्टैंप की गिनती को ठीक किया गया presentationTimeOffset (#3334).
  • डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
    • Opus: एक साथ कई OpusDecoder इंस्टेंस शुरू होने पर, मेमोरी खराब होने की समस्या को ठीक किया गया.
    • MPEG-H: मेमोरी लीक, ASCII के बाहर के वर्णों को छोटा करने, और कम मेमोरी होने पर MpeghUiManager को निर्देश भेजने पर संभावित नेटिव क्रैश की समस्या को ठीक किया गया है (#3365).

वर्शन 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).
    • स्क्रबिंग मोड की संभावित समस्या को ठीक किया गया है. इसमें 'स्ट्रीम के आखिर' तक पहुंचने पर, स्क्रबिंग रुक सकती थी.
  • 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).
  • ऑडियो:
    • 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 कॉलबैक ट्रिगर हो सकते थे और सीपीयू को बार-बार चालू करना पड़ सकता था.
  • टेक्स्ट:
    • TTML: क्षेत्रों के लिए, style से displayAlign पर फ़ॉलबैक करें (#2559).
    • टीटीएमएल: <p> एलिमेंट के पैरेंट से, क्यू शुरू होने का समय इनहेरिट करें (#3246).
  • मेटाडेटा:
    • MediaMetadata.discSubtitle फ़ील्ड जोड़ें और इसे ID3v2.4 TSST और Vorbis DISCSUBTITLE डेटा से पार्स करें.
    • 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 जोड़ें, ताकि ऐक्टिव मीडिया सेशन के बारे में क्वेरी की जा सके और Media3 SessionToken के इंस्टेंस दिखाए जा सकें.
    • अगर तरीके को ओवरराइड नहीं किया गया है, तो 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 और Compose PresentationState में शटर सप्रेशन बग को ठीक किया गया. इसकी वजह से, उन टाइमलाइन पर क्रैश की समस्या आ रही थी जो पीरियड यूआईडी लुकअप (#3264) के साथ काम नहीं करती हैं.
  • डाउनलोड:
    • डाउनलोड करने के लिए फ़ेच किए जाने पर, मीडिया प्लेलिस्ट में एचएलएस वैरिएबल को रिज़ॉल्व करें (#3258).
  • Ktor एक्सटेंशन:
    • media3-datasource-ktor का नया एक्सटेंशन मॉड्यूल जोड़ें, जो Ktor एचटीटीपी स्टैक की मदद से KtorDataSource उपलब्ध कराता है.
    • कनेक्शन खोलते समय, पूरी एचटीटीपी रिस्पॉन्स बॉडी को मेमोरी में लोड करने से जुड़ी KtorDataSource गड़बड़ी को ठीक किया गया (#3305).
  • एचएलएस एक्सटेंशन:
    • एचएलएस कॉन्टेंट स्टीयरिंग और पाथवे क्लोनिंग के लिए सहायता जोड़ी गई (#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 प्रॉपर्टी का इस्तेमाल अब नहीं किया जाता.

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_ITEM MediaController में उपलब्ध नहीं होता. यह सेशन, अन्य आइटम पर जाने की सुविधा देता है, लेकिन प्लेलिस्ट में बदलाव करने की अनुमति नहीं देता.
    • उस समस्या को ठीक किया गया है जिसमें 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 कंटेनर में, वर्सटाइल वीडियो कोडिंग (वीवीसी) ट्रैक के लिए सहायता जोड़ी गई.
  • इंस्पेक्टर:
    • नुकसान पहुंचा सकने वाला बदलाव: 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 में नए फ़ील्ड और लॉजिक के साथ इस्तेमाल किया जा सकता है.
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से कंप्रेस्ड ऑफ़लोड मोड में, बिना गैप वाले ऑडियो की प्लेलिस्ट चलाते समय ऑडियो रुक जाता था.
  • टेक्स्ट:
    • VobSub: क्यू की अवधि तय करने के लिए, START और STOP एसपीयू कंट्रोल कमांड का इस्तेमाल करें. इससे, क्यू की अवधि हमेशा पांच सेकंड पर डिफ़ॉल्ट रूप से सेट नहीं होगी (#2935).
  • मेटाडेटा:
    • मेटाडेटा रेंडरर की डिफ़ॉल्ट संख्या को बढ़ाकर चार कर दिया गया है, ताकि एचएलएस वैरिएंट और रेंडर किए गए वर्शन से पब्लिश किए गए सभी संभावित मेटाडेटा ट्रैक को कवर किया जा सके (#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 में PlaybackSpeedControl Composable जोड़ें.
    • वीडियो चलाने की स्पीड को कंट्रोल करने के लिए, media3-ui-compose-material3 में PlaybackSpeedToggleButton Composable जोड़ें.
    • खिलाड़ी की प्रोग्रेस दिखाने और ड्रैग और टैप करके खोजने के लिए, 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).
  • वीडियो:
    • एपीआई 30 से पहले के वर्शन वाले डिवाइसों पर, कॉन्टेंट का फ़्रेम रेट बदलने पर वीडियो कोडेक को खारिज कर दिया जाता है, ताकि वीडियो रुक-रुककर न चले (#2941).
  • टेक्स्ट:
    • VobSub: कुछ सबटाइटल न दिखने की समस्या को ठीक किया गया. इसके लिए, उन एसपीयू को सही तरीके से मैनेज किया गया जिनमें सिर्फ़ एक कंट्रोल सीक्वेंस होता है या जिनमें ज़रूरी जानकारी को कई कंट्रोल सीक्वेंस में बांटा गया होता है (#2935).
  • आईएमए एक्सटेंशन:
    • गड़बड़ी ठीक की गई: उस समस्या को ठीक किया गया है जिसकी वजह से विज्ञापन का एमआईएमई टाइप, IMA LOADED इवेंट में दिए गए एमआईएमई टाइप से मैच नहीं होता था. अब विज्ञापनों के पॉड इंडेक्स और विज्ञापन के क्रम का इस्तेमाल करके, विज्ञापन के एमआईएमई टाइप को मैप किया जाता है.
    • getAdsManager() और AdEvent.getAd() के नतीजे को ऐक्सेस करने से पहले, शून्य की जांच जोड़ें.
  • सेशन:
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, विज्ञापन चलने के दौरान प्लैटफ़ॉर्म सेशन से कनेक्ट किए गए MediaController को रोकने पर ऐप्लिकेशन क्रैश हो जाता था (#2948).
    • अलग-अलग क्लास में extras Bundle इंस्टेंस पर पुष्टि करने के अतिरिक्त तरीके जोड़ें, ताकि अन्य प्रोसेस से भेजे गए गलत 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).
  • आरटीएसपी एक्सटेंशन:
    • रैप अराउंड वाले टाइमस्टैंप के साथ आरटीपी पैकेट को सही तरीके से मैनेज करें (#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 मिनट बाद.
    • बैकग्राउंड में वीडियो चलाने के दौरान बफ़रिंग की समस्याओं को ठीक करने के लिए, वेक लॉक हैंडलिंग को डिफ़ॉल्ट रूप से चालू करें. यह 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 कॉल को हैंडल न कर पाए.
    • String CharSequence के अलावा, अन्य मेटाडेटा वैल्यू के प्रोपेगेशन को ठीक किया गया. जैसे, स्पैन-स्टाइल वाली स्ट्रिंग (#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 में ContentFrame Composable जोड़ें. यह 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).
  • 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 एक्सटेंशन:
    • setVolume() और getVolume() के लिए सहायता जोड़ी गई (#2279).
    • टाइमलाइन खाली होने पर, CastPlayer को STATE_BUFFERING में जाने से रोकें.
    • getDeviceVolume(), setDeviceVolume(), getDeviceMuted(), और setDeviceMuted() के लिए सहायता जोड़ें (#2089).
  • टेस्ट यूटिलिटी:
    • खिलाड़ी को आगे बढ़ाने के लिए, 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).
  • ऑडियो:
    • ऑफ़लोड से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से, कम अवधि वाले कॉन्टेंट की प्लेलिस्ट चलाते समय, वीडियो की पोज़िशन अटक सकती थी (#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 में मौजूद गड़बड़ी को ठीक किया गया. इस गड़बड़ी की वजह से, null MediaMetadata के साथ 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).
    • सीकिंग की स्पीड बढ़ाने के लिए, एक्सपेरिमेंट के तौर पर ExoPlayer AV1 सैंपल डिपेंडेंसी पार्सिंग की सुविधा जोड़ी गई. इसे नए DefaultRenderersFactory.experimentalSetParseAv1SampleDependencies API की मदद से चालू करें.
    • देरी से मिले 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).
  • असर:
    • 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).
  • यूज़र इंटरफ़ेस (यूआई):
    • 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).
  • वीडियो:
    • onOutputFormatChanged को प्रोसेस करते समय, MediaCodecAdapter के लिए दी गई पिक्सल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की वैल्यू का इस्तेमाल करने की सुविधा को वापस लाया गया (#1371).
  • टेक्स्ट:
    • ReplacingCuesResolver.discardCuesBeforeTimeUs में मौजूद उस गड़बड़ी को ठीक किया गया है जिसकी वजह से timeUs पर चालू क्यू (पहले शुरू हुआ, लेकिन अब तक खत्म नहीं हुआ) को गलत तरीके से खारिज कर दिया गया था (#1939).
  • मेटाडेटा:
    • Vorbis टिप्पणियों से डिस्क/ट्रैक नंबर और शैली को MediaMetadata में एक्सट्रैक्ट करें (#1958).

वर्शन 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 कॉलबैक के ज़रिए भेजी जाती हैं. वहीं, पार्स करने से जुड़ी गड़बड़ियों को अनदेखा कर दिया जाता है. यह पहले से मौजूद व्यवहार है.
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, मल्टी-पीरियड 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 में null Surface मिल सकता है. साथ ही, पहले से सेट किए गए Surface को हटाने के लिए, नए तरीके detachOutputSurface को कॉल किया जा सकता है. हालांकि, ऐसा तब ही किया जा सकता है, जब कोडेक इसका (MediaCodecInfo.detachedSurfaceSupported) इस्तेमाल करने की अनुमति देता हो.
    • onOutputFormatChanged को प्रोसेस करते समय, अगर MediaCodecAdapter पिक्सल के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की वैल्यू दी गई हैं, तो उनका इस्तेमाल करें (#1371).
    • Galaxy Tab S7 FE पर डिवाइस से जुड़ी समस्या को हल करने के लिए, कोई दूसरा तरीका जोड़ें. इस समस्या की वजह से, 60 एफ़पीएस (फ़्रेम प्रति सेकंड) वाली सुरक्षित H264 स्ट्रीम को 'काम नहीं करती' के तौर पर मार्क किया जाता है (#1619).
    • उन कोडेक के लिए समस्या हल करने का तरीका जोड़ें जो आखिरी सैंपल के बाद अटक जाते हैं और एंड-ऑफ़-स्ट्रीम सिग्नल नहीं दिखाते.
  • टेक्स्ट:
    • कस्टम VoiceSpan जोड़ें और उसे WebVTT वॉइस स्पैन के लिए पॉप्युलेट करें (#1632).
    • यह पक्का करें कि एचएलएस में WebVTT, सबटाइटल के बहुत बड़े टाइमस्टैंप के साथ दिखे. ये टाइमस्टैंप, माइक्रोसेकंड के तौर पर दिखाए जाने और 90,000 MPEG टाइमबेस से गुणा करने पर, 64-बिट long से ज़्यादा हो जाते हैं (#1763).
    • Dolby Vision कॉन्टेंट में CEA-608 सबटाइटल के साथ काम करता है (#1820).
    • सीईए-608 सबटाइटल चालू होने पर, DASH मल्टी-पीरियड स्ट्रीम में वीडियो चलाने के दौरान हैंग होने की समस्या को ठीक किया गया (#1863).
  • मेटाडेटा:
    • C.TRACK_TYPE_METADATA टाइप को ऐसे ट्रैक असाइन करें जिनमें icy या vnd.dvb.ait कॉन्टेंट शामिल हो.
  • इमेज:
    • Glide या Coil जैसी बाहरी इमेज लोड करने वाली लाइब्रेरी के साथ इंटिग्रेशन को आसान बनाने के लिए, ExternallyLoadedImageDecoder जोड़ें.
  • डेटा सोर्स:
    • 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).
  • आरटीएसपी एक्सटेंशन:
    • उन यूआरएल से उपयोगकर्ता की जानकारी हटाने की सुविधा को ठीक किया गया जिनमें कोड में बदले गए @ वर्ण शामिल हैं (#1138).
    • हेडर एक्सटेंशन वाले आरटीपी पैकेट को पार्स करते समय क्रैश होने की समस्या को ठीक किया गया (#1225).
  • डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1 वगैरह):
    • IAMF डिकोडर मॉड्यूल जोड़ें. यह मॉड्यूल, libiamf नेटिव लाइब्रेरी का इस्तेमाल करके, IAMF ट्रैक वाली MP4 फ़ाइलों को चलाने की सुविधा देता है. इससे ऑडियो को सिंथेसाइज़ किया जा सकता है.
      • स्टीरियो लेआउट के साथ-साथ, 5.1 ऑडियो और स्पेशल ऑडियो की सुविधा के साथ वीडियो चलाया जा सकता है. साथ ही, हेड ट्रैकिंग की सुविधा को चालू किया जा सकता है. हालांकि, फ़िलहाल बाइनॉरल प्लेबैक की सुविधा उपलब्ध नहीं है.
    • Android 15 पर डिकोडर एक्सटेंशन के लिए, 16 केबी वाले पेज के साइज़ के साथ काम करने की सुविधा जोड़ी गई (#1685).
  • 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:
    • PreloadMediaSource में एसिंक्रोनस तरीके से प्रीलोड कॉलबैक को हैंडल करना (#1568).
    • लोड न होने पर, बफ़र की अवधि के बावजूद वीडियो चलाने की अनुमति दें (#1571).
  • एक्सट्रैक्टर:
    • MP3: Info फ़्रेम में लंबाई वाले फ़ील्ड के आधार पर, आखिर में मौजूद नॉन-एमपी3 डेटा को सही तरीके से अनदेखा करके, Searched too many bytes गड़बड़ी को ठीक किया गया (#1480).
  • टेक्स्ट:
    • टीटीएमएल: प्रतिशत 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) को पूरी तरह से लागू न करने की वजह से होती है.
  • असर:
    • 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, और TSOP ID3 टैग (#1302) के साथ गलत तरीके से मैप किए गए थे.
    • जब वैल्यू एक बाइट से ज़्यादा लंबी हो, तो MP4 (/iTunes) न्यूमेरिक gnre (शैली) और tmpo (टेम्पो) टैग को पढ़ने की समस्या को ठीक किया गया.
    • ID3 TCON फ़्रेम को MediaMetadata.genre में प्रोपेगेट करें (#1305).
  • इमेज:
    • नॉन-स्क्वेयर 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 एक्सटेंशन:
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, कई पीरियड वाली लाइव स्ट्रीम को फिर से तैयार करने पर, IndexOutOfBoundsException (#1329) गड़बड़ी दिख सकती है.
    • dashif:Laurl लाइसेंस के यूआरएल के लिए सहायता जोड़ी गई (#1345).
  • Cast एक्सटेंशन:
    • Media3 मीडिया आइटम में, MediaQueueItem के एल्बम टाइटल को कलाकार के नाम में बदलने वाली गड़बड़ी को ठीक किया गया (#1255).
  • टेस्ट यूटिलिटी:
    • 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.FormatSupport IntDef और 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 की वजह से होने वाली गड़बड़ी को ठीक करने के लिए, कोई दूसरा तरीका जोड़ें.
  • ट्रैक चुनना:
    • 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).
  • डीआरएम:
    • Android 14 वाले कुछ डिवाइसों पर, ResourceBusyException या NotProvisionedException के बजाय MediaDrm फ़्रेमवर्क से मिलने वाले NoSuchMethodError को ठीक करें (#1145).
  • असर:
    • कलर स्पेस को बदलकर, पीक्यू से एसडीआर टोन-मैपिंग को बेहतर बनाया गया है.
  • सेशन:
    • उस समस्या को ठीक किया गया है जिसमें कंट्रोलर के मौजूदा आइटम को बदलने पर, मौजूदा पोज़िशन वापस चली जाती है (#951).
    • उस समस्या को ठीक किया गया है जिसमें मीडिया कंट्रोलर और सेशन के बीच, सिर्फ़ नॉन-नुल extras वाले MediaMetadata को ट्रांसमिट नहीं किया जाता था (#1176).
  • यूज़र इंटरफ़ेस (यूआई):
    • अगर 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).
  • ऑडियो:
    • वॉल्यूम रैंप को बेहतर बनाकर, साइलेंस स्किप करने वाले एल्गोरिदम को बेहतर बनाया गया. साथ ही, कम से कम साइलेंस और ज़्यादा नैचुरल साइलेंस की अवधि को बनाए रखा गया (#7423).
    • स्किप की गई साइलेंस को ज़्यादा सटीक तरीके से रिपोर्ट करना (#1035).
  • वीडियो:
    • 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 को उनके प्रज़ेंटेशन के समय के आस-पास उपलब्ध कराया जाता है.
  • डीआरएम:
    • डीआरएम कॉन्टेंट में, एन्क्रिप्ट (सुरक्षित) नहीं किए गए 'क्लियर लीड' सैंपल को डिफ़ॉल्ट रूप से तुरंत चलाएं. भले ही, बाद में एन्क्रिप्ट किए गए सैंपल के लिए कुंजियां अभी तक तैयार न हों. अगर एन्क्रिप्ट किए गए सैंपल तक पहुंचने पर भी कुंजियां तैयार नहीं होती हैं, तो वीडियो बीच में रुक सकता है. हालांकि, पहले इस पॉइंट पर वीडियो शुरू ही नहीं होता था. इस सुविधा को बंद करने के लिए, 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).
  • ऑडियो:
    • कई बार कॉल किए जाने पर, 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 को ठीक करें. ऐसा तब करें, जब प्लेयर से कोई सरफ़ेस अटैच न हो. यह गड़बड़ी, बिना एन्क्रिप्ट किए गए कॉन्टेंट को चलाने के लिए, सुरक्षित डिकोडर का गलत तरीके से इस्तेमाल करने की वजह से हुई.
  • सेशन:
    • कस्टम कुंजियों और वैल्यू को MediaMetadataCompat से MediaMetadata.extras और MediaMetadata.extras से MediaMetadataCompat में डालें (#756, #802).
    • लेगसी कंट्रोलर के लिए, ब्रॉडकास्टिंग notifyChildrenChanged को ठीक किया गया (#644).
    • एक गड़बड़ी को ठीक किया गया है. इसमें, सूचना के बंद किए गए setWhen टाइमर के लिए नेगेटिव टाइम सेट करने पर, कुछ डिवाइसों पर ऐप्लिकेशन क्रैश हो जाता था (#903).
    • IllegalStateException को ठीक किया गया. ऐसा तब होता है, जब पहली सूचना के अपडेट का अनुरोध किए जाने पर, मीडिया सूचना कंट्रोलर का कनेक्शन पूरा नहीं होता (#917).
  • यूज़र इंटरफ़ेस (यूआई):
    • उस समस्या को ठीक किया गया है जिसमें BottomSheetDialogFragment में मटीरियल डिज़ाइन का इस्तेमाल करने पर, फ़ॉरवर्ड और रिवाइंड बटन नहीं दिखते थे (#511).
    • PlayerControlView में, तेज़ी से आगे बढ़ाने वाले बटन में मौजूद नंबर अलाइन नहीं थे. इस समस्या को ठीक किया गया (#547).
  • DASH एक्सटेंशन:
    • DASH मेनिफ़ेस्ट में Dolby के लिए, "f800" को चैनल की संख्या 5 के तौर पर पार्स करें (#688).
  • डिकोडर एक्सटेंशन (FFmpeg, VP9, AV1, MIDI वगैरह):
    • MIDI: उस समस्या को ठीक किया गया है जिसमें आगे की ओर जाने पर, प्रोग्राम में बदलाव करने वाले इवेंट स्किप हो जाते थे (#704).
    • FFmpeg 6.0 पर माइग्रेट करें और इसके साथ काम करने वाले एनडीके को r26b पर अपडेट करें (#707, #867).
  • 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) दिखता था.
  • वीडियो:
    • 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 की वजह से ऑडियो न चलने की समस्या को ठीक किया जा सकता है. इसके लिए, सिस्टम डायलॉग लॉन्च करें, ताकि उपयोगकर्ता सही ऑडियो आउटपुट (जैसे, ब्लूटूथ हेडफ़ोन) कनेक्ट कर सके. अगर कॉन्फ़िगर किए जा सकने वाले टाइम आउट (डिफ़ॉल्ट रूप से पांच मिनट) के अंदर कोई सही डिवाइस कनेक्ट हो जाता है, तो लिसनर अपने-आप वीडियो चलाना फिर से शुरू कर देगा.
  • डाउनलोड:
    • 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 हो सकता है.
  • टेस्ट यूटिलिटी:
    • 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_METADATA
      • COMMAND_SET_PLAYLIST_METADATA
      • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
      • COMMAND_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) के बीच के अलग-अलग व्यवहार को ठीक करें.
  • ट्रांसफ़ॉर्मर:
    • 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 एक नया ट्रैक चुनने की प्रोसेस को ट्रिगर करेगा.
  • एक्सट्रैक्टर:
    • Ogg: लंबी अवधि वाली फ़ाइलों में, फ़ॉरवर्ड या बैकवर्ड करने पर आने वाली गड़बड़ी को ठीक किया गया (#391).
    • FMP4: उस समस्या को ठीक किया गया है जिसमें TimestampAdjuster, emsg ऐटम से मेटाडेटा सैंपल टाइम के साथ गलत टाइमस्टैंप ऑफ़सेट को शुरू करता है (#356).
  • ऑडियो:
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से टनलिंग चालू होने और 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 जोड़ें.
  • आरटीएसपी एक्सटेंशन:
    • MPEG4-LATM के लिए, अगर Describe Response SDP मैसेज में profile-level-id वैल्यू मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल करें (#302).
    • अगर DESCRIBE रिस्पॉन्स हेडर (#11160) में मौजूद है, तो आरटीएसपी सेशन से रिलेटिव पाथ रिज़ॉल्यूशन के लिए बेस यूआरआई का इस्तेमाल करें.
  • DASH एक्सटेंशन:
    • मल्टी पीरियड DASH स्ट्रीम के लिए, MediaLoadData.startTimeMs और MediaLoadData.endTimeMs से मीडिया टाइम ऑफ़सेट हटाएं.
    • उस गड़बड़ी को ठीक किया गया है जिसमें कई समयावधि वाले लाइव डैश मीडिया सोर्स को फिर से तैयार करने पर, IndexOutOfBoundsException (#10838) जनरेट होता था.
  • एचएलएस एक्सटेंशन:
    • 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 रिलीज़ से जुड़ी है.

  • कोर लाइब्रेरी:
    • एपीआई 33 पर नेटवर्क टाइप का पता लगाने से जुड़ी समस्या को ठीक किया गया (#10970).
    • ExoPlayer.isTunnelingEnabled को कॉल करते समय NullPointerException की समस्या को ठीक करें (#10977).
  • डाउनलोड:
    • मर्ज किए जाने वाले दो सेगमेंट के शुरू होने के समय के बीच के ज़्यादा से ज़्यादा अंतर को SegmentDownloader और सबक्लास (#248) में कॉन्फ़िगर किया जा सकता है.
  • ऑडियो:
    • Samsung डिवाइसों पर, बिना गैप के MP3 फ़ाइलें चलाने में आ रही समस्या को ठीक किया गया (#8594).
    • उस गड़बड़ी को ठीक किया गया है जिसकी वजह से, ऑडियो बंद करने के तुरंत बाद सेट की गई वीडियो चलाने की स्पीड, पहले से सेट की गई स्पीड से बदल जाती थी (#10882).
  • वीडियो:
    • HEVC HDR10 फ़ॉर्मैट को HEVCProfileMain10 के बजाय HEVCProfileMain10HDR10 पर मैप करें.
    • Chromecast with Google TV और Lenovo M10 FHD Plus पर डिवाइस से जुड़ी समस्या को हल करने का तरीका जोड़ें. इस समस्या की वजह से, 60fps एवीसी स्ट्रीम को 'इस्तेमाल नहीं किया जा सकता' के तौर पर मार्क किया जाता है (#10898).
    • स्क्रीन के रीफ़्रेश रेट से ज़्यादा फ़्रेम रेट वाले मीडिया को चलाते समय, फ़्रेम रिलीज़ की परफ़ॉर्मेंस से जुड़ी समस्याएं ठीक करना.
  • कास्ट:
    • एक मीडिया आइटम से दूसरे पर जाने के दौरान, कुछ समय के लिए दिखने वाले 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).
  • ऑडियो:
    • डायरेक्ट प्लेबैक (पासथ्रू) में 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).
  • डाउनलोड:
    • ProgressiveDownloader में संभावित इनफ़ाइनाइट लूप को ठीक किया गया. यह लूप, एक ही PriorityTaskManager (#10570) से एक साथ डाउनलोड करने और वीडियो चलाने की वजह से होता है.
    • डाउनलोड की सूचना तुरंत दिखाएं (#183).
    • एक साथ कई डाउनलोड हटाने की सीमा को एक पर सेट करें, ताकि बहुत ज़्यादा थ्रेड न बनें (#10458).
  • वीडियो:
    • अगर डिसप्ले पर 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).
  • मेटाडेटा:
    • 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) होता है.
  • आरटीएसपी:
    • H263 फ़्रैगमेंटेड पैकेट हैंडलिंग जोड़ी गई (#119).
    • MP4A-LATM के लिए सहायता जोड़ी गई (#162).
  • आईएमए:
    • विज्ञापन लोड होने में लगने वाले समय की सीमा जोड़ें, ताकि उन मामलों को मैनेज किया जा सके जिनमें 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).
  • एक्सट्रैक्टर:
    • H265 के शॉर्ट टर्म रेफ़रंस पिक्चर सेट को पार्स करने से जुड़ी समस्या को ठीक किया गया (#10316).
    • esds बॉक्स से बिटरेट को पार्स करने की समस्या को ठीक किया गया (#10381).
  • DASH:
    • मेनिफ़ेस्ट से ClearKey लाइसेंस यूआरएल को पार्स करना (#10246).
  • यूज़र इंटरफ़ेस (यूआई):
    • पक्का करें कि TalkBack, प्लेबैक कंट्रोल मेन्यू (#10298) में, फ़िलहाल चालू स्पीड के विकल्प की जानकारी दे.
  • आरटीएसपी:
    • VP8 फ़्रैगमेंटेड पैकेट हैंडलिंग जोड़ी गई (#110).
  • लीनबैक एक्सटेंशन:
    • LeanbackAdapter में playWhenReady बदलावों के बारे में सुनें (10420).
  • कास्ट:
    • MediaItem का इस्तेमाल करें, जिसे प्लेलिस्ट के तरीकों में CastTimeline में Window.mediaItem के तौर पर पास किया गया है (#25, #8212).
    • Player.getMetadata() और Listener.onMediaMetadataChanged() को CastPlayer (#25) के साथ सपोर्ट करें.

वर्शन 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 के सबटाइटल फ़ॉर्मैट को मैनेज करने के लिए किया जाता था.
  • एक्सट्रैक्टर:
    • एवीआई के लिए सहायता जोड़ी गई (#2092).
    • Matroska: Opus ट्रैक के लिए DiscardPadding को पार्स करें.
    • MP4: esds बॉक्स से बिटरेट पार्स करें.
    • Ogg: डुप्लीकेट Opus आईडी और टिप्पणी हेडर की अनुमति दें (#10038).
  • यूज़र इंटरफ़ेस (यूआई):
    • 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).
  • अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
    • Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) हटाएं. इसके बजाय, Player.Listener.onTracksChanged(Tracks) का इस्तेमाल करें.
    • Player.getCurrentTrackGroups और Player.getCurrentTrackSelections को हटाएं. इसके बजाय, Player.getCurrentTracks का इस्तेमाल करें. ExoPlayer.getCurrentTrackGroups और ExoPlayer.getCurrentTrackSelections का इस्तेमाल भी जारी रखा जा सकता है. हालांकि, ये तरीके अब काम नहीं करते.
    • DownloadHelper DEFAULT_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).
  • एक्सट्रैक्टर:
    • WAV: RF64 स्ट्रीम के लिए सहायता जोड़ी गई (#9543).
    • H.265 एसपीएस एनएएल यूनिट को पार्स करने में होने वाली गड़बड़ी को ठीक किया गया (#9719).
    • Ogg Opus और Ogg Vorbis फ़ाइलों में, Vorbis टिप्पणियों (METADATA_BLOCK_PICTURE के साथ) को पार्स करें.
  • टेक्स्ट:
    • MediaItem.SubtitleConfiguration.id फ़ील्ड जोड़ें, जिसे कॉन्फ़िगरेशन से बनाए गए सबटाइटल ट्रैक के Format.id फ़ील्ड में भेजा जाता है (#9673).
    • Matroska कंटेनर में WebVTT सबटाइटल के लिए बुनियादी सहायता जोड़ी गई (#9886).
    • Cea708Decoder को सर्विस ब्लॉक के तय साइज़ से ज़्यादा डेटा पढ़ने से रोकें.
  • डीआरएम:
    • DrmSessionManager.(pre)acquireSession से playbackLooper को हटाएं. जब कोई ऐप्लिकेशन, कस्टम MediaSource में DrmSessionManager का इस्तेमाल करता है, तो playbackLooper को DrmSessionManager.setPlayer में पास करना ज़रूरी होता है.
  • विज्ञापन चलाना / आईएमए:
    • आईएमए डाइनैमिक ऐड इंसर्शन (डीएआई) के लिए सहायता जोड़ी गई (#8213).
    • AdPlaybackState में एक ऐसा तरीका जोड़ें जिससे विज्ञापन ग्रुप को रीसेट किया जा सके, ताकि उसे फिर से चलाया जा सके (#9615).
    • विज्ञापन चलने के दौरान, वीडियो चलाने की स्पीड को 1.0 पर सेट करें (#9018).
    • उस समस्या को ठीक किया गया है जिसकी वजह से विज्ञापन ग्रुप लोड न होने पर, वीडियो तुरंत रीसेट हो जाता था (#9929).
  • यूज़र इंटरफ़ेस (यूआई):
    • कुछ थीम का इस्तेमाल करते समय, StyledPlayerView रिवाइंड और फ़ास्टफ़ॉरवर्ड बटन में मौजूद नंबरों के रंग को ठीक किया गया (#9765).
    • वीडियो चलाने की स्पीड वाली स्ट्रिंग का सही अनुवाद किया गया (#9811).
  • 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 एक्सटेंशन:
    • उस गड़बड़ी को ठीक किया गया जिसकी वजह से CastPlayer, onIsPlayingChanged को सही तरीके से कॉल नहीं कर पा रहा था (#9792).
    • ऑडियो मेटाडेटा के साथ-साथ आर्टवर्क भी शामिल करें DefaultMediaItemConverter (#9663).
  • 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).
  • अब इस्तेमाल नहीं किए जा रहे सिंबल हटाएं:
    • 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 मॉड्यूल का इस्तेमाल किया जाता है. इससे प्लेयर और मीडिया सेशन के बीच सीधे तौर पर इंटिग्रेशन की सुविधा मिलती है. इसके लिए, अडैप्टर/कनेक्टर क्लास का इस्तेमाल करने की ज़रूरत नहीं होती.