মিডিয়া3

মিডিয়া ব্যবহারের ক্ষেত্রে সমর্থন লাইব্রেরি.
সর্বশেষ আপডেট স্থিতিশীল রিলিজ প্রার্থী মুক্তি বিটা রিলিজ আলফা রিলিজ
10 সেপ্টেম্বর, 2024 1.4.1 - - 1.5.0-আলফা01

নির্ভরতা ঘোষণা করা

Media3 এর উপর নির্ভরতা যোগ করতে, আপনাকে অবশ্যই আপনার প্রকল্পে Google Maven সংগ্রহস্থল যোগ করতে হবে। আরও তথ্যের জন্য Google এর Maven সংগ্রহস্থল পড়ুন।

আপনার অ্যাপ বা মডিউলের জন্য build.gradle ফাইলে আপনার প্রয়োজনীয় আর্টিফ্যাক্টগুলির জন্য নির্ভরতা যোগ করুন:

গ্রোভি 

dependencies {
    def media3_version = "1.4.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
    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 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 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"
}

কোটলিন

dependencies {
    val media3_version = "1.4.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
    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 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 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")
}

নির্ভরতা সম্পর্কে আরও তথ্যের জন্য, বিল্ড নির্ভরতা যুক্ত করুন দেখুন।

প্রতিক্রিয়া

আপনার প্রতিক্রিয়া জেটপ্যাককে আরও ভাল করতে সাহায্য করে। আপনি প্রশ্ন, পরিচিত সমস্যা এবং বৈশিষ্ট্য অনুরোধের উত্তর খুঁজতে এবং নতুন সমস্যা ফাইল করতে Media3 সমস্যা ট্র্যাকার ব্যবহার করতে পারেন।

সংস্করণ 1.5

সংস্করণ 1.5.0-alpha01

10 সেপ্টেম্বর, 2024

এই রিলিজে 1.4.1 প্রকাশের পর থেকে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • সাধারণ গ্রন্থাগার:
    • ForwardingSimpleBasePlayer যোগ করুন যা সম্পূর্ণ সামঞ্জস্যতা এবং শ্রোতা হ্যান্ডলিং ( #1183 ) নিশ্চিত করার সময় ছোট সমন্বয় সহ অন্য প্লেয়ারের কাছে ফরওয়ার্ড করার অনুমতি দেয়।
    • getPlaylist() পদ্ধতিতে SimpleBasePlayer.State.playlist প্রতিস্থাপন করুন।
    • SimpleBasePlayer.State.Builder.setPlaylist() এর জন্য ওভাররাইড যোগ করুন একটি প্লেলিস্ট কাঠামো তৈরি করার পরিবর্তে সরাসরি একটি Timeline এবং বর্তমান Tracks এবং Metadata নির্দিষ্ট করতে।
    • minSdk বাড়িয়ে 21 করুন (Android Lollipop)। এটি অন্যান্য সমস্ত AndroidX লাইব্রেরির সাথে সারিবদ্ধ।
    • androidx.media3:media3-common-ktx আর্টিফ্যাক্ট যোগ করুন যা কমন লাইব্রেরির উপরে তৈরি Kotlin-নির্দিষ্ট কার্যকারিতা প্রদান করে
    • media3-common-ktx লাইব্রেরিতে Player.Events শোনার জন্য একটি কোরোটিন ঘোরাতে Player.listen সাসপেন্ডিং এক্সটেনশন ফাংশন যোগ করুন।
  • এক্সো প্লেয়ার:
    • MediaCodecRenderer.onProcessedStreamChange() এখন প্রতিটি মিডিয়া আইটেমের জন্য কল করা যেতে পারে। আগে এটি প্রথমটির জন্য ডাকা হয়নি। এটি সক্ষম করতে MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() ব্যবহার করুন।
    • PreloadMediaSource.PreloadControl.onPreloadError যোগ PreloadMediaSource.PreloadControl
    • অ্যাপে প্রিলোড ইভেন্ট প্রচার করতে BasePreloadManager.Listener যোগ করুন।
    • SNTP ক্লায়েন্ট টাইমআউট পরিবর্তন করার অনুমতি দিন এবং টাইমআউটে বিকল্প ঠিকানাগুলি পুনরায় চেষ্টা করুন ( #1540 )।
    • MediaCodecAdapter.Configuration.flags সরান কারণ ক্ষেত্রটি সর্বদা শূন্য ছিল।
    • ব্যবহারকারীকে Wear OS API 35+ এ প্লেব্যাকের জন্য অন্তর্নির্মিত স্পিকার নির্বাচন করার অনুমতি দিন (যেখানে ডিভাইসটি এর জন্য সমর্থনের বিজ্ঞাপন দেয়)।
    • অডিও ফোকাস হ্যান্ডলিং সক্ষম না হওয়া পর্যন্ত ব্লকিং কলটি Context.getSystemService(Context.AUDIO_SERVICE) এ স্থগিত করুন। এটি নিশ্চিত করে যে অডিও ফোকাস হ্যান্ডলিং সক্ষম না থাকলে ব্লকিং কলটি করা হবে না ( #1616 )।
    • লোডিং ব্যর্থ হলে বাফার করা সময়কাল নির্বিশেষে প্লেব্যাকের অনুমতি দিন ( #1571 )।
    • পৃথক রেন্ডারার প্লেব্যাক প্রস্তুত হওয়ার অনুমতি দিলে সংকেত দিতে AnalyticsListener.onRendererReadyChanged() যোগ করুন।
  • ট্রান্সফরমার:
    • SurfaceAssetLoader যোগ করুন, যা Surface মাধ্যমে ট্রান্সফরমারে ভিডিও ডেটা সারিবদ্ধ করা সমর্থন করে।
    • ImageAssetLoader একটি IllegalStateException নিক্ষেপ করার পরিবর্তে AssetLoader.onError এর মাধ্যমে অসমর্থিত ইনপুট রিপোর্ট করে।
  • নিষ্কাশনকারী:
    • Mp4Extractor এবং FragmentedMp4Extractor H264 নমুনাগুলি সনাক্ত করার অনুমতি দিন যা পরবর্তী নমুনাগুলির দ্বারা রেফারেন্স হিসাবে ব্যবহৃত হয় না৷
    • AmrExtractor এ সূচক-ভিত্তিক চাওয়া সক্রিয় করতে বিকল্প যোগ করুন।
    • বৈধ ফ্রেমের মধ্যে 128kB-এর বেশি MP3 ফাইলগুলিকে ছেঁটে ফেলা হিসাবে বিবেচনা করুন (অবৈধের পরিবর্তে)। এর মানে শেষ পর্যন্ত নন-MP3 ডেটা সহ ফাইল, MP3 বাইটের দৈর্ঘ্য নির্দেশ করার জন্য অন্য কোনও মেটাডেটা নেই, এখন ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} ( #1563 )।
  • ডেটা সোর্স:
    • API স্তর 34 ( #1262 ) এর পরিবর্তে সংস্করণ S এক্সটেনশন 7 থেকে শুরু করার অনুমতি দিতে HttpEngineDataSource আপডেট করুন।
  • অডিও:
    • মিডিয়াতে উপস্থিত থাকলে কোডেকে স্বয়ংক্রিয়ভাবে CTA-2075 লাউডনেস মেটাডেটা কনফিগার করুন।
    • খোঁজার সময় মসৃণ ভলিউম র‌্যাম্প ডাউন নিশ্চিত করুন।
  • ভিডিও:
    • MediaCodecVideoRenderer ডিকোডিং নমুনাগুলি এড়িয়ে চলে যা অন্য নমুনা দ্বারা রেন্ডার করা বা রেফারেন্স হিসাবে ব্যবহৃত হয় না।
    • API 35 এবং তার উপরে, MediaCodecAdapter এখন configure একটি null Surface পেতে পারে এবং কোডেক এটিকে সমর্থন করলে ( MediaCodecInfo.detachedSurfaceSupported ) পূর্বে সেট করা Surface অপসারণের জন্য একটি নতুন পদ্ধতি detachOutputSurface কল করতে পারে।
    • MediaCodecAdapter সরবরাহকৃত পিক্সেল আকৃতির অনুপাতের মানগুলি ব্যবহার করুন যদি onOutputFormatChanged ( #1371 ) এ প্রক্রিয়া করার সময় দেওয়া হয়।
  • পাঠ্য:
  • ছবি:
    • গ্লাইড বা কয়েলের মতো বাহ্যিক চিত্র লোডিং লাইব্রেরির সাথে সরলীকৃত একীকরণের জন্য ExternallyLoadedImageDecoder যোগ করুন।
  • ডেটা সোর্স:
    • FileDescriptorDataSource যোগ করুন, একটি নতুন DataSource যা একটি FileDescriptor ( #3757 ) থেকে পড়তে ব্যবহার করা যেতে পারে।
  • প্রভাব:
    • ছোটখাটো SurfaceTexture স্কেলিং এর জন্য DefaultVideoFrameProcessor সমাধান যোগ করুন। SurfaceTexture একটি ছোট স্কেলিং অন্তর্ভুক্ত থাকতে পারে যা একটি ক্রপ করা বাফারের প্রান্তের চারপাশে 1-টেক্সেল সীমানা কেটে দেয়। এটি এখন এমনভাবে পরিচালনা করা হয় যে আউটপুট প্রত্যাশার কাছাকাছি।
    • গতি বাড়ান DefaultVideoFrameProcessor.queueInputBitmap() । ফলস্বরূপ, Transformer দিয়ে ভিডিওতে ছবি রপ্তানি করা দ্রুততর হয়।
  • আইএমএ এক্সটেনশন:
    • প্লেলিস্ট সাফ করার ফলে ImaServerSideAdInsertionMediaSource এ একটি ArrayIndexOutOfBoundsException হতে পারে এমন বাগ ঠিক করুন।
  • অধিবেশন:
    • MediaButtonReceiver.shouldStartForegroundService(Intent) যোগ করুন অ্যাপগুলিকে এই পদ্ধতিটি ওভাররাইড করে প্লেব্যাক পুনরায় চালু করার জন্য আসা একটি প্লে কমান্ডকে দমন করার অনুমতি দিতে৷ ডিফল্টরূপে, পরিষেবাটি সর্বদা শুরু হয় এবং একটি ForegroundServiceDidNotStartInTimeException ( #1528 ) দিয়ে সিস্টেমটি পরিষেবাটি ক্র্যাশ না করে প্লেব্যাক দমন করা যায় না।
  • ড্যাশ এক্সটেনশন:
    • একটি সেগমেন্টের মাঝখানে শুরু হওয়া পিরিয়ডের জন্য সমর্থন যোগ করুন ( #1440 )।
  • ডিকোডার এক্সটেনশন (FFmpeg, VP9, ​​AV1, ইত্যাদি):
    • IAMF ডিকোডার মডিউল যোগ করুন, যা অডিও সংশ্লেষণ করতে libiamf নেটিভ লাইব্রেরি ব্যবহার করে IAMF ট্র্যাক ধারণকারী MP4 ফাইলের প্লেব্যাকের জন্য সমর্থন প্রদান করে।
      • প্লেব্যাক একটি স্টেরিও লেআউটের পাশাপাশি 5.1 এর সাথে স্থানিককরণের সাথে ঐচ্ছিক হেড ট্র্যাকিং সক্ষম করা আছে, কিন্তু বাইনরাল প্লেব্যাক সমর্থন বর্তমানে উপলব্ধ নেই।
  • কাস্ট এক্সটেনশন:
    • CastSession সংযোগ বিচ্ছিন্ন হওয়ার পরে টাইমলাইন সাফ করা বন্ধ করুন, যা প্রেরক অ্যাপটিকে সংযোগ বিচ্ছিন্ন হওয়ার পরে স্থানীয়ভাবে প্লেব্যাক পুনরায় শুরু করতে সক্ষম করে।
    • একটি Context প্রদান করা হলে CastPlayer এর DeviceInfo পপুলেট করুন। এটি একটি RoutingSession এ MediaSession লিঙ্ক করতে সক্ষম করে, যা আউটপুট সুইচার ( #1056 ) একীভূত করার জন্য প্রয়োজনীয়।
  • পরীক্ষা উপযোগিতা:
    • DataSourceContractTest এখন যাচাই করার জন্য পরীক্ষাগুলি অন্তর্ভুক্ত করে:
      • ইনপুট স্ট্রীম read position আপডেট করা হয়েছে৷
      • আউটপুট বাফার offset সঠিকভাবে প্রয়োগ করা হয়।
  • অপ্রচলিত চিহ্নগুলি সরান:
    • অপসারিত Player.hasPrevious , Player.hasPreviousWindow() সরান। পরিবর্তে Player.hasPreviousMediaItem() ব্যবহার করুন।
    • অবচিত Player.previous() পদ্ধতি সরান। পরিবর্তে Player.seekToPreviousMediaItem() ব্যবহার করুন।
    • অপসারিত DrmSessionEventListener.onDrmSessionAcquired পদ্ধতি সরান।

সংস্করণ 1.4.0

সংস্করণ 1.4.1

আগস্ট 27, 2024

androidx.media3:media3-*:1.4.1 প্রকাশিত হয়েছে। সংস্করণ 1.4.1- এ এই কমিটগুলি রয়েছে।

  • এক্সো প্লেয়ার:
    • PreloadMediaSource ( #1568 ) এ অ্যাসিঙ্ক্রোনাসভাবে প্রিলোড কলব্যাকগুলি পরিচালনা করুন।
    • লোডিং ব্যর্থ হলে বাফার করা সময়কাল নির্বিশেষে প্লেব্যাকের অনুমতি দিন ( #1571 )।
  • নিষ্কাশনকারী:
    • MP3: একটি Info ফ্রেমের দৈর্ঘ্য ক্ষেত্রের উপর ভিত্তি করে অনুগামী নন-MP3 ডেটা সঠিকভাবে উপেক্ষা করে Searched too many bytes ত্রুটি ঠিক করুন ( #1480 )।
  • পাঠ্য:
    • TTML: শতকরা tts:fontSize মানগুলির হ্যান্ডলিং ঠিক করুন যাতে তারা শতাংশ tts:fontSize মান সহ প্যারেন্ট নোড থেকে সঠিকভাবে উত্তরাধিকার সূত্রে প্রাপ্ত হয়।
    • LegacySubtitleUtil এ IndexOutOfBoundsException ঠিক করুন কারণ অনুরোধ করা আউটপুট শুরুর সময়টি Subtitle ( #1516 ) চূড়ান্ত ইভেন্ট সময়ের চেয়ে বেশি বা সমান হওয়ার ক্ষেত্রে ভুলভাবে পরিচালনা করা হয়েছে।
  • DRM:
    • android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE এপিআই 31+ ডিভাইসে L1 ওয়াইডিভাইন সামগ্রী চালাতে ত্রুটি। ফ্রেমওয়ার্ক MediaDrm.requiresSecureDecoder পদ্ধতি ( #1603 ) এর একটি অসম্পূর্ণ বাস্তবায়নের কারণে এই ত্রুটিটি ঘটেছে।
  • প্রভাব:
    • GlObjectsProvider এ একটি release() পদ্ধতি যোগ করুন।
  • অধিবেশন:
    • KEYCODE_HEADSETHOOK এর একটি ডবল-ট্যাপকে 'পরবর্তীতে অনুসন্ধান করুন' অ্যাকশনে রূপান্তর করুন, যেমন নথিভুক্ত ( #1493 )।
    • ForegroundServiceDidNotStartInTimeException ( #1581 ) এড়াতে এটিকে উপেক্ষা করার সিদ্ধান্ত নেওয়ার সময় KEYCODE_HEADSETHOOK MediaButtonReceiver এ একটি 'play' কমান্ড হিসাবে পরিচালনা করুন।
  • RTSP এক্সটেনশন:
    • SDP পার্সিং ( #1087 ) এ অবৈধ মিডিয়া বিবরণ এড়িয়ে যান।

সংস্করণ 1.4.0

25 জুলাই, 2024

androidx.media3:media3-*:1.4.0 প্রকাশিত হয়েছে। সংস্করণ 1.4.0- এ এই কমিট রয়েছে।

  • সাধারণ গ্রন্থাগার:
    • নো-অপ সিক কলগুলিকে উপেক্ষা করার পরিবর্তে সুরক্ষিত BasePlayer.seekTo() এবং SimpleBasePlayer.handleSeek() পদ্ধতিতে ফরওয়ার্ড করুন। আপনি যদি একটি কাস্টম প্লেয়ারে এই পদ্ধতিগুলি প্রয়োগ করেন, তাহলে আপনাকে mediaItemIndex == C.INDEX_UNSET এর সাথে এই অতিরিক্ত কলগুলি পরিচালনা করতে হতে পারে।
    • উন্নত জাভা 8 ডিসুগারিং ( #1312 ) এর উপর কম্পাইল নির্ভরতা সরান।
    • নিশ্চিত করুন যে সময়কাল MediaItem.Builder.setImageDurationMs() এ পাস করা হয়েছে তা একটি নন-ইমেজ MediaItem জন্য উপেক্ষা করা হয়েছে (ডকুমেন্টেড হিসাবে)।
    • Format দৃষ্টান্ত সম্পর্কে অ্যাপ-প্রদত্ত কাস্টম তথ্য সঞ্চয় করতে Format.customData যোগ করুন।
  • এক্সো প্লেয়ার:
    • BasePreloadManager যোগ করুন যা তাদের rankingData দ্বারা সংজ্ঞায়িত অগ্রাধিকারের উপর ভিত্তি করে একাধিক উত্সের জন্য প্রিলোডিং সমন্বয় করে। কাস্টমাইজেশন এই ক্লাস প্রসারিত করা সম্ভব. DefaultPreloadManager যোগ করুন যা মেমরিতে উত্সগুলির মিডিয়া নমুনাগুলিকে প্রিলোড করতে PreloadMediaSource ব্যবহার করে এবং একটি পূর্ণসংখ্যা rankingData ব্যবহার করে যা UI-তে একটি আইটেমের সূচক নির্দেশ করে৷
    • একাধিক প্লেয়ারকে সমর্থন করার জন্য LoadControl বাস্তবায়ন সক্ষম করতে LoadControl বেশিরভাগ পদ্ধতিতে PlayerId যোগ করুন।
    • Buffer.isDecodeOnly() এবং C.BUFFER_FLAG_DECODE_ONLY সরান। রেন্ডারার এবং ডিকোডাররা টাইমস্ট্যাম্পের উপর ভিত্তি করে বাফারগুলি এড়িয়ে যাওয়ার সিদ্ধান্ত নেবে বলে এই পতাকা সেট করার দরকার নেই৷ একটি নমুনা দেখানো হবে কিনা তা নির্ধারণ করতে কাস্টম Renderer বাস্তবায়নের বাফার সময় অন্তত BaseRenderer.getLastResetPositionUs() কিনা তা পরীক্ষা করা উচিত। কাস্টম SimpleDecoder বাস্তবায়ন যদি প্রয়োজন হয় তাহলে isAtLeastOutputStartTimeUs() চেক করতে পারে বা অন্য বাফারগুলিকে এড়িয়ে যেতে DecoderOutputBuffer.shouldBeSkipped দিয়ে চিহ্নিত করতে পারে।
    • TargetPreloadStatusControl.getTargetPreloadStatus(T) দ্বারা একটি নাল মান ফেরত দেওয়ার অনুমতি দিন যাতে প্রদত্ত rankingData সাথে একটি MediaSource প্রিলোড না করা যায়।
    • BasePreloadManager এ remove(MediaSource) যোগ করুন।
    • প্রিলোড ম্যানেজার ইনস্ট্যান্স রাখার সময় সমস্ত হোল্ডিং সোর্স প্রকাশ করতে BasePreloadManager এ reset() যোগ করুন।
    • PriorityTaskManager এবং API 35 থেকে MediaCodec গুরুত্বের জন্য ব্যবহৃত অগ্রাধিকার মান নির্ধারণ করতে ExoPlayer.setPriority() (এবং Builder.setPriority() ) যোগ করুন।
    • CMCD ( #1124 ) এ ভুল bs (বাফার স্টারভেশন) কী এর ফলে শেষ রিবাফার টাইম আপডেট করার সমস্যা সমাধান করুন।
    • উৎসটি শেষ পর্যন্ত লোড হয়েছে তা বোঝাতে 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 এ IntDef-এর নাম পরিবর্তন করুন।
    • CPU ওয়েক-সাইকেলের সাথে কাজকে আরও ভালোভাবে সারিবদ্ধ করতে এবং রেন্ডারাররা যখন অগ্রগতি করতে পারে তখন জেগে উঠতে বিলম্ব করতে ডায়নামিক শিডিউলিংয়ের জন্য পরীক্ষামূলক সমর্থন যোগ করুন। আপনার ExoPlayer দৃষ্টান্ত সেট আপ করার সময় আপনি experimentalSetDynamicSchedulingEnabled() ব্যবহার করে এটি সক্ষম করতে পারেন।
    • Renderer.getDurationToProgressUs() যোগ করুন। একজন Renderer এক্সোপ্লেয়ারে ফিরে যাওয়ার জন্য এই পদ্ধতিটি প্রয়োগ করতে পারে যে সময়কাল রেন্ডারারের অগ্রগতির জন্য প্লেব্যাককে অগ্রসর হতে হবে। যদি ExoPlayer experimentalSetDynamicSchedulingEnabled() দিয়ে সেট করা থাকে তাহলে ExoPlayer তার কাজের টাস্ক শিডিউল করার সময় গণনা করার সময় এই পদ্ধতিটিকে কল করবে।
    • MediaCodecAdapter#OnBufferAvailableListener যোগ করুন যখন ইনপুট এবং আউটপুট বাফার MediaCodecRenderer দ্বারা ব্যবহারের জন্য উপলব্ধ থাকে তখন সতর্ক করতে। এই কলব্যাকগুলি পাওয়ার সময় MediaCodecRenderer ExoPlayer সংকেত দেবে এবং ExoPlayer experimentalSetDynamicSchedulingEnabled() এর সাথে সেট করা থাকলে, রেন্ডারাররা অগ্রগতি করতে পারে বলে ExoPlayer তার কাজের লুপ নির্ধারণ করবে৷
    • পৃথক প্যারামিটারের পরিবর্তে LoadControl পদ্ধতির জন্য ডেটা ক্লাস ব্যবহার করুন।
    • Exoplayer.release() কল করা হয়েছে কিনা তা পরীক্ষা করতে ExoPlayer.isReleased() যোগ করুন।
    • ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() যোগ করুন সর্বোচ্চ অবস্থানটি কনফিগার করতে যার জন্য seekToPrevious() পূর্ববর্তী আইটেমটি ( #1425 ) চায়।
    • কিছু অডিও ফোকাস অসঙ্গতি ঠিক করুন, যেমন প্লেয়ার পজ করার সময় সম্পূর্ণ বা ক্ষণস্থায়ী ফোকাস ক্ষতির রিপোর্ট না করা ( #1436 )।
    • সম্ভাব্য IndexOutOfBoundsException ঠিক করুন এক্সট্রাক্টররা প্রাথমিক প্রস্তুতির ধাপের পরে অতিরিক্ত ট্র্যাক রিপোর্ট করার কারণে ( #1476 )।
    • ExoPlayer.setVideoEffect() এর Effects রেন্ডারার অফসেট সরানো সহ টাইমস্ট্যাম্পগুলি পাবে ( #1098 )।
    • অন্য প্লেলিস্ট আইটেম ( #1483 ) এ পড়ার সময় প্লেয়ার ত্রুটি পরিচালনা করার সময় সম্ভাব্য IllegalArgumentException ঠিক করুন।
  • ট্রান্সফরমার:
    • ExportResult এ audioConversionProcess এবং videoConversionProcess যোগ করুন আউটপুট ফাইলে সংশ্লিষ্ট ট্র্যাক কীভাবে তৈরি করা হয়েছে তা নির্দেশ করে।
    • শিথিল ট্রিম অপ্টিমাইজেশান H.264 স্তর চেক.
    • একটি ক্রমানুসারে SDR এবং HDR ইনপুট মিডিয়ার মধ্যে পরিবর্তনের জন্য সমর্থন যোগ করুন।
    • রচনা-স্তরের অডিও প্রভাবগুলির জন্য সমর্থন যোগ করুন।
    • এইচডিআর ভিডিওতে আল্ট্রা এইচডিআর ছবি ট্রান্সকোড করার জন্য সমর্থন যোগ করুন।
    • রিসেট এবং পুনঃব্যবহারের পরে DefaultAudioMixer সঠিক পরিমাণ বাইটের আউটপুট না করে এমন সমস্যাটি সমাধান করুন।
    • একটি ডিকোডার বাগ নিয়ে কাজ করুন যেখানে পিসিএম ইনপুট পরিচালনা করার সময় অডিও চ্যানেলের সংখ্যা স্টেরিওতে সীমাবদ্ধ ছিল।
    • ExoPlayerAssetLoader এ ট্র্যাক নির্বাচন করার সময়, অডিও চ্যানেল গণনার সীমাবদ্ধতা উপেক্ষা করুন কারণ তারা শুধুমাত্র প্লেব্যাকের জন্য প্রযোজ্য।
    • androidx.media3.transformer.Muxer ইন্টারফেস androidx.media3.muxer.Muxer দিয়ে প্রতিস্থাপন করুন এবং androidx.media3.transformer.Muxer সরান।
    • কন্টেন্ট URI স্কিম থেকে HEIC ইমেজ লোডিং ঠিক করুন। ( #1373 )।
    • AV সিঙ্ক উন্নত করতে AudioGraphInput এ অডিও ট্র্যাকের সময়কাল সামঞ্জস্য করুন।
    • ExportResult.processedInputs ক্ষেত্র সরান। আপনি যদি কোডেক বিবরণের জন্য এই ক্ষেত্রটি ব্যবহার করেন, তাহলে পরিবর্তে DefaultDecoderFactory.listener ব্যবহার করুন। কোডেক ব্যতিক্রমের ক্ষেত্রে, কোডেক বিবরণ ExportException.codecInfo তে পাওয়া যাবে।
  • নিষ্কাশনকারী:
    • MPEG-TS: নমুনা সারিতে একটি স্ট্রীমের শেষ অ্যাক্সেস ইউনিট পাস করে শেষ ফ্রেমটি রেন্ডার করা হয়েছে তা নিশ্চিত করে পরিবর্তনটি এগিয়ে দিন ( #7909 )। শুধুমাত্র I-ফ্রেমে যে সমস্যাগুলি উদ্ভূত হয়েছে সেগুলি সমাধানের জন্য অন্তর্ভুক্ত করা হচ্ছে HLS স্ট্রীম ( #1150 ) এবং H.262 HLS স্ট্রীম ( #1126 )৷
    • MP3: অন্তর্নিহিত স্ট্রীম (যেমন ফাইলের আকার, বা HTTP Content-Length শিরোনাম) দ্বারা রিপোর্ট করা আকারের চেয়ে একটি Info ফ্রেম থেকে ডেটা আকার পছন্দ করুন। এটি ধ্রুবক বিটরেট চাওয়ার গণনা থেকে অ-প্লেযোগ্য ট্রেলার ডেটা (যেমন অ্যালবাম আর্টওয়ার্ক) বাদ দিতে সাহায্য করে, অনুসন্ধানগুলিকে আরও সঠিক করে তোলে ( #1376 )।
    • MP3: Info ফ্রেমে ফ্রেম গণনা এবং অন্যান্য ডেটা ব্যবহার করুন (যদি উপস্থিত থাকে) Info ফ্রেমের পরে ফ্রেমের বিটরেট থেকে এক্সট্রাপোলেট করার পরিবর্তে একটি গড় বিটরেট গণনা করতে একটি ইনফো ফ্রেমের (যদি থাকে) ব্যবহার করুন, যেমন PCUT ফ্রেম ( #1376 )।
    • AVI পাত্রে PCM অডিও ফরম্যাট নিষ্কাশন ঠিক করুন।
  • অডিও:
    • ডিটিএস ফিক্স করুন: পাসথ্রু প্লেব্যাকের জন্য এক্স প্রোফাইল 2 এনকোডিং বৈশিষ্ট্য ( #1299 )।
    • অফলোড করা প্লেব্যাকের জন্য, AudioTrack.stop() কল করার আগে DefaultAudioSink এ স্ট্রীম সমাপ্তির জন্য ট্র্যাকিং ফিল্ড রিসেট করুন যাতে AudioTrack.StreamEventCallback#onPresentationEnded সঠিকভাবে সনাক্ত করতে পারে যখন সমস্ত মুলতুবি ডেটা চালানো হয়েছে৷
    • SilenceSkippingAudioProcessor এ বাগ ফিক্স করুন যেখানে বিভিন্ন অডিও ফরম্যাটের মধ্যে পরিবর্তন (উদাহরণস্বরূপ স্টেরিও থেকে মনো) প্রসেসরকে ব্যতিক্রম ঘটাতে পারে ( #1352 )।
    • MediaCodecAudioRenderer.getDurationToProgressUs() প্রয়োগ করুন যাতে ExoPlayer গতিশীলভাবে তার প্রধান কাজের লুপ নির্ধারণ করে কখন MediaCodecAudioRenderer অগ্রগতি করতে পারে।
  • ভিডিও:
    • মাঝামাঝি প্লেব্যাকের সারফেস স্যুইচ করার সময় যেখানে Listener.onRenderedFirstFrame() খুব তাড়াতাড়ি আসে সেই সমস্যার সমাধান করুন।
    • প্রয়োজনে একটি সামঞ্জস্যপূর্ণ AV1 ডিকোডার ব্যবহার করতে ডলবি ভিশনের জন্য ডিকোডার ফলব্যাক লজিক ঠিক করুন ( #1389 )।
    • একটি ভিডিও রেন্ডারার মিড-প্লেব্যাক সক্ষম করার কারণে হতে পারে এমন কোডেক ব্যতিক্রমের সমাধান করুন৷
  • পাঠ্য:
    • একটি অনুসন্ধান অবস্থানের আগে শুরু হওয়া সাবটাইটেলগুলি এড়িয়ে যাওয়ার সমস্যাটি ঠিক করুন৷ এই সমস্যাটি শুধুমাত্র Media3 1.4.0-alpha01-এ চালু করা হয়েছে।
    • ডিফল্ট সাবটাইটেল পার্সিং আচরণ পরিবর্তন করুন যাতে এটি রেন্ডারিংয়ের পরিবর্তে নিষ্কাশনের সময় ঘটে ( এক্সোপ্লেয়ারের আর্কিটেকচার ডায়াগ্রামটি নিষ্কাশন এবং রেন্ডারিংয়ের মধ্যে পার্থক্যের জন্য দেখুন)।
      • MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) এবং TextRenderer.experimentalSetLegacyDecodingEnabled(true) উভয় কল করে এই পরিবর্তনটি ওভাররাইড করা যেতে পারে। একটি ExoPlayer উদাহরণে এই উপাদানগুলিকে কীভাবে প্লাম্ব করা যায় তার জন্য কাস্টমাইজেশনের ডক্স দেখুন। এই পদ্ধতিগুলি (এবং লিগ্যাসি সাবটাইটেল ডিকোডিংয়ের জন্য সমস্ত সমর্থন) ভবিষ্যতের রিলিজে সরিয়ে দেওয়া হবে।
      • কাস্টম SubtitleDecoder বাস্তবায়ন সহ অ্যাপগুলিকে SubtitleParser (এবং SubtitleParser.Factory এর পরিবর্তে SubtitleDecoderFactory ) বাস্তবায়ন করতে তাদের আপডেট করতে হবে।
    • PGS: আক্ষরিক রঙের মান ( #1367 ) এর পরিবর্তে, একটি রঙ সূচক হিসাবে 0 সমাধান করতে রান-দৈর্ঘ্য ডিকোডিং ঠিক করুন।
    • CEA-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 )।
  • মেটাডেটা:
    • ID3 সাজানোর ট্যাগ থেকে MP4 এর ম্যাপিং ঠিক করুন। পূর্বে 'অ্যালবাম সর্ট' ( soal ), 'শিল্পী সাজানো' ( soar ) এবং 'অ্যালবাম আর্টিস্ট সর্ট' ( soaa ) MP4 ট্যাগগুলি TSO2 , TSOA এবং TSOP ID3 ট্যাগে ( #1302 ) ভুলভাবে ম্যাপ করা হয়েছিল৷
    • মান এক বাইটের বেশি হলে MP4 (/iTunes) নিউমেরিক gnre (genre) এবং tmpo (টেম্পো) ট্যাগের রিডিং ঠিক করুন।
    • ID3 TCON ফ্রেম MediaMetadata.genre ( #1305 ) এ প্রচার করুন।
  • ছবি:
    • নন-স্কোয়ার ড্যাশ থাম্বনেইল গ্রিডের জন্য সমর্থন যোগ করুন ( #1300 )।
    • API 34+ এর জন্য AVIF এর জন্য সমর্থন যোগ করুন।
    • পূর্বে সেট করা ImageOutput সাফ করার জন্য ExoPlayer.setImageOutput() এর প্যারামিটার হিসাবে null অনুমতি দিন।
  • ডেটা সোর্স:
    • android.resource://package/id raw resource URI-এর জন্য সমর্থন প্রয়োগ করুন যেখানে package বর্তমান অ্যাপ্লিকেশনের প্যাকেজের থেকে আলাদা। এটি কাজ করার জন্য পূর্বে নথিভুক্ত করা হয়নি, তবে নামের তুলনায় অন্য প্যাকেজে সংস্থান অ্যাক্সেস করার আরও কার্যকর উপায়।
    • DataSpec কনস্ট্রাক্টরগুলিতে url অ-শূন্য আছে তা আগ্রহের সাথে চেক করুন। এই প্যারামিটারটি ইতিমধ্যেই নন-নাল বলে টীকা করা হয়েছে।
    • ByteArrayDataSource নির্মাণের সময় হার্ড-কোড করার পরিবর্তে open() চলাকালীন একটি বাইট অ্যারেতে একটি URI সমাধান করার অনুমতি দিন ( #1405 )।
  • DRM:
    • DefaultDrmSessionManagerProvider ( #1271 ) এ একটি LoadErrorHandlingPolicy সেট করার অনুমতি দিন।
  • প্রভাব:
    • SpeedChangeEffect এ একই EditedMediaItem বা Composition মধ্যে একাধিক গতি পরিবর্তন সমর্থন করুন।
    • আল্ট্রা এইচডিআর বিটম্যাপ ইনপুট থেকে HLG এবং PQ আউটপুটের জন্য সমর্থন।
    • EGL_GL_COLORSPACE_BT2020_HLG_EXT এর জন্য সমর্থন যোগ করুন, যা ExoPlayer.setVideoEffect এবং ট্রান্সফরমারের ডিবাগ সারফেসভিউতে HLG পৃষ্ঠের আউটপুট উন্নত করে।
    • setOverlayFrameAnchor() এ প্রয়োগ করা x এবং y মানগুলি ফ্লিপ করে ডকুমেন্টেশনের সাথে সামঞ্জস্যপূর্ণ করতে ওভারলে ম্যাট্রিক্স বাস্তবায়ন আপডেট করুন। OverlaySettings.Builder.setOverlayFrameAnchor() ব্যবহার করলে, তাদের x এবং y মানগুলিকে -1 দ্বারা গুণ করে ফ্লিপ করুন।
    • ExoPlayer#setVideoEffects ( #821 ) এর সাথে ব্যবহার করার সময় যেখানে TimestampWrapper ক্র্যাশ হয় সেখানে বাগ ঠিক করুন।
    • ডিফল্ট SDR রঙের কাজের স্থানকে রৈখিক রং থেকে বৈদ্যুতিক BT 709 SDR ভিডিওতে পরিবর্তন করুন। এছাড়াও মূল রঙের স্থান ধরে রাখতে তৃতীয় বিকল্প প্রদান করুন।
    • EditedMediaItemSequences ( #1055 ) এর অনির্দিষ্ট z-ক্রম সংজ্ঞায়িত করার অনুমতি দিন।
    • HDR বিষয়বস্তুর বিভিন্ন অংশ জুড়ে একটি সামঞ্জস্যপূর্ণ আলোক পরিসর বজায় রাখুন (HLG পরিসর ব্যবহার করে)।
    • HDR সামগ্রীতে আল্ট্রা এইচডিআর (বিটম্যাপ) ওভারলেগুলির জন্য সমর্থন যোগ করুন।
    • API 26 এর আগে SeparableConvolution প্রভাবগুলি ব্যবহার করার অনুমতি দিন।
    • অব্যবহৃত OverlaySettings.useHdr সরান যেহেতু ওভারলে এবং ফ্রেমের গতিশীল পরিসর অবশ্যই মিলবে।
    • TextOverlay এর জন্য HDR সমর্থন যোগ করুন। টেক্সট ওভারলে এর উজ্জ্বলতা OverlaySettings.Builder.setHdrLuminanceMultiplier() দিয়ে সামঞ্জস্য করা যেতে পারে।
  • আইএমএ এক্সটেনশন:
    • স্থিতিশীল করার জন্য DAI বিজ্ঞাপন স্ট্রীম চালানোর জন্য অ্যাপগুলির জন্য প্রয়োজনীয় API-কে প্রচার করুন।
    • ImaServerSideAdInsertionMediaSource.AdLoader এ replaceAdTagParameters(Map <String, String>) যোগ করুন যা রানটাইমে বিজ্ঞাপন ট্যাগ প্যারামিটার প্রতিস্থাপন করতে দেয়।
    • যেখানে VideoAdPlayer.VideoAdPlayerCallback.onError() বলা হয়নি যেখানে বিজ্ঞাপন প্লেব্যাকের সময় প্লেয়ারের ত্রুটি ঘটেছে ( #1334 ) বাগটি ঠিক করুন৷
    • data:// বিজ্ঞাপন ট্যাগ URIs ( #700 ) ব্যবহার করার সময় একটি NullPointerException ঠিক করতে IMA SDK সংস্করণকে 3.33.0 এ বাম্প করুন৷
  • অধিবেশন:
    • CommandButton.enabled এর ডিফল্ট true পরিবর্তন করুন এবং নিশ্চিত করুন যে মানটি কন্ট্রোলারের জন্য মিথ্যা থাকতে পারে এমনকি যদি সংশ্লিষ্ট কমান্ড উপলব্ধ থাকে।
    • CommandButton এর জন্য আইকন ধ্রুবক যোগ করুন যা কাস্টম আইকন সম্পদের পরিবর্তে ব্যবহার করা উচিত।
    • onTaskRemoved() ( #1219 ) এ পরিষেবাটি বন্ধ করা দরকার কিনা তা অ্যাপগুলিকে জিজ্ঞাসা করতে MediaSessionService.isPlaybackOngoing() যোগ করুন।
    • MediaSessionService.pauseAllPlayersAndStopSelf() যোগ করুন যা সুবিধাজনকভাবে সমস্ত সেশনের প্লেব্যাককে বিরতি দিতে এবং MediaSessionService এর জীবনচক্র বন্ধ করতে stopSelf() কল করার অনুমতি দেয়৷
    • একটি নিরাপদ ডিফল্ট বাস্তবায়ন প্রদান করতে MediaSessionService.onTaskRemoved(Intent) ওভাররাইড করুন যা প্লেব্যাক চলমান থাকলে বা অন্যথায় পরিষেবাটি বন্ধ করে দিলে অগ্রভাগে পরিষেবা চালু রাখে।
    • প্ল্যাটফর্ম সেশন মেটাডেটা ( #1256 ) এ সময়কাল সেট না করে লাইভ স্ট্রিমের জন্য মিডিয়া বিজ্ঞপ্তিতে সিকবার লুকান।
    • Media1 এর মতো মেটাডেটা বৈশিষ্ট্য নির্বাচন করার সময় একই পছন্দের ক্রম এবং যুক্তি ব্যবহার করার জন্য MediaMetadata এর MediaDescriptionCompat এ রূপান্তর সারিবদ্ধ করুন।
    • MediaSession.sendError() যোগ করুন যা Media3 কন্ট্রোলারে অ-মারাত্মক ত্রুটি পাঠানোর অনুমতি দেয়। নোটিফিকেশন কন্ট্রোলার ব্যবহার করার সময় (দেখুন MediaSession.getMediaNotificationControllerInfo() ), প্রদত্ত ত্রুটি তথ্য ( #543 ) সহ প্ল্যাটফর্ম সেশনের PlaybackState একটি ত্রুটির অবস্থায় আপডেট করতে কাস্টম ত্রুটি ব্যবহার করা হয়।
    • একটি নির্দিষ্ট কন্ট্রোলার থেকে প্লেয়ার ইন্টারঅ্যাকশনের একটি সিরিজ শেষ হলে সেশনগুলি জানাতে MediaSession.Callback.onPlayerInteractionFinished() যোগ করুন।
    • SessionError যোগ করুন এবং ত্রুটি সম্পর্কে আরও তথ্য প্রদান করতে এবং সম্ভব হলে ত্রুটিটি কীভাবে সমাধান করা যায় সে সম্পর্কে ত্রুটি কোডের পরিবর্তে এটি SessionResult এবং LibraryResult এ ব্যবহার করুন।
    • মিডিয়া 3 কন্ট্রোলার টেস্ট অ্যাপের জন্য কোডটি প্রকাশ করুন যা একটি মিডিয়া সেশন প্রকাশকারী অ্যাপগুলির সাথে ইন্টারঅ্যাকশন পরীক্ষা করতে ব্যবহার করা যেতে পারে।
    • মিডিয়া3-এর 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() ব্যবহার করে ত্রুটির ধরন বেছে নেওয়ার জন্য বা ডিফল্টরূপে চালু থাকা ত্রুটির প্রতিলিপি থেকে অপ্ট-আউট করার মাধ্যমে কনফিগার করা যেতে পারে।
  • UI:
    • একটি ExoPlayer ( #1144 ) এর সাথে সংযুক্ত থাকাকালীন PlayerView এ চিত্র প্রদর্শন সমর্থন যোগ করুন।
    • PlayerControlView বিভিন্ন আইকনের কাস্টমাইজেশন যোগ করুন xml অ্যাট্রিবিউটের মাধ্যমে PlayerView ইন্সট্যান্স প্রতি বিভিন্ন অঙ্কনযোগ্য করার জন্য, গ্লোবাল ওভাররাইডের পরিবর্তে ( #1200 )।
    • API 34 ( #1237 ) এ কম্পোজ AndroidView ভিতরে SurfaceView ব্যবহার করার সময় প্রসারিত/ক্রপ করা ভিডিও তৈরি করে এমন একটি প্ল্যাটফর্ম বাগ নিয়ে কাজ করুন।
  • ডাউনলোড:
    • নিশ্চিত করুন যে DownloadHelper অপ্রকাশিত Renderer দৃষ্টান্ত ফাঁস করে না, যার ফলে অবশেষে IllegalStateException: Too many receivers, total of 1000, registered for pid ( #1224 ) এর জন্য নিবন্ধিত।
  • ক্রোনেট এক্সটেনশন:
    • CronetDataSource এ SocketTimeoutException ঠিক করুন। Cronet এর কিছু সংস্করণে, কলব্যাক দ্বারা প্রদত্ত অনুরোধ সবসময় একই রকম হয় না। এর ফলে কলব্যাক সম্পূর্ণ হয় না এবং টাইমিং আউটের অনুরোধ করে (https://issuetracker.google.com/328442628)।
  • HLS এক্সটেনশন:
    • বাগটি ঠিক করুন যেখানে মুলতুবি থাকা EMSG নমুনাগুলি একটি বিচ্ছিন্নতার জন্য অপেক্ষা করা হয়েছে HlsSampleStreamWrapper এ একটি ভুল অফসেট সহ একটি IndexOutOfBoundsException বা একটি IllegalArgumentException ( #1002 ) সৃষ্টি করে।
    • যেখানে অ-প্রাথমিক প্লেলিস্টগুলি LL-HLS স্ট্রিমগুলির জন্য পুনরায় লোড হতে থাকে সেখানে বাগ ঠিক করুন ( #1240 )৷
    • বাগ ফিক্স করুন যেখানে HLS-এর জন্য CMCD সক্রিয় করার ফলে Source Error এবং IllegalArgumentException হয়েছে।
    • লাইভ প্লেব্যাকের সময় যেখানে নন-প্রাথমিক প্লেলিস্টগুলি রিফ্রেশ হয় না সেখানে বাগ ঠিক করুন ( #1240 )।
    • HLS লাইভ স্ট্রিমগুলির জন্য CMCD সক্ষম করার ফলে ArrayIndexOutOfBoundsException ( #1395 ) হয় যেখানে বাগ ঠিক করুন৷
  • ড্যাশ এক্সটেনশন:
    • বাগ ঠিক করুন যেখানে একটি মাল্টি-পিরিয়ড লাইভ স্ট্রীম পুনরায় প্রস্তুত করলে একটি IndexOutOfBoundsException ( #1329 ) হতে পারে।
    • dashif:Laurl লাইসেন্স ইউআরএল ( #1345 ) এর জন্য সমর্থন যোগ করুন।
  • কাস্ট এক্সটেনশন:
    • MediaQueueItem এর অ্যালবাম শিরোনামটিকে Media3 মিডিয়া আইটেম ( #1255 ) এ শিল্পীর কাছে রূপান্তরিত করা বাগ সংশোধন করুন।
  • পরীক্ষা উপযোগিতা:
    • FakeRenderer এ onInit() এবং onRelease() প্রয়োগ করুন।
    • অপ্রত্যাশিত ত্রুটিগুলি ব্যর্থ করতে TestPlayerRunHelper.runUntil()/playUntil() পদ্ধতিগুলি পরিবর্তন করুন (যেমন যেগুলি AnalyticsListener.onVideoCodecError() এ রিপোর্ট করা হয়েছে)৷ এই আচরণটি নিষ্ক্রিয় করতে নতুন TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() পদ্ধতি চেইন ব্যবহার করুন৷
  • ডেমো অ্যাপ:
    • সংক্ষিপ্ত ফর্ম ডেমো অ্যাপে DefaultPreloadManager ব্যবহার করুন।
    • কমান্ড লাইন ( #1266 ) থেকে Intent আর্গুমেন্ট সহ পুনরাবৃত্তি মোড সেট করার অনুমতি দিন।
    • ডিভাইস দ্বারা সমর্থিত হলে 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

জুন 07, 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 যোগ করুন।
  • এক্সো প্লেয়ার:
    • PreloadMediaPeriod স্ট্রীমগুলিকে আবার প্রিলোড করার সময় ধরে রাখতে পারে না এমন সমস্যার সমাধান করুন।
    • ট্র্যাক পুনঃনির্বাচনের সময় প্লেয়িং পিরিয়ডে সঠিক সংশ্লিষ্ট TrackSelectionResult প্রয়োগ করুন।
    • মিডিয়া আইটেম ( #1017 ) এর মধ্যে স্থানান্তর করার সময় প্লেয়িং পিরিয়ড অগ্রসর হওয়ার পরেই প্রারম্ভিক-সক্ষম রেন্ডারার শুরু করুন।
    • DefaultVideoFrameProcessor.Factory.Builder.build() ( #1187 ) এর জন্য proguard -keepclasseswithmembers নিয়মে অনুপস্থিত রিটার্ন টাইপ যোগ করুন।
  • ট্রান্সফরমার:
    • API 30 এর আগে MediaMuxer নেতিবাচক উপস্থাপনা টাইমস্ট্যাম্প সমর্থন না করার কারণে নিক্ষিপ্ত ব্যতিক্রমের জন্য সমাধান যোগ করুন।
  • ট্র্যাক নির্বাচন:
    • DefaultTrackSelector : কম বা সেট না করা ফ্রেম রেটগুলির তুলনায় 'যুক্তিসঙ্গত' ফ্রেম রেট (>=10fps) সহ ভিডিও ট্র্যাকগুলিকে পছন্দ করুন৷ এটি নিশ্চিত করে যে প্লেয়ারটি মোশন ফটোগুলি থেকে বের করা MP4-এ 'আসল' ভিডিও ট্র্যাক নির্বাচন করে যাতে দুটি HEVC ট্র্যাক থাকতে পারে যেখানে একটির রেজোলিউশন বেশি কিন্তু খুব কম সংখ্যক ফ্রেম ( #1051 )।
  • নিষ্কাশনকারী:
    • WAV ফাইল ( #1117 ) থেকে বিজোড়-আকারের খণ্ড পড়ার সময় যেখানে প্যাডিং এড়িয়ে যাওয়া হয়নি সেই সমস্যাটি ঠিক করুন।
    • MP3: মেটাডেটা ফ্রেম যেমন XING এবং VBRI থেকে Format.averageBitrate পপুলেট করুন।
    • MPEG-TS: একটি পরিবর্তন প্রত্যাবর্তন করুন যার লক্ষ্য শেষ ফ্রেমটি নিশ্চিত করার লক্ষ্যে একটি স্ট্রীমের শেষ অ্যাক্সেস ইউনিটকে নমুনা সারিতে পাস করে ( #7909 )। এটি শুধুমাত্র আই-ফ্রেমের HLS স্ট্রীম ( #1150 ) এবং H.262 HLS স্ট্রীম ( #1126 ) এর সাথে নতুন সমস্যা সৃষ্টি করার কারণে এই পরিবর্তন হয়েছে।
  • অডিও:
    • অডিও ট্র্যাক অফলোড মোডে আরম্ভ করতে ব্যর্থ হলে অফলোড অক্ষম করে রেন্ডারার পুনরুদ্ধারের অনুমতি দিন।
  • ভিডিও:
    • Galaxy Tab S7 FE, Google TV এর সাথে Chromecast এবং Lenovo M10 FHD Plus-এ ডিভাইসের সমস্যার সমাধান যোগ করুন যার ফলে 60fps H265 স্ট্রীম অসমর্থিত হিসাবে চিহ্নিত করা হয়
    • এপিআই ( #1169 ) এর প্রয়োজন অনুযায়ী ডিভাইসটি স্বয়ংক্রিয়ভাবে এটি না করলেও টানেলিং করার সময় প্রথম ফ্রেমটি সর্বদা রেন্ডার করা নিশ্চিত করে এমন সমাধান যোগ করুন। ( #966 )।
    • HDR কালার ইনফো হ্যান্ডলিং কোডেক খারাপ আচরণের কারণ হয় এবং SDR ভিডিও ট্র্যাকের জন্য অভিযোজিত ফর্ম্যাট সুইচ প্রতিরোধ করে এমন সমস্যাটি সমাধান করুন ( #1158 )।
  • পাঠ্য:
    • WebVTT: WebvttParser.parse ( #1177 ) থেকে বানোয়াট অতিরিক্ত CuesWithTiming দৃষ্টান্ত তৈরি করা থেকে সরাসরি ধারাবাহিক সংকেতগুলিকে আটকান।
  • DRM:
    • একটি NoSuchMethodError নিয়ে কাজ করুন যা কিছু Android 14 ডিভাইসে ResourceBusyException বা NotProvisionedException এর পরিবর্তে MediaDrm ফ্রেমওয়ার্ক দ্বারা নিক্ষেপ করা যেতে পারে ( #1145 )।
  • প্রভাব:
    • রঙের স্থানগুলিকে রূপান্তর করে PQ থেকে SDR টোন-ম্যাপিং উন্নত করা হয়েছে।
  • অধিবেশন:
    • কন্ট্রোলার বর্তমান আইটেম ( #951 ) প্রতিস্থাপন করলে বর্তমান অবস্থান যেখানে ফিরে যায় সেই সমস্যাটি ঠিক করুন।
    • মিডিয়া কন্ট্রোলার এবং সেশনের মধ্যে যেখানে MediaMetadata শুধুমাত্র নন-নাল extras সহ প্রেরিত হয় না সেখানে সমস্যাটি ঠিক করুন ( #1176 )।
  • UI:
    • অডিও ট্র্যাক ভাষার নাম অন্তর্ভুক্ত করতে ফলব্যাক যদি Locale একটি প্রদর্শন নাম সনাক্ত করতে না পারে ( #988 )।
  • ড্যাশ এক্সটেনশন:
    • ম্যানিফেস্ট থেকে Format.labels ( #1054 ) এ সমস্ত Label উপাদান পূরণ করুন।
  • RTSP এক্সটেনশন:
    • এসডিপি পার্সিং ( #1087 ) এ খালি সেশন তথ্য মানগুলি (আই-ট্যাগ) এড়িয়ে যান।
  • ডিকোডার এক্সটেনশনস (এফএফএমপিইজি, ভিপি 9, এভি 1, এমআইডিআই ইত্যাদি):
    • ডিফল্টরূপে স্থানীয় নির্ভরতা হিসাবে এমআইডিআই এক্সটেনশনটি অক্ষম করুন কারণ এটি কনফিগার করার জন্য একটি অতিরিক্ত মাভেন রিপোজিটরি প্রয়োজন। স্থানীয় নির্ভরতা থেকে এই মডিউলটির প্রয়োজন এমন ব্যবহারকারীরা এটি পুনরায় সক্ষম করতে পারেন ।

সংস্করণ 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 (অ্যান্ড্রয়েড কিটকাট) এ বাড়ান। এটি অন্যান্য সমস্ত অ্যান্ড্রয়েডএক্স লাইব্রেরির সাথে একত্রিত , এবং আমাদের অ্যান্ড্রয়েডএক্স নির্ভরতার সর্বশেষ সংস্করণগুলিতে আপগ্রেড করার জন্য আমাদের প্রয়োজন।
    • MediaMetadata.Builder.populate(MediaMetadata) এ artworkUri এবং artworkData উভয়কেই জনপ্রিয় করুন যখন তাদের মধ্যে কমপক্ষে একটি নাল ( #964 ) হয়।
  • এক্সপ্লেয়ার:
    • PreloadMediaSource এবং PreloadMediaPeriod যুক্ত করুন যা অ্যাপ্লিকেশনগুলিকে প্লেব্যাকের আগে একটি নির্দিষ্ট শুরুর অবস্থানে একটি সামগ্রী মিডিয়া উত্স প্রিলোড করতে দেয়। PreloadMediaSource Timeline পাওয়ার জন্য সামগ্রী মিডিয়া উত্স প্রস্তুত করার, প্রদত্ত শুরুর অবস্থানে পিরিয়ড প্রস্তুত এবং ক্যাশে, ট্র্যাকগুলি নির্বাচন করা এবং সময়ের জন্য মিডিয়া ডেটা লোড করার জন্য সামগ্রী মিডিয়া উত্স প্রস্তুত করার যত্ন নেয়। অ্যাপ্লিকেশনগুলি PreloadMediaSource.PreloadControl প্রয়োগ করে প্রিলোড অগ্রগতি নিয়ন্ত্রণ করে এবং প্লেব্যাকের জন্য প্লেয়ারকে প্রিলোড উত্সটি সেট করে।
    • ExoPlayer.setImageOutput যুক্ত করুন যা অ্যাপ্লিকেশনগুলিকে ImageRenderer.ImageOutput সেট করতে দেয়।
    • DefaultRenderersFactory এখন নাল ImageOutput এবং ImageDecoder.Factory.DEFAULT সহ ডিফল্টরূপে প্লেয়ারকে একটি ImageRenderer সরবরাহ করে।
    • Player.Listener.onPositionDiscontinuity ।
    • নিষ্কাশনের সময় সাবটাইটেলগুলি পার্স করার জন্য পরীক্ষামূলক সমর্থন যুক্ত করুন। আপনি এটি MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ব্যবহার করে এটি সক্ষম করতে পারেন।
    • PreloadMediaSource সহ অভিযোজিত মিডিয়া উত্সগুলিকে সমর্থন করুন।
    • HttpEngineDataSource , HttpDataSource httpengine এপিআই ব্যবহার করে প্রয়োগ করুন।
    • সাবক্লাসিং CompositeSequenceableLoader প্রতিরোধ করুন। এই উপাদানটি পূর্বে এক্সটেনসিবল করা হয়েছিল তবে লাইব্রেরির মধ্যে কখনও সাবক্লাস করা হয়নি। ডেকরেটর প্যাটার্ন ব্যবহার করে একটি উদাহরণ মোড়ানো এবং একটি কাস্টম CompositeSequenceableLoaderFactory প্রয়োগ করে কাস্টমাইজেশনগুলি করা যেতে পারে।
    • সমস্যাটি ঠিক করুন যেখানে একই সময়ে পুনরাবৃত্তি করার ফলে এই আইটেমটি থেকে মেটাডেটা সাফ হয়ে যায় ( #1007 )।
    • BundledChunkExtractor.Factory এবং DefaultHlsExtractorFactory setSubtitleParserFactory এবং পাস null অস্বীকার করার জন্য experimentalSetSubtitleParserFactory পদ্ধতিগুলির নামকরণ করুন। পার্সিং আচরণ নিয়ন্ত্রণের জন্য নতুন experimentalParseSubtitlesDuringExtraction(boolean) পদ্ধতিগুলি ব্যবহার করুন।
    • SubtitleParser.Factory কাস্টমাইজ করার জন্য সমর্থন যুক্ত করুন at এক্সট্রাকশন চলাকালীন ব্যবহৃত ফ্যাক্টরি। এটি MediaSource.Factory.setSubtitleParserFactory() দিয়ে অর্জন করা যেতে পারে।
    • MergingMediaSource থেকে উত্পন্ন সমস্ত Format.id ক্ষেত্রগুলিতে উত্স উপসর্গ যুক্ত করুন। এটি কোন উত্সটি একটি Format তৈরি করেছে তা সনাক্ত করতে সহায়তা করে ( #883 )।
    • কাস্টম কমন মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) কী নামগুলি কেবল হাইফেন ( #1028 ) এর জন্য এটি সংশোধন করে কী নামগুলি বৈধ করার জন্য ব্যবহৃত রেজেক্সটি ঠিক করুন।
    • ডাবল-এনকোডিং সিএমসিডি ক্যোয়ারী প্যারামিটারগুলি ( #1075 ) বন্ধ করুন।
  • ট্রান্সফরমার:
    • এইচ .265/এইচইভিসি এসইএফ স্লো মোশন ভিডিওগুলি সমতল করার জন্য সমর্থন যুক্ত করুন।
    • ট্রান্সমাক্সিংয়ের গতি বাড়ান, বিশেষত 'ভিডিও সরান' সম্পাদনাগুলির জন্য।
    • আউটপুট ফাইলটি কোনও ভিডিও ফ্রেমে শুরু হয় তা নিশ্চিত করতে API যুক্ত করুন। এটি প্লেয়ার বাস্তবায়নের সাথে ট্রিমিং অপারেশনগুলির আউটপুটকে আরও সামঞ্জস্যপূর্ণ করে তুলতে পারে যা প্রথম ভিডিও ফ্রেমটি উপস্থাপনা টাইমস্ট্যাম্প ( #829 ) না হওয়া পর্যন্ত দেখায় না।
    • একক সম্পদ এমপি 4 ট্রিম অপারেশন অনুকূলকরণের জন্য সমর্থন যুক্ত করুন।
    • আউটপুট ফাইলে কোনও ভিডিও ফ্রেমের প্রথম টাইমস্ট্যাম্প রয়েছে তা নিশ্চিত করতে সহায়তা যুক্ত করুন। আইওএস ভিত্তিক প্লেয়ারগুলিতে কালো ফ্রেম দিয়ে শুরু হওয়া আউটপুট ফাইলগুলি ফিক্স করে ( #829 )।
  • ট্র্যাক নির্বাচন:
    • চিত্র ট্র্যাক নির্বাচন সক্ষম করতে DefaultTrackSelector.selectImageTrack যুক্ত করুন।
    • TrackSelectionParameters.isPrioritizeImageOverVideoEnabled যুক্ত করুন is ডিফল্ট মানটি false যার অর্থ একটি ভিডিও ট্র্যাক নির্বাচন করা অগ্রাধিকার দেওয়া হয়।
  • এক্সট্র্যাক্টর:
    • ColorInfo.colorSpace , ColorInfo.colorTransfer এবং ColorInfo.colorRange মান ( #692 ) পুনরুদ্ধার করতে এমপি 4 এক্সট্র্যাক্টরে অতিরিক্ত এভি 1 সি পার্সিং যুক্ত করুন।
    • এমপি 3: একটি Info শিরোনাম ( Xing হেডারের সিবিআর সমতুল্য) সহ ফাইলগুলির জন্য ধ্রুবক বিট্রেট (সিবিআর) ব্যবহার করুন। পূর্বে আমরা Info শিরোনাম থেকে সিক টেবিলটি ব্যবহার করেছি, তবে এর ফলে আমরা এটি উপেক্ষা করে এবং ফাইলটি সিবিআর বলে ধরে নিই তার চেয়ে কম সুনির্দিষ্ট সন্ধান করতে পারে।
    • এমপিইজি 2-টিএস: ডিটিএস, ডিটিএস-এলবিআর এবং ডিটিএস যুক্ত করুন: এক্স প্রোফাইল 2 সমর্থন ( #275 )।
    • টিএস বর্ণনাকারীদের কাছ থেকে অডিও প্রকারগুলি বের করুন এবং তাদের পতাকাগুলিতে ম্যাপ করুন, ব্যবহারকারীদের আরও ভাল-অবহিত অডিও ট্র্যাক নির্বাচনগুলি ( #973 ) করার অনুমতি দেয়।
  • অডিও:
    • মসৃণ ভলিউম র‌্যাম্পের সাথে অ্যালগরিদম এড়িয়ে যাওয়া নীরবতা উন্নত করুন; ন্যূনতম নীরবতা এবং আরও প্রাকৃতিক নীরবতার সময়কাল ধরে রাখা ( #7423 )।
    • এড়িয়ে যাওয়া নীরবতা আরও নির্ধারিতভাবে রিপোর্ট করুন ( #1035 )।
  • ভিডিও:
    • MediaCodecVideoRenderer কনস্ট্রাক্টর পরিবর্তন করুন যা একটি VideoFrameProcessor.Factory নেয় Fact ফ্যাক্টরি আর্গুমেন্ট গ্রহণ করে এবং এটি একটি কনস্ট্রাক্টর দিয়ে প্রতিস্থাপন করুন যা একটি VideoSinkProvider যুক্তি নেয়। অ্যাপ্লিকেশনগুলি MediaCodecVideoRenderer একটি কাস্টম VideoFrameProcessor.Factory CompositingVideoSinkProvider করতে চায় VideoFrameProcessor.Factory
  • পাঠ্য:
    • সমাধানের জন্য বিটম্যাপ সংকেতগুলির সিরিয়ালাইজেশন ঠিক করুন একটি পার্সেল মার্শাল করার চেষ্টা করেছিলেন যাতে DefaultExtractorsFactory.setTextTrackTranscodingEnabled ( #836 ) ব্যবহার করার সময় Tried to marshall a Parcel that contained Binder objects ।
    • সিইএ -708: rowLock মান উপেক্ষা করুন। সিইএ -708-ই এস -2023 স্পেসে বলা হয়েছে যে স্ট্রিমের উপস্থিত মানগুলি নির্বিশেষে rowLock এবং columnLock উভয়কেই সত্য বলে ধরে নেওয়া উচিত ( columnLock সমর্থন প্রয়োগ করা হয়নি, সুতরাং এটি কার্যকরভাবে সর্বদা মিথ্যা বলে ধরে নেওয়া হয়)।
  • ছবি:
    • ড্যাশ থাম্বনেইলগুলির জন্য সমর্থন যুক্ত করুন। গ্রিড চিত্রগুলি ক্রপযুক্ত এবং পৃথক থাম্বনেইলগুলি তাদের উপস্থাপনার সময়গুলির কাছাকাছি ImageOutput সরবরাহ করা হয়।
  • DRM:
    • ডিফল্টরূপে অবিলম্বে ডিআরএম সামগ্রীতে 'ক্লিয়ার লিড' আনক্রিপ্ট করা নমুনাগুলি খেলুন, এমনকি পরবর্তী এনক্রিপ্ট করা নমুনাগুলির কীগুলি এখনও প্রস্তুত না হলেও। প্লেব্যাকের অবস্থানটি এনক্রিপ্ট করা নমুনাগুলিতে পৌঁছানোর সময় কীগুলি এখনও প্রস্তুত না থাকলে এটি মিড-প্লেব্যাক স্টলগুলির দিকে নিয়ে যেতে পারে (তবে পূর্বে প্লেব্যাক এই মুহুর্তে মোটেও শুরু হত না)। এই আচরণটি MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey ক্লারকন্টেন্টওয়াইথআউটকি বা DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys উইথআউটকেইস দিয়ে অক্ষম করা যেতে পারে।
  • আইএমএ এক্সটেনশন:
    • উপযুক্ত ফাইল এক্সটেনশন ছাড়াই ড্যাশ এবং এইচএলএস বিজ্ঞাপনগুলি যেখানে প্লে করা যায় না সেখানে সমস্যাটি ঠিক করুন।
  • অধিবেশন:
    • টিভি অ্যাপ্লিকেশনগুলির জন্য ডাবল-ক্লিক সনাক্তকরণ অক্ষম করুন ( #962 )।
    • সমস্যাটি সমাধান করুন যেখানে MediaItem.RequestMetadata কেবল নন-নাল অতিরিক্ত সহ মিডিয়া কন্ট্রোলার এবং সেশনের মধ্যে সংক্রমণিত হয় না।
    • MediaLibrarySession.Builder কনস্ট্রাক্টর যুক্ত করুন যা কেবলমাত্র MediaLibraryService পরিবর্তে একটি Context নেয়।
  • এইচএলএস এক্সটেনশন:
    • প্যাকেজ-বেসরকারী দৃশ্যমানতায় HlsMediaPeriod হ্রাস করুন। এই ধরণের এইচএলএস প্যাকেজের বাইরে থেকে সরাসরি নির্ভর করা উচিত নয়।
    • সমাধান করুন আরও দক্ষতার সাথে একটি বিভাগ শুরু করার চেষ্টা করে ( #1031 )।
  • ডিকোডার এক্সটেনশনস (এফএফএমপিইজি, ভিপি 9, এভি 1, এমআইডিআই ইত্যাদি):
    • এমআইডিআই ডিকোডার: সিসেক্স ইভেন্ট বার্তাগুলি উপেক্ষা করুন ( #710 )।
  • পরীক্ষার ইউটিলিটিস:
    • TestPlayerRunHelper.playUntilPosition প্লেব্যাক বিরতি দেবেন না। পরীক্ষাটি প্লেব্যাককে একটি খেলার অবস্থায় রাখে, তবে পরীক্ষাটি দৃ ser ়তা এবং আরও ক্রিয়া যুক্ত করতে সক্ষম না হওয়া পর্যন্ত অগ্রগতি স্থগিত করে।
  • ডেমো অ্যাপ:
    • শর্ট-ফর্ম সামগ্রী ব্যবহারের ক্ষেত্রে 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

  • এক্সপ্লেয়ার:
    • ইস্যু ঠিক করুন যেখানে ম্যানুয়াল LiveConfiguration.min/maxOffset বাইরে চায় min/maxOffset
    • ইস্যু করুন যে ওপাস এবং ভোর্বিস চ্যানেল লেআউটগুলি 3, 5, 6, 7 এবং 8 চ্যানেলের ( #8396 ) এর জন্য ভুল।
    • একটি লাইভ স্ট্রিমে শূন্য করার পরে ট্র্যাক নির্বাচনগুলি যেখানে ভুলভাবে স্ট্রিমটি তার ডিফল্ট অবস্থানে ( #9347 ) শুরু করতে দিন সেখানে ট্র্যাক নির্বাচনগুলি ঠিক করুন।
    • CmcdData.Factory নতুন দৃষ্টান্তগুলি যেখানে অংশের উত্স থেকে bufferedDurationUs জন্য নেতিবাচক মানগুলি গ্রহণ করছে, সেই সমস্যাটি সমাধান করুন, যার ফলে একটি IllegalArgumentException ( #888 ) তৈরি হয়েছিল।
  • ট্রান্সফরমার:
    • এমন কোনও সমস্যা নিয়ে কাজ করুন যেখানে উচ্চ অপারেটিং হার নির্ধারণের কারণে এনকোডার কনফিগারেশনের সময় নিক্ষেপ করবে।
  • এক্সট্র্যাক্টর:
    • মার্ক মাধ্যমিক (প্লেযোগ্য) এইচইভিসি ট্র্যাকগুলি জেপিইজি মোশন ফটোগুলিতে ROLE_FLAG_ALTERNATE হিসাবে তাদের উচ্চতর রেজোলিউশনের কারণে প্লেব্যাকের জন্য স্বয়ংক্রিয়ভাবে নির্বাচিত হওয়া রোধ করতে পারে।
    • টিএস এইচ 264 স্ট্রিমগুলির জন্য ভুল কীফ্রেম সনাক্তকরণ ঠিক করুন ( #864 )।
    • 47721 সেকেন্ডের চেয়ে দীর্ঘ ( #855 ) টিএস স্ট্রিমগুলির সময়কাল অনুমান করুন।
  • অডিও:
    • একাধিকবার ( #712 ) বলা হয় যখন SilenceSkippingAudioProcessor জন্য EOS এর হ্যান্ডলিং ঠিক করুন।
  • ভিডিও:
    • Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with Google TV, and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #693 ).
  • মেটাডেটা:
    • বাগটি ফিক্স করুন যেখানে MediaMetadata কেবল উচ্চ-কেস কীগুলি ( #876 ) দিয়ে ভোর্বিস মন্তব্য থেকে জনবহুল ছিল।
    • খুব বড় আইডি 3 ফ্রেমগুলি পার্স করার সময় OutOfMemoryError ধরুন, যার অর্থ প্লেব্যাক পুরোপুরি ব্যর্থ হওয়ার পরিবর্তে ট্যাগ তথ্য ছাড়াই চালিয়ে যেতে পারে।
  • DRM:
    • স্পিউরিয়াস ক্লিয়ারকি https://default.url লাইসেন্স ইউআরএল এর জন্য এপিআই 33+ এর জন্য ওয়ার্কআরাউন্ড প্রসারিত করুন (পূর্বে কেবলমাত্র এপিআই 33 এ প্রয়োগ করা ওয়ার্কআউটআউন্ডটি ঠিক প্রয়োগ করা হয়েছে) ( #837 )।
    • প্লেয়ারটির সাথে সংযুক্ত কোনও পৃষ্ঠ ছাড়াই এনক্রিপ্ট করা থেকে কনক্রিপ্ট করা থেকে স্যুইচ করার সময় ERROR_DRM_SESSION_NOT_OPENED করুন। ত্রুটিটি পরিষ্কার সামগ্রী খেলতে ভুলভাবে একটি সুরক্ষিত ডিকোডার ব্যবহার করার কারণে হয়েছিল।
  • অধিবেশন:
    • MediaMetadata.extras এবং MediaMetadata.extras MediaMetadataCompat ( #756 , #802 ) এ MediaMetadataCompat কাস্টম কী এবং মানগুলি রাখুন।
    • লিগ্যাসি কন্ট্রোলারদের জন্য ব্রডকাস্টিং notifyChildrenChanged ফিক্স করুন ( #644 )।
    • একটি বাগ ঠিক করুন যেখানে বিজ্ঞপ্তিটির টাইমার যখন কোনও প্রতিবন্ধী setWhen জন্য নেতিবাচক সময় নির্ধারণ করা কিছু ডিভাইসে ক্র্যাশ ঘটায় ( #903 )।
    • যখন প্রথম বিজ্ঞপ্তি আপডেটের জন্য অনুরোধ করা হয় ( #917 ) যখন মিডিয়া বিজ্ঞপ্তি কন্ট্রোলার সংযোগ শেষ না করে তখন IllegalStateException ঠিক করুন।
  • UI:
    • ইস্যু ঠিক করুন যেখানে বটমশিটডিয়ালোগফ্র্যাগমেন্টে ( #511 ) উপাদান ডিজাইনের সাথে ব্যবহার করার সময় ফরোয়ার্ড এবং রিওয়াইন্ড বোতামগুলি দৃশ্যমান হয় না।
    • PlayerControlView দ্রুত ফরোয়ার্ড বোতামের সংখ্যাগুলি ভুলভাবে চিহ্নিত করা হয়েছিল ( #547 ) সমস্যাটি সমাধান করুন।
  • ড্যাশ এক্সটেনশন:
    • ড্যাশ ম্যানিফেস্টে ডলবির জন্য 5 এর চ্যানেল গণনা হিসাবে "F800" পার্স ( #688 )।
  • ডিকোডার এক্সটেনশনস (এফএফএমপিইজি, ভিপি 9, এভি 1, এমআইডিআই ইত্যাদি):
    • এমআইডিআই: সমস্যাটি সমাধান করুন যেখানে ফরোয়ার্ড সন্ধান করা প্রোগ্রাম পরিবর্তন ইভেন্টগুলি ( #704 ) এড়িয়ে যান।
    • এফএফএমপিইজি 6.0 এ স্থানান্তর করুন এবং এনডিকে r26b ( #707 , #867 ) এ সমর্থন করেছেন।
  • কাস্ট এক্সটেনশন:
    • কাস্ট ডিভাইসে ( #708 ) মিডিয়া লোড করার সময় অ্যাপ্লিকেশনটি ক্রাশ না করার জন্য একটি Timeline তৈরি স্যানিটাইজ করুন।

সংস্করণ 1.2.0

15 নভেম্বর, 2023

  • সাধারণ গ্রন্থাগার:
    • Log.Logger ইন্টারফেসের পদ্ধতিগুলিতে একটি @Nullable Throwable প্যারামিটার যুক্ত করুন। এই পদ্ধতিগুলির message প্যারামিটারে আর লগকে দেওয়া Throwable সম্পর্কে কোনও তথ্য নেই Log.{d,i,w,e}() পদ্ধতিগুলি, সুতরাং বাস্তবায়নগুলি যদি ইচ্ছা হলে এই তথ্যটি ম্যানুয়ালি সংযোজন করতে হবে (সম্ভবত Logger.appendThrowableString(String, Throwable) ব্যবহার করে। Logger.appendThrowableString(String, Throwable) )।
    • কোটলিন সামঞ্জস্যতার সমস্যাটি ঠিক করুন যেখানে বাতিলযোগ্য জেনেরিক টাইপ প্যারামিটার এবং বাতিলযোগ্য অ্যারে উপাদান প্রকারগুলি বাতিলযোগ্য হিসাবে সনাক্ত করা যায় না। উদাহরণগুলি হ'ল TrackSelectorResult এবং SimpleDecoder পদ্ধতি পরামিতি ( #6792 )।
    • প্লেব্যাক অস্থায়ীভাবে দমন করা হলে (যেমন ক্ষণস্থায়ী অডিও ফোকাস ক্ষতির কারণে) একটি "প্লে" বোতামটি দেখানোর জন্য Util.shouldShowPlayButton ডিফল্ট ইউআই এবং বিজ্ঞপ্তি আচরণ পরিবর্তন করুন uld লিগ্যাসি আচরণটি PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) বা MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) ( #11213 ) ব্যবহার করে বজায় রাখা যেতে পারে।
    • আপগ্রেড androidx.annotation:annotation-experimental 1.3.1 এ।
    • Player ইন্টারফেসে ExoPlayer.setAudioAttributes সরান।
  • এক্সপ্লেয়ার:
    • ডিকোড-কেবলমাত্র নমুনাগুলি সঠিকভাবে সনাক্ত না করার কারণে এসি 4 স্ট্রিমগুলিতে সমস্যাগুলি সন্ধান করুন ( #11000 )।
    • অনুপযুক্ত অডিও আউটপুট ডিভাইসগুলিতে প্লেব্যাকের দমন যোগ করুন (যেমন ওয়েয়ার ওএস ডিভাইসে অন্তর্নির্মিত স্পিকার) যখন এই বৈশিষ্ট্যটি ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput আউটপুটটির মাধ্যমে সক্ষম করা হয়। প্লেব্যাক দমন কারণটি Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT হিসাবে আপডেট করা হবে Play উপযুক্ত আউটপুট সংযুক্ত থাকলে দমন কারণটি সরানো হবে।
    • MediaSource.canUpdateMediaItem এবং MediaSource.updateMediaItem যোগ করুন MediaItem আপডেটগুলি Player.replaceMediaItem(s) মাধ্যমে তৈরির পরে গ্রহণের জন্য।
    • Player.replaceMediaItem(s) ( #33 , #9978 ) এর মাধ্যমে লাইব্রেরি দ্বারা সরবরাহিত সমস্ত MediaSource ক্লাসের জন্য MediaItem আপডেটের অনুমতি দিন।
    • MimeTypes.TEXT_EXOPLAYER_CUES থেকে MimeTypes.APPLICATION_MEDIA3_CUES করুন।
    • PngExtractor যুক্ত করুন যা একটি নমুনা হিসাবে TrackOutput একটি সম্পূর্ণ পিএনজি ফাইল প্রেরণ করে এবং পড়তে পারে।
    • SequenceableLoader.continueLoading(long) SequenceableLoader ইন্টারফেসে সিকোয়েন্সি ব্লাডার ইন্টারফেসে SequenceableLoader.continueLoading(LoadingInfo loadingInfo) বাড়ান। LoadingInfo বিদ্যমান playbackPositionUs ছাড়াও playbackSpeed এবং lastRebufferRealtimeMs সহ অতিরিক্ত পরামিতি রয়েছে।
    • ChunkSource.getNextChunk(long, long, List, ChunkHolder) ChunkSource ইন্টারফেসে ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) উন্নত করুন।
    • সাধারণ মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) লগিংয়ে অতিরিক্ত ক্ষেত্র যুক্ত করুন: বাফার স্টারভেশন ( bs ), ডেডলাইন ( dl ), প্লেব্যাক রেট ( pr ) এবং স্টার্টআপ ( su ) ( #8699 )।
    • লুমা এবং ক্রোমা বিটডেপথকে ColorInfo যুক্ত করুন ( #491 )।
    • সাধারণ মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) লগিংয়ে অতিরিক্ত ক্ষেত্র যুক্ত করুন: পরবর্তী অবজেক্ট রিকোয়েস্ট ( nor ) এবং পরবর্তী পরিসীমা অনুরোধ ( nrr ) ( #8699 )।
    • ক্যোয়ারী প্যারামিটারগুলি ( #553 ) ব্যবহার করে সাধারণ মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) ডেটা প্রেরণ করতে কার্যকারিতা যুক্ত করুন।
    • ExperimentalBandwidthMeter ( #612 ) ConcurrentModificationException ঠিক করুন।
    • CompositeMediaSource.getMediaTimeForChildMediaTime MediaPeriodId প্যারামিটার যুক্ত করুন।
    • ConcatenatingMediaSource2 ( #11226 ) এ ClippingMediaSource (এবং পিরিয়ড/উইন্ডো টাইম অফসেট সহ অন্যান্য উত্সগুলি) সমর্থন করুন।
    • একটি MediaPeriodId যুক্তি পেতে BaseRenderer.onStreamChanged() পরিবর্তন করুন।
  • ট্রান্সফরমার:
    • চিত্র ইনপুটগুলির জন্য পার্স এক্সিফ রোটেশন ডেটা।
    • TransformationRequest.HdrMode টীকাটি প্রকার এবং এর সাথে সম্পর্কিত ধ্রুবকগুলি সরান। এর পরিবর্তে Composition.HdrMode এবং এর সাথে সম্পর্কিত ধ্রুবকগুলি ব্যবহার করুন।
    • ঘূর্ণন সমস্যাগুলি ঠিক করতে OverlaySettings সহজ করুন।
    • TimestampIterator SampleConsumer.queueInputBitmap frameRate এবং durationUs পরামিতি পরিবর্তিত হয়েছে।
  • ট্র্যাক নির্বাচন:
    • DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness যুক্ত করুন। অ-সামুদ্রিকবিহীন অভিযোজনকে স্পষ্টভাবে মঞ্জুরি দিতে বা বাতিল করতে allowaudiononsaseasteaptivey ডিফল্টটি true বর্তমান আচরণে থাকে।
  • এক্সট্র্যাক্টর:
    • এমপিইজি-টিএস: নিশ্চিত করুন যে শেষ ফ্রেমটি স্যাম্পল কাতারে ( #7909 ) একটি স্ট্রিমের শেষ অ্যাক্সেস ইউনিটটি পাস করে রেন্ডার করা হয়েছে।
    • rotationDegrees নির্ধারণ করার সময় টাইপো ঠিক করুন। projectionPosePitch projectionPoseRoll ( #461 ) এ পরিবর্তিত হয়েছে।
    • এই ধারণাটি সরান যে Extractor উদাহরণগুলি সরাসরি instanceof দিয়ে পরিদর্শন করা যেতে পারে। আপনি যদি কোনও Extractor বাস্তবায়নের বিবরণে রানটাইম অ্যাক্সেস চান তবে আপনাকে প্রথমে Extractor.getUnderlyingInstance কল করতে হবে get
    • BmpExtractor যুক্ত করুন।
    • WebpExtractor যুক্ত করুন।
    • HeifExtractor যুক্ত করুন।
    • Mp4Extractor কুইকটাইম ক্লাসিক সমর্থন যুক্ত করুন।
  • অডিও:
    • এমপি 4 এবং ম্যাট্রোস্কায় 24/32-বিট বিগ-এন্ডিয়ান পিসিএম এবং এমপি 4 এ lpcm জন্য পার্স পিসিএম এনকোডিংয়ের জন্য সমর্থন যুক্ত করুন।
    • এমপি 4 এ ভোর্বিস অডিও আহরণের জন্য সমর্থন যুক্ত করুন।
    • 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 করুন।
    • অফলোড প্লেব্যাকের সময় ওপাস গ্যাপলেস মেটাডেটার জন্য সমর্থন যুক্ত করুন।
    • প্রথম লিখতে ব্যর্থ হলে ( #627 ) অফলোড অক্ষম করে রেন্ডারার পুনরুদ্ধারের অনুমতি দিন।
    • অডিও-কেবলমাত্র অডিওলড প্লেব্যাকের জন্য ডিফল্টরূপে অফলোড শিডিয়ুলিং সক্ষম করুন।
    • ExoPlayer.experimentalSetOffloadSchedulingEnabled মুছুন AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged
    • onExperimentalSleepingForOffloadChanged onSleepingForOffloadChanged এবং onExperimentalOffloadedPlayback onOffloadedPlayback হিসাবে নামকরণ করা হয়েছে।
    • একটি অভ্যন্তরীণ AudioOffloadPreferences ক্লাসে অডিও অডিও অফলোড মোড সম্পর্কিত TrackSelectionParameters ইন্টারফেস এবং সংজ্ঞাগুলি সরান।
    • AnalyticsListener , AudioRendererEventListener এবং AudioSink.Listener onAudioTrackInitialized এবং onAudioTrackReleased কলব্যাকগুলি যুক্ত করুন।
    • ফিক্স ডিটিএস এক্সপ্রেস অডিও বাফার আন্ডারফ্লো ইস্যু ( #650 )।
    • E-AC3-JOC এর জন্য ক্ষমতাগুলি চেক করুন যেখানে বাগটি ঠিক করুন একটি IllegalArgumentException ( #677 ) ছুড়ে দেয়।
  • ভিডিও:
    • MediaCodecVideoRenderer একটি কাস্টম VideoFrameProcessor.Factory ব্যবহার করার অনুমতি দিন।
    • অডিও স্ট্রিমটি নেতিবাচক টাইমস্ট্যাম্পগুলি ( #291 ) দিয়ে শুরু হলে প্রথম ফ্রেমটি রেন্ডার করা যায় না এমন বাগটি ঠিক করুন।
  • পাঠ্য:
    • ExoplayerCuesDecoder সরান। sampleMimeType = application/x-media3-cues সহ পাঠ্য ট্র্যাকগুলি এখন SubtitleDecoder উদাহরণের প্রয়োজন ছাড়াই সরাসরি TextRenderer দ্বারা পরিচালিত হয়।
  • মেটাডেটা:
    • MetadataDecoder.decode আর "ডিকোড-কেবল" নমুনার জন্য আর ডাকা হবে না কারণ বাস্তবায়ন অবশ্যই নাল ফিরে আসতে হবে।
  • প্রভাব:
    • টাইমস্ট্যাম্প দ্বারা বিটম্যাপ ইনপুটটি কুইউয়িং বিটম্যাপ ইনপুট VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) যুক্ত করুন।
    • VideoFrameProcessor.registerInputStream() rege অ্যাপ্লিকেশনগুলি অবশ্যই VideoFrameProcessor.Listener#onInputStreamRegistered() প্রয়োগ করতে হবে।
    • VideoFrameProcessor.queueInputBitmap TimestampIterator frameRate এবং durationUs প্যারামিটারগুলি পরিবর্তিত হয়েছে।
  • আইএমএ এক্সটেনশন:
    • প্লেলিস্টের প্রথম আইটেম নয় এমন একটি মাল্টি-পিরিয়ড ড্যাশ লাইভ স্ট্রিম যেখানে একটি ব্যতিক্রম ( #571 ) ছুঁড়ে ফেলতে পারে সেখানে বাগটি ঠিক করুন।
    • AdsLoader.destroy() কল করার আগে স্ট্রিম ম্যানেজারটি প্রকাশ করুন
    • ইমাম এসডিকে সংস্করণটি 3.31.0 এ বাম্প করুন।
  • অধিবেশন:
    • DefaultMediaNotificationProvider প্রোভাইডারে ( #167 ) FOREGROUND_SERVICE_IMMEDIATE বিজ্ঞপ্তিগুলি অগ্রভাগের পরিষেবা আচরণটি সেট করুন।
    • স্যামসুং ডিভাইসগুলিতে অবনমিত এপিআইয়ের সমস্যা এড়াতে কেবল android.media.session.MediaSession.setMediaButtonBroadcastReceiver() এর উপরে এপিআই 31 এর উপরে ব্যবহার করুন ( #167 )।
    • বিজ্ঞপ্তি এবং প্ল্যাটফর্ম সেশনটি পপুলেট করতে ব্যবহৃত কমান্ড এবং কাস্টম লেআউট সেট করতে মিডিয়া বিজ্ঞপ্তি নিয়ামককে প্রক্সি হিসাবে ব্যবহার করুন।
    • মিডিয়া বোতামের ইভেন্টগুলি রূপান্তর করুন যা MediaSessionService.onStartCommand() দ্বারা প্রাপ্ত মিডিয়া 3 এর মধ্যে তাদের প্ল্যাটফর্ম সেশনে রাউট করার পরিবর্তে এবং মিডিয়া 3 এ ফিরে আসে। এটির সাথে, কলার কন্ট্রোলার সর্বদা মিডিয়া বিজ্ঞপ্তি নিয়ামক এবং অ্যাপ্লিকেশনগুলি সহজেই সমস্ত সমর্থিত এপিআই স্তরে একইভাবে বিজ্ঞপ্তি থেকে আসা কলগুলি স্বীকৃতি দিতে পারে।
    • বাগটি ফিক্স করুন যেখানে MediaController.getCurrentPosition() অগ্রসর হচ্ছে না যখন কোনও উত্তরাধিকার MediaSessionCompat সাথে সংযুক্ত থাকে।
    • সুবিধার জন্য MediaLibrarySession.getSubscribedControllers(mediaId) যুক্ত করুন।
    • ওভাররাইড MediaLibrarySession.Callback.onSubscribe() যার জন্য কন্ট্রোলার সাবস্ক্রাইব করে তার পিতামাতার আইডির প্রাপ্যতা জোর দেওয়ার জন্য। যদি সফল হয় তবে সাবস্ক্রিপশনটি গৃহীত হয় এবং ব্রাউজারকে notifyChildrenChanged() করার জন্য অবিলম্বে ডাকা হয় ( #561 )।
    • স্বয়ংচালিত ওএসের জন্য সেশন ডেমো মডিউল যুক্ত করুন এবং অ্যান্ড্রয়েড অটোর জন্য সেশন ডেমো সক্ষম করুন।
    • মিডিয়া বিজ্ঞপ্তি নিয়ামকের জন্য COMMAND_GET_TIMELINE উপলভ্য না হলে ফ্রেমওয়ার্ক সেশনের সারি সেট করবেন না। ফ্রেমওয়ার্ক সেশন থেকে ক্লায়েন্ট কন্ট্রোলার হিসাবে অ্যান্ড্রয়েড অটো সহ, অ্যান্ড্রয়েড অটো এর ইউআইতে queue বোতামটি প্রদর্শিত হবে না ( #339 ) এর প্রভাব রয়েছে।
    • SimpleBitmapLoader পরিবর্তে ডিফল্টরূপে DataSourceBitmapLoader ব্যবহার করুন ( #271 , #327 )।
    • MediaSession.Callback.onMediaButtonEvent(Intent) যুক্ত করুন যা অ্যাপ্লিকেশনগুলিকে ডিফল্ট মিডিয়া বোতাম ইভেন্ট হ্যান্ডলিংকে ওভাররাইড করতে দেয়।
  • UI:
    • একজন Player.Listener যুক্ত করুন Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT কোনও উপযুক্ত ডিভাইসটি কনফিগারযোগ্য সময়সীমার মধ্যে সংযুক্ত থাকলে শ্রোতা প্লেব্যাকটি অটো-রেজিউম করবে (ডিফল্ট 5 মিনিট)।
  • ডাউনলোড:
    • অ্যান্ড্রয়েড 14 সামঞ্জস্যের জন্য DownloadService জন্য "ডেটা সিঙ্ক" ফোরগ্রাউন্ড পরিষেবা প্রকারটি ঘোষণা করুন। এই পরিষেবাটি ব্যবহার করার সময়, অ্যাপ্লিকেশনটিকে ম্যানিফেস্টে foregroundServiceType হিসাবে dataSync যুক্ত করতে হবে এবং FOREGROUND_SERVICE_DATA_SYNC অনুমতি ( #11239 ) যুক্ত করতে হবে।
  • এইচএলএস এক্সটেনশন:
    • সর্বশেষ লোড সমাপ্ত সময় ( #663 ) এর চেয়ে শেষ লোড শুরুর সময় থেকে গণনা করা একটি ব্যবধান সহ এইচএলএস লাইভ প্লেলিস্টকে রিফ্রেশ করুন।
  • ড্যাশ এক্সটেনশন:
    • বিভাগের টেম্পলেট ইউআরএলে একই ড্যাশ আইডেন্টিফায়ার একাধিক অনুমতি দিন।
    • নিষ্কাশনের সময় সাবটাইটেলগুলি পার্স করার জন্য পরীক্ষামূলক সমর্থন যুক্ত করুন। সাবটাইটেল বিভাগগুলির মধ্যে স্থানান্তরিত করার সময় ফ্লিকারিং সমাধান সহ ওভারল্যাপিং সাবটাইটেলগুলি মার্জ করার জন্য এটি আরও ভাল সমর্থন রয়েছে। আপনি এটি DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ( #288 ) ব্যবহার করে এটি সক্ষম করতে পারেন।
  • আরটিএসপি এক্সটেনশন:
    • টিসিপিতে ফিরে আসার সময় বা কিছু পরিস্থিতিতে ঝুলন্ত প্লেব্যাকের দিকে IndexOutOfBoundsException হতে পারে এমন একটি রেসের শর্তটি ঠিক করুন।
    • আরটিএসপি সেটআপে স্টেটটি পরীক্ষা করুন যখন RtspMediaPeriod লোডিং স্টেট ( #577 ) ফেরত দেয়।
    • বিকল্পগুলির প্রতিক্রিয়া পাবলিক হেডারে কাস্টম আরটিএসপি অনুরোধের পদ্ধতিগুলি উপেক্ষা করুন ( #613 )।
    • কিপ-অ্যালাইভ আরটিএসপি বিকল্পের অনুরোধগুলি প্রেরণের সময় ব্যবধানে আরটিএসপি সেটআপ প্রতিক্রিয়া টাইমআউট মান ব্যবহার করুন ( #662 )।
  • ডিকোডার এক্সটেনশনস (এফএফএমপিইজি, ভিপি 9, এভি 1, এমআইডিআই ইত্যাদি):
    • এমআইডিআই ডিকোডার মডিউলটি রিলিজ করুন, যা অডিওকে সংশ্লেষিত করতে JSYN লাইব্রেরি ব্যবহার করে স্ট্যান্ডার্ড এমআইডিআই ফাইলগুলির প্লেব্যাকের জন্য সহায়তা সরবরাহ করে।
    • DecoderOutputBuffer.shouldBeSkipped যুক্ত করুন। সরাসরি আউটপুট বাফারগুলি চিহ্নিত করতে শোল্ডবেসপিপ করা যা উপস্থাপন করার দরকার নেই। এটি C.BUFFER_FLAG_DECODE_ONLY এর চেয়ে বেশি পছন্দ করা হয় যা হ্রাস করা হবে।
    • Decoder.setOutputStartTimeUs এবং SimpleDecoder.isAtLeastOutputStartTimeUs যুক্ত করুন is আইস্যাটলস্ট আউটপুটস্টার্টটাইমিয়াস ডিকোডারদের শুরু সময়ের আগে ডিকোড-কেবল নমুনাগুলি ফেলে দেওয়ার অনুমতি দেওয়ার জন্য। এটি Buffer.isDecodeOnly কাছে অগ্রাধিকার দেওয়া উচিত e
    • ম্যাভেন রিপোজিটরিতে বাগ প্রকাশনা এমআইডিআই ডিকোডার আর্টিফ্যাক্ট ঠিক করুন। নিদর্শনটির নাম পরিবর্তন করা হয়েছে media3-exoplayer-midi ( #734 )।
  • লিনব্যাক এক্সটেনশন:
    • বাগটি ঠিক করুন যেখানে কোনও পৃষ্ঠকে অক্ষম করা লিনব্যাক কোডে ( #617 ) ArithmeticException তৈরি করতে পারে।
  • পরীক্ষার ইউটিলিটিস:
    • TestExoPlayerBuilder এবং FakeClock এস্প্রেসো ইউআই পরীক্ষাগুলির সাথে সামঞ্জস্যপূর্ণ করুন এবং ইউআই পরীক্ষাগুলি রচনা করুন। এটি এমন একটি বাগ ঠিক করে যেখানে প্লেব্যাক এস্প্রেসো বা রচনা ভিউ ইন্টারঅ্যাকশনগুলির সময় অ-নির্ধারিতভাবে অগ্রসর হয়।
  • অবনমিত প্রতীকগুলি সরান:
    • 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-আলফা 02

সেপ্টেম্বর 29, 2023

1.2.0 স্থিতিশীল সংস্করণ ব্যবহার করুন।

সংস্করণ 1.2.0-Alpha01

আগস্ট 17, 2023

1.2.0 স্থিতিশীল সংস্করণ ব্যবহার করুন।

সংস্করণ 1.1.0

সংস্করণ 1.1.1

16 আগস্ট, 2023

  • সাধারণ গ্রন্থাগার:
    • দুর্ঘটনাক্রমে সমস্ত মডিউল ( #499 ) থেকে multidex নির্ভরতা যুক্ত করুন।
  • এক্সপ্লেয়ার:
    • PlaybackStatsListener সমস্যাটি সমাধান করুন যেখানে প্লেলিস্টটি সাফ হওয়ার পরে স্পিউরিয়াস PlaybackStats তৈরি করা হয়।
    • সাধারণ মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) লগিংয়ে অতিরিক্ত ক্ষেত্র যুক্ত করুন: স্ট্রিমিং ফর্ম্যাট (এসএফ), স্ট্রিম টাইপ (এসটি), সংস্করণ (ভি), শীর্ষ বারেট (টিবি), অবজেক্ট সময়কাল (ডি), পরিমাপ করা থ্রুপুট (এমটিপি) এবং অবজেক্টের ধরণ (ওটি) ( #8699 )।
  • অডিও:
    • Player.getState() খুব সংক্ষিপ্ত ফাইলগুলি খেলার সময় কখনও STATE_ENDED স্থানান্তরিত হয় নি ( #538 )।
  • অডিও অফলোড:
    • আরএফসি 7845 অনুসারে অফলোড ওপাস প্লেব্যাকের জন্য বিটস্ট্রিমে ওজিজি আইডি শিরোনাম এবং মন্তব্য শিরোনাম পৃষ্ঠাগুলি প্রপেন্ড করুন।
  • ভিডিও:
    • এইচ .265/এইচইভিসি: এসপিএসকে সংক্ষিপ্ত এবং দীর্ঘমেয়াদী রেফারেন্স চিত্রের তথ্য পার্সিং করুন।
  • পাঠ্য:
    • সিইএ -608: কেবল দৃশ্যমান পাঠ্য বিবেচনা করার জন্য কিউ কাটা কাটা যুক্তি পরিবর্তন করুন। পূর্বে ইন্ডেন্ট এবং ট্যাব অফসেট অন্তর্ভুক্ত করা হয়েছিল যখন কিউ দৈর্ঘ্য 32 টি অক্ষরে সীমাবদ্ধ করার সময় (যা প্রযুক্তিগতভাবে স্পেক দ্বারা সঠিক ছিল) ( #11019 )।
  • আইএমএ এক্সটেনশন:
    • ইমাম এসডিকে সংস্করণটি 3.30.3 এ বাম্প করুন।
  • অধিবেশন:
    • নিয়ামকের রাজ্যে কাস্টম লেআউট যুক্ত করুন এবং এটি অ্যাক্সেস করার জন্য একজন গেটার সরবরাহ করুন। যখন কাস্টম লেআউটটি পরিবর্তিত হয়, MediaController.Listener.onCustomLayoutChanged বলা হয়। বিভিন্ন মিডিয়া 3 কন্ট্রোলারে বিভিন্ন কাস্টম লেআউটগুলি প্রেরণ করতে চায় এমন অ্যাপ্লিকেশনগুলি MediaSession.Callback.onConnect এটি করতে পারে একটি AcceptedResultBuilder ব্যবহার করে সংযোগটি শেষ হয়ে গেলে কাস্টম লেআউটটি কন্ট্রোলারের কাছে উপলব্ধ রয়েছে তা নিশ্চিত করতে।
    • MediaLibraryServiceLegacyStub এমন একটি ত্রুটি প্রেরণ করেছে এমন Result সমাধান করুন যা এটি সমর্থন করে না যা একটি UnsupportedOperationException ( #78 ) তৈরি করে।
    • PlayerWrapper যেভাবে লিগ্যাসি কমান্ড ( COMMAND_ADJUST_DEVICE_VOLUME এবং COMMAND_SET_DEVICE_VOLUME ) এবং নতুন কমান্ডগুলি ( COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS এবং COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS ) (কমান্ড_ফ্লাগস) এর মাধ্যমে ভলিউমকন্ট্রোলটাইপ নির্ধারণ করে একটি volumeControlType নির্ধারণ করে একটি VolumeProviderCompat তৈরি করে তা ঠিক করুন ( কমান্ড_ফ্লাগস )

সংস্করণ 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 যুক্ত করুন।
    • একই অবস্থানে ( #8046 ) আইটেম যুক্ত এবং অপসারণের জন্য শর্টকাট হিসাবে Player.replaceMediaItem(s) যুক্ত করুন।
  • এক্সপ্লেয়ার:
    • এক্সপ্লেয়ারকে কেবল স্পষ্টভাবে বেছে নেওয়া হলে ডিভাইস ভলিউম পদ্ধতিগুলির নিয়ন্ত্রণ রাখতে মঞ্জুরি দিন ExoPlayer.Builder.setDeviceVolumeControlEnabled
      • getDeviceVolume()
      • isDeviceMuted()
      • setDeviceVolume(int) এবং setDeviceVolume(int, int)
      • increaseDeviceVolume(int) এবং increaseDeviceVolume(int, int)
      • decreaseDeviceVolume(int) এবং decreaseDeviceVolume(int, int)
    • FilteringMediaSource যুক্ত করুন যা একটি MediaSource থেকে উপলব্ধ ট্র্যাক প্রকারগুলি ফিল্টার করতে দেয়।
    • অভিযোজিত স্ট্রিমিং ফর্ম্যাটগুলি ড্যাশ, এইচএলএস এবং স্মুথস্ট্রিমিংয়ের বহির্গামী অনুরোধগুলিতে সাধারণ মিডিয়া ক্লায়েন্ট ডেটা (সিএমসিডি) অন্তর্ভুক্ত করার জন্য সমর্থন যুক্ত করুন। নিম্নলিখিত ক্ষেত্রগুলি, br , bl , cid , rtp এবং sid অন্তর্ভুক্ত করা হয়েছে ( #8699 )। এপিআই কাঠামো এবং এপিআই পদ্ধতি:
      • সিএমসিডি লগিং ডিফল্টরূপে অক্ষম করা হয়েছে, এটি সক্ষম করতে MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) ব্যবহার করুন।
      • সমস্ত কীগুলি ডিফল্টরূপে সক্ষম করা হয়, CmcdConfiguration.RequestConfig.isKeyAllowed(String key) ওভাররাইড করে R
      • CmcdConfiguration.RequestConfig.getCustomData() কাস্টম কী লগিং সক্ষম করতে ওভাররাইড করুন।
    • কাস্টম *.exolist.json ফাইল ( #439 ) দিয়ে ডেমো অ্যাপটি শুরু করা আরও সহজ করার জন্য প্রধান ডেমো প্রকাশের জন্য অতিরিক্ত ক্রিয়া যুক্ত করুন।
    • ভিডিও প্লেব্যাকের সময় Effect ব্যবহারের জন্য ExoPlayer.setVideoEffects() যুক্ত করুন।
    • sourceId int চেয়ে long হিসাবে সঞ্চয় করতে SampleQueue আপডেট করুন। এটি পাবলিক পদ্ধতির স্বাক্ষরগুলিকে 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 ছাড়াই পদ্ধতির বৈকল্পিককে কল করা যেতে পারে। নোট করুন যে অবনমিত বৈকল্পিকগুলির জন্যও, অফসেটটি আর startTimeUs এবং endTimeUs MediaLoadData অবজেক্টগুলির সাথে প্রেরণকারী দ্বারা প্রেরণ করা হয় না।
    • 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 যখন রেন্ডারারের ক্ষমতা পরিবর্তন করে তখন একটি নতুন ট্র্যাক নির্বাচনকে ট্রিগার করবে।
  • এক্সট্র্যাক্টর:
    • ওজিজি: দীর্ঘ সময়কাল ( #391 ) সহ ফাইলগুলি সন্ধান করার সময় বাগটি ঠিক করুন।
    • এফএমপি 4: ইস্যু করুন যেখানে TimestampAdjuster ইএমএসজি পরমাণু ( #356 ) থেকে মেটাডেটা নমুনা সময়ের সাথে একটি ভুল টাইমস্ট্যাম্প অফসেট শুরু করে।
  • অডিও:
    • টানেলিং সক্ষম করা এবং AudioProcessors সক্রিয় থাকলে কিছু প্লেব্যাকগুলি ব্যর্থ হয় যেখানে বাগটি ঠিক করুন, যেমন গ্যাপলেস ট্রিমিংয়ের জন্য ( #10847 )।
    • সরাসরি প্লেব্যাকগুলিতে (অফলোড) ওজিজি প্যাকেটে ওপাস ফ্রেমগুলি এনক্যাপসুলেট করুন।
    • অফলোড সময়সূচী সহ ঘুমের সময় বর্তমান অবস্থানটি এক্সট্রোপোলেট করুন।
    • প্লেয়ারের জীবনচক্রের শেষে সংস্থানগুলি প্রকাশের জন্য Renderer.release() এবং AudioSink.release() যুক্ত করুন।
    • DefaultAudioSink অডিও ক্ষমতা পরিবর্তনগুলি শুনুন। DefaultAudioSink কনস্ট্রাক্টারে একটি প্রয়োজনীয় প্যারামিটার context যুক্ত করুন, যার সাথে DefaultAudioSink শ্রোতা হিসাবে AudioCapabilitiesReceiver রিসিভারের নিবন্ধন করবে এবং ক্ষমতা পরিবর্তনের সাথে অবহিত হলে তার audioCapabilities সম্পত্তি আপডেট করবে।
    • onAudioCapabilitiesChanged AudioSink.Listener RendererCapabilities.Listener onRendererCapabilitiesChanged
    • অডিও চ্যানেলগুলিতে স্কেলিং/মিক্সিং প্রয়োগের জন্য ChannelMixingAudioProcessor যুক্ত করুন।
    • অডিও DecoderDiscardReasons DISCARD_REASON_AUDIO_BYPASS_POSSIBLE আইএনটি মান বাতিল করুন
    • Add direct playback support for DTS Express and DTS:X ( #335 ).
  • ভিডিও:
    • Make MediaCodecVideoRenderer report a VideoSize with a width and height of 0 when the renderer is disabled. Player.Listener.onVideoSizeChanged is called accordingly when Player.getVideoSize() changes. With this change, ExoPlayer's video size with MediaCodecVideoRenderer has a width and height of 0 when Player.getCurrentTracks does not support video, or the size of the supported video track is not yet determined.
  • DRM:
    • Reduce the visibility of several internal-only methods on DefaultDrmSession that aren't expected to be called from outside the DRM package:
      • void onMediaDrmEvent(int)
      • void provision()
      • void onProvisionCompleted()
      • onProvisionError(Exception, boolean)
  • Muxer:
    • Add a new muxer library which can be used to create an MP4 container file.
  • IMA extension:
    • Enable multi-period live DASH streams for DAI. Please note that the current implementation does not yet support seeking in live streams ( #10912 ).
    • Fix a bug where a new ad group is inserted in live streams because the calculated content position in consecutive timelines varies slightly.
  • অধিবেশন:
    • Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling a Player method.
    • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset ( #167 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
  • UI:
    • Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
  • RTSP Extension:
    • For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message ( #302 ).
    • Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header ( #11160 ).
  • DASH Extension:
    • Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
    • Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException ( #10838 ).
  • HLS Extension:
    • Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. If the initialization doesn't complete before the timeout, a PlaybackException is thrown to avoid the playback endless stalling. The timeout is set to zero by default ( #323 ).
  • Test Utilities:
    • Check for URI scheme case insensitivity in DataSourceContractTest .
  • Remove deprecated symbols:
    • Remove DefaultAudioSink constructors, use DefaultAudioSink.Builder instead.
    • Remove HlsMasterPlaylist , use HlsMultivariantPlaylist instead.
    • Remove Player.stop(boolean) . Use Player.stop() and Player.clearMediaItems() (if reset is true ) instead.
    • Remove two deprecated SimpleCache constructors, use a non-deprecated constructor that takes a DatabaseProvider instead for better performance.
    • Remove DefaultBandwidthMeter constructor, use DefaultBandwidthMeter.Builder instead.
    • Remove DefaultDrmSessionManager constructors, use DefaultDrmSessionManager.Builder instead.
    • Remove two deprecated HttpDataSource.InvalidResponseCodeException constructors, use a non-deprecated constructor that accepts additional fields( cause , responseBody ) to enhance error logging.
    • Remove DownloadHelper.forProgressive , DownloadHelper.forHls , DownloadHelper.forDash , and DownloadHelper.forSmoothStreaming , use DownloadHelper.forMediaItem instead.
    • Remove deprecated DownloadService constructor, use a non deprecated constructor that includes the option to provide a channelDescriptionResourceId parameter.
    • Remove deprecated String constants for Charsets ( ASCII_NAME , UTF8_NAME , ISO88591_NAME , UTF16_NAME and UTF16LE_NAME ), use Kotlin Charsets from the kotlin.text package, the java.nio.charset.StandardCharsets or the com.google.common.base.Charsets instead.
    • Remove deprecated WorkManagerScheduler constructor, use a non deprecated constructor that includes the option to provide a Context parameter instead.
    • Remove the deprecated methods createVideoSampleFormat , createAudioSampleFormat , createContainerFormat , and createSampleFormat , which were used to instantiate the Format class. Instead use Format.Builder for creating instances of Format .
    • Remove the deprecated methods copyWithMaxInputSize , copyWithSubsampleOffsetUs , copyWithLabel , copyWithManifestFormatInfo , copyWithGaplessInfo , copyWithFrameRate , copyWithDrmInitData , copyWithMetadata , copyWithBitrate and copyWithVideoSize , use Format.buildUpon() and setter methods instead.
    • Remove deprecated ExoPlayer.retry() , use prepare() instead.
    • Remove deprecated zero-arg DefaultTrackSelector constructor, use DefaultTrackSelector(Context) instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove deprecated DownloadManager constructor, use the constructor that takes an Executor instead.
    • Remove deprecated Cue constructors, use Cue.Builder instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove four deprecated AnalyticsListener methods:
      • onDecoderEnabled , use onAudioEnabled and/or onVideoEnabled instead.
      • onDecoderInitialized , use onAudioDecoderInitialized and/or onVideoDecoderInitialized instead.
      • onDecoderInputFormatChanged , use onAudioInputFormatChanged and/or onVideoInputFormatChanged instead.
      • onDecoderDisabled , use onAudioDisabled and/or onVideoDisabled instead.
    • Remove the deprecated Player.Listener.onSeekProcessed and AnalyticsListener.onSeekProcessed , use onPositionDiscontinuity with DISCONTINUITY_REASON_SEEK instead.
    • Remove ExoPlayer.setHandleWakeLock(boolean) , use setWakeMode(int) instead.
    • Remove deprecated DefaultLoadControl.Builder.createDefaultLoadControl() , use build() instead.
    • Remove deprecated MediaItem.PlaybackProperties , use MediaItem.LocalConfiguration instead. Deprecated field MediaItem.playbackProperties is now of type MediaItem.LocalConfiguration .

Version 1.1.0-rc01

জুন 21, 2023

Use the 1.1.0 stable version .

Version 1.1.0-beta01

7 জুন, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.1.0-alpha01

10 মে, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.0.0

সংস্করণ 1.0.2

18 মে, 2023

androidx.media3:media3-*:1.0.2 is released. Version 1.0.2 contains these commits.

This release corresponds to the ExoPlayer 2.18.7 release .

This release contains the following changes since the 1.0.1 release :

  • Core library:
    • Add Buffer.isLastSample() that denotes if Buffer contains flag C.BUFFER_FLAG_LAST_SAMPLE .
    • Fix issue where last frame may not be rendered if the last sample with frames is dequeued without reading the 'end of stream' sample. ( #11079 ).
  • Extractors:
    • Fix parsing of H.265 SPS in MPEG-TS files by re-using the parsing logic already used by RTSP and MP4 extractors ( #303 ).
  • পাঠ্য:
    • SSA: Add support for UTF-16 files if they start with a byte order mark ( #319 ).
  • অধিবেশন:
    • Fix issue where MediaController doesn't update its available commands when connected to a legacy MediaSessionCompat that updates its actions.
    • Fix bug that prevented the MediaLibraryService from returning null for a call from System UI to Callback.onGetLibraryRoot with params.isRecent == true on API 30 ( #355 ).
    • Fix memory leak of MediaSessionService or MediaLibraryService ( #346 ).
    • Fix bug where a combined Timeline and position update in a MediaSession may cause a MediaController to throw an IllegalStateException .

সংস্করণ 1.0.1

18 এপ্রিল, 2023

androidx.media3:media3-*:1.0.1 is released. Version 1.0.1 contains these commits.

This release corresponds to the ExoPlayer 2.18.6 release .

  • Core library:
    • Reset target live stream override when seeking to default position ( #11051 ).
    • Fix bug where empty sample streams in the media could cause playback to be stuck.
  • অধিবেশন:
    • Fix bug where multiple identical queue items published by a legacy MediaSessionCompat result in an exception in MediaController ( #290 ).
    • Add missing forwarding of MediaSession.broadcastCustomCommand to the legacy MediaControllerCompat.Callback.onSessionEvent ( #293 ).
    • Fix bug where calling MediaSession.setPlayer doesn't update the available commands.
    • Fix issue that TrackSelectionOverride instances sent from a MediaController are ignored if they reference a group with Format.metadata ( #296 ).
    • Fix issue where Player.COMMAND_GET_CURRENT_MEDIA_ITEM needs to be available to access metadata via the legacy MediaSessionCompat .
    • Fix issue where MediaSession instances on a background thread cause crashes when used in MediaSessionService ( #318 ).
    • Fix issue where a media button receiver was declared by the library without the app having intended this ( #314 ).
  • ড্যাশ:
    • Fix handling of empty segment timelines ( #11014 ).
  • RTSP:
    • Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport ( #11069 ).

সংস্করণ 1.0.0

22 মার্চ, 2023

androidx.media3:media3-*:1.0.0 is released. Version 1.0.0 contains these commits.

This release corresponds to the ExoPlayer 2.18.5 release .

There are no changes since 1.0.0-rc02.

Version 1.0.0-rc02

2 মার্চ, 2023

androidx.media3:media3-*:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits.

This release corresponds to the ExoPlayer 2.18.4 release .

  • Core library:
    • Fix network type detection on API 33 ( #10970 ).
    • Fix NullPointerException when calling ExoPlayer.isTunnelingEnabled ( #10977 ).
  • ডাউনলোড:
    • Make the maximum difference of the start time of two segments to be merged configurable in SegmentDownloader and subclasses ( #248 ).
  • অডিও:
    • Fix broken gapless MP3 playback on Samsung devices ( #8594 ).
    • Fix bug where playback speeds set immediately after disabling audio may be overridden by a previous speed change ( #10882 ).
  • ভিডিও:
    • Map HEVC HDR10 format to HEVCProfileMain10HDR10 instead of HEVCProfileMain10 .
    • Add workaround for a device issue on Chromecast with Google TV and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #10898 ).
    • Fix frame release performance issues when playing media with a frame rate far higher than the screen refresh rate.
  • কাস্ট:
    • Fix transient STATE_IDLE when transitioning between media items ( #245 ).
  • RTSP:
    • Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ( #10971 ).
  • অধিবেশন:
    • Fix a bug where notification play/pause button doesn't update with player state ( #192 ).
  • IMA extension:
    • Fix a bug which prevented DAI streams without any ads from starting because the first (and in the case without ads the only) LOADED event wasn't received.

Version 1.0.0-rc01

ফেব্রুয়ারী 16, 2023

androidx.media3:media3-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

This release corresponds to the ExoPlayer 2.18.3 release .

  • Core library:
    • Tweak the renderer's decoder ordering logic to uphold the MediaCodecSelector 's preferences, even if a decoder reports it may not be able to play the media performantly. For example with default selector, hardware decoder with only functional support will be preferred over software decoder that fully supports the format ( #10604 ).
    • Add ExoPlayer.Builder.setPlaybackLooper that sets a pre-existing playback thread for a new ExoPlayer instance.
    • Allow download manager helpers to be cleared ( #10776 ).
    • Add parameter to BasePlayer.seekTo to also indicate the command used for seeking.
    • Use theme when loading drawables on API 21+ ( #220 ).
    • Add ConcatenatingMediaSource2 that allows combining multiple media items into a single window ( #247 ).
  • Extractors:
    • Throw a ParserException instead of a NullPointerException if the sample table (stbl) is missing a required sample description (stsd) when parsing trak atoms.
    • Correctly skip samples when seeking directly to a sync frame in fMP4 ( #10941 ).
  • অডিও:
    • Use the compressed audio format bitrate to calculate the min buffer size for AudioTrack in direct playbacks (passthrough).
  • পাঠ্য:
    • Fix TextRenderer passing an invalid (negative) index to Subtitle.getEventTime if a subtitle file contains no cues.
    • SubRip: Add support for UTF-16 files if they start with a byte order mark.
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • ড্যাশ:
    • Add full parsing for image adaptation sets, including tile counts ( #3752 ).
  • UI:
    • Fix the deprecated PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) to ensure visibility changes are passed to the registered listener ( #229 ).
    • Fix the ordering of the center player controls in PlayerView when using a right-to-left (RTL) layout ( #227 ).
  • অধিবেশন:
    • Add abstract SimpleBasePlayer to help implement the Player interface for custom players.
    • Add helper method to convert platform session token to Media3 SessionToken ( #171 ).
    • Use onMediaMetadataChanged to trigger updates of the platform media session ( #219 ).
    • Add the media session as an argument of getMediaButtons() of the DefaultMediaNotificationProvider and use immutable lists for clarity ( #216 ).
    • Add onSetMediaItems callback listener to provide means to modify/set MediaItem list, starting index and position by session before setting onto Player ( #156 ).
    • Avoid double tap detection for non-Bluetooth media button events ( #233 ).
    • Make QueueTimeline more robust in case of a shady legacy session state ( #241 ).
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • Cast extension:
    • Bump Cast SDK version to 21.2.0.
  • IMA extension:
    • Remove player listener of the ImaServerSideAdInsertionMediaSource on the application thread to avoid threading issues.
    • Add a property focusSkipButtonWhenAvailable to the ImaServerSideAdInsertionMediaSource.AdsLoader.Builder to request focusing the skip button on TV devices and set it to true by default.
    • Add a method focusSkipButton() to the ImaServerSideAdInsertionMediaSource.AdsLoader to programmatically request to focus the skip button.
    • Bump IMA SDK version to 3.29.0.
  • Demo app:
    • Request notification permission for download notifications at runtime ( #10884 ).

Version 1.0.0-beta03

নভেম্বর 22, 2022

androidx.media3:media3-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

This release corresponds to the ExoPlayer 2.18.2 release .

  • Core library:
    • Add ExoPlayer.isTunnelingEnabled to check if tunneling is enabled for the currently selected tracks ( #2518 ).
    • Add WrappingMediaSource to simplify wrapping a single MediaSource ( #7279 ).
    • Discard back buffer before playback gets stuck due to insufficient available memory.
    • Close the Tracing "doSomeWork" block when offload is enabled.
    • Fix session tracking problem with fast seeks in PlaybackStatsListener ( #180 ).
    • Send missing onMediaItemTransition callback when calling seekToNext or seekToPrevious in a single-item playlist ( #10667 ).
    • Add Player.getSurfaceSize that returns the size of the surface on which the video is rendered.
    • Fix bug where removing listeners during the player release can cause an IllegalStateException ( #10758 ).
  • নির্মাণ:
    • Enforce minimum compileSdkVersion to avoid compilation errors ( #10684 ).
    • Avoid publishing block when included in another gradle build.
  • Track selection:
    • Prefer other tracks to Dolby Vision if display does not support it. ( #8944 ).
  • ডাউনলোড:
    • Fix potential infinite loop in ProgressiveDownloader caused by simultaneous download and playback with the same PriorityTaskManager ( #10570 ).
    • Make download notification appear immediately ( #183 ).
    • Limit parallel download removals to 1 to avoid excessive thread creation ( #10458 ).
  • ভিডিও:
    • Try alternative decoder for Dolby Vision if display does not support it. ( #9794 ).
  • অডিও:
    • Use SingleThreadExecutor for releasing AudioTrack instances to avoid OutOfMemory errors when releasing multiple players at the same time ( #10057 ).
    • Adds AudioOffloadListener.onExperimentalOffloadedPlayback for the AudioTrack offload state. ( #134 ).
    • Make AudioTrackBufferSizeProvider a public interface.
    • Add ExoPlayer.setPreferredAudioDevice to set the preferred audio output device ( #135 ).
    • Rename androidx.media3.exoplayer.audio.AudioProcessor to androidx.media3.common.audio.AudioProcessor .
    • Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions ( #10701 ).
  • মেটাডেটা:
    • MetadataRenderer can now be configured to render metadata as soon as they are available. Create an instance with MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) to specify whether the renderer will output metadata early or in sync with the player position.
  • DRM:
    • Work around a bug in the Android 13 ClearKey implementation that returns a non-empty but invalid license URL.
    • Fix setMediaDrmSession failed: session not opened error when switching between DRM schemes in a playlist (eg Widevine to ClearKey).
  • পাঠ্য:
    • CEA-608: Ensure service switch commands on field 2 are handled correctly ( #10666 ).
  • ড্যাশ:
    • Parse EventStream.presentationTimeOffset from manifests ( #10460 ).
  • UI:
    • Use current overrides of the player as preset in TrackSelectionDialogBuilder ( #10429 ).
  • অধিবেশন:
    • Ensure commands are always executed in the correct order even if some require asynchronous resolution ( #85 ).
    • Add DefaultMediaNotificationProvider.Builder to build DefaultMediaNotificationProvider instances. The builder can configure the notification ID, the notification channel ID and the notification channel name used by the provider. Also, add method DefaultMediaNotificationProvider.setSmallIcon(int) to set the notifications small icon. ( #104 ).
    • Ensure commands sent before MediaController.release() are not dropped ( #99 ).
    • SimpleBitmapLoader can load bitmap from file:// URIs ( #108 ).
    • Fix assertion that prevents MediaController to seek over an ad in a period ( #122 ).
    • When playback ends, the MediaSessionService is stopped from the foreground and a notification is shown to restart playback of the last played media item ( #112 ).
    • Don't start a foreground service with a pending intent for pause ( #167 ).
    • Manually hide the 'badge' associated with the notification created by DefaultNotificationProvider on API 26 and API 27 (the badge is automatically hidden on API 28+) ( #131 ).
    • Fix bug where a second binder connection from a legacy MediaSession to a Media3 MediaController causes IllegalStateExceptions ( #49 ).
  • RTSP:
    • Add H263 fragmented packet handling ( #119 ).
    • Add support for MP4A-LATM ( #162 ).
  • আইএমএ:
    • Add timeout for loading ad information to handle cases where the IMA SDK gets stuck loading an ad ( #10510 ).
    • Prevent skipping mid-roll ads when seeking to the end of the content ( #10685 ).
    • Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI ( #10764 ).
  • FFmpeg extension:
    • Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above ( #9933 ).
  • AV1 extension:
    • Update CMake version to avoid incompatibilities with the latest Android Studio releases ( #9933 ).
  • Cast extension:
    • Implement getDeviceInfo() to be able to identify CastPlayer when controlling playback with a MediaController ( #142 ).
  • ট্রান্সফরমার:
    • Add muxer watchdog timer to detect when generating an output sample is too slow.
  • Remove deprecated symbols:
    • Remove Transformer.Builder.setOutputMimeType(String) . This feature has been removed. The MIME type will always be MP4 when the default muxer is used.

Version 1.0.0-beta02

জুলাই 21, 2022

androidx.media3:media3-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

This release corresponds to the ExoPlayer 2.18.1 release .

  • Core library:
    • Ensure that changing the ShuffleOrder with ExoPlayer.setShuffleOrder results in a call to Player.Listener#onTimelineChanged with reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED ( #9889 ).
    • For progressive media, only include selected tracks in buffered position ( #10361 ).
    • Allow custom logger for all ExoPlayer log output ( #9752 ).
    • Fix implementation of setDataSourceFactory in DefaultMediaSourceFactory , which was non-functional in some cases ( #116 ).
  • Extractors:
    • Fix parsing of H265 short term reference picture sets ( #10316 ).
    • Fix parsing of bitrates from esds boxes ( #10381 ).
  • ড্যাশ:
    • Parse ClearKey license URL from manifests ( #10246 ).
  • UI:
    • Ensure TalkBack announces the currently active speed option in the playback controls menu ( #10298 ).
  • RTSP:
    • Add VP8 fragmented packet handling ( #110 ).
  • Leanback extension:
    • Listen to playWhenReady changes in LeanbackAdapter ( 10420 ).
  • কাস্ট:
    • Use the MediaItem that has been passed to the playlist methods as Window.mediaItem in CastTimeline ( #25 , #8212 ).
    • Support Player.getMetadata() and Listener.onMediaMetadataChanged() with CastPlayer ( #25 ).

Version 1.0.0-beta01

16 জুন, 2022

androidx.media3:media3-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

This corresponds to the ExoPlayer 2.18.0 release .

  • Core library:
    • Enable support for Android platform diagnostics via MediaMetricsManager . ExoPlayer will forward playback events and performance data to the platform, which helps to provide system performance and debugging information on the device. This data may also be collected by Google if sharing usage and diagnostics data is enabled by the user of the device. Apps can opt-out of contributing to platform diagnostics for ExoPlayer with ExoPlayer.Builder.setUsePlatformDiagnostics(false) .
    • Fix bug that tracks are reset too often when using MergingMediaSource , for example when side-loading subtitles and changing the selected subtitle mid-playback ( #10248 ).
    • Stop detecting 5G-NSA network type on API 29 and 30. These playbacks will assume a 4G network.
    • Disallow passing null to MediaSource.Factory.setDrmSessionManagerProvider and MediaSource.Factory.setLoadErrorHandlingPolicy . Instances of DefaultDrmSessionManagerProvider and DefaultLoadErrorHandlingPolicy can be passed explicitly if required.
    • Add MediaItem.RequestMetadata to represent metadata needed to play media when the exact LocalConfiguration is not known. Also remove MediaMetadata.mediaUrl as this is now included in RequestMetadata .
    • Add Player.Command.COMMAND_SET_MEDIA_ITEM to enable players to allow setting a single item.
  • Track selection:
    • Flatten TrackSelectionOverrides class into TrackSelectionParameters , and promote TrackSelectionOverride to a top level class.
    • Rename TracksInfo to Tracks and TracksInfo.TrackGroupInfo to Tracks.Group . Player.getCurrentTracksInfo and Player.Listener.onTracksInfoChanged have also been renamed to Player.getCurrentTracks and Player.Listener.onTracksChanged . This includes 'un-deprecating' the Player.Listener.onTracksChanged method name, but with different parameter types.
    • Change DefaultTrackSelector.buildUponParameters and DefaultTrackSelector.Parameters.buildUpon to return DefaultTrackSelector.Parameters.Builder instead of the deprecated DefaultTrackSelector.ParametersBuilder .
    • Add DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities which is enabled by default. When enabled, the DefaultTrackSelector will prefer audio tracks whose channel count does not exceed the device output capabilities. On handheld devices, the DefaultTrackSelector will prefer stereo/mono over multichannel audio formats, unless the multichannel format can be Spatialized (Android 12L+) or is a Dolby surround sound format. In addition, on devices that support audio spatialization, the DefaultTrackSelector will monitor for changes in the Spatializer properties and trigger a new track selection upon these. Devices with a television UI mode are excluded from these constraints and the format with the highest channel count will be preferred. To enable this feature, the DefaultTrackSelector instance must be constructed with a Context .
  • ভিডিও:
    • Rename DummySurface to PlaceholderSurface .
    • Add AV1 support to the MediaCodecVideoRenderer.getCodecMaxInputSize .
  • অডিও:
    • Use LG AC3 audio decoder advertising non-standard MIME type.
    • Change the return type of AudioAttributes.getAudioAttributesV21() from android.media.AudioAttributes to a new AudioAttributesV21 wrapper class, to prevent slow ART verification on API < 21.
    • Query the platform (API 29+) or assume the audio encoding channel count for audio passthrough when the format audio channel count is unset, which occurs with HLS chunkless preparation ( 10204 ).
    • Configure AudioTrack with channel mask AudioFormat.CHANNEL_OUT_7POINT1POINT4 if the decoder outputs 12 channel PCM audio ( #10322 .
  • ডিআরএম
    • Ensure the DRM session is always correctly updated when seeking immediately after a format change ( 10274 ).
  • পাঠ্য:
    • Change Player.getCurrentCues() to return CueGroup instead of List<Cue> .
    • SSA: Support OutlineColour style setting when BorderStyle == 3 (ie OutlineColour sets the background of the cue) ( #8435 ).
    • CEA-708: Parse data into multiple service blocks and ignore blocks not associated with the currently selected service number.
    • Remove RawCcExtractor , which was only used to handle a Google-internal subtitle format.
  • Extractors:
    • Add support for AVI ( #2092 ).
    • Matroska: Parse DiscardPadding for Opus tracks.
    • MP4: Parse bitrates from esds boxes.
    • Ogg: Allow duplicate Opus ID and comment headers ( #10038 ).
  • UI:
    • Fix delivery of events to OnClickListener s set on PlayerView in the case that useController=false ( #9605 ). Also fix delivery of events to OnLongClickListener for all view configurations.
    • Fix incorrectly treating a sequence of touch events that exit the bounds of PlayerView before ACTION_UP as a click ( #9861 ).
    • Fix PlayerView accessibility issue where tapping might toggle playback rather than hiding the controls ( #8627 ).
    • Rewrite TrackSelectionView and TrackSelectionDialogBuilder to work with the Player interface rather than ExoPlayer . This allows the views to be used with other Player implementations, and removes the dependency from the UI module to the ExoPlayer module. This is a breaking change.
    • Don't show forced text tracks in the PlayerView track selector, and keep a suitable forced text track selected if "None" is selected ( #9432 ).
  • ড্যাশ:
    • Parse channel count from DTS AudioChannelConfiguration elements. This re-enables audio passthrough for DTS streams ( #10159 ).
    • Disallow passing null to DashMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • HLS:
    • Fallback to chunkful preparation if the playlist CODECS attribute does not contain the audio codec ( #10065 ).
    • Disallow passing null to HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory , HlsMediaSource.Factory.setPlaylistParserFactory , and HlsMediaSource.Factory.setPlaylistTrackerFactory . Instances of DefaultCompositeSequenceableLoaderFactory , DefaultHlsPlaylistParserFactory , or a reference to DefaultHlsPlaylistTracker.FACTORY can be passed explicitly if required.
  • Smooth Streaming:
    • Disallow passing null to SsMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • RTSP:
    • Add RTP reader for H263 ( #63 ).
    • Add RTP reader for MPEG4 ( #35 ).
    • Add RTP reader for HEVC ( #36 ).
    • Add RTP reader for AMR. Currently only mono-channel, non-interleaved AMR streams are supported. Compound AMR RTP payload is not supported. ( #46 )
    • Add RTP reader for VP8 ( #47 ).
    • Add RTP reader for WAV ( #56 ).
    • Fix RTSP basic authorization header. ( #9544 ).
    • Stop checking mandatory SDP fields as ExoPlayer doesn't need them ( #10049 ).
    • Throw checked exception when parsing RTSP timing ( #10165 ).
    • Add RTP reader for VP9 ( #47 ).
    • Add RTP reader for OPUS ( #53 ).
  • তথ্য সূত্র:
    • Rename DummyDataSource to PlaceholderDataSource .
    • Workaround OkHttp interrupt handling.
  • অধিবেশন:
    • Replace MediaSession.MediaItemFiller with MediaSession.Callback.onAddMediaItems to allow asynchronous resolution of requests.
    • Support setMediaItems(s) methods when MediaController connects to a legacy media session.
    • Remove MediaController.setMediaUri and MediaSession.Callback.onSetMediaUri . The same functionality can be achieved by using MediaController.setMediaItem and MediaSession.Callback.onAddMediaItems .
    • Forward legacy MediaController calls to play media to MediaSession.Callback.onAddMediaItems instead of onSetMediaUri .
    • Add MediaNotification.Provider and DefaultMediaNotificationProvider to provide customization of the notification.
    • Add BitmapLoader and SimpleBitmapLoader for downloading artwork images.
    • Add MediaSession.setCustomLayout() to provide backwards compatibility with the legacy session.
    • Add MediaSession.setSessionExtras() to provide feature parity with legacy session.
    • Rename MediaSession.MediaSessionCallback to MediaSession.Callback , MediaLibrarySession.MediaLibrarySessionCallback to MediaLibrarySession.Callback and MediaSession.Builder.setSessionCallback to setCallback .
    • Fix NPE in MediaControllerImplLegacy ( #59 ).
    • Update session position info on timeline change( #51 ).
    • Fix NPE in MediaControllerImplBase after releasing controller ( #74 ).
  • Ad playback / IMA:
    • Decrease ad polling rate from every 100ms to every 200ms, to line up with Media Rating Council (MRC) recommendations.
  • FFmpeg extension:
    • Update CMake version to 3.21.0+ to avoid a CMake bug causing AndroidStudio's gradle sync to fail ( #9933 ).
  • Remove deprecated symbols:
    • Remove Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) . Use Player.Listener.onTracksChanged(Tracks) instead.
    • Remove Player.getCurrentTrackGroups and Player.getCurrentTrackSelections . Use Player.getCurrentTracks instead. You can also continue to use ExoPlayer.getCurrentTrackGroups and ExoPlayer.getCurrentTrackSelections , although these methods remain deprecated.
    • Remove DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT and DEFAULT_TRACK_SELECTOR_PARAMETERS constants. Use getDefaultTrackSelectorParameters(Context) instead when possible, and DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT otherwise.
    • Remove constructor DefaultTrackSelector(ExoTrackSelection.Factory) . Use DefaultTrackSelector(Context, ExoTrackSelection.Factory) instead.
    • Remove Transformer.Builder.setContext . The Context should be passed to the Transformer.Builder constructor instead.

Version 1.0.0-alpha03

14 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

This corresponds to the ExoPlayer 2.17.1 release .

  • অডিও:
    • Fix error checking audio capabilities for Dolby Atmos (E-AC3-JOC) in HLS.
  • Extractors:
    • FMP4: Fix issue where emsg sample metadata could be output in the wrong order for streams containing both v0 and v1 emsg atoms ( #9996 ).
  • পাঠ্য:
    • Fix the interaction of SingleSampleMediaSource.Factory.setTrackId and MediaItem.SubtitleConfiguration.Builder.setId to prioritise the SubtitleConfiguration field and fall back to the Factory value if it's not set ( #10016 ).
  • Ad playback:
    • Fix audio underruns between ad periods in live HLS SSAI streams.

Version 1.0.0-alpha02

2 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

This corresponds to the ExoPlayer 2.17.0 release .

  • Core Library:
    • Add protected method DefaultRenderersFactory.getCodecAdapterFactory() so that subclasses of DefaultRenderersFactory that override buildVideoRenderers() or buildAudioRenderers() can access the codec adapter factory and pass it to MediaCodecRenderer instances they create.
    • Propagate ICY header fields name and genre to MediaMetadata.station and MediaMetadata.genre respectively so that they reach the app via Player.Listener.onMediaMetadataChanged() ( #9677 ).
    • Remove null keys from DefaultHttpDataSource#getResponseHeaders .
    • Sleep and retry when creating a MediaCodec instance fails. This works around an issue that occurs on some devices when switching a surface from a secure codec to another codec ( #8696 ).
    • Add MediaCodecAdapter.getMetrics() to allow users obtain metrics data from MediaCodec . ( #9766 ).
    • Fix Maven dependency resolution ( #8353 ).
    • Disable automatic speed adjustment for live streams that neither have low-latency features nor a user request setting the speed ( #9329 ).
    • Rename DecoderCounters#inputBufferCount to queuedInputBufferCount .
    • Make SimpleExoPlayer.renderers private. Renderers can be accessed via ExoPlayer.getRenderer .
    • Updated some AnalyticsListener.EventFlags constant values to match values in Player.EventFlags .
    • Split AnalyticsCollector into an interface and default implementation to allow it to be stripped by R8 if an app doesn't need it.
  • Track selection:
    • Support preferred video role flags in track selection ( #9402 ).
    • Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation ( #9519 ).
    • Update video and audio track selection logic to only choose formats for adaptive selections that have the same level of decoder and hardware support ( #9565 ).
    • Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders ( #4835 ).
    • Prefer audio content preferences (for example, the "default" audio track or a track matching the system locale language) over technical track selection constraints (for example, preferred MIME type, or maximum channel count).
    • Fix track selection issue where overriding one track group did not disable other track groups of the same type ( #9675 ).
    • Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly ( #9649 ).
    • Prohibit duplicate TrackGroup s in a TrackGroupArray . TrackGroup s can always be made distinguishable by setting an id in the TrackGroup constructor. This fixes a crash when resuming playback after backgrounding the app with an active track override ( #9718 ).
    • Amend logic in AdaptiveTrackSelection to allow a quality increase under sufficient network bandwidth even if playback is very close to the live edge ( #9784 ).
  • ভিডিও:
    • Fix decoder fallback logic for Dolby Vision to use a compatible H264/H265 decoder if needed.
  • অডিও:
    • Fix decoder fallback logic for Dolby Atmos (E-AC3-JOC) to use a compatible E-AC3 decoder if needed.
    • Change AudioCapabilities APIs to require passing explicitly AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES instead of null .
    • Allow customization of the AudioTrack buffer size calculation by injecting an AudioTrackBufferSizeProvider to DefaultAudioSink . ( #8891 ).
    • Retry AudioTrack creation if the requested buffer size was > 1MB. ( #9712 ).
  • Extractors:
    • WAV: Add support for RF64 streams ( #9543 ).
    • Fix incorrect parsing of H.265 SPS NAL units ( #9719 ).
    • Parse Vorbis Comments (including METADATA_BLOCK_PICTURE ) in Ogg Opus and Ogg Vorbis files.
  • পাঠ্য:
    • Add a MediaItem.SubtitleConfiguration.id field which is propagated to the Format.id field of the subtitle track created from the configuration ( #9673 ).
    • Add basic support for WebVTT subtitles in Matroska containers ( #9886 ).
    • Prevent Cea708Decoder from reading more than the declared size of a service block.
  • DRM:
    • Remove playbackLooper from DrmSessionManager.(pre)acquireSession . When a DrmSessionManager is used by an app in a custom MediaSource , the playbackLooper needs to be passed to DrmSessionManager.setPlayer instead.
  • Ad playback / IMA:
    • Add support for IMA Dynamic Ad Insertion (DAI) ( #8213 ).
    • Add a method to AdPlaybackState to allow resetting an ad group so that it can be played again ( #9615 ).
    • Enforce playback speed of 1.0 during ad playback ( #9018 ).
    • Fix issue where an ad group that failed to load caused an immediate playback reset ( #9929 ).
  • UI:
    • Fix the color of the numbers in StyledPlayerView rewind and fastforward buttons when using certain themes ( #9765 ).
    • Correctly translate playback speed strings ( #9811 ).
  • ড্যাশ:
    • Add parsed essential and supplemental properties to the Representation ( #9579 ).
    • Support the forced-subtitle track role ( #9727 ).
    • Stop interpreting the main track role as C.SELECTION_FLAG_DEFAULT .
    • Fix base URL exclusion logic for manifests that do not declare the DVB namespace ( #9856 ).
    • Support relative MPD.Location URLs ( #9939 ).
  • HLS:
    • Correctly populate Format.label for audio only HLS streams ( #9608 ).
    • Use chunkless preparation by default to improve start up time. If your renditions contain muxed closed-caption tracks that are not declared in the master playlist, you should add them to the master playlist to be available for playback, or turn off chunkless preparation with HlsMediaSource.Factory.setAllowChunklessPreparation(false) .
    • Support key-frame accurate seeking in HLS ( #2882 ).
  • RTSP:
    • Provide a client API to override the SocketFactory used for any server connection ( #9606 ).
    • Prefer DIGEST authentication method over BASIC if both are present ( #9800 ).
    • Handle when RTSP track timing is not available ( #9775 ).
    • Ignore invalid RTP-Info header values ( #9619 ).
  • ট্রান্সফরমার:
    • Increase required min API version to 21.
    • TransformationException is now used to describe errors that occur during a transformation.
    • Add TransformationRequest for specifying the transformation options.
    • Allow multiple listeners to be registered.
    • Fix Transformer being stuck when the codec output is partially read.
    • Fix potential NPE in Transformer.getProgress when releasing the muxer throws.
    • Add a demo app for applying transformations.
  • MediaSession extension:
    • By default, MediaSessionConnector now clears the playlist on stop. Apps that want the playlist to be retained can call setClearMediaItemsOnStop(false) on the connector.
  • Cast extension:
    • Fix bug that prevented CastPlayer from calling onIsPlayingChanged correctly ( #9792 ).
    • Support audio metadata including artwork with DefaultMediaItemConverter ( #9663 ).
  • FFmpeg extension:
    • Make build_ffmpeg.sh depend on LLVM's bin utils instead of GNU's ( #9933 ).
  • Android 12 compatibility:
    • Upgrade the Cast extension to depend on com.google.android.gms:play-services-cast-framework:20.1.0 . Earlier versions of play-services-cast-framework are not compatible with apps targeting Android 12, and will crash with an IllegalArgumentException when creating PendingIntent s ( #9528 ).
  • Remove deprecated symbols:
    • Remove Player.EventListener . Use Player.Listener instead.
    • Remove MediaSourceFactory#setDrmSessionManager , MediaSourceFactory#setDrmHttpDataSourceFactory , and MediaSourceFactory#setDrmUserAgent . Use MediaSourceFactory#setDrmSessionManagerProvider instead.
    • Remove MediaSourceFactory#setStreamKeys . Use MediaItem.Builder#setStreamKeys instead.
    • Remove MediaSourceFactory#createMediaSource(Uri) . Use MediaSourceFactory#createMediaSource(MediaItem) instead.
    • Remove setTag from DashMediaSource , HlsMediaSource and SsMediaSource . Use MediaItem.Builder#setTag instead.
    • Remove DashMediaSource#setLivePresentationDelayMs(long, boolean) . Use MediaItem.Builder#setLiveConfiguration and MediaItem.LiveConfiguration.Builder#setTargetOffsetMs to override the manifest, or DashMediaSource#setFallbackTargetLiveOffsetMs to provide a fallback value.
    • Remove (Simple)ExoPlayer.setThrowsWhenUsingWrongThread . Opting out of the thread enforcement is no longer possible.
    • Remove ActionFile and ActionFileUpgradeUtil . Use ExoPlayer 2.16.1 or before to use ActionFileUpgradeUtil to merge legacy action files into DefaultDownloadIndex .
    • Remove ProgressiveMediaSource#setExtractorsFactory . Use ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) constructor instead.
    • Remove ProgressiveMediaSource.Factory#setTag and, and ProgressiveMediaSource.Factory#setCustomCacheKey . Use MediaItem.Builder#setTag and MediaItem.Builder#setCustomCacheKey instead.
    • Remove DefaultRenderersFactory(Context, @ExtensionRendererMode int) and DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) constructors. Use the DefaultRenderersFactory(Context) constructor, DefaultRenderersFactory#setExtensionRendererMode , and DefaultRenderersFactory#setAllowedVideoJoiningTimeMs instead.
    • Remove all public CronetDataSource constructors. Use CronetDataSource.Factory instead.
  • Change the following IntDefs to @Target(TYPE_USE) only. This may break the compilation of usages in Kotlin, which can be fixed by moving the annotation to annotate the type ( 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 (in com.google.android.exoplayer2.ext.flac package)
    • @FlacExtractor.Flags (in com.google.android.exoplayer2.extractor.flac package)
    • @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

Version 1.0.0-alpha01

27 অক্টোবর, 2021

androidx.media3:media3-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

নতুন বৈশিষ্ট্য

Media3 হল ExoPlayer সহ মিডিয়া সাপোর্ট লাইব্রেরির জন্য নতুন হোম। The first alpha contains early, functional implementations of libraries for implementing media use cases, including:

  • ExoPlayer, an application-level media player for Android that is easy to customize and extend.
  • Media session functionality, for exposing and controlling playbacks. This new session module uses the same Player interface as ExoPlayer.
  • UI components for building media playback user interfaces.
  • Modules wrapping functionality in other libraries for use with ExoPlayer, for example, ad insertion via the IMA SDK.

For more information, see the Media3 GitHub project .

ExoPlayer was previously hosted in a separate ExoPlayer GitHub project . In Media3 its package name is androidx.media3.exoplayer . We plan to continue to maintain and release the ExoPlayer GitHub project for a while to give apps time to migrate to Media3. Media3 has replacements for all the ExoPlayer modules, except for the legacy media2 and mediasession extensions, which are replaced by the new media3-session module. This provides direct integration between players and media sessions without needing to use an adapter/connector class.

,

Media3

Support libraries for media use cases.
সর্বশেষ আপডেট স্থিতিশীল রিলিজ প্রার্থী মুক্তি বিটা রিলিজ আলফা রিলিজ
10 সেপ্টেম্বর, 2024 1.4.1 - - 1.5.0-আলফা01

Declaring dependencies

To add a dependency on Media3, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

গ্রোভি 

dependencies {
    def media3_version = "1.4.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
    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 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 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"
}

কোটলিন

dependencies {
    val media3_version = "1.4.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
    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 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 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")
}

For more information about dependencies, see Add Build Dependencies .

প্রতিক্রিয়া

Your feedback helps make Jetpack better. You can use the Media3 issue tracker to find answers to questions, known issues and feature requests, and to file new issues.

সংস্করণ 1.5

Version 1.5.0-alpha01

10 সেপ্টেম্বর, 2024

This release includes the following changes since the 1.4.1 release :

  • Common Library:
    • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling ( #1183 ).
    • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
    • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
    • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
    • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
    • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • ExoPlayer:
    • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
    • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
    • Add BasePreloadManager.Listener to propagate preload events to apps.
    • Allow changing SNTP client timeout and retry alternative addresses on timeout ( #1540 ).
    • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
    • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
    • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled ( #1616 ).
    • Allow playback regardless of buffered duration when loading fails ( #1571 ).
    • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • ট্রান্সফরমার:
    • Add SurfaceAssetLoader , which supports queueing video data to Transformer via a Surface .
    • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException .
  • Extractors:
    • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
    • Add option to enable index-based seeking in AmrExtractor .
    • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} ( #1563 ).
  • DataSource:
    • Update HttpEngineDataSource to allow use starting at version S extension 7 instead of API level 34 ( #1262 ).
  • অডিও:
    • Automatically configure CTA-2075 loudness metadata on the codec if present in the media.
    • Ensure smooth volume ramp down when seeking.
  • ভিডিও:
    • MediaCodecVideoRenderer avoids decoding samples that are neither rendered nor used as reference by other samples.
    • On API 35 and above, MediaCodecAdapter may now receive a null Surface in configure and calls to a new method detachOutputSurface to remove a previously set Surface if the codec supports this ( MediaCodecInfo.detachedSurfaceSupported ).
    • Use MediaCodecAdapter supplied pixel aspect ratio values if provided when processing onOutputFormatChanged ( #1371 ).
  • পাঠ্য:
  • ছবি:
    • Add ExternallyLoadedImageDecoder for simplified integration with external image loading libraries like Glide or Coil.
  • DataSource:
    • Add FileDescriptorDataSource , a new DataSource that can be used to read from a FileDescriptor ( #3757 ).
  • প্রভাব:
    • Add DefaultVideoFrameProcessor workaround for minor SurfaceTexture scaling. SurfaceTexture may include a small scaling that cuts off a 1-texel border around the edge of a cropped buffer. This is now handled such that output is closer to expected.
    • Speed up DefaultVideoFrameProcessor.queueInputBitmap() . As a result, exporting images to videos with Transformer is faster.
  • IMA extension:
    • Fix bug where clearing the playlist may cause an ArrayIndexOutOfBoundsException in ImaServerSideAdInsertionMediaSource .
  • অধিবেশন:
    • Add MediaButtonReceiver.shouldStartForegroundService(Intent) to allow apps to suppress a play command coming in for playback resumption by overriding this method. By default, the service is always started and playback can't be suppressed without the system crashing the service with a ForegroundServiceDidNotStartInTimeException ( #1528 ).
  • DASH Extension:
    • Add support for periods starting in the middle of a segment ( #1440 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, etc.):
    • Add the IAMF decoder module, which provides support for playback of MP4 files containing IAMF tracks using the libiamf native library to synthesize audio.
      • Playback is enabled with a stereo layout as well as 5.1 with spatialization together with optional head tracking enabled, but binaural playback support is currently not available.
  • Cast Extension:
    • Stop clearning the timeline after the CastSession disconnects, which enables the sender app to resume playback locally after a disconnection.
    • Populate CastPlayer's DeviceInfo when a Context is provided. This enables linking the MediaSession to a RoutingSession , which is necessary for integrating Output Switcher ( #1056 ).
  • Test Utilities:
    • DataSourceContractTest now includes tests to verify:
      • Input stream read position is updated.
      • Output buffer offset is applied correctly.
  • Remove deprecated symbols:
    • Remove deprecated Player.hasPrevious , Player.hasPreviousWindow() . Use Player.hasPreviousMediaItem() instead.
    • Remove deprecated Player.previous() method. Use Player.seekToPreviousMediaItem() instead.
    • Remove deprecated DrmSessionEventListener.onDrmSessionAcquired method.

সংস্করণ 1.4.0

সংস্করণ 1.4.1

আগস্ট 27, 2024

androidx.media3:media3-*:1.4.1 is released. Version 1.4.1 contains these commits .

  • ExoPlayer:
    • Handle preload callbacks asynchronously in PreloadMediaSource ( #1568 ).
    • Allow playback regardless of buffered duration when loading fails ( #1571 ).
  • Extractors:
    • MP3: Fix Searched too many bytes error by correctly ignoring trailing non-MP3 data based on the length field in an Info frame ( #1480 ).
  • পাঠ্য:
    • TTML: Fix handling of percentage tts:fontSize values to ensure they are correctly inherited from parent nodes with percentage tts:fontSize values.
    • Fix IndexOutOfBoundsException in LegacySubtitleUtil due to incorrectly handling the case of the requested output start time being greater than or equal to the final event time in the Subtitle ( #1516 ).
  • DRM:
    • Fix android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE error on API 31+ devices playing L1 Widevine content. This error is caused by an incomplete implementation of the framework MediaDrm.requiresSecureDecoder method ( #1603 ).
  • প্রভাব:
    • Add a release() method to GlObjectsProvider .
  • অধিবেশন:
    • Transform a double-tap of KEYCODE_HEADSETHOOK into a 'seek to next' action, as documented ( #1493 ).
    • Handle KEYCODE_HEADSETHOOK as a 'play' command in MediaButtonReceiver when deciding whether to ignore it to avoid a ForegroundServiceDidNotStartInTimeException ( #1581 ).
  • RTSP Extension:
    • Skip invalid Media Descriptions in SDP parsing ( #1087 ).

সংস্করণ 1.4.0

25 জুলাই, 2024

androidx.media3:media3-*:1.4.0 is released. Version 1.4.0 contains these commits .

  • Common Library:
    • Forward presumed no-op seek calls to the protected BasePlayer.seekTo() and SimpleBasePlayer.handleSeek() methods instead of ignoring them. If you are implementing these methods in a custom player, you may need to handle these additional calls with mediaItemIndex == C.INDEX_UNSET .
    • Remove compile dependency on enhanced Java 8 desugaring ( #1312 ).
    • Ensure the duration passed to MediaItem.Builder.setImageDurationMs() is ignored for a non-image MediaItem (as documented).
    • Add Format.customData to store app-provided custom information about Format instances.
  • ExoPlayer:
    • Add BasePreloadManager which coordinates the preloading for multiple sources based on the priorities defined by their rankingData . Customization is possible by extending this class. Add DefaultPreloadManager which uses PreloadMediaSource to preload media samples of the sources into memory, and uses an integer rankingData that indicates the index of an item on the UI.
    • Add PlayerId to most methods of LoadControl to enable LoadControl implementations to support multiple players.
    • Remove Buffer.isDecodeOnly() and C.BUFFER_FLAG_DECODE_ONLY . There is no need to set this flag as renderers and decoders will decide to skip buffers based on timestamp. Custom Renderer implementations should check if the buffer time is at least BaseRenderer.getLastResetPositionUs() to decide whether a sample should be shown. Custom SimpleDecoder implementations can check isAtLeastOutputStartTimeUs() if needed or mark other buffers with DecoderOutputBuffer.shouldBeSkipped to skip them.
    • Allow a null value to be returned by TargetPreloadStatusControl.getTargetPreloadStatus(T) to indicate not to preload a MediaSource with the given rankingData .
    • Add remove(MediaSource) to BasePreloadManager .
    • Add reset() to BasePreloadManager to release all the holding sources while keep the preload manager instance.
    • Add ExoPlayer.setPriority() (and Builder.setPriority() ) to define the priority value used in PriorityTaskManager and for MediaCodec importance from API 35.
    • Fix issue with updating the last rebuffer time which resulted in incorrect bs (buffer starvation) key in CMCD ( #1124 ).
    • Add PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) to indicate that the source has loaded to the end. This allows the DefaultPreloadManager and the custom PreloadMediaSource.PreloadControl implementations to preload the next source or take other actions.
    • Fix bug where silence skipping at the end of items can trigger a playback exception.
    • Add clear to PreloadMediaSource to discard the preloading period.
    • Add new error code PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED that is used when codec resources are reclaimed for higher priority tasks.
    • Let AdsMediaSource load preroll ads before initial content media preparation completes ( #1358 ).
    • Fix bug where playback moved to STATE_ENDED when re-preparing a multi-period DASH live stream after the original period was already removed from the manifest.
    • Rename onTimelineRefreshed() to onSourcePrepared() and onPrepared() to onTracksSelected() in PreloadMediaSource.PreloadControl . Also rename the IntDefs in DefaultPreloadManager.Stage accordingly.
    • Add experimental support for dynamic scheduling to better align work with CPU wake-cycles and delay waking up to when renderers can progress. You can enable this using experimentalSetDynamicSchedulingEnabled() when setting up your ExoPlayer instance.
    • Add Renderer.getDurationToProgressUs() . A Renderer can implement this method to return to ExoPlayer the duration that playback must advance for the renderer to progress. If ExoPlayer is set with experimentalSetDynamicSchedulingEnabled() then ExoPlayer will call this method when calculating the time to schedule its work task.
    • Add MediaCodecAdapter#OnBufferAvailableListener to alert when input and output buffers are available for use by MediaCodecRenderer . MediaCodecRenderer will signal ExoPlayer when receiving these callbacks and if ExoPlayer is set with experimentalSetDynamicSchedulingEnabled() , then ExoPlayer will schedule its work loop as renderers can make progress.
    • Use data class for LoadControl methods instead of individual parameters.
    • Add ExoPlayer.isReleased() to check whether Exoplayer.release() has been called.
    • Add ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() to configure the maximum position for which seekToPrevious() seeks to the previous item ( #1425 ).
    • Fix some audio focus inconsistencies, eg not reporting full or transient focus loss while the player is paused ( #1436 ).
    • Fix potential IndexOutOfBoundsException caused by extractors reporting additional tracks after the initial preparation step ( #1476 ).
    • Effects in ExoPlayer.setVideoEffect() will receive the timestamps with the renderer offset removed ( #1098 ).
    • Fix potential IllegalArgumentException when handling player error that happened while reading ahead into another playlist item ( #1483 ).
  • ট্রান্সফরমার:
    • Add audioConversionProcess and videoConversionProcess to ExportResult indicating how the respective track in the output file was made.
    • Relax trim optimization H.264 level checks.
    • Add support for changing between SDR and HDR input media in a sequence.
    • Add support for composition-level audio effects.
    • Add support for transcoding Ultra HDR images into HDR videos.
    • Fix issue where the DefaultAudioMixer does not output the correct amount of bytes after being reset and reused.
    • Work around a decoder bug where the number of audio channels was capped at stereo when handling PCM input.
    • When selecting tracks in ExoPlayerAssetLoader , ignore audio channel count constraints as they only apply for playback.
    • Replace androidx.media3.transformer.Muxer interface with androidx.media3.muxer.Muxer and remove androidx.media3.transformer.Muxer .
    • Fix HEIC image loading from content URI schemes. ( #1373 ).
    • Adjust audio track duration in AudioGraphInput to improve AV sync.
    • Remove ExportResult.processedInputs field. If you use this field for codec details, then use DefaultDecoderFactory.listener instead. In case of a codec exception, codec details will be available in the ExportException.codecInfo .
  • Extractors:
    • MPEG-TS: Roll forward the change ensuring the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ). Incorporating fixes to resolve the issues that emerged in I-frame only HLS streams( #1150 ) and H.262 HLS streams ( #1126 ).
    • MP3: Prefer the data size from an Info frame over the size reported by the underlying stream (eg file size, or HTTP Content-Length header). This helps to exclude non-playable trailer data (eg album artwork) from constant bitrate seeking calculations, making seeks more accurate ( #1376 ).
    • MP3: Use the frame count and other data in an Info frame (if present) to compute an average bitrate for constant bitrate seeking, rather than extrapolating from the bitrate of the frame after the Info frame, which may be artificially small, eg PCUT frame ( #1376 ).
    • Fix PCM audio format extraction in AVI containers.
  • অডিও:
    • Fix DTS:X Profile 2 encoding attributes for passthrough playback ( #1299 ).
    • For offloaded playback, reset the tracking field for stream completion in DefaultAudioSink prior to calling AudioTrack.stop() so that AudioTrack.StreamEventCallback#onPresentationEnded correctly identifies when all pending data has been played.
    • Fix bug in SilenceSkippingAudioProcessor where transitions between different audio formats (for example stereo to mono) can cause the processor to throw an exception ( #1352 ).
    • Implement MediaCodecAudioRenderer.getDurationToProgressUs() so that ExoPlayer will dynamically schedule its main work loop to when the MediaCodecAudioRenderer can make progress.
  • ভিডিও:
    • Fix issue where Listener.onRenderedFirstFrame() arrives too early when switching surfaces mid-playback.
    • Fix decoder fallback logic for Dolby Vision to use a compatible AV1 decoder if needed ( #1389 ).
    • Fix codec exception that may be caused by enabling a video renderer mid-playback.
  • পাঠ্য:
    • Fix issue where subtitles starting before a seek position are skipped. This issue was only introduced in Media3 1.4.0-alpha01.
    • Change default subtitle parsing behavior so it happens during extraction instead of during rendering (see ExoPlayer's architecture diagram for the difference between extraction and rendering).
      • This change can be overridden by calling both MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) and TextRenderer.experimentalSetLegacyDecodingEnabled(true) . See the docs on customization for how to plumb these components into an ExoPlayer instance. These methods (and all support for legacy subtitle decoding) will be removed in a future release.
      • Apps with custom SubtitleDecoder implementations need to update them to implement SubtitleParser instead (and SubtitleParser.Factory instead of SubtitleDecoderFactory ).
    • PGS: Fix run-length decoding to resolve 0 as a color index, instead of a literal color value ( #1367 ).
    • CEA-708: Ignore rowLock value. The CEA-708-E S-2023 spec states that rowLock and columnLock should both be assumed to be true, regardless of the values present in the stream ( columnLock support is not implemented, so it's effectively assumed to always be false).
      • This was originally included in the 1.3.0-alpha01 release notes, but the change was accidentally reverted before the 1.3.0-rc01 release. This is now fixed, so the change is present again.
    • CEA-708: Avoid duplicate newlines being added by ExoPlayer's naive handling of the 'set pen location' command ( #1315 ).
    • Fix an IllegalArgumentException from LegacySubtitleUtil when a WebVTT subtitle sample contains no cues, eg as part of a DASH stream ( #1516 ).
  • মেটাডেটা:
    • Fix mapping of MP4 to ID3 sort tags. Previously the 'album sort' ( soal ), 'artist sort' ( soar ) and 'album artist sort' ( soaa ) MP4 tags were wrongly mapped to the TSO2 , TSOA and TSOP ID3 tags ( #1302 ).
    • Fix reading of MP4 (/iTunes) numeric gnre (genre) and tmpo (tempo) tags when the value is more than one byte long.
    • Propagate ID3 TCON frame to MediaMetadata.genre ( #1305 ).
  • ছবি:
    • Add support for non-square DASH thumbnail grids ( #1300 ).
    • Add support for AVIF for API 34+.
    • Allow null as parameter for ExoPlayer.setImageOutput() to clear a previously set ImageOutput .
  • DataSource:
    • Implement support for android.resource://package/id raw resource URIs where package is different to the package of the current application. This wasn't previously documented to work, but is a more efficient way of accessing resources in another package than by name.
    • Eagerly check url is non-null in the DataSpec constructors. This parameter was already annotated to be non-null.
    • Allow ByteArrayDataSource to resolve a URI to a byte array during open() , instead of being hard-coded at construction ( #1405 ).
  • DRM:
    • Allow setting a LoadErrorHandlingPolicy on DefaultDrmSessionManagerProvider ( #1271 ).
  • প্রভাব:
    • Support multiple speed changes within the same EditedMediaItem or Composition in SpeedChangeEffect .
    • Support for HLG and PQ output from ultra HDR bitmap input.
    • Add support for EGL_GL_COLORSPACE_BT2020_HLG_EXT, which improves HLG surface output in ExoPlayer.setVideoEffect and Transformer's Debug SurfaceView.
    • Update Overlay matrix implementation to make it consistent with the documentation by flipping the x and y values applied in setOverlayFrameAnchor() . If using OverlaySettings.Builder.setOverlayFrameAnchor() , flip their x and y values by multiplying them by -1 .
    • Fix bug where TimestampWrapper crashes when used with ExoPlayer#setVideoEffects ( #821 ).
    • Change default SDR color working space from linear colors to electrical BT 709 SDR video. Also provide third option to retain the original colorspace.
    • Allow defining indeterminate z-order of EditedMediaItemSequences ( #1055 ).
    • Maintain a consistent luminance range across different pieces of HDR content (uses the HLG range).
    • Add support for Ultra HDR (bitmap) overlays on HDR content.
    • Allow SeparableConvolution effects to be used before API 26.
    • Remove unused OverlaySettings.useHdr since dynamic range of overlay and frame must match.
    • Add HDR support for TextOverlay . Luminance of the text overlay can be adjusted with OverlaySettings.Builder.setHdrLuminanceMultiplier() .
  • IMA extension:
    • Promote API that is required for apps to play DAI ad streams to stable.
    • Add replaceAdTagParameters(Map <String, String>) to ImaServerSideAdInsertionMediaSource.AdLoader that allows replacing ad tag parameters at runtime.
    • Fix bug where VideoAdPlayer.VideoAdPlayerCallback.onError() was not called when a player error happened during ad playback ( #1334 ).
    • Bump IMA SDK version to 3.33.0 to fix a NullPointerException when using data:// ad tag URIs ( #700 ).
  • অধিবেশন:
    • Change default of CommandButton.enabled to true and ensure the value can stay false for controllers even if the associated command is available.
    • Add icon constants for CommandButton that should be used instead of custom icon resources.
    • Add MediaSessionService.isPlaybackOngoing() to let apps query whether the service needs to be stopped in onTaskRemoved() ( #1219 ).
    • Add MediaSessionService.pauseAllPlayersAndStopSelf() that conveniently allows to pause playback of all sessions and call stopSelf() to terminate the lifecycle of the MediaSessionService .
    • Override MediaSessionService.onTaskRemoved(Intent) to provide a safe default implementation that keeps the service running in the foreground if playback is ongoing or stops the service otherwise.
    • Hide seekbar in the media notification for live streams by not setting the duration into the platform session metadata ( #1256 ).
    • Align conversion of MediaMetadata to MediaDescriptionCompat , to use the same preferred order and logic when selecting metadata properties as in media1.
    • Add MediaSession.sendError() that allows sending non-fatal errors to Media3 controller. When using the notification controller (see MediaSession.getMediaNotificationControllerInfo() ), the custom error is used to update the PlaybackState of the platform session to an error state with the given error information ( #543 ).
    • Add MediaSession.Callback.onPlayerInteractionFinished() to inform sessions when a series of player interactions from a specific controller finished.
    • Add SessionError and use it in SessionResult and LibraryResult instead of the error code to provide more information about the error and how to resolve the error if possible.
    • Publish the code for the media3 controller test app that can be used to test interactions with apps publishing a media session.
    • Propagate extras passed to media3's MediaSession[Builder].setSessionExtras() to a media1 controller's PlaybackStateCompat.getExtras() .
    • Map fatal and non-fatal errors to and from the platform session. A PlaybackException is mapped to a fatal error state of the PlaybackStateCompat . A SessionError sent to the media notification controller with MediaSession.sendError(ControllerInfo, SessionError) is mapped to a non-fatal error in PlaybackStateCompat which means that error code and message are set but the state of the platform session remains different to STATE_ERROR .
    • Allow the session activity to be set per controller to override the global session activity. The session activity can be defined for a controller at connection time by creating a ConnectionResult with AcceptedResultBuilder.setSessionActivivty(PendingIntent) . Once connected, the session activity can be updated with MediaSession.setSessionActivity(ControllerInfo, PendingIntent) .
    • Improve error replication of calls to MediaLibrarySession.Callback . Error replication can now be configured by using MediaLibrarySession.Builder.setLibraryErrorReplicationMode() for choosing the error type or opt-ing out of error replication which is on by default.
  • UI:
    • Add image display support to PlayerView when connected to an ExoPlayer ( #1144 ).
    • Add customization of various icons in PlayerControlView through xml attributes to allow different drawables per PlayerView instance, rather than global overrides ( #1200 ).
    • Work around a platform bug causing stretched/cropped video when using SurfaceView inside a Compose AndroidView on API 34 ( #1237 ).
  • ডাউনলোড:
    • Ensure that DownloadHelper does not leak unreleased Renderer instances, which can eventually result in an app crashing with IllegalStateException: Too many receivers, total of 1000, registered for pid ( #1224 ).
  • Cronet Extension:
    • Fix SocketTimeoutException in CronetDataSource . In some versions of Cronet, the request provided by the callback is not always the same. This leads to callback not completing and request timing out (https://issuetracker.google.com/328442628).
  • HLS Extension:
    • Fix bug where pending EMSG samples waiting for a discontinuity were delegated in HlsSampleStreamWrapper with an incorrect offset causing an IndexOutOfBoundsException or an IllegalArgumentException ( #1002 ).
    • Fix bug where non-primary playlists keep reloading for LL-HLS streams ( #1240 ).
    • Fix bug where enabling CMCD for HLS with initialization segments resulted in Source Error and IllegalArgumentException .
    • Fix bug where non-primary playing playlists are not refreshed during live playback ( #1240 ).
    • Fix bug where enabling CMCD for HLS live streams causes ArrayIndexOutOfBoundsException ( #1395 ).
  • DASH Extension:
    • Fix bug where re-preparing a multi-period live stream can throw an IndexOutOfBoundsException ( #1329 ).
    • Add support for dashif:Laurl license urls ( #1345 ).
  • Cast Extension:
    • Fix bug that converted the album title of the MediaQueueItem to the artist in the Media3 media item ( #1255 ).
  • Test Utilities:
    • Implement onInit() and onRelease() in FakeRenderer .
    • Change TestPlayerRunHelper.runUntil()/playUntil() methods to fail on nonfatal errors (eg those reported to AnalyticsListener.onVideoCodecError() ). Use the new TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() method chain to disable this behavior.
  • Demo app:
    • Use DefaultPreloadManager in the short form demo app.
    • Allow setting repeat mode with Intent arguments from command line ( #1266 ).
    • Use HttpEngineDataSource as the HttpDataSource when supported by the device.
  • Remove deprecated symbols:
    • Remove CronetDataSourceFactory . Use CronetDataSource.Factory instead.
    • Remove some DataSpec constructors. Use DataSpec.Builder instead.
    • Remove setContentTypePredicate(Predicate) method from DefaultHttpDataSource , OkHttpDataSource and CronetDataSource . Use the equivalent method on each XXXDataSource.Factory instead.
    • Remove OkHttpDataSource constructors and OkHttpDataSourceFactory . Use OkHttpDataSource.Factory instead.
    • Remove PlayerMessage.setHandler(Handler) . Use setLooper(Looper) instead.
    • Remove Timeline.Window.isLive field. Use the isLive() method instead.
    • Remove DefaultHttpDataSource constructors. Use DefaultHttpDataSource.Factory instead.
    • Remove DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS . Use DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS instead.
    • Remove MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) . Use MediaCodecInfo.canReuseCodec(Format, Format) instead.
    • Remove DrmSessionManager.DUMMY and getDummyDrmSessionManager() method. Use DrmSessionManager.DRM_UNSUPPORTED instead.
    • Remove AnalyticsListener.onAudioInputFormatChanged(EventTime, Format) , AnalyticsListener.onVideoInputFormatChanged(EventTime, Format) , AudioRendererEventListener.onAudioInputFormatChanged(Format) , VideoRendererEventListener.onVideoInputFormatChanged(Format) . Use the overloads that take a DecoderReuseEvaluation instead.
    • Remove RendererSupport.FormatSupport IntDef and FORMAT_HANDLED , FORMAT_EXCEEDS_CAPABILITIES , FORMAT_UNSUPPORTED_DRM , FORMAT_UNSUPPORTED_SUBTYPE , FORMAT_UNSUPPORTED_TYPE constants. Use the equivalent IntDef and constants in androidx.media3.common.C instead (eg C.FORMAT_HANDLED ).
    • Remove Bundleable interface. This includes removing all Bundleable.Creator<Foo> CREATOR constant fields. Callers should use the Bundle toBundle() and static Foo fromBundle(Bundle) methods on each type instead.

Version 1.4.0-rc01

10 জুলাই, 2024

Use the 1.4.0 stable version .

Version 1.4.0-beta01

জুন 26, 2024

Use the 1.4.0 stable version .

Version 1.4.0-alpha02

জুন 07, 2024

Use the 1.4.0 stable version .

Version 1.4.0-alpha01

এপ্রিল 17, 2024

Use the 1.4.0 stable version .

সংস্করণ 1.3.0

সংস্করণ 1.3.1

11 এপ্রিল, 2024

androidx.media3:media3-*:1.3.1 is released. Version 1.3.1 contains these commits .

  • Common Library:
    • Add Format.labels to allow localized or other alternative labels.
  • ExoPlayer:
    • Fix issue where PreloadMediaPeriod cannot retain the streams when it is preloaded again.
    • Apply the correct corresponding TrackSelectionResult to the playing period in track reselection.
    • Start early-enabled renderers only after advancing the playing period when transitioning between media items ( #1017 ).
    • Add missing return type to proguard -keepclasseswithmembers rule for DefaultVideoFrameProcessor.Factory.Builder.build() ( #1187 ).
  • ট্রান্সফরমার:
    • Add workaround for exception thrown due to MediaMuxer not supporting negative presentation timestamps before API 30.
  • Track Selection:
    • DefaultTrackSelector : Prefer video tracks with a 'reasonable' frame rate (>=10fps) over those with a lower or unset frame rate. This ensures the player selects the 'real' video track in MP4s extracted from motion photos that can contain two HEVC tracks where one has a higher resolution but a very small number of frames ( #1051 ).
  • Extractors:
    • Fix issue where padding was not skipped when reading odd-sized chunks from WAV files ( #1117 ).
    • MP3: Populate Format.averageBitrate from metadata frames such as XING and VBRI .
    • MPEG-TS: Revert a change that aimed to ensure the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ). This is due to the change causing new problems with I-frame only HLS streams ( #1150 ) and H.262 HLS streams ( #1126 ).
  • অডিও:
    • Allow renderer recovery by disabling offload if audio track fails to initialize in offload mode.
  • ভিডিও:
    • Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with Google TV, and Lenovo M10 FHD Plus that causes 60fps H265 streams to be marked as unsupported
    • Add workaround that ensures the first frame is always rendered while tunneling even if the device does not do this automatically as required by the API ( #1169 ). ( #966 ).
    • Fix issue where HDR color info handling causes codec misbehavior and prevents adaptive format switches for SDR video tracks ( #1158 ).
  • পাঠ্য:
    • WebVTT: Prevent directly consecutive cues from creating spurious additional CuesWithTiming instances from WebvttParser.parse ( #1177 ).
  • DRM:
    • Work around a NoSuchMethodError which can be thrown by the MediaDrm framework instead of ResourceBusyException or NotProvisionedException on some Android 14 devices ( #1145 ).
  • প্রভাব:
    • Improved PQ to SDR tone-mapping by converting color spaces.
  • অধিবেশন:
    • Fix issue where the current position jumps back when the controller replaces the current item ( #951 ).
    • Fix issue where MediaMetadata with just non-null extras is not transmitted between media controllers and sessions ( #1176 ).
  • UI:
    • Fallback to include audio track language name if Locale cannot identify a display name ( #988 ).
  • DASH Extension:
    • Populate all Label elements from the manifest into Format.labels ( #1054 ).
  • RTSP Extension:
    • Skip empty session information values (i-tags) in SDP parsing ( #1087 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • Disable the MIDI extension as a local dependency by default because it requires an additional Maven repository to be configured. Users who need this module from a local dependency can re-enable it .

সংস্করণ 1.3.0

6 মার্চ, 2024

androidx.media3:media3-*:1.3.0 is released. Version 1.3.0 contains these commits .

  • Common Library:
    • Implement support for android.resource://package/[type/]name raw resource URIs where package is different to the package of the current application. This has always been documented to work, but wasn't correctly implemented until now.
    • Normalize MIME types set by app code or read from media to be fully lower-case.
    • Define ads with a full MediaItem instead of a single Uri in AdPlaybackState .
    • Increase minSdk to 19 (Android KitKat). This is aligned with all other AndroidX libraries , and is required for us to upgrade to the latest versions of our AndroidX dependencies.
    • Populate both artworkUri and artworkData in MediaMetadata.Builder.populate(MediaMetadata) when at least one of them is non-null ( #964 ).
  • ExoPlayer:
    • Add PreloadMediaSource and PreloadMediaPeriod that allows apps to preload a content media source at a specific start position before playback. PreloadMediaSource takes care of preparing the content media source to receive the Timeline , preparing and caching the period at the given start position, selecting tracks and loading media data for the period. Apps control the preload progress by implementing PreloadMediaSource.PreloadControl and set the preloaded source to the player for playback.
    • Add ExoPlayer.setImageOutput that allows apps to set ImageRenderer.ImageOutput .
    • DefaultRenderersFactory now provides an ImageRenderer to the player by default with null ImageOutput and ImageDecoder.Factory.DEFAULT .
    • Emit Player.Listener.onPositionDiscontinuity event when silence is skipped ( #765 ).
    • Add experimental support for parsing subtitles during extraction. You can enable this using MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() .
    • Support adaptive media sources with PreloadMediaSource .
    • Implement HttpEngineDataSource , an HttpDataSource using the HttpEngine API.
    • Prevent subclassing CompositeSequenceableLoader . This component was previously made extensible but was never subclassed within the library. Customizations can be done by wrapping an instance using the decorator pattern and implementing a custom CompositeSequenceableLoaderFactory .
    • Fix issue where repeating the same time causes metadata from this item to be cleared ( #1007 ).
    • Rename experimentalSetSubtitleParserFactory methods on BundledChunkExtractor.Factory and DefaultHlsExtractorFactory to setSubtitleParserFactory and disallow passing null . Use the new experimentalParseSubtitlesDuringExtraction(boolean) methods to control parsing behaviour.
    • Add support for customising the SubtitleParser.Factory used during extraction. This can be achieved with MediaSource.Factory.setSubtitleParserFactory() .
    • Add source prefix to all Format.id fields generated from MergingMediaSource . This helps to identify which source produced a Format ( #883 ).
    • Fix the regex used for validating custom Common Media Client Data (CMCD) key names by modifying it to only check for hyphen ( #1028 ).
    • Stop double-encoding CMCD query parameters ( #1075 ).
  • ট্রান্সফরমার:
    • Add support for flattening H.265/HEVC SEF slow motion videos.
    • Increase transmuxing speed, especially for 'remove video' edits.
    • Add API to ensure that the output file starts on a video frame. This can make the output of trimming operations more compatible with player implementations that don't show the first video frame until its presentation timestamp ( #829 ).
    • Add support for optimizing single asset MP4 trim operations.
    • Add support to ensure a video frame has the first timestamp in the output file. Fixes output files beginning with black frame on iOS based players ( #829 ).
  • Track Selection:
    • Add DefaultTrackSelector.selectImageTrack to enable image track selection.
    • Add TrackSelectionParameters.isPrioritizeImageOverVideoEnabled to determine whether to select an image track if both an image track and a video track are available. The default value is false which means selecting a video track is prioritized.
  • Extractors:
    • Add additional AV1C parsing to MP4 extractor to retrieve ColorInfo.colorSpace , ColorInfo.colorTransfer , and ColorInfo.colorRange values ( #692 ).
    • MP3: Use constant bitrate (CBR) seeking for files with an Info header (the CBR equivalent of the Xing header). Previously we used the seek table from the Info header, but this results in less precise seeking than if we ignore it and assume the file is CBR.
    • MPEG2-TS: Add DTS, DTS-LBR and DTS:X Profile2 support ( #275 ).
    • Extract audio types from TS descriptors and map them to role flags, allowing users to make better-informed audio track selections ( #973 ).
  • অডিও:
    • Improve silence skipping algorithm with smooth volume ramp; retained minimal silence and more natural silence durations ( #7423 ).
    • Report the skipped silence more deterministically ( #1035 ).
  • ভিডিও:
    • Change the MediaCodecVideoRenderer constructor that takes a VideoFrameProcessor.Factory argument and replace it with a constructor that takes a VideoSinkProvider argument. Apps that want to inject a custom VideoFrameProcessor.Factory can instantiate a CompositingVideoSinkProvider that uses the custom VideoFrameProcessor.Factory and pass the video sink provider to MediaCodecVideoRenderer .
  • পাঠ্য:
    • Fix serialization of bitmap cues to resolve Tried to marshall a Parcel that contained Binder objects error when using DefaultExtractorsFactory.setTextTrackTranscodingEnabled ( #836 ).
    • CEA-708: Ignore rowLock value. The CEA-708-E S-2023 spec states that rowLock and columnLock should both be assumed to be true, regardless of the values present in the stream ( columnLock support is not implemented, so it's effectively assumed to always be false).
  • ছবি:
    • Add support for DASH thumbnails. Grid images are cropped and individual thumbnails are provided to ImageOutput close to their presentation times.
  • DRM:
  • IMA extension:
    • Fix issue where DASH and HLS ads without the appropriate file extension can't be played.
  • অধিবেশন:
    • Disable double-click detection for TV apps ( #962 ).
    • Fix issue where MediaItem.RequestMetadata with just non-null extras is not transmitted between media controllers and sessions.
    • Add constructor to MediaLibrarySession.Builder that only takes a Context instead of a MediaLibraryService .
  • HLS Extension:
    • Reduce HlsMediaPeriod to package-private visibility. This type shouldn't be directly depended on from outside the HLS package.
    • Resolve seeks to beginning of a segment more efficiently ( #1031 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • MIDI decoder: Ignore SysEx event messages ( #710 ).
  • Test Utilities:
    • Don't pause playback in TestPlayerRunHelper.playUntilPosition . The test keeps the playback in a playing state, but suspends progress until the test is able to add assertions and further actions.
  • Demo app:
    • Add a shortform demo module to demo the usage of PreloadMediaSource with the short-form content use case.

সংস্করণ 1.3.0-rc01

22 ফেব্রুয়ারি, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.3.0-beta01

7 ফেব্রুয়ারি, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.3.0-alpha01

15 জানুয়ারী, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.2.0

সংস্করণ 1.2.1

জানুয়ারী 9, 2024

  • ExoPlayer:
    • Fix issue where manual seeks outside of the LiveConfiguration.min/maxOffset range keep adjusting the offset back to min/maxOffset .
    • Fix issue that OPUS and VORBIS channel layouts are wrong for 3, 5, 6, 7 and 8 channels ( #8396 ).
    • Fix issue where track selections after seek to zero in a live stream incorrectly let the stream start at its default position ( #9347 ).
    • Fix the issue where new instances of CmcdData.Factory were receiving negative values for bufferedDurationUs from chunk sources, resulting in an IllegalArgumentException ( #888 ).
  • ট্রান্সফরমার:
    • Work around an issue where the encoder would throw at configuration time due to setting a high operating rate.
  • Extractors:
    • Mark secondary (unplayable) HEVC tracks in JPEG motion photos as ROLE_FLAG_ALTERNATE to prevent them being automatically selected for playback because of their higher resolution.
    • Fix wrong keyframe detection for TS H264 streams ( #864 ).
    • Fix duration estimation of TS streams that are longer than 47721 seconds ( #855 ).
  • অডিও:
    • Fix handling of EOS for SilenceSkippingAudioProcessor when called multiple times ( #712 ).
  • ভিডিও:
    • Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with Google TV, and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #693 ).
  • মেটাডেটা:
    • Fix bug where MediaMetadata was only populated from Vorbis comments with upper-case keys ( #876 ).
    • Catch OutOfMemoryError when parsing very large ID3 frames, meaning playback can continue without the tag info instead of playback failing completely.
  • DRM:
    • Extend workaround for spurious ClearKey https://default.url license URL to API 33+ (previously the workaround only applied on API 33 exactly) ( #837 ).
    • Fix ERROR_DRM_SESSION_NOT_OPENED when switching from encrypted to clear content without a surface attached to the player. The error was due to incorrectly using a secure decoder to play the clear content.
  • অধিবেশন:
    • Put the custom keys and values in MediaMetadataCompat to MediaMetadata.extras and MediaMetadata.extras to MediaMetadataCompat ( #756 , #802 ).
    • Fix broadcasting notifyChildrenChanged for legacy controllers ( #644 ).
    • Fix a bug where setting a negative time for a disabled setWhen timer of the notification caused a crash on some devices ( #903 ).
    • Fix IllegalStateException when the media notification controller hasn't completed connecting when the first notification update is requested ( #917 ).
  • UI:
    • Fix issue where forward and rewind buttons are not visible when used with Material Design in a BottomSheetDialogFragment ( #511 ).
    • Fix issue where the numbers in the fast forward button of the PlayerControlView were misaligned ( #547 ).
  • DASH Extension:
    • Parse "f800" as channel count of 5 for Dolby in DASH manifest ( #688 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • MIDI: Fix issue where seeking forward skips the Program Change events ( #704 ).
    • Migrate to FFmpeg 6.0 and update supported NDK to r26b ( #707 , #867 ).
  • Cast Extension:
    • Sanitize creation of a Timeline to not crash the app when loading media fails on the cast device ( #708 ).

সংস্করণ 1.2.0

15 নভেম্বর, 2023

  • Common Library:
    • Add a @Nullable Throwable parameter to the methods in the Log.Logger interface. The message parameter to these methods no longer contains any information about the Throwable passed to the Log.{d,i,w,e}() methods, so implementations will need to manually append this information if desired (possibly using Logger.appendThrowableString(String, Throwable) ).
    • Fix Kotlin compatibility issue where nullable generic type parameters and nullable array element types are not detected as nullable. Examples are TrackSelectorResult and SimpleDecoder method parameters ( #6792 ).
    • Change default UI and notification behavior in Util.shouldShowPlayButton to show a "play" button while playback is temporarily suppressed (eg due to transient audio focus loss). The legacy behavior can be maintained by using PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) or MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) ( #11213 ).
    • Upgrade androidx.annotation:annotation-experimental to 1.3.1 to fix https://issuetracker.google.com/251172715.
    • Move ExoPlayer.setAudioAttributes to the Player interface.
  • ExoPlayer:
    • Fix seeking issues in AC4 streams caused by not identifying decode-only samples correctly ( #11000 ).
    • Add suppression of playback on unsuitable audio output devices (eg the built-in speaker on Wear OS devices) when this feature is enabled via ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput . The playback suppression reason will be updated as Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT if playback is attempted when no suitable audio outputs are available, or if all suitable outputs are disconnected during playback. The suppression reason will be removed when a suitable output is connected.
    • Add MediaSource.canUpdateMediaItem and MediaSource.updateMediaItem to accept MediaItem updates after creation via Player.replaceMediaItem(s) .
    • Allow MediaItem updates for all MediaSource classes provided by the library via Player.replaceMediaItem(s) ( #33 , #9978 ).
    • Rename MimeTypes.TEXT_EXOPLAYER_CUES to MimeTypes.APPLICATION_MEDIA3_CUES .
    • Add PngExtractor that sends and reads a whole PNG file into the TrackOutput as one sample.
    • Enhance SequenceableLoader.continueLoading(long) method in the SequenceableLoader interface to SequenceableLoader.continueLoading(LoadingInfo loadingInfo) . LoadingInfo contains additional parameters, including playbackSpeed and lastRebufferRealtimeMs in addition to the existing playbackPositionUs .
    • Enhance ChunkSource.getNextChunk(long, long, List, ChunkHolder) method in the ChunkSource interface to ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) .
    • Add additional fields to Common Media Client Data (CMCD) logging: buffer starvation ( bs ), deadline ( dl ), playback rate ( pr ) and startup ( su ) ( #8699 ).
    • Add luma and chroma bitdepth to ColorInfo ( #491 ).
    • Add additional fields to Common Media Client Data (CMCD) logging: next object request ( nor ) and next range request ( nrr ) ( #8699 ).
    • Add functionality to transmit Common Media Client Data (CMCD) data using query parameters ( #553 ).
    • Fix ConcurrentModificationException in ExperimentalBandwidthMeter ( #612 ).
    • Add MediaPeriodId parameter to CompositeMediaSource.getMediaTimeForChildMediaTime .
    • Support ClippingMediaSource (and other sources with period/window time offsets) in ConcatenatingMediaSource2 ( #11226 ).
    • Change BaseRenderer.onStreamChanged() to also receive a MediaPeriodId argument.
  • ট্রান্সফরমার:
    • Parse EXIF rotation data for image inputs.
    • Remove TransformationRequest.HdrMode annotation type and its associated constants. Use Composition.HdrMode and its associated constants instead.
    • Simplify the OverlaySettings to fix rotation issues.
    • Changed frameRate and durationUs parameters of SampleConsumer.queueInputBitmap to TimestampIterator .
  • Track Selection:
    • Add DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness to explicitly allow or disallow non-seamless adaptation. The default stays at its current behavior of true .
  • Extractors:
    • MPEG-TS: Ensure the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ).
    • Fix typo when determining rotationDegrees . Changed projectionPosePitch to projectionPoseRoll ( #461 ).
    • Remove the assumption that Extractor instances can be directly inspected with instanceof . If you want runtime access to the implementation details of an Extractor you must first call Extractor.getUnderlyingInstance .
    • Add BmpExtractor .
    • Add WebpExtractor .
    • Add HeifExtractor .
    • Add QuickTime classic support to Mp4Extractor .
  • অডিও:
    • Add support for 24/32-bit big-endian PCM in MP4 and Matroska, and parse PCM encoding for lpcm in MP4.
    • Add support for extracting Vorbis audio in MP4.
    • Add AudioSink.getFormatOffloadSupport(Format) that retrieves level of offload support the sink can provide for the format through a DefaultAudioOffloadSupportProvider . It returns the new AudioOffloadSupport that contains isFormatSupported , isGaplessSupported , and isSpeedChangeSupported .
    • Add AudioSink.setOffloadMode() through which the offload configuration on the audio sink is configured. Default is AudioSink.OFFLOAD_MODE_DISABLED .
    • Offload can be enabled through setAudioOffloadPreference in TrackSelectionParameters . If the set preference is to enable, the device supports offload for the format, and the track selection is a single audio track, then audio offload will be enabled.
    • If audioOffloadModePreference is set to AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED , then the DefaultTrackSelector will only select an audio track and only if that track's format is supported in offload. If no audio track is supported in offload, then no track will be selected.
    • Disabling gapless support for offload when pre-API level 33 due to playback position issue after track transition.
    • Remove parameter enableOffload from DefaultRenderersFactory.buildAudioSink method signature.
    • Remove method DefaultAudioSink.Builder.setOffloadMode .
    • Remove intdef value DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED .
    • Add support for Opus gapless metadata during offload playback.
    • Allow renderer recovery by disabling offload if failed at first write ( #627 ).
    • Enable Offload Scheduling by default for audio-only offloaded playback.
    • Delete ExoPlayer.experimentalSetOffloadSchedulingEnabled and AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged .
    • Renamed onExperimentalSleepingForOffloadChanged as onSleepingForOffloadChanged and onExperimentalOffloadedPlayback as onOffloadedPlayback .
    • Move audio offload mode related TrackSelectionParameters interfaces and definitions to an inner AudioOffloadPreferences class.
    • Add onAudioTrackInitialized and onAudioTrackReleased callbacks to AnalyticsListener , AudioRendererEventListener and AudioSink.Listener .
    • Fix DTS Express audio buffer underflow issue ( #650 ).
    • Fix bug where the capabilities check for E-AC3-JOC throws an IllegalArgumentException ( #677 ).
  • ভিডিও:
    • Allow MediaCodecVideoRenderer to use a custom VideoFrameProcessor.Factory .
    • Fix bug where the first frame couldn't be rendered if the audio stream starts with negative timestamps ( #291 ).
  • পাঠ্য:
    • Remove ExoplayerCuesDecoder . Text tracks with sampleMimeType = application/x-media3-cues are now directly handled by TextRenderer without needing a SubtitleDecoder instance.
  • মেটাডেটা:
    • MetadataDecoder.decode will no longer be called for "decode-only" samples as the implementation must return null anyway.
  • প্রভাব:
    • Add VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) queuing bitmap input by timestamp.
    • Change VideoFrameProcessor.registerInputStream() to be non-blocking. Apps must implement VideoFrameProcessor.Listener#onInputStreamRegistered() .
    • Changed frameRate and durationUs parameters of VideoFrameProcessor.queueInputBitmap to TimestampIterator .
  • IMA extension:
    • Fix bug where a multi-period DASH live stream that is not the first item in a playlist can throw an exception ( #571 ).
    • Release StreamManager before calling AdsLoader.destroy()
    • Bump IMA SDK version to 3.31.0.
  • অধিবেশন:
    • Set the notifications foreground service behavior to FOREGROUND_SERVICE_IMMEDIATE in DefaultMediaNotificationProvider ( #167 ).
    • Use only android.media.session.MediaSession.setMediaButtonBroadcastReceiver() above API 31 to avoid problems with deprecated API on Samsung devices ( #167 ).
    • Use the media notification controller as proxy to set available commands and custom layout used to populate the notification and the platform session.
    • Convert media button events that are received by MediaSessionService.onStartCommand() within Media3 instead of routing them to the platform session and back to Media3. With this, the caller controller is always the media notification controller and apps can easily recognize calls coming from the notification in the same way on all supported API levels.
    • Fix bug where MediaController.getCurrentPosition() is not advancing when connected to a legacy MediaSessionCompat .
    • Add MediaLibrarySession.getSubscribedControllers(mediaId) for convenience.
    • Override MediaLibrarySession.Callback.onSubscribe() to assert the availability of the parent ID for which the controller subscribes. If successful, the subscription is accepted and notifyChildrenChanged() is called immediately to inform the browser ( #561 ).
    • Add session demo module for Automotive OS and enable session demo for Android Auto.
    • Do not set the queue of the framework session when COMMAND_GET_TIMELINE is not available for the media notification controller. With Android Auto as the client controller reading from the framework session, this has the effect that the queue button in the UI of Android Auto is not displayed ( #339 ).
    • Use DataSourceBitmapLoader by default instead of SimpleBitmapLoader ( #271 , #327 ).
    • Add MediaSession.Callback.onMediaButtonEvent(Intent) that allows apps to override the default media button event handling.
  • UI:
    • Add a Player.Listener implementation for Wear OS devices that handles playback suppression due to Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT by launching a system dialog to allow a user to connect a suitable audio output (eg bluetooth headphones). The listener will auto-resume playback if a suitable device is connected within a configurable timeout (default is 5 minutes).
  • ডাউনলোড:
    • Declare "data sync" foreground service type for DownloadService for Android 14 compatibility. When using this service, the app also needs to add dataSync as foregroundServiceType in the manifest and add the FOREGROUND_SERVICE_DATA_SYNC permission ( #11239 ).
  • HLS Extension:
    • Refresh the HLS live playlist with an interval calculated from the last load start time rather than the last load completed time ( #663 ).
  • DASH Extension:
    • Allow multiple of the same DASH identifier in segment template URL.
    • Add experimental support for parsing subtitles during extraction. This has better support for merging overlapping subtitles, including resolving flickering when transitioning between subtitle segments. You can enable this using DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ( #288 ).
  • RTSP Extension:
    • Fix a race condition that could lead to IndexOutOfBoundsException when falling back to TCP, or playback hanging in some situations.
    • Check state in RTSP setup when returning loading state of RtspMediaPeriod ( #577 ).
    • Ignore custom Rtsp request methods in Options response public header ( #613 ).
    • Use RTSP Setup Response timeout value in time interval of sending keep-alive RTSP Options requests ( #662 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • Release the MIDI decoder module, which provides support for playback of standard MIDI files using the Jsyn library to synthesize audio.
    • Add DecoderOutputBuffer.shouldBeSkipped to directly mark output buffers that don't need to be presented. This is preferred over C.BUFFER_FLAG_DECODE_ONLY that will be deprecated.
    • Add Decoder.setOutputStartTimeUs and SimpleDecoder.isAtLeastOutputStartTimeUs to allow decoders to drop decode-only samples before the start time. This should be preferred to Buffer.isDecodeOnly that will be deprecated.
    • Fix bug publishing MIDI decoder artifact to Maven repository. The artifact is renamed to media3-exoplayer-midi ( #734 ).
  • Leanback extension:
    • Fix bug where disabling a surface can cause an ArithmeticException in Leanback code ( #617 ).
  • Test Utilities:
    • Make TestExoPlayerBuilder and FakeClock compatible with Espresso UI tests and Compose UI tests. This fixes a bug where playback advances non-deterministically during Espresso or Compose view interactions.
  • Remove deprecated symbols:
    • Remove TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) and TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) . Use Composition.Builder.setHdrMode(int) and pass the Composition to Transformer.start(Composition, String) instead.
    • Remove deprecated DownloadNotificationHelper.buildProgressNotification method, use a non deprecated method that takes a notMetRequirements parameter instead.

সংস্করণ 1.2.0-rc01

নভেম্বর 1, 2023

Use the 1.2.0 stable version .

সংস্করণ 1.2.0-beta01

অক্টোবর 19, 2023

Use the 1.2.0 stable version .

Version 1.2.0-alpha02

সেপ্টেম্বর 29, 2023

Use the 1.2.0 stable version .

Version 1.2.0-alpha01

আগস্ট 17, 2023

Use the 1.2.0 stable version .

সংস্করণ 1.1.0

সংস্করণ 1.1.1

16 আগস্ট, 2023

  • Common Library:
    • Remove accidentally added multidex dependency from all modules ( #499 ).
  • ExoPlayer:
    • Fix issue in PlaybackStatsListener where spurious PlaybackStats are created after the playlist is cleared.
    • Add additional fields to Common Media Client Data (CMCD) logging: streaming format (sf), stream type (st), version (v), top birate (tb), object duration (d), measured throughput (mtp) and object type (ot) ( #8699 ).
  • অডিও:
    • Fix a bug where Player.getState() never transitioned to STATE_ENDED when playing very short files ( #538 ).
  • Audio Offload:
    • Prepend Ogg ID Header and Comment Header Pages to bitstream for offloaded Opus playback in accordance with RFC 7845.
  • ভিডিও:
    • H.265/HEVC: Fix parsing SPS short and long term reference picture info.
  • পাঠ্য:
    • CEA-608: Change cue truncation logic to only consider visible text. Previously indent and tab offset were included when limiting the cue length to 32 characters (which was technically correct by the spec) ( #11019 ).
  • IMA extension:
    • Bump IMA SDK version to 3.30.3.
  • অধিবেশন:
    • Add custom layout to the state of the controller and provide a getter to access it. When the custom layout changes, MediaController.Listener.onCustomLayoutChanged is called. Apps that want to send different custom layouts to different Media3 controller can do this in MediaSession.Callback.onConnect by using an AcceptedResultBuilder to make sure the custom layout is available to the controller when connection completes.
    • Fix cases where MediaLibraryServiceLegacyStub sent an error to a Result that didn't support this which produced an UnsupportedOperationException ( #78 ).
    • Fix the way PlayerWrapper creates a VolumeProviderCompat by determining volumeControlType through both legacy commands ( COMMAND_ADJUST_DEVICE_VOLUME and COMMAND_SET_DEVICE_VOLUME ) and new commands ( COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS and COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS ) ( #554 ).

সংস্করণ 1.1.0

5 জুলাই, 2023

  • Common Library:
    • Add suppression reason for unsuitable audio route and play when ready change reason for suppressed too long. ( #15 ).
    • Add commands to Player:
      • COMMAND_GET_METADATA
      • COMMAND_SET_PLAYLIST_METADATA
      • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
      • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
    • Add overloaded methods to Player which allow users to specify volume flags:
      • void setDeviceVolume(int, int)
      • void increaseDeviceVolume(int)
      • void decreaseDeviceVolume(int)
      • void setDeviceMuted(boolean, int)
    • Add Builder for DeviceInfo and deprecate existing constructor.
    • Add DeviceInfo.routingControllerId to specify the routing controller ID for remote playbacks.
    • Add Player.replaceMediaItem(s) as a shortcut to adding and removing items at the same position ( #8046 ).
  • ExoPlayer:
    • Allow ExoPlayer to have control of device volume methods only if explicitly opted in. Use ExoPlayer.Builder.setDeviceVolumeControlEnabled to have access to:
      • getDeviceVolume()
      • isDeviceMuted()
      • setDeviceVolume(int) and setDeviceVolume(int, int)
      • increaseDeviceVolume(int) and increaseDeviceVolume(int, int)
      • decreaseDeviceVolume(int) and decreaseDeviceVolume(int, int)
    • Add FilteringMediaSource that allows to filter available track types from a MediaSource .
    • Add support for including Common Media Client Data (CMCD) in the outgoing requests of adaptive streaming formats DASH, HLS, and SmoothStreaming. The following fields, br , bl , cid , rtp , and sid , have been incorporated ( #8699 ). API structure and API methods:
      • CMCD logging is disabled by default, use MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) to enable it.
      • All keys are enabled by default, override CmcdConfiguration.RequestConfig.isKeyAllowed(String key) to filter out which keys are logged.
      • Override CmcdConfiguration.RequestConfig.getCustomData() to enable custom key logging.
    • Add additional action to manifest of main demo to make it easier to start the demo app with a custom *.exolist.json file ( #439 ).
    • Add ExoPlayer.setVideoEffects() for using Effect during video playback.
    • Update SampleQueue to store sourceId as a long rather than an int . This changes the signatures of public methods SampleQueue.sourceId and SampleQueue.peekSourceId .
    • Add parameters to LoadControl methods shouldStartPlayback and onTracksSelected that allow associating these methods with the relevant MediaPeriod .
    • Change signature of ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) by adding a timeline parameter that contains the periods with the UIDs used as keys in the map. This is required to avoid concurrency issues with multi-period live streams.
    • Deprecate EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) and BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs) . The variant of the methods without the mediaTimeOffsetUs can be called instead. Note that even for the deprecated variants, the offset is not anymore added to startTimeUs and endTimeUs of the MediaLoadData objects that are dispatched by the dispatcher.
    • Rename ExoTrackSelection.blacklist to excludeTrack and isBlacklisted to isTrackExcluded .
    • Fix inconsistent behavior between ExoPlayer.setMediaItem(s) and addMediaItem(s) when called on an empty playlist.
  • ট্রান্সফরমার:
    • Remove Transformer.Builder.setMediaSourceFactory(MediaSource.Factory) . Use ExoPlayerAssetLoader.Factory(MediaSource.Factory) and Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory) instead.
    • Remove Transformer.startTransformation(MediaItem, ParcelFileDescriptor) .
    • Fix a bug where transformation could get stuck (leading to muxer timeout) if the end of the video stream was signaled at the moment when an input frame was pending processing.
    • Query codecs via MediaCodecList instead of using findDecoder/EncoderForFormat utilities, to expand support.
    • Remove B-frame configuration in DefaultEncoderFactory because it doesn't work on some devices.
  • Track selection:
    • Add DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange which is disabled by default. When enabled, the DefaultTrackSelector will trigger a new track selection when the renderer capabilities changed.
  • Extractors:
    • Ogg: Fix bug when seeking in files with a long duration ( #391 ).
    • FMP4: Fix issue where TimestampAdjuster initializes a wrong timestamp offset with metadata sample time from emsg atom ( #356 ).
  • অডিও:
    • Fix bug where some playbacks fail when tunneling is enabled and AudioProcessors are active, eg for gapless trimming ( #10847 ).
    • Encapsulate Opus frames in Ogg packets in direct playbacks (offload).
    • Extrapolate current position during sleep with offload scheduling.
    • Add Renderer.release() and AudioSink.release() for releasing the resources at the end of player's lifecycle.
    • Listen to audio capabilities changes in DefaultAudioSink . Add a required parameter context in the constructor of DefaultAudioSink , with which the DefaultAudioSink will register as the listener to the AudioCapabilitiesReceiver and update its audioCapabilities property when informed with a capabilities change.
    • Propagate audio capabilities changes via a new event onAudioCapabilitiesChanged in AudioSink.Listener interface, and a new interface RendererCapabilities.Listener which triggers onRendererCapabilitiesChanged events.
    • Add ChannelMixingAudioProcessor for applying scaling/mixing to audio channels.
    • Add new int value DISCARD_REASON_AUDIO_BYPASS_POSSIBLE to DecoderDiscardReasons to discard audio decoder when bypass mode is possible after audio capabilities change.
    • Add direct playback support for DTS Express and DTS:X ( #335 ).
  • ভিডিও:
    • Make MediaCodecVideoRenderer report a VideoSize with a width and height of 0 when the renderer is disabled. Player.Listener.onVideoSizeChanged is called accordingly when Player.getVideoSize() changes. With this change, ExoPlayer's video size with MediaCodecVideoRenderer has a width and height of 0 when Player.getCurrentTracks does not support video, or the size of the supported video track is not yet determined.
  • DRM:
    • Reduce the visibility of several internal-only methods on DefaultDrmSession that aren't expected to be called from outside the DRM package:
      • void onMediaDrmEvent(int)
      • void provision()
      • void onProvisionCompleted()
      • onProvisionError(Exception, boolean)
  • Muxer:
    • Add a new muxer library which can be used to create an MP4 container file.
  • IMA extension:
    • Enable multi-period live DASH streams for DAI. Please note that the current implementation does not yet support seeking in live streams ( #10912 ).
    • Fix a bug where a new ad group is inserted in live streams because the calculated content position in consecutive timelines varies slightly.
  • অধিবেশন:
    • Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling a Player method.
    • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset ( #167 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
  • UI:
    • Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
  • RTSP Extension:
    • For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message ( #302 ).
    • Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header ( #11160 ).
  • DASH Extension:
    • Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
    • Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException ( #10838 ).
  • HLS Extension:
    • Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. If the initialization doesn't complete before the timeout, a PlaybackException is thrown to avoid the playback endless stalling. The timeout is set to zero by default ( #323 ).
  • Test Utilities:
    • Check for URI scheme case insensitivity in DataSourceContractTest .
  • Remove deprecated symbols:
    • Remove DefaultAudioSink constructors, use DefaultAudioSink.Builder instead.
    • Remove HlsMasterPlaylist , use HlsMultivariantPlaylist instead.
    • Remove Player.stop(boolean) . Use Player.stop() and Player.clearMediaItems() (if reset is true ) instead.
    • Remove two deprecated SimpleCache constructors, use a non-deprecated constructor that takes a DatabaseProvider instead for better performance.
    • Remove DefaultBandwidthMeter constructor, use DefaultBandwidthMeter.Builder instead.
    • Remove DefaultDrmSessionManager constructors, use DefaultDrmSessionManager.Builder instead.
    • Remove two deprecated HttpDataSource.InvalidResponseCodeException constructors, use a non-deprecated constructor that accepts additional fields( cause , responseBody ) to enhance error logging.
    • Remove DownloadHelper.forProgressive , DownloadHelper.forHls , DownloadHelper.forDash , and DownloadHelper.forSmoothStreaming , use DownloadHelper.forMediaItem instead.
    • Remove deprecated DownloadService constructor, use a non deprecated constructor that includes the option to provide a channelDescriptionResourceId parameter.
    • Remove deprecated String constants for Charsets ( ASCII_NAME , UTF8_NAME , ISO88591_NAME , UTF16_NAME and UTF16LE_NAME ), use Kotlin Charsets from the kotlin.text package, the java.nio.charset.StandardCharsets or the com.google.common.base.Charsets instead.
    • Remove deprecated WorkManagerScheduler constructor, use a non deprecated constructor that includes the option to provide a Context parameter instead.
    • Remove the deprecated methods createVideoSampleFormat , createAudioSampleFormat , createContainerFormat , and createSampleFormat , which were used to instantiate the Format class. Instead use Format.Builder for creating instances of Format .
    • Remove the deprecated methods copyWithMaxInputSize , copyWithSubsampleOffsetUs , copyWithLabel , copyWithManifestFormatInfo , copyWithGaplessInfo , copyWithFrameRate , copyWithDrmInitData , copyWithMetadata , copyWithBitrate and copyWithVideoSize , use Format.buildUpon() and setter methods instead.
    • Remove deprecated ExoPlayer.retry() , use prepare() instead.
    • Remove deprecated zero-arg DefaultTrackSelector constructor, use DefaultTrackSelector(Context) instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove deprecated DownloadManager constructor, use the constructor that takes an Executor instead.
    • Remove deprecated Cue constructors, use Cue.Builder instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove four deprecated AnalyticsListener methods:
      • onDecoderEnabled , use onAudioEnabled and/or onVideoEnabled instead.
      • onDecoderInitialized , use onAudioDecoderInitialized and/or onVideoDecoderInitialized instead.
      • onDecoderInputFormatChanged , use onAudioInputFormatChanged and/or onVideoInputFormatChanged instead.
      • onDecoderDisabled , use onAudioDisabled and/or onVideoDisabled instead.
    • Remove the deprecated Player.Listener.onSeekProcessed and AnalyticsListener.onSeekProcessed , use onPositionDiscontinuity with DISCONTINUITY_REASON_SEEK instead.
    • Remove ExoPlayer.setHandleWakeLock(boolean) , use setWakeMode(int) instead.
    • Remove deprecated DefaultLoadControl.Builder.createDefaultLoadControl() , use build() instead.
    • Remove deprecated MediaItem.PlaybackProperties , use MediaItem.LocalConfiguration instead. Deprecated field MediaItem.playbackProperties is now of type MediaItem.LocalConfiguration .

Version 1.1.0-rc01

জুন 21, 2023

Use the 1.1.0 stable version .

Version 1.1.0-beta01

7 জুন, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.1.0-alpha01

10 মে, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.0.0

সংস্করণ 1.0.2

18 মে, 2023

androidx.media3:media3-*:1.0.2 is released. Version 1.0.2 contains these commits.

This release corresponds to the ExoPlayer 2.18.7 release .

This release contains the following changes since the 1.0.1 release :

  • Core library:
    • Add Buffer.isLastSample() that denotes if Buffer contains flag C.BUFFER_FLAG_LAST_SAMPLE .
    • Fix issue where last frame may not be rendered if the last sample with frames is dequeued without reading the 'end of stream' sample. ( #11079 ).
  • Extractors:
    • Fix parsing of H.265 SPS in MPEG-TS files by re-using the parsing logic already used by RTSP and MP4 extractors ( #303 ).
  • পাঠ্য:
    • SSA: Add support for UTF-16 files if they start with a byte order mark ( #319 ).
  • অধিবেশন:
    • Fix issue where MediaController doesn't update its available commands when connected to a legacy MediaSessionCompat that updates its actions.
    • Fix bug that prevented the MediaLibraryService from returning null for a call from System UI to Callback.onGetLibraryRoot with params.isRecent == true on API 30 ( #355 ).
    • Fix memory leak of MediaSessionService or MediaLibraryService ( #346 ).
    • Fix bug where a combined Timeline and position update in a MediaSession may cause a MediaController to throw an IllegalStateException .

সংস্করণ 1.0.1

18 এপ্রিল, 2023

androidx.media3:media3-*:1.0.1 is released. Version 1.0.1 contains these commits.

This release corresponds to the ExoPlayer 2.18.6 release .

  • Core library:
    • Reset target live stream override when seeking to default position ( #11051 ).
    • Fix bug where empty sample streams in the media could cause playback to be stuck.
  • অধিবেশন:
    • Fix bug where multiple identical queue items published by a legacy MediaSessionCompat result in an exception in MediaController ( #290 ).
    • Add missing forwarding of MediaSession.broadcastCustomCommand to the legacy MediaControllerCompat.Callback.onSessionEvent ( #293 ).
    • Fix bug where calling MediaSession.setPlayer doesn't update the available commands.
    • Fix issue that TrackSelectionOverride instances sent from a MediaController are ignored if they reference a group with Format.metadata ( #296 ).
    • Fix issue where Player.COMMAND_GET_CURRENT_MEDIA_ITEM needs to be available to access metadata via the legacy MediaSessionCompat .
    • Fix issue where MediaSession instances on a background thread cause crashes when used in MediaSessionService ( #318 ).
    • Fix issue where a media button receiver was declared by the library without the app having intended this ( #314 ).
  • ড্যাশ:
    • Fix handling of empty segment timelines ( #11014 ).
  • RTSP:
    • Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport ( #11069 ).

সংস্করণ 1.0.0

22 মার্চ, 2023

androidx.media3:media3-*:1.0.0 is released. Version 1.0.0 contains these commits.

This release corresponds to the ExoPlayer 2.18.5 release .

There are no changes since 1.0.0-rc02.

Version 1.0.0-rc02

2 মার্চ, 2023

androidx.media3:media3-*:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits.

This release corresponds to the ExoPlayer 2.18.4 release .

  • Core library:
    • Fix network type detection on API 33 ( #10970 ).
    • Fix NullPointerException when calling ExoPlayer.isTunnelingEnabled ( #10977 ).
  • ডাউনলোড:
    • Make the maximum difference of the start time of two segments to be merged configurable in SegmentDownloader and subclasses ( #248 ).
  • অডিও:
    • Fix broken gapless MP3 playback on Samsung devices ( #8594 ).
    • Fix bug where playback speeds set immediately after disabling audio may be overridden by a previous speed change ( #10882 ).
  • ভিডিও:
    • Map HEVC HDR10 format to HEVCProfileMain10HDR10 instead of HEVCProfileMain10 .
    • Add workaround for a device issue on Chromecast with Google TV and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #10898 ).
    • Fix frame release performance issues when playing media with a frame rate far higher than the screen refresh rate.
  • কাস্ট:
    • Fix transient STATE_IDLE when transitioning between media items ( #245 ).
  • RTSP:
    • Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ( #10971 ).
  • অধিবেশন:
    • Fix a bug where notification play/pause button doesn't update with player state ( #192 ).
  • IMA extension:
    • Fix a bug which prevented DAI streams without any ads from starting because the first (and in the case without ads the only) LOADED event wasn't received.

Version 1.0.0-rc01

ফেব্রুয়ারী 16, 2023

androidx.media3:media3-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

This release corresponds to the ExoPlayer 2.18.3 release .

  • Core library:
    • Tweak the renderer's decoder ordering logic to uphold the MediaCodecSelector 's preferences, even if a decoder reports it may not be able to play the media performantly. For example with default selector, hardware decoder with only functional support will be preferred over software decoder that fully supports the format ( #10604 ).
    • Add ExoPlayer.Builder.setPlaybackLooper that sets a pre-existing playback thread for a new ExoPlayer instance.
    • Allow download manager helpers to be cleared ( #10776 ).
    • Add parameter to BasePlayer.seekTo to also indicate the command used for seeking.
    • Use theme when loading drawables on API 21+ ( #220 ).
    • Add ConcatenatingMediaSource2 that allows combining multiple media items into a single window ( #247 ).
  • Extractors:
    • Throw a ParserException instead of a NullPointerException if the sample table (stbl) is missing a required sample description (stsd) when parsing trak atoms.
    • Correctly skip samples when seeking directly to a sync frame in fMP4 ( #10941 ).
  • অডিও:
    • Use the compressed audio format bitrate to calculate the min buffer size for AudioTrack in direct playbacks (passthrough).
  • পাঠ্য:
    • Fix TextRenderer passing an invalid (negative) index to Subtitle.getEventTime if a subtitle file contains no cues.
    • SubRip: Add support for UTF-16 files if they start with a byte order mark.
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • ড্যাশ:
    • Add full parsing for image adaptation sets, including tile counts ( #3752 ).
  • UI:
    • Fix the deprecated PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) to ensure visibility changes are passed to the registered listener ( #229 ).
    • Fix the ordering of the center player controls in PlayerView when using a right-to-left (RTL) layout ( #227 ).
  • অধিবেশন:
    • Add abstract SimpleBasePlayer to help implement the Player interface for custom players.
    • Add helper method to convert platform session token to Media3 SessionToken ( #171 ).
    • Use onMediaMetadataChanged to trigger updates of the platform media session ( #219 ).
    • Add the media session as an argument of getMediaButtons() of the DefaultMediaNotificationProvider and use immutable lists for clarity ( #216 ).
    • Add onSetMediaItems callback listener to provide means to modify/set MediaItem list, starting index and position by session before setting onto Player ( #156 ).
    • Avoid double tap detection for non-Bluetooth media button events ( #233 ).
    • Make QueueTimeline more robust in case of a shady legacy session state ( #241 ).
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • Cast extension:
    • Bump Cast SDK version to 21.2.0.
  • IMA extension:
    • Remove player listener of the ImaServerSideAdInsertionMediaSource on the application thread to avoid threading issues.
    • Add a property focusSkipButtonWhenAvailable to the ImaServerSideAdInsertionMediaSource.AdsLoader.Builder to request focusing the skip button on TV devices and set it to true by default.
    • Add a method focusSkipButton() to the ImaServerSideAdInsertionMediaSource.AdsLoader to programmatically request to focus the skip button.
    • Bump IMA SDK version to 3.29.0.
  • Demo app:
    • Request notification permission for download notifications at runtime ( #10884 ).

Version 1.0.0-beta03

নভেম্বর 22, 2022

androidx.media3:media3-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

This release corresponds to the ExoPlayer 2.18.2 release .

  • Core library:
    • Add ExoPlayer.isTunnelingEnabled to check if tunneling is enabled for the currently selected tracks ( #2518 ).
    • Add WrappingMediaSource to simplify wrapping a single MediaSource ( #7279 ).
    • Discard back buffer before playback gets stuck due to insufficient available memory.
    • Close the Tracing "doSomeWork" block when offload is enabled.
    • Fix session tracking problem with fast seeks in PlaybackStatsListener ( #180 ).
    • Send missing onMediaItemTransition callback when calling seekToNext or seekToPrevious in a single-item playlist ( #10667 ).
    • Add Player.getSurfaceSize that returns the size of the surface on which the video is rendered.
    • Fix bug where removing listeners during the player release can cause an IllegalStateException ( #10758 ).
  • নির্মাণ:
    • Enforce minimum compileSdkVersion to avoid compilation errors ( #10684 ).
    • Avoid publishing block when included in another gradle build.
  • Track selection:
    • Prefer other tracks to Dolby Vision if display does not support it. ( #8944 ).
  • ডাউনলোড:
    • Fix potential infinite loop in ProgressiveDownloader caused by simultaneous download and playback with the same PriorityTaskManager ( #10570 ).
    • Make download notification appear immediately ( #183 ).
    • Limit parallel download removals to 1 to avoid excessive thread creation ( #10458 ).
  • ভিডিও:
    • Try alternative decoder for Dolby Vision if display does not support it. ( #9794 ).
  • অডিও:
    • Use SingleThreadExecutor for releasing AudioTrack instances to avoid OutOfMemory errors when releasing multiple players at the same time ( #10057 ).
    • Adds AudioOffloadListener.onExperimentalOffloadedPlayback for the AudioTrack offload state. ( #134 ).
    • Make AudioTrackBufferSizeProvider a public interface.
    • Add ExoPlayer.setPreferredAudioDevice to set the preferred audio output device ( #135 ).
    • Rename androidx.media3.exoplayer.audio.AudioProcessor to androidx.media3.common.audio.AudioProcessor .
    • Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions ( #10701 ).
  • মেটাডেটা:
    • MetadataRenderer can now be configured to render metadata as soon as they are available. Create an instance with MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) to specify whether the renderer will output metadata early or in sync with the player position.
  • DRM:
    • Work around a bug in the Android 13 ClearKey implementation that returns a non-empty but invalid license URL.
    • Fix setMediaDrmSession failed: session not opened error when switching between DRM schemes in a playlist (eg Widevine to ClearKey).
  • পাঠ্য:
    • CEA-608: Ensure service switch commands on field 2 are handled correctly ( #10666 ).
  • ড্যাশ:
    • Parse EventStream.presentationTimeOffset from manifests ( #10460 ).
  • UI:
    • Use current overrides of the player as preset in TrackSelectionDialogBuilder ( #10429 ).
  • অধিবেশন:
    • Ensure commands are always executed in the correct order even if some require asynchronous resolution ( #85 ).
    • Add DefaultMediaNotificationProvider.Builder to build DefaultMediaNotificationProvider instances. The builder can configure the notification ID, the notification channel ID and the notification channel name used by the provider. Also, add method DefaultMediaNotificationProvider.setSmallIcon(int) to set the notifications small icon. ( #104 ).
    • Ensure commands sent before MediaController.release() are not dropped ( #99 ).
    • SimpleBitmapLoader can load bitmap from file:// URIs ( #108 ).
    • Fix assertion that prevents MediaController to seek over an ad in a period ( #122 ).
    • When playback ends, the MediaSessionService is stopped from the foreground and a notification is shown to restart playback of the last played media item ( #112 ).
    • Don't start a foreground service with a pending intent for pause ( #167 ).
    • Manually hide the 'badge' associated with the notification created by DefaultNotificationProvider on API 26 and API 27 (the badge is automatically hidden on API 28+) ( #131 ).
    • Fix bug where a second binder connection from a legacy MediaSession to a Media3 MediaController causes IllegalStateExceptions ( #49 ).
  • RTSP:
    • Add H263 fragmented packet handling ( #119 ).
    • Add support for MP4A-LATM ( #162 ).
  • আইএমএ:
    • Add timeout for loading ad information to handle cases where the IMA SDK gets stuck loading an ad ( #10510 ).
    • Prevent skipping mid-roll ads when seeking to the end of the content ( #10685 ).
    • Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI ( #10764 ).
  • FFmpeg extension:
    • Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above ( #9933 ).
  • AV1 extension:
    • Update CMake version to avoid incompatibilities with the latest Android Studio releases ( #9933 ).
  • Cast extension:
    • Implement getDeviceInfo() to be able to identify CastPlayer when controlling playback with a MediaController ( #142 ).
  • ট্রান্সফরমার:
    • Add muxer watchdog timer to detect when generating an output sample is too slow.
  • Remove deprecated symbols:
    • Remove Transformer.Builder.setOutputMimeType(String) . This feature has been removed. The MIME type will always be MP4 when the default muxer is used.

Version 1.0.0-beta02

জুলাই 21, 2022

androidx.media3:media3-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

This release corresponds to the ExoPlayer 2.18.1 release .

  • Core library:
    • Ensure that changing the ShuffleOrder with ExoPlayer.setShuffleOrder results in a call to Player.Listener#onTimelineChanged with reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED ( #9889 ).
    • For progressive media, only include selected tracks in buffered position ( #10361 ).
    • Allow custom logger for all ExoPlayer log output ( #9752 ).
    • Fix implementation of setDataSourceFactory in DefaultMediaSourceFactory , which was non-functional in some cases ( #116 ).
  • Extractors:
    • Fix parsing of H265 short term reference picture sets ( #10316 ).
    • Fix parsing of bitrates from esds boxes ( #10381 ).
  • ড্যাশ:
    • Parse ClearKey license URL from manifests ( #10246 ).
  • UI:
    • Ensure TalkBack announces the currently active speed option in the playback controls menu ( #10298 ).
  • RTSP:
    • Add VP8 fragmented packet handling ( #110 ).
  • Leanback extension:
    • Listen to playWhenReady changes in LeanbackAdapter ( 10420 ).
  • কাস্ট:
    • Use the MediaItem that has been passed to the playlist methods as Window.mediaItem in CastTimeline ( #25 , #8212 ).
    • Support Player.getMetadata() and Listener.onMediaMetadataChanged() with CastPlayer ( #25 ).

Version 1.0.0-beta01

16 জুন, 2022

androidx.media3:media3-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

This corresponds to the ExoPlayer 2.18.0 release .

  • Core library:
    • Enable support for Android platform diagnostics via MediaMetricsManager . ExoPlayer will forward playback events and performance data to the platform, which helps to provide system performance and debugging information on the device. This data may also be collected by Google if sharing usage and diagnostics data is enabled by the user of the device. Apps can opt-out of contributing to platform diagnostics for ExoPlayer with ExoPlayer.Builder.setUsePlatformDiagnostics(false) .
    • Fix bug that tracks are reset too often when using MergingMediaSource , for example when side-loading subtitles and changing the selected subtitle mid-playback ( #10248 ).
    • Stop detecting 5G-NSA network type on API 29 and 30. These playbacks will assume a 4G network.
    • Disallow passing null to MediaSource.Factory.setDrmSessionManagerProvider and MediaSource.Factory.setLoadErrorHandlingPolicy . Instances of DefaultDrmSessionManagerProvider and DefaultLoadErrorHandlingPolicy can be passed explicitly if required.
    • Add MediaItem.RequestMetadata to represent metadata needed to play media when the exact LocalConfiguration is not known. Also remove MediaMetadata.mediaUrl as this is now included in RequestMetadata .
    • Add Player.Command.COMMAND_SET_MEDIA_ITEM to enable players to allow setting a single item.
  • Track selection:
    • Flatten TrackSelectionOverrides class into TrackSelectionParameters , and promote TrackSelectionOverride to a top level class.
    • Rename TracksInfo to Tracks and TracksInfo.TrackGroupInfo to Tracks.Group . Player.getCurrentTracksInfo and Player.Listener.onTracksInfoChanged have also been renamed to Player.getCurrentTracks and Player.Listener.onTracksChanged . This includes 'un-deprecating' the Player.Listener.onTracksChanged method name, but with different parameter types.
    • Change DefaultTrackSelector.buildUponParameters and DefaultTrackSelector.Parameters.buildUpon to return DefaultTrackSelector.Parameters.Builder instead of the deprecated DefaultTrackSelector.ParametersBuilder .
    • Add DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities which is enabled by default. When enabled, the DefaultTrackSelector will prefer audio tracks whose channel count does not exceed the device output capabilities. On handheld devices, the DefaultTrackSelector will prefer stereo/mono over multichannel audio formats, unless the multichannel format can be Spatialized (Android 12L+) or is a Dolby surround sound format. In addition, on devices that support audio spatialization, the DefaultTrackSelector will monitor for changes in the Spatializer properties and trigger a new track selection upon these. Devices with a television UI mode are excluded from these constraints and the format with the highest channel count will be preferred. To enable this feature, the DefaultTrackSelector instance must be constructed with a Context .
  • ভিডিও:
    • Rename DummySurface to PlaceholderSurface .
    • Add AV1 support to the MediaCodecVideoRenderer.getCodecMaxInputSize .
  • অডিও:
    • Use LG AC3 audio decoder advertising non-standard MIME type.
    • Change the return type of AudioAttributes.getAudioAttributesV21() from android.media.AudioAttributes to a new AudioAttributesV21 wrapper class, to prevent slow ART verification on API < 21.
    • Query the platform (API 29+) or assume the audio encoding channel count for audio passthrough when the format audio channel count is unset, which occurs with HLS chunkless preparation ( 10204 ).
    • Configure AudioTrack with channel mask AudioFormat.CHANNEL_OUT_7POINT1POINT4 if the decoder outputs 12 channel PCM audio ( #10322 .
  • ডিআরএম
    • Ensure the DRM session is always correctly updated when seeking immediately after a format change ( 10274 ).
  • পাঠ্য:
    • Change Player.getCurrentCues() to return CueGroup instead of List<Cue> .
    • SSA: Support OutlineColour style setting when BorderStyle == 3 (ie OutlineColour sets the background of the cue) ( #8435 ).
    • CEA-708: Parse data into multiple service blocks and ignore blocks not associated with the currently selected service number.
    • Remove RawCcExtractor , which was only used to handle a Google-internal subtitle format.
  • Extractors:
    • Add support for AVI ( #2092 ).
    • Matroska: Parse DiscardPadding for Opus tracks.
    • MP4: Parse bitrates from esds boxes.
    • Ogg: Allow duplicate Opus ID and comment headers ( #10038 ).
  • UI:
    • Fix delivery of events to OnClickListener s set on PlayerView in the case that useController=false ( #9605 ). Also fix delivery of events to OnLongClickListener for all view configurations.
    • Fix incorrectly treating a sequence of touch events that exit the bounds of PlayerView before ACTION_UP as a click ( #9861 ).
    • Fix PlayerView accessibility issue where tapping might toggle playback rather than hiding the controls ( #8627 ).
    • Rewrite TrackSelectionView and TrackSelectionDialogBuilder to work with the Player interface rather than ExoPlayer . This allows the views to be used with other Player implementations, and removes the dependency from the UI module to the ExoPlayer module. This is a breaking change.
    • Don't show forced text tracks in the PlayerView track selector, and keep a suitable forced text track selected if "None" is selected ( #9432 ).
  • ড্যাশ:
    • Parse channel count from DTS AudioChannelConfiguration elements. This re-enables audio passthrough for DTS streams ( #10159 ).
    • Disallow passing null to DashMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • HLS:
    • Fallback to chunkful preparation if the playlist CODECS attribute does not contain the audio codec ( #10065 ).
    • Disallow passing null to HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory , HlsMediaSource.Factory.setPlaylistParserFactory , and HlsMediaSource.Factory.setPlaylistTrackerFactory . Instances of DefaultCompositeSequenceableLoaderFactory , DefaultHlsPlaylistParserFactory , or a reference to DefaultHlsPlaylistTracker.FACTORY can be passed explicitly if required.
  • Smooth Streaming:
    • Disallow passing null to SsMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • RTSP:
    • Add RTP reader for H263 ( #63 ).
    • Add RTP reader for MPEG4 ( #35 ).
    • Add RTP reader for HEVC ( #36 ).
    • Add RTP reader for AMR. Currently only mono-channel, non-interleaved AMR streams are supported. Compound AMR RTP payload is not supported. ( #46 )
    • Add RTP reader for VP8 ( #47 ).
    • Add RTP reader for WAV ( #56 ).
    • Fix RTSP basic authorization header. ( #9544 ).
    • Stop checking mandatory SDP fields as ExoPlayer doesn't need them ( #10049 ).
    • Throw checked exception when parsing RTSP timing ( #10165 ).
    • Add RTP reader for VP9 ( #47 ).
    • Add RTP reader for OPUS ( #53 ).
  • তথ্য সূত্র:
    • Rename DummyDataSource to PlaceholderDataSource .
    • Workaround OkHttp interrupt handling.
  • অধিবেশন:
    • Replace MediaSession.MediaItemFiller with MediaSession.Callback.onAddMediaItems to allow asynchronous resolution of requests.
    • Support setMediaItems(s) methods when MediaController connects to a legacy media session.
    • Remove MediaController.setMediaUri and MediaSession.Callback.onSetMediaUri . The same functionality can be achieved by using MediaController.setMediaItem and MediaSession.Callback.onAddMediaItems .
    • Forward legacy MediaController calls to play media to MediaSession.Callback.onAddMediaItems instead of onSetMediaUri .
    • Add MediaNotification.Provider and DefaultMediaNotificationProvider to provide customization of the notification.
    • Add BitmapLoader and SimpleBitmapLoader for downloading artwork images.
    • Add MediaSession.setCustomLayout() to provide backwards compatibility with the legacy session.
    • Add MediaSession.setSessionExtras() to provide feature parity with legacy session.
    • Rename MediaSession.MediaSessionCallback to MediaSession.Callback , MediaLibrarySession.MediaLibrarySessionCallback to MediaLibrarySession.Callback and MediaSession.Builder.setSessionCallback to setCallback .
    • Fix NPE in MediaControllerImplLegacy ( #59 ).
    • Update session position info on timeline change( #51 ).
    • Fix NPE in MediaControllerImplBase after releasing controller ( #74 ).
  • Ad playback / IMA:
    • Decrease ad polling rate from every 100ms to every 200ms, to line up with Media Rating Council (MRC) recommendations.
  • FFmpeg extension:
    • Update CMake version to 3.21.0+ to avoid a CMake bug causing AndroidStudio's gradle sync to fail ( #9933 ).
  • Remove deprecated symbols:
    • Remove Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) . Use Player.Listener.onTracksChanged(Tracks) instead.
    • Remove Player.getCurrentTrackGroups and Player.getCurrentTrackSelections . Use Player.getCurrentTracks instead. You can also continue to use ExoPlayer.getCurrentTrackGroups and ExoPlayer.getCurrentTrackSelections , although these methods remain deprecated.
    • Remove DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT and DEFAULT_TRACK_SELECTOR_PARAMETERS constants. Use getDefaultTrackSelectorParameters(Context) instead when possible, and DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT otherwise.
    • Remove constructor DefaultTrackSelector(ExoTrackSelection.Factory) . Use DefaultTrackSelector(Context, ExoTrackSelection.Factory) instead.
    • Remove Transformer.Builder.setContext . The Context should be passed to the Transformer.Builder constructor instead.

Version 1.0.0-alpha03

14 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

This corresponds to the ExoPlayer 2.17.1 release .

  • অডিও:
    • Fix error checking audio capabilities for Dolby Atmos (E-AC3-JOC) in HLS.
  • Extractors:
    • FMP4: Fix issue where emsg sample metadata could be output in the wrong order for streams containing both v0 and v1 emsg atoms ( #9996 ).
  • পাঠ্য:
    • Fix the interaction of SingleSampleMediaSource.Factory.setTrackId and MediaItem.SubtitleConfiguration.Builder.setId to prioritise the SubtitleConfiguration field and fall back to the Factory value if it's not set ( #10016 ).
  • Ad playback:
    • Fix audio underruns between ad periods in live HLS SSAI streams.

Version 1.0.0-alpha02

2 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

This corresponds to the ExoPlayer 2.17.0 release .

  • Core Library:
    • Add protected method DefaultRenderersFactory.getCodecAdapterFactory() so that subclasses of DefaultRenderersFactory that override buildVideoRenderers() or buildAudioRenderers() can access the codec adapter factory and pass it to MediaCodecRenderer instances they create.
    • Propagate ICY header fields name and genre to MediaMetadata.station and MediaMetadata.genre respectively so that they reach the app via Player.Listener.onMediaMetadataChanged() ( #9677 ).
    • Remove null keys from DefaultHttpDataSource#getResponseHeaders .
    • Sleep and retry when creating a MediaCodec instance fails. This works around an issue that occurs on some devices when switching a surface from a secure codec to another codec ( #8696 ).
    • Add MediaCodecAdapter.getMetrics() to allow users obtain metrics data from MediaCodec . ( #9766 ).
    • Fix Maven dependency resolution ( #8353 ).
    • Disable automatic speed adjustment for live streams that neither have low-latency features nor a user request setting the speed ( #9329 ).
    • Rename DecoderCounters#inputBufferCount to queuedInputBufferCount .
    • Make SimpleExoPlayer.renderers private. Renderers can be accessed via ExoPlayer.getRenderer .
    • Updated some AnalyticsListener.EventFlags constant values to match values in Player.EventFlags .
    • Split AnalyticsCollector into an interface and default implementation to allow it to be stripped by R8 if an app doesn't need it.
  • Track selection:
    • Support preferred video role flags in track selection ( #9402 ).
    • Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation ( #9519 ).
    • Update video and audio track selection logic to only choose formats for adaptive selections that have the same level of decoder and hardware support ( #9565 ).
    • Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders ( #4835 ).
    • Prefer audio content preferences (for example, the "default" audio track or a track matching the system locale language) over technical track selection constraints (for example, preferred MIME type, or maximum channel count).
    • Fix track selection issue where overriding one track group did not disable other track groups of the same type ( #9675 ).
    • Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly ( #9649 ).
    • Prohibit duplicate TrackGroup s in a TrackGroupArray . TrackGroup s can always be made distinguishable by setting an id in the TrackGroup constructor. This fixes a crash when resuming playback after backgrounding the app with an active track override ( #9718 ).
    • Amend logic in AdaptiveTrackSelection to allow a quality increase under sufficient network bandwidth even if playback is very close to the live edge ( #9784 ).
  • ভিডিও:
    • Fix decoder fallback logic for Dolby Vision to use a compatible H264/H265 decoder if needed.
  • অডিও:
    • Fix decoder fallback logic for Dolby Atmos (E-AC3-JOC) to use a compatible E-AC3 decoder if needed.
    • Change AudioCapabilities APIs to require passing explicitly AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES instead of null .
    • Allow customization of the AudioTrack buffer size calculation by injecting an AudioTrackBufferSizeProvider to DefaultAudioSink . ( #8891 ).
    • Retry AudioTrack creation if the requested buffer size was > 1MB. ( #9712 ).
  • Extractors:
    • WAV: Add support for RF64 streams ( #9543 ).
    • Fix incorrect parsing of H.265 SPS NAL units ( #9719 ).
    • Parse Vorbis Comments (including METADATA_BLOCK_PICTURE ) in Ogg Opus and Ogg Vorbis files.
  • পাঠ্য:
    • Add a MediaItem.SubtitleConfiguration.id field which is propagated to the Format.id field of the subtitle track created from the configuration ( #9673 ).
    • Add basic support for WebVTT subtitles in Matroska containers ( #9886 ).
    • Prevent Cea708Decoder from reading more than the declared size of a service block.
  • DRM:
    • Remove playbackLooper from DrmSessionManager.(pre)acquireSession . When a DrmSessionManager is used by an app in a custom MediaSource , the playbackLooper needs to be passed to DrmSessionManager.setPlayer instead.
  • Ad playback / IMA:
    • Add support for IMA Dynamic Ad Insertion (DAI) ( #8213 ).
    • Add a method to AdPlaybackState to allow resetting an ad group so that it can be played again ( #9615 ).
    • Enforce playback speed of 1.0 during ad playback ( #9018 ).
    • Fix issue where an ad group that failed to load caused an immediate playback reset ( #9929 ).
  • UI:
    • Fix the color of the numbers in StyledPlayerView rewind and fastforward buttons when using certain themes ( #9765 ).
    • Correctly translate playback speed strings ( #9811 ).
  • ড্যাশ:
    • Add parsed essential and supplemental properties to the Representation ( #9579 ).
    • Support the forced-subtitle track role ( #9727 ).
    • Stop interpreting the main track role as C.SELECTION_FLAG_DEFAULT .
    • Fix base URL exclusion logic for manifests that do not declare the DVB namespace ( #9856 ).
    • Support relative MPD.Location URLs ( #9939 ).
  • HLS:
    • Correctly populate Format.label for audio only HLS streams ( #9608 ).
    • Use chunkless preparation by default to improve start up time. If your renditions contain muxed closed-caption tracks that are not declared in the master playlist, you should add them to the master playlist to be available for playback, or turn off chunkless preparation with HlsMediaSource.Factory.setAllowChunklessPreparation(false) .
    • Support key-frame accurate seeking in HLS ( #2882 ).
  • RTSP:
    • Provide a client API to override the SocketFactory used for any server connection ( #9606 ).
    • Prefer DIGEST authentication method over BASIC if both are present ( #9800 ).
    • Handle when RTSP track timing is not available ( #9775 ).
    • Ignore invalid RTP-Info header values ( #9619 ).
  • ট্রান্সফরমার:
    • Increase required min API version to 21.
    • TransformationException is now used to describe errors that occur during a transformation.
    • Add TransformationRequest for specifying the transformation options.
    • Allow multiple listeners to be registered.
    • Fix Transformer being stuck when the codec output is partially read.
    • Fix potential NPE in Transformer.getProgress when releasing the muxer throws.
    • Add a demo app for applying transformations.
  • MediaSession extension:
    • By default, MediaSessionConnector now clears the playlist on stop. Apps that want the playlist to be retained can call setClearMediaItemsOnStop(false) on the connector.
  • Cast extension:
    • Fix bug that prevented CastPlayer from calling onIsPlayingChanged correctly ( #9792 ).
    • Support audio metadata including artwork with DefaultMediaItemConverter ( #9663 ).
  • FFmpeg extension:
    • Make build_ffmpeg.sh depend on LLVM's bin utils instead of GNU's ( #9933 ).
  • Android 12 compatibility:
    • Upgrade the Cast extension to depend on com.google.android.gms:play-services-cast-framework:20.1.0 . Earlier versions of play-services-cast-framework are not compatible with apps targeting Android 12, and will crash with an IllegalArgumentException when creating PendingIntent s ( #9528 ).
  • Remove deprecated symbols:
    • Remove Player.EventListener . Use Player.Listener instead.
    • Remove MediaSourceFactory#setDrmSessionManager , MediaSourceFactory#setDrmHttpDataSourceFactory , and MediaSourceFactory#setDrmUserAgent . Use MediaSourceFactory#setDrmSessionManagerProvider instead.
    • Remove MediaSourceFactory#setStreamKeys . Use MediaItem.Builder#setStreamKeys instead.
    • Remove MediaSourceFactory#createMediaSource(Uri) . Use MediaSourceFactory#createMediaSource(MediaItem) instead.
    • Remove setTag from DashMediaSource , HlsMediaSource and SsMediaSource . Use MediaItem.Builder#setTag instead.
    • Remove DashMediaSource#setLivePresentationDelayMs(long, boolean) . Use MediaItem.Builder#setLiveConfiguration and MediaItem.LiveConfiguration.Builder#setTargetOffsetMs to override the manifest, or DashMediaSource#setFallbackTargetLiveOffsetMs to provide a fallback value.
    • Remove (Simple)ExoPlayer.setThrowsWhenUsingWrongThread . Opting out of the thread enforcement is no longer possible.
    • Remove ActionFile and ActionFileUpgradeUtil . Use ExoPlayer 2.16.1 or before to use ActionFileUpgradeUtil to merge legacy action files into DefaultDownloadIndex .
    • Remove ProgressiveMediaSource#setExtractorsFactory . Use ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) constructor instead.
    • Remove ProgressiveMediaSource.Factory#setTag and, and ProgressiveMediaSource.Factory#setCustomCacheKey . Use MediaItem.Builder#setTag and MediaItem.Builder#setCustomCacheKey instead.
    • Remove DefaultRenderersFactory(Context, @ExtensionRendererMode int) and DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) constructors. Use the DefaultRenderersFactory(Context) constructor, DefaultRenderersFactory#setExtensionRendererMode , and DefaultRenderersFactory#setAllowedVideoJoiningTimeMs instead.
    • Remove all public CronetDataSource constructors. Use CronetDataSource.Factory instead.
  • Change the following IntDefs to @Target(TYPE_USE) only. This may break the compilation of usages in Kotlin, which can be fixed by moving the annotation to annotate the type ( 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 (in com.google.android.exoplayer2.ext.flac package)
    • @FlacExtractor.Flags (in com.google.android.exoplayer2.extractor.flac package)
    • @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

Version 1.0.0-alpha01

27 অক্টোবর, 2021

androidx.media3:media3-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

নতুন বৈশিষ্ট্য

Media3 হল ExoPlayer সহ মিডিয়া সাপোর্ট লাইব্রেরির জন্য নতুন হোম। The first alpha contains early, functional implementations of libraries for implementing media use cases, including:

  • ExoPlayer, an application-level media player for Android that is easy to customize and extend.
  • Media session functionality, for exposing and controlling playbacks. This new session module uses the same Player interface as ExoPlayer.
  • UI components for building media playback user interfaces.
  • Modules wrapping functionality in other libraries for use with ExoPlayer, for example, ad insertion via the IMA SDK.

For more information, see the Media3 GitHub project .

ExoPlayer was previously hosted in a separate ExoPlayer GitHub project . In Media3 its package name is androidx.media3.exoplayer . We plan to continue to maintain and release the ExoPlayer GitHub project for a while to give apps time to migrate to Media3. Media3 has replacements for all the ExoPlayer modules, except for the legacy media2 and mediasession extensions, which are replaced by the new media3-session module. This provides direct integration between players and media sessions without needing to use an adapter/connector class.

,

Media3

Support libraries for media use cases.
সর্বশেষ আপডেট স্থিতিশীল রিলিজ প্রার্থী মুক্তি বিটা রিলিজ আলফা রিলিজ
10 সেপ্টেম্বর, 2024 1.4.1 - - 1.5.0-আলফা01

Declaring dependencies

To add a dependency on Media3, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

গ্রোভি 

dependencies {
    def media3_version = "1.4.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
    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 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 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"
}

কোটলিন

dependencies {
    val media3_version = "1.4.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
    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 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 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")
}

For more information about dependencies, see Add Build Dependencies .

প্রতিক্রিয়া

Your feedback helps make Jetpack better. You can use the Media3 issue tracker to find answers to questions, known issues and feature requests, and to file new issues.

সংস্করণ 1.5

Version 1.5.0-alpha01

10 সেপ্টেম্বর, 2024

This release includes the following changes since the 1.4.1 release :

  • Common Library:
    • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling ( #1183 ).
    • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
    • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
    • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
    • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
    • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • ExoPlayer:
    • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
    • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
    • Add BasePreloadManager.Listener to propagate preload events to apps.
    • Allow changing SNTP client timeout and retry alternative addresses on timeout ( #1540 ).
    • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
    • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
    • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled ( #1616 ).
    • Allow playback regardless of buffered duration when loading fails ( #1571 ).
    • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • ট্রান্সফরমার:
    • Add SurfaceAssetLoader , which supports queueing video data to Transformer via a Surface .
    • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException .
  • Extractors:
    • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
    • Add option to enable index-based seeking in AmrExtractor .
    • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} ( #1563 ).
  • DataSource:
    • Update HttpEngineDataSource to allow use starting at version S extension 7 instead of API level 34 ( #1262 ).
  • অডিও:
    • Automatically configure CTA-2075 loudness metadata on the codec if present in the media.
    • Ensure smooth volume ramp down when seeking.
  • ভিডিও:
    • MediaCodecVideoRenderer avoids decoding samples that are neither rendered nor used as reference by other samples.
    • On API 35 and above, MediaCodecAdapter may now receive a null Surface in configure and calls to a new method detachOutputSurface to remove a previously set Surface if the codec supports this ( MediaCodecInfo.detachedSurfaceSupported ).
    • Use MediaCodecAdapter supplied pixel aspect ratio values if provided when processing onOutputFormatChanged ( #1371 ).
  • পাঠ্য:
  • ছবি:
    • Add ExternallyLoadedImageDecoder for simplified integration with external image loading libraries like Glide or Coil.
  • DataSource:
    • Add FileDescriptorDataSource , a new DataSource that can be used to read from a FileDescriptor ( #3757 ).
  • প্রভাব:
    • Add DefaultVideoFrameProcessor workaround for minor SurfaceTexture scaling. SurfaceTexture may include a small scaling that cuts off a 1-texel border around the edge of a cropped buffer. This is now handled such that output is closer to expected.
    • Speed up DefaultVideoFrameProcessor.queueInputBitmap() . As a result, exporting images to videos with Transformer is faster.
  • IMA extension:
    • Fix bug where clearing the playlist may cause an ArrayIndexOutOfBoundsException in ImaServerSideAdInsertionMediaSource .
  • অধিবেশন:
    • Add MediaButtonReceiver.shouldStartForegroundService(Intent) to allow apps to suppress a play command coming in for playback resumption by overriding this method. By default, the service is always started and playback can't be suppressed without the system crashing the service with a ForegroundServiceDidNotStartInTimeException ( #1528 ).
  • DASH Extension:
    • Add support for periods starting in the middle of a segment ( #1440 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, etc.):
    • Add the IAMF decoder module, which provides support for playback of MP4 files containing IAMF tracks using the libiamf native library to synthesize audio.
      • Playback is enabled with a stereo layout as well as 5.1 with spatialization together with optional head tracking enabled, but binaural playback support is currently not available.
  • Cast Extension:
    • Stop clearning the timeline after the CastSession disconnects, which enables the sender app to resume playback locally after a disconnection.
    • Populate CastPlayer's DeviceInfo when a Context is provided. This enables linking the MediaSession to a RoutingSession , which is necessary for integrating Output Switcher ( #1056 ).
  • Test Utilities:
    • DataSourceContractTest now includes tests to verify:
      • Input stream read position is updated.
      • Output buffer offset is applied correctly.
  • Remove deprecated symbols:
    • Remove deprecated Player.hasPrevious , Player.hasPreviousWindow() . Use Player.hasPreviousMediaItem() instead.
    • Remove deprecated Player.previous() method. Use Player.seekToPreviousMediaItem() instead.
    • Remove deprecated DrmSessionEventListener.onDrmSessionAcquired method.

সংস্করণ 1.4.0

সংস্করণ 1.4.1

আগস্ট 27, 2024

androidx.media3:media3-*:1.4.1 is released. Version 1.4.1 contains these commits .

  • ExoPlayer:
    • Handle preload callbacks asynchronously in PreloadMediaSource ( #1568 ).
    • Allow playback regardless of buffered duration when loading fails ( #1571 ).
  • Extractors:
    • MP3: Fix Searched too many bytes error by correctly ignoring trailing non-MP3 data based on the length field in an Info frame ( #1480 ).
  • পাঠ্য:
    • TTML: Fix handling of percentage tts:fontSize values to ensure they are correctly inherited from parent nodes with percentage tts:fontSize values.
    • Fix IndexOutOfBoundsException in LegacySubtitleUtil due to incorrectly handling the case of the requested output start time being greater than or equal to the final event time in the Subtitle ( #1516 ).
  • DRM:
    • Fix android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE error on API 31+ devices playing L1 Widevine content. This error is caused by an incomplete implementation of the framework MediaDrm.requiresSecureDecoder method ( #1603 ).
  • প্রভাব:
    • Add a release() method to GlObjectsProvider .
  • অধিবেশন:
    • Transform a double-tap of KEYCODE_HEADSETHOOK into a 'seek to next' action, as documented ( #1493 ).
    • Handle KEYCODE_HEADSETHOOK as a 'play' command in MediaButtonReceiver when deciding whether to ignore it to avoid a ForegroundServiceDidNotStartInTimeException ( #1581 ).
  • RTSP Extension:
    • Skip invalid Media Descriptions in SDP parsing ( #1087 ).

সংস্করণ 1.4.0

25 জুলাই, 2024

androidx.media3:media3-*:1.4.0 is released. Version 1.4.0 contains these commits .

  • Common Library:
    • Forward presumed no-op seek calls to the protected BasePlayer.seekTo() and SimpleBasePlayer.handleSeek() methods instead of ignoring them. If you are implementing these methods in a custom player, you may need to handle these additional calls with mediaItemIndex == C.INDEX_UNSET .
    • Remove compile dependency on enhanced Java 8 desugaring ( #1312 ).
    • Ensure the duration passed to MediaItem.Builder.setImageDurationMs() is ignored for a non-image MediaItem (as documented).
    • Add Format.customData to store app-provided custom information about Format instances.
  • ExoPlayer:
    • Add BasePreloadManager which coordinates the preloading for multiple sources based on the priorities defined by their rankingData . Customization is possible by extending this class. Add DefaultPreloadManager which uses PreloadMediaSource to preload media samples of the sources into memory, and uses an integer rankingData that indicates the index of an item on the UI.
    • Add PlayerId to most methods of LoadControl to enable LoadControl implementations to support multiple players.
    • Remove Buffer.isDecodeOnly() and C.BUFFER_FLAG_DECODE_ONLY . There is no need to set this flag as renderers and decoders will decide to skip buffers based on timestamp. Custom Renderer implementations should check if the buffer time is at least BaseRenderer.getLastResetPositionUs() to decide whether a sample should be shown. Custom SimpleDecoder implementations can check isAtLeastOutputStartTimeUs() if needed or mark other buffers with DecoderOutputBuffer.shouldBeSkipped to skip them.
    • Allow a null value to be returned by TargetPreloadStatusControl.getTargetPreloadStatus(T) to indicate not to preload a MediaSource with the given rankingData .
    • Add remove(MediaSource) to BasePreloadManager .
    • Add reset() to BasePreloadManager to release all the holding sources while keep the preload manager instance.
    • Add ExoPlayer.setPriority() (and Builder.setPriority() ) to define the priority value used in PriorityTaskManager and for MediaCodec importance from API 35.
    • Fix issue with updating the last rebuffer time which resulted in incorrect bs (buffer starvation) key in CMCD ( #1124 ).
    • Add PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) to indicate that the source has loaded to the end. This allows the DefaultPreloadManager and the custom PreloadMediaSource.PreloadControl implementations to preload the next source or take other actions.
    • Fix bug where silence skipping at the end of items can trigger a playback exception.
    • Add clear to PreloadMediaSource to discard the preloading period.
    • Add new error code PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED that is used when codec resources are reclaimed for higher priority tasks.
    • Let AdsMediaSource load preroll ads before initial content media preparation completes ( #1358 ).
    • Fix bug where playback moved to STATE_ENDED when re-preparing a multi-period DASH live stream after the original period was already removed from the manifest.
    • Rename onTimelineRefreshed() to onSourcePrepared() and onPrepared() to onTracksSelected() in PreloadMediaSource.PreloadControl . Also rename the IntDefs in DefaultPreloadManager.Stage accordingly.
    • Add experimental support for dynamic scheduling to better align work with CPU wake-cycles and delay waking up to when renderers can progress. You can enable this using experimentalSetDynamicSchedulingEnabled() when setting up your ExoPlayer instance.
    • Add Renderer.getDurationToProgressUs() . A Renderer can implement this method to return to ExoPlayer the duration that playback must advance for the renderer to progress. If ExoPlayer is set with experimentalSetDynamicSchedulingEnabled() then ExoPlayer will call this method when calculating the time to schedule its work task.
    • Add MediaCodecAdapter#OnBufferAvailableListener to alert when input and output buffers are available for use by MediaCodecRenderer . MediaCodecRenderer will signal ExoPlayer when receiving these callbacks and if ExoPlayer is set with experimentalSetDynamicSchedulingEnabled() , then ExoPlayer will schedule its work loop as renderers can make progress.
    • Use data class for LoadControl methods instead of individual parameters.
    • Add ExoPlayer.isReleased() to check whether Exoplayer.release() has been called.
    • Add ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() to configure the maximum position for which seekToPrevious() seeks to the previous item ( #1425 ).
    • Fix some audio focus inconsistencies, eg not reporting full or transient focus loss while the player is paused ( #1436 ).
    • Fix potential IndexOutOfBoundsException caused by extractors reporting additional tracks after the initial preparation step ( #1476 ).
    • Effects in ExoPlayer.setVideoEffect() will receive the timestamps with the renderer offset removed ( #1098 ).
    • Fix potential IllegalArgumentException when handling player error that happened while reading ahead into another playlist item ( #1483 ).
  • ট্রান্সফরমার:
    • Add audioConversionProcess and videoConversionProcess to ExportResult indicating how the respective track in the output file was made.
    • Relax trim optimization H.264 level checks.
    • Add support for changing between SDR and HDR input media in a sequence.
    • Add support for composition-level audio effects.
    • Add support for transcoding Ultra HDR images into HDR videos.
    • Fix issue where the DefaultAudioMixer does not output the correct amount of bytes after being reset and reused.
    • Work around a decoder bug where the number of audio channels was capped at stereo when handling PCM input.
    • When selecting tracks in ExoPlayerAssetLoader , ignore audio channel count constraints as they only apply for playback.
    • Replace androidx.media3.transformer.Muxer interface with androidx.media3.muxer.Muxer and remove androidx.media3.transformer.Muxer .
    • Fix HEIC image loading from content URI schemes. ( #1373 ).
    • Adjust audio track duration in AudioGraphInput to improve AV sync.
    • Remove ExportResult.processedInputs field. If you use this field for codec details, then use DefaultDecoderFactory.listener instead. In case of a codec exception, codec details will be available in the ExportException.codecInfo .
  • Extractors:
    • MPEG-TS: Roll forward the change ensuring the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ). Incorporating fixes to resolve the issues that emerged in I-frame only HLS streams( #1150 ) and H.262 HLS streams ( #1126 ).
    • MP3: Prefer the data size from an Info frame over the size reported by the underlying stream (eg file size, or HTTP Content-Length header). This helps to exclude non-playable trailer data (eg album artwork) from constant bitrate seeking calculations, making seeks more accurate ( #1376 ).
    • MP3: Use the frame count and other data in an Info frame (if present) to compute an average bitrate for constant bitrate seeking, rather than extrapolating from the bitrate of the frame after the Info frame, which may be artificially small, eg PCUT frame ( #1376 ).
    • Fix PCM audio format extraction in AVI containers.
  • অডিও:
    • Fix DTS:X Profile 2 encoding attributes for passthrough playback ( #1299 ).
    • For offloaded playback, reset the tracking field for stream completion in DefaultAudioSink prior to calling AudioTrack.stop() so that AudioTrack.StreamEventCallback#onPresentationEnded correctly identifies when all pending data has been played.
    • Fix bug in SilenceSkippingAudioProcessor where transitions between different audio formats (for example stereo to mono) can cause the processor to throw an exception ( #1352 ).
    • Implement MediaCodecAudioRenderer.getDurationToProgressUs() so that ExoPlayer will dynamically schedule its main work loop to when the MediaCodecAudioRenderer can make progress.
  • ভিডিও:
    • Fix issue where Listener.onRenderedFirstFrame() arrives too early when switching surfaces mid-playback.
    • Fix decoder fallback logic for Dolby Vision to use a compatible AV1 decoder if needed ( #1389 ).
    • Fix codec exception that may be caused by enabling a video renderer mid-playback.
  • পাঠ্য:
    • Fix issue where subtitles starting before a seek position are skipped. This issue was only introduced in Media3 1.4.0-alpha01.
    • Change default subtitle parsing behavior so it happens during extraction instead of during rendering (see ExoPlayer's architecture diagram for the difference between extraction and rendering).
      • This change can be overridden by calling both MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) and TextRenderer.experimentalSetLegacyDecodingEnabled(true) . See the docs on customization for how to plumb these components into an ExoPlayer instance. These methods (and all support for legacy subtitle decoding) will be removed in a future release.
      • Apps with custom SubtitleDecoder implementations need to update them to implement SubtitleParser instead (and SubtitleParser.Factory instead of SubtitleDecoderFactory ).
    • PGS: Fix run-length decoding to resolve 0 as a color index, instead of a literal color value ( #1367 ).
    • CEA-708: Ignore rowLock value. The CEA-708-E S-2023 spec states that rowLock and columnLock should both be assumed to be true, regardless of the values present in the stream ( columnLock support is not implemented, so it's effectively assumed to always be false).
      • This was originally included in the 1.3.0-alpha01 release notes, but the change was accidentally reverted before the 1.3.0-rc01 release. This is now fixed, so the change is present again.
    • CEA-708: Avoid duplicate newlines being added by ExoPlayer's naive handling of the 'set pen location' command ( #1315 ).
    • Fix an IllegalArgumentException from LegacySubtitleUtil when a WebVTT subtitle sample contains no cues, eg as part of a DASH stream ( #1516 ).
  • মেটাডেটা:
    • Fix mapping of MP4 to ID3 sort tags. Previously the 'album sort' ( soal ), 'artist sort' ( soar ) and 'album artist sort' ( soaa ) MP4 tags were wrongly mapped to the TSO2 , TSOA and TSOP ID3 tags ( #1302 ).
    • Fix reading of MP4 (/iTunes) numeric gnre (genre) and tmpo (tempo) tags when the value is more than one byte long.
    • Propagate ID3 TCON frame to MediaMetadata.genre ( #1305 ).
  • ছবি:
    • Add support for non-square DASH thumbnail grids ( #1300 ).
    • Add support for AVIF for API 34+.
    • Allow null as parameter for ExoPlayer.setImageOutput() to clear a previously set ImageOutput .
  • DataSource:
    • Implement support for android.resource://package/id raw resource URIs where package is different to the package of the current application. This wasn't previously documented to work, but is a more efficient way of accessing resources in another package than by name.
    • Eagerly check url is non-null in the DataSpec constructors. This parameter was already annotated to be non-null.
    • Allow ByteArrayDataSource to resolve a URI to a byte array during open() , instead of being hard-coded at construction ( #1405 ).
  • DRM:
    • Allow setting a LoadErrorHandlingPolicy on DefaultDrmSessionManagerProvider ( #1271 ).
  • প্রভাব:
    • Support multiple speed changes within the same EditedMediaItem or Composition in SpeedChangeEffect .
    • Support for HLG and PQ output from ultra HDR bitmap input.
    • Add support for EGL_GL_COLORSPACE_BT2020_HLG_EXT, which improves HLG surface output in ExoPlayer.setVideoEffect and Transformer's Debug SurfaceView.
    • Update Overlay matrix implementation to make it consistent with the documentation by flipping the x and y values applied in setOverlayFrameAnchor() . If using OverlaySettings.Builder.setOverlayFrameAnchor() , flip their x and y values by multiplying them by -1 .
    • Fix bug where TimestampWrapper crashes when used with ExoPlayer#setVideoEffects ( #821 ).
    • Change default SDR color working space from linear colors to electrical BT 709 SDR video. Also provide third option to retain the original colorspace.
    • Allow defining indeterminate z-order of EditedMediaItemSequences ( #1055 ).
    • Maintain a consistent luminance range across different pieces of HDR content (uses the HLG range).
    • Add support for Ultra HDR (bitmap) overlays on HDR content.
    • Allow SeparableConvolution effects to be used before API 26.
    • Remove unused OverlaySettings.useHdr since dynamic range of overlay and frame must match.
    • Add HDR support for TextOverlay . Luminance of the text overlay can be adjusted with OverlaySettings.Builder.setHdrLuminanceMultiplier() .
  • IMA extension:
    • Promote API that is required for apps to play DAI ad streams to stable.
    • Add replaceAdTagParameters(Map <String, String>) to ImaServerSideAdInsertionMediaSource.AdLoader that allows replacing ad tag parameters at runtime.
    • Fix bug where VideoAdPlayer.VideoAdPlayerCallback.onError() was not called when a player error happened during ad playback ( #1334 ).
    • Bump IMA SDK version to 3.33.0 to fix a NullPointerException when using data:// ad tag URIs ( #700 ).
  • অধিবেশন:
    • Change default of CommandButton.enabled to true and ensure the value can stay false for controllers even if the associated command is available.
    • Add icon constants for CommandButton that should be used instead of custom icon resources.
    • Add MediaSessionService.isPlaybackOngoing() to let apps query whether the service needs to be stopped in onTaskRemoved() ( #1219 ).
    • Add MediaSessionService.pauseAllPlayersAndStopSelf() that conveniently allows to pause playback of all sessions and call stopSelf() to terminate the lifecycle of the MediaSessionService .
    • Override MediaSessionService.onTaskRemoved(Intent) to provide a safe default implementation that keeps the service running in the foreground if playback is ongoing or stops the service otherwise.
    • Hide seekbar in the media notification for live streams by not setting the duration into the platform session metadata ( #1256 ).
    • Align conversion of MediaMetadata to MediaDescriptionCompat , to use the same preferred order and logic when selecting metadata properties as in media1.
    • Add MediaSession.sendError() that allows sending non-fatal errors to Media3 controller. When using the notification controller (see MediaSession.getMediaNotificationControllerInfo() ), the custom error is used to update the PlaybackState of the platform session to an error state with the given error information ( #543 ).
    • Add MediaSession.Callback.onPlayerInteractionFinished() to inform sessions when a series of player interactions from a specific controller finished.
    • Add SessionError and use it in SessionResult and LibraryResult instead of the error code to provide more information about the error and how to resolve the error if possible.
    • Publish the code for the media3 controller test app that can be used to test interactions with apps publishing a media session.
    • Propagate extras passed to media3's MediaSession[Builder].setSessionExtras() to a media1 controller's PlaybackStateCompat.getExtras() .
    • Map fatal and non-fatal errors to and from the platform session. A PlaybackException is mapped to a fatal error state of the PlaybackStateCompat . A SessionError sent to the media notification controller with MediaSession.sendError(ControllerInfo, SessionError) is mapped to a non-fatal error in PlaybackStateCompat which means that error code and message are set but the state of the platform session remains different to STATE_ERROR .
    • Allow the session activity to be set per controller to override the global session activity. The session activity can be defined for a controller at connection time by creating a ConnectionResult with AcceptedResultBuilder.setSessionActivivty(PendingIntent) . Once connected, the session activity can be updated with MediaSession.setSessionActivity(ControllerInfo, PendingIntent) .
    • Improve error replication of calls to MediaLibrarySession.Callback . Error replication can now be configured by using MediaLibrarySession.Builder.setLibraryErrorReplicationMode() for choosing the error type or opt-ing out of error replication which is on by default.
  • UI:
    • Add image display support to PlayerView when connected to an ExoPlayer ( #1144 ).
    • Add customization of various icons in PlayerControlView through xml attributes to allow different drawables per PlayerView instance, rather than global overrides ( #1200 ).
    • Work around a platform bug causing stretched/cropped video when using SurfaceView inside a Compose AndroidView on API 34 ( #1237 ).
  • ডাউনলোড:
    • Ensure that DownloadHelper does not leak unreleased Renderer instances, which can eventually result in an app crashing with IllegalStateException: Too many receivers, total of 1000, registered for pid ( #1224 ).
  • Cronet Extension:
    • Fix SocketTimeoutException in CronetDataSource . In some versions of Cronet, the request provided by the callback is not always the same. This leads to callback not completing and request timing out (https://issuetracker.google.com/328442628).
  • HLS Extension:
    • Fix bug where pending EMSG samples waiting for a discontinuity were delegated in HlsSampleStreamWrapper with an incorrect offset causing an IndexOutOfBoundsException or an IllegalArgumentException ( #1002 ).
    • Fix bug where non-primary playlists keep reloading for LL-HLS streams ( #1240 ).
    • Fix bug where enabling CMCD for HLS with initialization segments resulted in Source Error and IllegalArgumentException .
    • Fix bug where non-primary playing playlists are not refreshed during live playback ( #1240 ).
    • Fix bug where enabling CMCD for HLS live streams causes ArrayIndexOutOfBoundsException ( #1395 ).
  • DASH Extension:
    • Fix bug where re-preparing a multi-period live stream can throw an IndexOutOfBoundsException ( #1329 ).
    • Add support for dashif:Laurl license urls ( #1345 ).
  • Cast Extension:
    • Fix bug that converted the album title of the MediaQueueItem to the artist in the Media3 media item ( #1255 ).
  • Test Utilities:
    • Implement onInit() and onRelease() in FakeRenderer .
    • Change TestPlayerRunHelper.runUntil()/playUntil() methods to fail on nonfatal errors (eg those reported to AnalyticsListener.onVideoCodecError() ). Use the new TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() method chain to disable this behavior.
  • Demo app:
    • Use DefaultPreloadManager in the short form demo app.
    • Allow setting repeat mode with Intent arguments from command line ( #1266 ).
    • Use HttpEngineDataSource as the HttpDataSource when supported by the device.
  • Remove deprecated symbols:
    • Remove CronetDataSourceFactory . Use CronetDataSource.Factory instead.
    • Remove some DataSpec constructors. Use DataSpec.Builder instead.
    • Remove setContentTypePredicate(Predicate) method from DefaultHttpDataSource , OkHttpDataSource and CronetDataSource . Use the equivalent method on each XXXDataSource.Factory instead.
    • Remove OkHttpDataSource constructors and OkHttpDataSourceFactory . Use OkHttpDataSource.Factory instead.
    • Remove PlayerMessage.setHandler(Handler) . Use setLooper(Looper) instead.
    • Remove Timeline.Window.isLive field. Use the isLive() method instead.
    • Remove DefaultHttpDataSource constructors. Use DefaultHttpDataSource.Factory instead.
    • Remove DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS . Use DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS instead.
    • Remove MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) . Use MediaCodecInfo.canReuseCodec(Format, Format) instead.
    • Remove DrmSessionManager.DUMMY and getDummyDrmSessionManager() method. Use DrmSessionManager.DRM_UNSUPPORTED instead.
    • Remove AnalyticsListener.onAudioInputFormatChanged(EventTime, Format) , AnalyticsListener.onVideoInputFormatChanged(EventTime, Format) , AudioRendererEventListener.onAudioInputFormatChanged(Format) , VideoRendererEventListener.onVideoInputFormatChanged(Format) . Use the overloads that take a DecoderReuseEvaluation instead.
    • Remove RendererSupport.FormatSupport IntDef and FORMAT_HANDLED , FORMAT_EXCEEDS_CAPABILITIES , FORMAT_UNSUPPORTED_DRM , FORMAT_UNSUPPORTED_SUBTYPE , FORMAT_UNSUPPORTED_TYPE constants. Use the equivalent IntDef and constants in androidx.media3.common.C instead (eg C.FORMAT_HANDLED ).
    • Remove Bundleable interface. This includes removing all Bundleable.Creator<Foo> CREATOR constant fields. Callers should use the Bundle toBundle() and static Foo fromBundle(Bundle) methods on each type instead.

Version 1.4.0-rc01

10 জুলাই, 2024

Use the 1.4.0 stable version .

Version 1.4.0-beta01

জুন 26, 2024

Use the 1.4.0 stable version .

Version 1.4.0-alpha02

জুন 07, 2024

Use the 1.4.0 stable version .

Version 1.4.0-alpha01

এপ্রিল 17, 2024

Use the 1.4.0 stable version .

সংস্করণ 1.3.0

সংস্করণ 1.3.1

11 এপ্রিল, 2024

androidx.media3:media3-*:1.3.1 is released. Version 1.3.1 contains these commits .

  • Common Library:
    • Add Format.labels to allow localized or other alternative labels.
  • ExoPlayer:
    • Fix issue where PreloadMediaPeriod cannot retain the streams when it is preloaded again.
    • Apply the correct corresponding TrackSelectionResult to the playing period in track reselection.
    • Start early-enabled renderers only after advancing the playing period when transitioning between media items ( #1017 ).
    • Add missing return type to proguard -keepclasseswithmembers rule for DefaultVideoFrameProcessor.Factory.Builder.build() ( #1187 ).
  • ট্রান্সফরমার:
    • Add workaround for exception thrown due to MediaMuxer not supporting negative presentation timestamps before API 30.
  • Track Selection:
    • DefaultTrackSelector : Prefer video tracks with a 'reasonable' frame rate (>=10fps) over those with a lower or unset frame rate. This ensures the player selects the 'real' video track in MP4s extracted from motion photos that can contain two HEVC tracks where one has a higher resolution but a very small number of frames ( #1051 ).
  • Extractors:
    • Fix issue where padding was not skipped when reading odd-sized chunks from WAV files ( #1117 ).
    • MP3: Populate Format.averageBitrate from metadata frames such as XING and VBRI .
    • MPEG-TS: Revert a change that aimed to ensure the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ). This is due to the change causing new problems with I-frame only HLS streams ( #1150 ) and H.262 HLS streams ( #1126 ).
  • অডিও:
    • Allow renderer recovery by disabling offload if audio track fails to initialize in offload mode.
  • ভিডিও:
    • Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with Google TV, and Lenovo M10 FHD Plus that causes 60fps H265 streams to be marked as unsupported
    • Add workaround that ensures the first frame is always rendered while tunneling even if the device does not do this automatically as required by the API ( #1169 ). ( #966 ).
    • Fix issue where HDR color info handling causes codec misbehavior and prevents adaptive format switches for SDR video tracks ( #1158 ).
  • পাঠ্য:
    • WebVTT: Prevent directly consecutive cues from creating spurious additional CuesWithTiming instances from WebvttParser.parse ( #1177 ).
  • DRM:
    • Work around a NoSuchMethodError which can be thrown by the MediaDrm framework instead of ResourceBusyException or NotProvisionedException on some Android 14 devices ( #1145 ).
  • প্রভাব:
    • Improved PQ to SDR tone-mapping by converting color spaces.
  • অধিবেশন:
    • Fix issue where the current position jumps back when the controller replaces the current item ( #951 ).
    • Fix issue where MediaMetadata with just non-null extras is not transmitted between media controllers and sessions ( #1176 ).
  • UI:
    • Fallback to include audio track language name if Locale cannot identify a display name ( #988 ).
  • DASH Extension:
    • Populate all Label elements from the manifest into Format.labels ( #1054 ).
  • RTSP Extension:
    • Skip empty session information values (i-tags) in SDP parsing ( #1087 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • Disable the MIDI extension as a local dependency by default because it requires an additional Maven repository to be configured. Users who need this module from a local dependency can re-enable it .

সংস্করণ 1.3.0

6 মার্চ, 2024

androidx.media3:media3-*:1.3.0 is released. Version 1.3.0 contains these commits .

  • Common Library:
    • Implement support for android.resource://package/[type/]name raw resource URIs where package is different to the package of the current application. This has always been documented to work, but wasn't correctly implemented until now.
    • Normalize MIME types set by app code or read from media to be fully lower-case.
    • Define ads with a full MediaItem instead of a single Uri in AdPlaybackState .
    • Increase minSdk to 19 (Android KitKat). This is aligned with all other AndroidX libraries , and is required for us to upgrade to the latest versions of our AndroidX dependencies.
    • Populate both artworkUri and artworkData in MediaMetadata.Builder.populate(MediaMetadata) when at least one of them is non-null ( #964 ).
  • ExoPlayer:
    • Add PreloadMediaSource and PreloadMediaPeriod that allows apps to preload a content media source at a specific start position before playback. PreloadMediaSource takes care of preparing the content media source to receive the Timeline , preparing and caching the period at the given start position, selecting tracks and loading media data for the period. Apps control the preload progress by implementing PreloadMediaSource.PreloadControl and set the preloaded source to the player for playback.
    • Add ExoPlayer.setImageOutput that allows apps to set ImageRenderer.ImageOutput .
    • DefaultRenderersFactory now provides an ImageRenderer to the player by default with null ImageOutput and ImageDecoder.Factory.DEFAULT .
    • Emit Player.Listener.onPositionDiscontinuity event when silence is skipped ( #765 ).
    • Add experimental support for parsing subtitles during extraction. You can enable this using MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() .
    • Support adaptive media sources with PreloadMediaSource .
    • Implement HttpEngineDataSource , an HttpDataSource using the HttpEngine API.
    • Prevent subclassing CompositeSequenceableLoader . This component was previously made extensible but was never subclassed within the library. Customizations can be done by wrapping an instance using the decorator pattern and implementing a custom CompositeSequenceableLoaderFactory .
    • Fix issue where repeating the same time causes metadata from this item to be cleared ( #1007 ).
    • Rename experimentalSetSubtitleParserFactory methods on BundledChunkExtractor.Factory and DefaultHlsExtractorFactory to setSubtitleParserFactory and disallow passing null . Use the new experimentalParseSubtitlesDuringExtraction(boolean) methods to control parsing behaviour.
    • Add support for customising the SubtitleParser.Factory used during extraction. This can be achieved with MediaSource.Factory.setSubtitleParserFactory() .
    • Add source prefix to all Format.id fields generated from MergingMediaSource . This helps to identify which source produced a Format ( #883 ).
    • Fix the regex used for validating custom Common Media Client Data (CMCD) key names by modifying it to only check for hyphen ( #1028 ).
    • Stop double-encoding CMCD query parameters ( #1075 ).
  • ট্রান্সফরমার:
    • Add support for flattening H.265/HEVC SEF slow motion videos.
    • Increase transmuxing speed, especially for 'remove video' edits.
    • Add API to ensure that the output file starts on a video frame. This can make the output of trimming operations more compatible with player implementations that don't show the first video frame until its presentation timestamp ( #829 ).
    • Add support for optimizing single asset MP4 trim operations.
    • Add support to ensure a video frame has the first timestamp in the output file. Fixes output files beginning with black frame on iOS based players ( #829 ).
  • Track Selection:
    • Add DefaultTrackSelector.selectImageTrack to enable image track selection.
    • Add TrackSelectionParameters.isPrioritizeImageOverVideoEnabled to determine whether to select an image track if both an image track and a video track are available. The default value is false which means selecting a video track is prioritized.
  • Extractors:
    • Add additional AV1C parsing to MP4 extractor to retrieve ColorInfo.colorSpace , ColorInfo.colorTransfer , and ColorInfo.colorRange values ( #692 ).
    • MP3: Use constant bitrate (CBR) seeking for files with an Info header (the CBR equivalent of the Xing header). Previously we used the seek table from the Info header, but this results in less precise seeking than if we ignore it and assume the file is CBR.
    • MPEG2-TS: Add DTS, DTS-LBR and DTS:X Profile2 support ( #275 ).
    • Extract audio types from TS descriptors and map them to role flags, allowing users to make better-informed audio track selections ( #973 ).
  • অডিও:
    • Improve silence skipping algorithm with smooth volume ramp; retained minimal silence and more natural silence durations ( #7423 ).
    • Report the skipped silence more deterministically ( #1035 ).
  • ভিডিও:
    • Change the MediaCodecVideoRenderer constructor that takes a VideoFrameProcessor.Factory argument and replace it with a constructor that takes a VideoSinkProvider argument. Apps that want to inject a custom VideoFrameProcessor.Factory can instantiate a CompositingVideoSinkProvider that uses the custom VideoFrameProcessor.Factory and pass the video sink provider to MediaCodecVideoRenderer .
  • পাঠ্য:
    • Fix serialization of bitmap cues to resolve Tried to marshall a Parcel that contained Binder objects error when using DefaultExtractorsFactory.setTextTrackTranscodingEnabled ( #836 ).
    • CEA-708: Ignore rowLock value. The CEA-708-E S-2023 spec states that rowLock and columnLock should both be assumed to be true, regardless of the values present in the stream ( columnLock support is not implemented, so it's effectively assumed to always be false).
  • ছবি:
    • Add support for DASH thumbnails. Grid images are cropped and individual thumbnails are provided to ImageOutput close to their presentation times.
  • DRM:
  • IMA extension:
    • Fix issue where DASH and HLS ads without the appropriate file extension can't be played.
  • অধিবেশন:
    • Disable double-click detection for TV apps ( #962 ).
    • Fix issue where MediaItem.RequestMetadata with just non-null extras is not transmitted between media controllers and sessions.
    • Add constructor to MediaLibrarySession.Builder that only takes a Context instead of a MediaLibraryService .
  • HLS Extension:
    • Reduce HlsMediaPeriod to package-private visibility. This type shouldn't be directly depended on from outside the HLS package.
    • Resolve seeks to beginning of a segment more efficiently ( #1031 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • MIDI decoder: Ignore SysEx event messages ( #710 ).
  • Test Utilities:
    • Don't pause playback in TestPlayerRunHelper.playUntilPosition . The test keeps the playback in a playing state, but suspends progress until the test is able to add assertions and further actions.
  • Demo app:
    • Add a shortform demo module to demo the usage of PreloadMediaSource with the short-form content use case.

সংস্করণ 1.3.0-rc01

22 ফেব্রুয়ারি, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.3.0-beta01

7 ফেব্রুয়ারি, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.3.0-alpha01

15 জানুয়ারী, 2024

Use the 1.3.0 stable version .

সংস্করণ 1.2.0

সংস্করণ 1.2.1

জানুয়ারী 9, 2024

  • ExoPlayer:
    • Fix issue where manual seeks outside of the LiveConfiguration.min/maxOffset range keep adjusting the offset back to min/maxOffset .
    • Fix issue that OPUS and VORBIS channel layouts are wrong for 3, 5, 6, 7 and 8 channels ( #8396 ).
    • Fix issue where track selections after seek to zero in a live stream incorrectly let the stream start at its default position ( #9347 ).
    • Fix the issue where new instances of CmcdData.Factory were receiving negative values for bufferedDurationUs from chunk sources, resulting in an IllegalArgumentException ( #888 ).
  • ট্রান্সফরমার:
    • Work around an issue where the encoder would throw at configuration time due to setting a high operating rate.
  • Extractors:
    • Mark secondary (unplayable) HEVC tracks in JPEG motion photos as ROLE_FLAG_ALTERNATE to prevent them being automatically selected for playback because of their higher resolution.
    • Fix wrong keyframe detection for TS H264 streams ( #864 ).
    • Fix duration estimation of TS streams that are longer than 47721 seconds ( #855 ).
  • অডিও:
    • Fix handling of EOS for SilenceSkippingAudioProcessor when called multiple times ( #712 ).
  • ভিডিও:
    • Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with Google TV, and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #693 ).
  • মেটাডেটা:
    • Fix bug where MediaMetadata was only populated from Vorbis comments with upper-case keys ( #876 ).
    • Catch OutOfMemoryError when parsing very large ID3 frames, meaning playback can continue without the tag info instead of playback failing completely.
  • DRM:
    • Extend workaround for spurious ClearKey https://default.url license URL to API 33+ (previously the workaround only applied on API 33 exactly) ( #837 ).
    • Fix ERROR_DRM_SESSION_NOT_OPENED when switching from encrypted to clear content without a surface attached to the player. The error was due to incorrectly using a secure decoder to play the clear content.
  • অধিবেশন:
    • Put the custom keys and values in MediaMetadataCompat to MediaMetadata.extras and MediaMetadata.extras to MediaMetadataCompat ( #756 , #802 ).
    • Fix broadcasting notifyChildrenChanged for legacy controllers ( #644 ).
    • Fix a bug where setting a negative time for a disabled setWhen timer of the notification caused a crash on some devices ( #903 ).
    • Fix IllegalStateException when the media notification controller hasn't completed connecting when the first notification update is requested ( #917 ).
  • UI:
    • Fix issue where forward and rewind buttons are not visible when used with Material Design in a BottomSheetDialogFragment ( #511 ).
    • Fix issue where the numbers in the fast forward button of the PlayerControlView were misaligned ( #547 ).
  • DASH Extension:
    • Parse "f800" as channel count of 5 for Dolby in DASH manifest ( #688 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • MIDI: Fix issue where seeking forward skips the Program Change events ( #704 ).
    • Migrate to FFmpeg 6.0 and update supported NDK to r26b ( #707 , #867 ).
  • Cast Extension:
    • Sanitize creation of a Timeline to not crash the app when loading media fails on the cast device ( #708 ).

সংস্করণ 1.2.0

15 নভেম্বর, 2023

  • Common Library:
    • Add a @Nullable Throwable parameter to the methods in the Log.Logger interface. The message parameter to these methods no longer contains any information about the Throwable passed to the Log.{d,i,w,e}() methods, so implementations will need to manually append this information if desired (possibly using Logger.appendThrowableString(String, Throwable) ).
    • Fix Kotlin compatibility issue where nullable generic type parameters and nullable array element types are not detected as nullable. Examples are TrackSelectorResult and SimpleDecoder method parameters ( #6792 ).
    • Change default UI and notification behavior in Util.shouldShowPlayButton to show a "play" button while playback is temporarily suppressed (eg due to transient audio focus loss). The legacy behavior can be maintained by using PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) or MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) ( #11213 ).
    • Upgrade androidx.annotation:annotation-experimental to 1.3.1 to fix https://issuetracker.google.com/251172715.
    • Move ExoPlayer.setAudioAttributes to the Player interface.
  • ExoPlayer:
    • Fix seeking issues in AC4 streams caused by not identifying decode-only samples correctly ( #11000 ).
    • Add suppression of playback on unsuitable audio output devices (eg the built-in speaker on Wear OS devices) when this feature is enabled via ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput . The playback suppression reason will be updated as Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT if playback is attempted when no suitable audio outputs are available, or if all suitable outputs are disconnected during playback. The suppression reason will be removed when a suitable output is connected.
    • Add MediaSource.canUpdateMediaItem and MediaSource.updateMediaItem to accept MediaItem updates after creation via Player.replaceMediaItem(s) .
    • Allow MediaItem updates for all MediaSource classes provided by the library via Player.replaceMediaItem(s) ( #33 , #9978 ).
    • Rename MimeTypes.TEXT_EXOPLAYER_CUES to MimeTypes.APPLICATION_MEDIA3_CUES .
    • Add PngExtractor that sends and reads a whole PNG file into the TrackOutput as one sample.
    • Enhance SequenceableLoader.continueLoading(long) method in the SequenceableLoader interface to SequenceableLoader.continueLoading(LoadingInfo loadingInfo) . LoadingInfo contains additional parameters, including playbackSpeed and lastRebufferRealtimeMs in addition to the existing playbackPositionUs .
    • Enhance ChunkSource.getNextChunk(long, long, List, ChunkHolder) method in the ChunkSource interface to ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) .
    • Add additional fields to Common Media Client Data (CMCD) logging: buffer starvation ( bs ), deadline ( dl ), playback rate ( pr ) and startup ( su ) ( #8699 ).
    • Add luma and chroma bitdepth to ColorInfo ( #491 ).
    • Add additional fields to Common Media Client Data (CMCD) logging: next object request ( nor ) and next range request ( nrr ) ( #8699 ).
    • Add functionality to transmit Common Media Client Data (CMCD) data using query parameters ( #553 ).
    • Fix ConcurrentModificationException in ExperimentalBandwidthMeter ( #612 ).
    • Add MediaPeriodId parameter to CompositeMediaSource.getMediaTimeForChildMediaTime .
    • Support ClippingMediaSource (and other sources with period/window time offsets) in ConcatenatingMediaSource2 ( #11226 ).
    • Change BaseRenderer.onStreamChanged() to also receive a MediaPeriodId argument.
  • ট্রান্সফরমার:
    • Parse EXIF rotation data for image inputs.
    • Remove TransformationRequest.HdrMode annotation type and its associated constants. Use Composition.HdrMode and its associated constants instead.
    • Simplify the OverlaySettings to fix rotation issues.
    • Changed frameRate and durationUs parameters of SampleConsumer.queueInputBitmap to TimestampIterator .
  • Track Selection:
    • Add DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness to explicitly allow or disallow non-seamless adaptation. The default stays at its current behavior of true .
  • Extractors:
    • MPEG-TS: Ensure the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ).
    • Fix typo when determining rotationDegrees . Changed projectionPosePitch to projectionPoseRoll ( #461 ).
    • Remove the assumption that Extractor instances can be directly inspected with instanceof . If you want runtime access to the implementation details of an Extractor you must first call Extractor.getUnderlyingInstance .
    • Add BmpExtractor .
    • Add WebpExtractor .
    • Add HeifExtractor .
    • Add QuickTime classic support to Mp4Extractor .
  • অডিও:
    • Add support for 24/32-bit big-endian PCM in MP4 and Matroska, and parse PCM encoding for lpcm in MP4.
    • Add support for extracting Vorbis audio in MP4.
    • Add AudioSink.getFormatOffloadSupport(Format) that retrieves level of offload support the sink can provide for the format through a DefaultAudioOffloadSupportProvider . It returns the new AudioOffloadSupport that contains isFormatSupported , isGaplessSupported , and isSpeedChangeSupported .
    • Add AudioSink.setOffloadMode() through which the offload configuration on the audio sink is configured. Default is AudioSink.OFFLOAD_MODE_DISABLED .
    • Offload can be enabled through setAudioOffloadPreference in TrackSelectionParameters . If the set preference is to enable, the device supports offload for the format, and the track selection is a single audio track, then audio offload will be enabled.
    • If audioOffloadModePreference is set to AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED , then the DefaultTrackSelector will only select an audio track and only if that track's format is supported in offload. If no audio track is supported in offload, then no track will be selected.
    • Disabling gapless support for offload when pre-API level 33 due to playback position issue after track transition.
    • Remove parameter enableOffload from DefaultRenderersFactory.buildAudioSink method signature.
    • Remove method DefaultAudioSink.Builder.setOffloadMode .
    • Remove intdef value DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED .
    • Add support for Opus gapless metadata during offload playback.
    • Allow renderer recovery by disabling offload if failed at first write ( #627 ).
    • Enable Offload Scheduling by default for audio-only offloaded playback.
    • Delete ExoPlayer.experimentalSetOffloadSchedulingEnabled and AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged .
    • Renamed onExperimentalSleepingForOffloadChanged as onSleepingForOffloadChanged and onExperimentalOffloadedPlayback as onOffloadedPlayback .
    • Move audio offload mode related TrackSelectionParameters interfaces and definitions to an inner AudioOffloadPreferences class.
    • Add onAudioTrackInitialized and onAudioTrackReleased callbacks to AnalyticsListener , AudioRendererEventListener and AudioSink.Listener .
    • Fix DTS Express audio buffer underflow issue ( #650 ).
    • Fix bug where the capabilities check for E-AC3-JOC throws an IllegalArgumentException ( #677 ).
  • ভিডিও:
    • Allow MediaCodecVideoRenderer to use a custom VideoFrameProcessor.Factory .
    • Fix bug where the first frame couldn't be rendered if the audio stream starts with negative timestamps ( #291 ).
  • পাঠ্য:
    • Remove ExoplayerCuesDecoder . Text tracks with sampleMimeType = application/x-media3-cues are now directly handled by TextRenderer without needing a SubtitleDecoder instance.
  • মেটাডেটা:
    • MetadataDecoder.decode will no longer be called for "decode-only" samples as the implementation must return null anyway.
  • প্রভাব:
    • Add VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) queuing bitmap input by timestamp.
    • Change VideoFrameProcessor.registerInputStream() to be non-blocking. Apps must implement VideoFrameProcessor.Listener#onInputStreamRegistered() .
    • Changed frameRate and durationUs parameters of VideoFrameProcessor.queueInputBitmap to TimestampIterator .
  • IMA extension:
    • Fix bug where a multi-period DASH live stream that is not the first item in a playlist can throw an exception ( #571 ).
    • Release StreamManager before calling AdsLoader.destroy()
    • Bump IMA SDK version to 3.31.0.
  • অধিবেশন:
    • Set the notifications foreground service behavior to FOREGROUND_SERVICE_IMMEDIATE in DefaultMediaNotificationProvider ( #167 ).
    • Use only android.media.session.MediaSession.setMediaButtonBroadcastReceiver() above API 31 to avoid problems with deprecated API on Samsung devices ( #167 ).
    • Use the media notification controller as proxy to set available commands and custom layout used to populate the notification and the platform session.
    • Convert media button events that are received by MediaSessionService.onStartCommand() within Media3 instead of routing them to the platform session and back to Media3. With this, the caller controller is always the media notification controller and apps can easily recognize calls coming from the notification in the same way on all supported API levels.
    • Fix bug where MediaController.getCurrentPosition() is not advancing when connected to a legacy MediaSessionCompat .
    • Add MediaLibrarySession.getSubscribedControllers(mediaId) for convenience.
    • Override MediaLibrarySession.Callback.onSubscribe() to assert the availability of the parent ID for which the controller subscribes. If successful, the subscription is accepted and notifyChildrenChanged() is called immediately to inform the browser ( #561 ).
    • Add session demo module for Automotive OS and enable session demo for Android Auto.
    • Do not set the queue of the framework session when COMMAND_GET_TIMELINE is not available for the media notification controller. With Android Auto as the client controller reading from the framework session, this has the effect that the queue button in the UI of Android Auto is not displayed ( #339 ).
    • Use DataSourceBitmapLoader by default instead of SimpleBitmapLoader ( #271 , #327 ).
    • Add MediaSession.Callback.onMediaButtonEvent(Intent) that allows apps to override the default media button event handling.
  • UI:
    • Add a Player.Listener implementation for Wear OS devices that handles playback suppression due to Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT by launching a system dialog to allow a user to connect a suitable audio output (eg bluetooth headphones). The listener will auto-resume playback if a suitable device is connected within a configurable timeout (default is 5 minutes).
  • ডাউনলোড:
    • Declare "data sync" foreground service type for DownloadService for Android 14 compatibility. When using this service, the app also needs to add dataSync as foregroundServiceType in the manifest and add the FOREGROUND_SERVICE_DATA_SYNC permission ( #11239 ).
  • HLS Extension:
    • Refresh the HLS live playlist with an interval calculated from the last load start time rather than the last load completed time ( #663 ).
  • DASH Extension:
    • Allow multiple of the same DASH identifier in segment template URL.
    • Add experimental support for parsing subtitles during extraction. This has better support for merging overlapping subtitles, including resolving flickering when transitioning between subtitle segments. You can enable this using DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ( #288 ).
  • RTSP Extension:
    • Fix a race condition that could lead to IndexOutOfBoundsException when falling back to TCP, or playback hanging in some situations.
    • Check state in RTSP setup when returning loading state of RtspMediaPeriod ( #577 ).
    • Ignore custom Rtsp request methods in Options response public header ( #613 ).
    • Use RTSP Setup Response timeout value in time interval of sending keep-alive RTSP Options requests ( #662 ).
  • Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
    • Release the MIDI decoder module, which provides support for playback of standard MIDI files using the Jsyn library to synthesize audio.
    • Add DecoderOutputBuffer.shouldBeSkipped to directly mark output buffers that don't need to be presented. This is preferred over C.BUFFER_FLAG_DECODE_ONLY that will be deprecated.
    • Add Decoder.setOutputStartTimeUs and SimpleDecoder.isAtLeastOutputStartTimeUs to allow decoders to drop decode-only samples before the start time. This should be preferred to Buffer.isDecodeOnly that will be deprecated.
    • Fix bug publishing MIDI decoder artifact to Maven repository. The artifact is renamed to media3-exoplayer-midi ( #734 ).
  • Leanback extension:
    • Fix bug where disabling a surface can cause an ArithmeticException in Leanback code ( #617 ).
  • Test Utilities:
    • Make TestExoPlayerBuilder and FakeClock compatible with Espresso UI tests and Compose UI tests. This fixes a bug where playback advances non-deterministically during Espresso or Compose view interactions.
  • Remove deprecated symbols:
    • Remove TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) and TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) . Use Composition.Builder.setHdrMode(int) and pass the Composition to Transformer.start(Composition, String) instead.
    • Remove deprecated DownloadNotificationHelper.buildProgressNotification method, use a non deprecated method that takes a notMetRequirements parameter instead.

সংস্করণ 1.2.0-rc01

নভেম্বর 1, 2023

Use the 1.2.0 stable version .

সংস্করণ 1.2.0-beta01

অক্টোবর 19, 2023

Use the 1.2.0 stable version .

Version 1.2.0-alpha02

সেপ্টেম্বর 29, 2023

Use the 1.2.0 stable version .

Version 1.2.0-alpha01

আগস্ট 17, 2023

Use the 1.2.0 stable version .

সংস্করণ 1.1.0

সংস্করণ 1.1.1

16 আগস্ট, 2023

  • Common Library:
    • Remove accidentally added multidex dependency from all modules ( #499 ).
  • ExoPlayer:
    • Fix issue in PlaybackStatsListener where spurious PlaybackStats are created after the playlist is cleared.
    • Add additional fields to Common Media Client Data (CMCD) logging: streaming format (sf), stream type (st), version (v), top birate (tb), object duration (d), measured throughput (mtp) and object type (ot) ( #8699 ).
  • অডিও:
    • Fix a bug where Player.getState() never transitioned to STATE_ENDED when playing very short files ( #538 ).
  • Audio Offload:
    • Prepend Ogg ID Header and Comment Header Pages to bitstream for offloaded Opus playback in accordance with RFC 7845.
  • ভিডিও:
    • H.265/HEVC: Fix parsing SPS short and long term reference picture info.
  • পাঠ্য:
    • CEA-608: Change cue truncation logic to only consider visible text. Previously indent and tab offset were included when limiting the cue length to 32 characters (which was technically correct by the spec) ( #11019 ).
  • IMA extension:
    • Bump IMA SDK version to 3.30.3.
  • অধিবেশন:
    • Add custom layout to the state of the controller and provide a getter to access it. When the custom layout changes, MediaController.Listener.onCustomLayoutChanged is called. Apps that want to send different custom layouts to different Media3 controller can do this in MediaSession.Callback.onConnect by using an AcceptedResultBuilder to make sure the custom layout is available to the controller when connection completes.
    • Fix cases where MediaLibraryServiceLegacyStub sent an error to a Result that didn't support this which produced an UnsupportedOperationException ( #78 ).
    • Fix the way PlayerWrapper creates a VolumeProviderCompat by determining volumeControlType through both legacy commands ( COMMAND_ADJUST_DEVICE_VOLUME and COMMAND_SET_DEVICE_VOLUME ) and new commands ( COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS and COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS ) ( #554 ).

সংস্করণ 1.1.0

5 জুলাই, 2023

  • Common Library:
    • Add suppression reason for unsuitable audio route and play when ready change reason for suppressed too long. ( #15 ).
    • Add commands to Player:
      • COMMAND_GET_METADATA
      • COMMAND_SET_PLAYLIST_METADATA
      • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
      • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
    • Add overloaded methods to Player which allow users to specify volume flags:
      • void setDeviceVolume(int, int)
      • void increaseDeviceVolume(int)
      • void decreaseDeviceVolume(int)
      • void setDeviceMuted(boolean, int)
    • Add Builder for DeviceInfo and deprecate existing constructor.
    • Add DeviceInfo.routingControllerId to specify the routing controller ID for remote playbacks.
    • Add Player.replaceMediaItem(s) as a shortcut to adding and removing items at the same position ( #8046 ).
  • ExoPlayer:
    • Allow ExoPlayer to have control of device volume methods only if explicitly opted in. Use ExoPlayer.Builder.setDeviceVolumeControlEnabled to have access to:
      • getDeviceVolume()
      • isDeviceMuted()
      • setDeviceVolume(int) and setDeviceVolume(int, int)
      • increaseDeviceVolume(int) and increaseDeviceVolume(int, int)
      • decreaseDeviceVolume(int) and decreaseDeviceVolume(int, int)
    • Add FilteringMediaSource that allows to filter available track types from a MediaSource .
    • Add support for including Common Media Client Data (CMCD) in the outgoing requests of adaptive streaming formats DASH, HLS, and SmoothStreaming. The following fields, br , bl , cid , rtp , and sid , have been incorporated ( #8699 ). API structure and API methods:
      • CMCD logging is disabled by default, use MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) to enable it.
      • All keys are enabled by default, override CmcdConfiguration.RequestConfig.isKeyAllowed(String key) to filter out which keys are logged.
      • Override CmcdConfiguration.RequestConfig.getCustomData() to enable custom key logging.
    • Add additional action to manifest of main demo to make it easier to start the demo app with a custom *.exolist.json file ( #439 ).
    • Add ExoPlayer.setVideoEffects() for using Effect during video playback.
    • Update SampleQueue to store sourceId as a long rather than an int . This changes the signatures of public methods SampleQueue.sourceId and SampleQueue.peekSourceId .
    • Add parameters to LoadControl methods shouldStartPlayback and onTracksSelected that allow associating these methods with the relevant MediaPeriod .
    • Change signature of ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) by adding a timeline parameter that contains the periods with the UIDs used as keys in the map. This is required to avoid concurrency issues with multi-period live streams.
    • Deprecate EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) and BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs) . The variant of the methods without the mediaTimeOffsetUs can be called instead. Note that even for the deprecated variants, the offset is not anymore added to startTimeUs and endTimeUs of the MediaLoadData objects that are dispatched by the dispatcher.
    • Rename ExoTrackSelection.blacklist to excludeTrack and isBlacklisted to isTrackExcluded .
    • Fix inconsistent behavior between ExoPlayer.setMediaItem(s) and addMediaItem(s) when called on an empty playlist.
  • ট্রান্সফরমার:
    • Remove Transformer.Builder.setMediaSourceFactory(MediaSource.Factory) . Use ExoPlayerAssetLoader.Factory(MediaSource.Factory) and Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory) instead.
    • Remove Transformer.startTransformation(MediaItem, ParcelFileDescriptor) .
    • Fix a bug where transformation could get stuck (leading to muxer timeout) if the end of the video stream was signaled at the moment when an input frame was pending processing.
    • Query codecs via MediaCodecList instead of using findDecoder/EncoderForFormat utilities, to expand support.
    • Remove B-frame configuration in DefaultEncoderFactory because it doesn't work on some devices.
  • Track selection:
    • Add DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange which is disabled by default. When enabled, the DefaultTrackSelector will trigger a new track selection when the renderer capabilities changed.
  • Extractors:
    • Ogg: Fix bug when seeking in files with a long duration ( #391 ).
    • FMP4: Fix issue where TimestampAdjuster initializes a wrong timestamp offset with metadata sample time from emsg atom ( #356 ).
  • অডিও:
    • Fix bug where some playbacks fail when tunneling is enabled and AudioProcessors are active, eg for gapless trimming ( #10847 ).
    • Encapsulate Opus frames in Ogg packets in direct playbacks (offload).
    • Extrapolate current position during sleep with offload scheduling.
    • Add Renderer.release() and AudioSink.release() for releasing the resources at the end of player's lifecycle.
    • Listen to audio capabilities changes in DefaultAudioSink . Add a required parameter context in the constructor of DefaultAudioSink , with which the DefaultAudioSink will register as the listener to the AudioCapabilitiesReceiver and update its audioCapabilities property when informed with a capabilities change.
    • Propagate audio capabilities changes via a new event onAudioCapabilitiesChanged in AudioSink.Listener interface, and a new interface RendererCapabilities.Listener which triggers onRendererCapabilitiesChanged events.
    • Add ChannelMixingAudioProcessor for applying scaling/mixing to audio channels.
    • Add new int value DISCARD_REASON_AUDIO_BYPASS_POSSIBLE to DecoderDiscardReasons to discard audio decoder when bypass mode is possible after audio capabilities change.
    • Add direct playback support for DTS Express and DTS:X ( #335 ).
  • ভিডিও:
    • Make MediaCodecVideoRenderer report a VideoSize with a width and height of 0 when the renderer is disabled. Player.Listener.onVideoSizeChanged is called accordingly when Player.getVideoSize() changes. With this change, ExoPlayer's video size with MediaCodecVideoRenderer has a width and height of 0 when Player.getCurrentTracks does not support video, or the size of the supported video track is not yet determined.
  • DRM:
    • Reduce the visibility of several internal-only methods on DefaultDrmSession that aren't expected to be called from outside the DRM package:
      • void onMediaDrmEvent(int)
      • void provision()
      • void onProvisionCompleted()
      • onProvisionError(Exception, boolean)
  • Muxer:
    • Add a new muxer library which can be used to create an MP4 container file.
  • IMA extension:
    • Enable multi-period live DASH streams for DAI. Please note that the current implementation does not yet support seeking in live streams ( #10912 ).
    • Fix a bug where a new ad group is inserted in live streams because the calculated content position in consecutive timelines varies slightly.
  • অধিবেশন:
    • Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling a Player method.
    • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset ( #167 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
  • UI:
    • Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
  • RTSP Extension:
    • For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message ( #302 ).
    • Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header ( #11160 ).
  • DASH Extension:
    • Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
    • Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException ( #10838 ).
  • HLS Extension:
    • Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. If the initialization doesn't complete before the timeout, a PlaybackException is thrown to avoid the playback endless stalling. The timeout is set to zero by default ( #323 ).
  • Test Utilities:
    • Check for URI scheme case insensitivity in DataSourceContractTest .
  • Remove deprecated symbols:
    • Remove DefaultAudioSink constructors, use DefaultAudioSink.Builder instead.
    • Remove HlsMasterPlaylist , use HlsMultivariantPlaylist instead.
    • Remove Player.stop(boolean) . Use Player.stop() and Player.clearMediaItems() (if reset is true ) instead.
    • Remove two deprecated SimpleCache constructors, use a non-deprecated constructor that takes a DatabaseProvider instead for better performance.
    • Remove DefaultBandwidthMeter constructor, use DefaultBandwidthMeter.Builder instead.
    • Remove DefaultDrmSessionManager constructors, use DefaultDrmSessionManager.Builder instead.
    • Remove two deprecated HttpDataSource.InvalidResponseCodeException constructors, use a non-deprecated constructor that accepts additional fields( cause , responseBody ) to enhance error logging.
    • Remove DownloadHelper.forProgressive , DownloadHelper.forHls , DownloadHelper.forDash , and DownloadHelper.forSmoothStreaming , use DownloadHelper.forMediaItem instead.
    • Remove deprecated DownloadService constructor, use a non deprecated constructor that includes the option to provide a channelDescriptionResourceId parameter.
    • Remove deprecated String constants for Charsets ( ASCII_NAME , UTF8_NAME , ISO88591_NAME , UTF16_NAME and UTF16LE_NAME ), use Kotlin Charsets from the kotlin.text package, the java.nio.charset.StandardCharsets or the com.google.common.base.Charsets instead.
    • Remove deprecated WorkManagerScheduler constructor, use a non deprecated constructor that includes the option to provide a Context parameter instead.
    • Remove the deprecated methods createVideoSampleFormat , createAudioSampleFormat , createContainerFormat , and createSampleFormat , which were used to instantiate the Format class. Instead use Format.Builder for creating instances of Format .
    • Remove the deprecated methods copyWithMaxInputSize , copyWithSubsampleOffsetUs , copyWithLabel , copyWithManifestFormatInfo , copyWithGaplessInfo , copyWithFrameRate , copyWithDrmInitData , copyWithMetadata , copyWithBitrate and copyWithVideoSize , use Format.buildUpon() and setter methods instead.
    • Remove deprecated ExoPlayer.retry() , use prepare() instead.
    • Remove deprecated zero-arg DefaultTrackSelector constructor, use DefaultTrackSelector(Context) instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove deprecated DownloadManager constructor, use the constructor that takes an Executor instead.
    • Remove deprecated Cue constructors, use Cue.Builder instead.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • Remove four deprecated AnalyticsListener methods:
      • onDecoderEnabled , use onAudioEnabled and/or onVideoEnabled instead.
      • onDecoderInitialized , use onAudioDecoderInitialized and/or onVideoDecoderInitialized instead.
      • onDecoderInputFormatChanged , use onAudioInputFormatChanged and/or onVideoInputFormatChanged instead.
      • onDecoderDisabled , use onAudioDisabled and/or onVideoDisabled instead.
    • Remove the deprecated Player.Listener.onSeekProcessed and AnalyticsListener.onSeekProcessed , use onPositionDiscontinuity with DISCONTINUITY_REASON_SEEK instead.
    • Remove ExoPlayer.setHandleWakeLock(boolean) , use setWakeMode(int) instead.
    • Remove deprecated DefaultLoadControl.Builder.createDefaultLoadControl() , use build() instead.
    • Remove deprecated MediaItem.PlaybackProperties , use MediaItem.LocalConfiguration instead. Deprecated field MediaItem.playbackProperties is now of type MediaItem.LocalConfiguration .

Version 1.1.0-rc01

জুন 21, 2023

Use the 1.1.0 stable version .

Version 1.1.0-beta01

7 জুন, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.1.0-alpha01

10 মে, 2023

Use the 1.1.0 stable version .

সংস্করণ 1.0.0

সংস্করণ 1.0.2

18 মে, 2023

androidx.media3:media3-*:1.0.2 is released. Version 1.0.2 contains these commits.

This release corresponds to the ExoPlayer 2.18.7 release .

This release contains the following changes since the 1.0.1 release :

  • Core library:
    • Add Buffer.isLastSample() that denotes if Buffer contains flag C.BUFFER_FLAG_LAST_SAMPLE .
    • Fix issue where last frame may not be rendered if the last sample with frames is dequeued without reading the 'end of stream' sample. ( #11079 ).
  • Extractors:
    • Fix parsing of H.265 SPS in MPEG-TS files by re-using the parsing logic already used by RTSP and MP4 extractors ( #303 ).
  • পাঠ্য:
    • SSA: Add support for UTF-16 files if they start with a byte order mark ( #319 ).
  • অধিবেশন:
    • Fix issue where MediaController doesn't update its available commands when connected to a legacy MediaSessionCompat that updates its actions.
    • Fix bug that prevented the MediaLibraryService from returning null for a call from System UI to Callback.onGetLibraryRoot with params.isRecent == true on API 30 ( #355 ).
    • Fix memory leak of MediaSessionService or MediaLibraryService ( #346 ).
    • Fix bug where a combined Timeline and position update in a MediaSession may cause a MediaController to throw an IllegalStateException .

সংস্করণ 1.0.1

18 এপ্রিল, 2023

androidx.media3:media3-*:1.0.1 is released. Version 1.0.1 contains these commits.

This release corresponds to the ExoPlayer 2.18.6 release .

  • Core library:
    • Reset target live stream override when seeking to default position ( #11051 ).
    • Fix bug where empty sample streams in the media could cause playback to be stuck.
  • অধিবেশন:
    • Fix bug where multiple identical queue items published by a legacy MediaSessionCompat result in an exception in MediaController ( #290 ).
    • Add missing forwarding of MediaSession.broadcastCustomCommand to the legacy MediaControllerCompat.Callback.onSessionEvent ( #293 ).
    • Fix bug where calling MediaSession.setPlayer doesn't update the available commands.
    • Fix issue that TrackSelectionOverride instances sent from a MediaController are ignored if they reference a group with Format.metadata ( #296 ).
    • Fix issue where Player.COMMAND_GET_CURRENT_MEDIA_ITEM needs to be available to access metadata via the legacy MediaSessionCompat .
    • Fix issue where MediaSession instances on a background thread cause crashes when used in MediaSessionService ( #318 ).
    • Fix issue where a media button receiver was declared by the library without the app having intended this ( #314 ).
  • ড্যাশ:
    • Fix handling of empty segment timelines ( #11014 ).
  • RTSP:
    • Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport ( #11069 ).

সংস্করণ 1.0.0

22 মার্চ, 2023

androidx.media3:media3-*:1.0.0 is released. Version 1.0.0 contains these commits.

This release corresponds to the ExoPlayer 2.18.5 release .

There are no changes since 1.0.0-rc02.

Version 1.0.0-rc02

2 মার্চ, 2023

androidx.media3:media3-*:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits.

This release corresponds to the ExoPlayer 2.18.4 release .

  • Core library:
    • Fix network type detection on API 33 ( #10970 ).
    • Fix NullPointerException when calling ExoPlayer.isTunnelingEnabled ( #10977 ).
  • ডাউনলোড:
    • Make the maximum difference of the start time of two segments to be merged configurable in SegmentDownloader and subclasses ( #248 ).
  • অডিও:
    • Fix broken gapless MP3 playback on Samsung devices ( #8594 ).
    • Fix bug where playback speeds set immediately after disabling audio may be overridden by a previous speed change ( #10882 ).
  • ভিডিও:
    • Map HEVC HDR10 format to HEVCProfileMain10HDR10 instead of HEVCProfileMain10 .
    • Add workaround for a device issue on Chromecast with Google TV and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #10898 ).
    • Fix frame release performance issues when playing media with a frame rate far higher than the screen refresh rate.
  • কাস্ট:
    • Fix transient STATE_IDLE when transitioning between media items ( #245 ).
  • RTSP:
    • Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ( #10971 ).
  • অধিবেশন:
    • Fix a bug where notification play/pause button doesn't update with player state ( #192 ).
  • IMA extension:
    • Fix a bug which prevented DAI streams without any ads from starting because the first (and in the case without ads the only) LOADED event wasn't received.

Version 1.0.0-rc01

ফেব্রুয়ারী 16, 2023

androidx.media3:media3-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

This release corresponds to the ExoPlayer 2.18.3 release .

  • Core library:
    • Tweak the renderer's decoder ordering logic to uphold the MediaCodecSelector 's preferences, even if a decoder reports it may not be able to play the media performantly. For example with default selector, hardware decoder with only functional support will be preferred over software decoder that fully supports the format ( #10604 ).
    • Add ExoPlayer.Builder.setPlaybackLooper that sets a pre-existing playback thread for a new ExoPlayer instance.
    • Allow download manager helpers to be cleared ( #10776 ).
    • Add parameter to BasePlayer.seekTo to also indicate the command used for seeking.
    • Use theme when loading drawables on API 21+ ( #220 ).
    • Add ConcatenatingMediaSource2 that allows combining multiple media items into a single window ( #247 ).
  • Extractors:
    • Throw a ParserException instead of a NullPointerException if the sample table (stbl) is missing a required sample description (stsd) when parsing trak atoms.
    • Correctly skip samples when seeking directly to a sync frame in fMP4 ( #10941 ).
  • অডিও:
    • Use the compressed audio format bitrate to calculate the min buffer size for AudioTrack in direct playbacks (passthrough).
  • পাঠ্য:
    • Fix TextRenderer passing an invalid (negative) index to Subtitle.getEventTime if a subtitle file contains no cues.
    • SubRip: Add support for UTF-16 files if they start with a byte order mark.
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • ড্যাশ:
    • Add full parsing for image adaptation sets, including tile counts ( #3752 ).
  • UI:
    • Fix the deprecated PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) to ensure visibility changes are passed to the registered listener ( #229 ).
    • Fix the ordering of the center player controls in PlayerView when using a right-to-left (RTL) layout ( #227 ).
  • অধিবেশন:
    • Add abstract SimpleBasePlayer to help implement the Player interface for custom players.
    • Add helper method to convert platform session token to Media3 SessionToken ( #171 ).
    • Use onMediaMetadataChanged to trigger updates of the platform media session ( #219 ).
    • Add the media session as an argument of getMediaButtons() of the DefaultMediaNotificationProvider and use immutable lists for clarity ( #216 ).
    • Add onSetMediaItems callback listener to provide means to modify/set MediaItem list, starting index and position by session before setting onto Player ( #156 ).
    • Avoid double tap detection for non-Bluetooth media button events ( #233 ).
    • Make QueueTimeline more robust in case of a shady legacy session state ( #241 ).
  • মেটাডেটা:
    • Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
    • Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
    • Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
  • Cast extension:
    • Bump Cast SDK version to 21.2.0.
  • IMA extension:
    • Remove player listener of the ImaServerSideAdInsertionMediaSource on the application thread to avoid threading issues.
    • Add a property focusSkipButtonWhenAvailable to the ImaServerSideAdInsertionMediaSource.AdsLoader.Builder to request focusing the skip button on TV devices and set it to true by default.
    • Add a method focusSkipButton() to the ImaServerSideAdInsertionMediaSource.AdsLoader to programmatically request to focus the skip button.
    • Bump IMA SDK version to 3.29.0.
  • Demo app:
    • Request notification permission for download notifications at runtime ( #10884 ).

Version 1.0.0-beta03

নভেম্বর 22, 2022

androidx.media3:media3-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

This release corresponds to the ExoPlayer 2.18.2 release .

  • Core library:
    • Add ExoPlayer.isTunnelingEnabled to check if tunneling is enabled for the currently selected tracks ( #2518 ).
    • Add WrappingMediaSource to simplify wrapping a single MediaSource ( #7279 ).
    • Discard back buffer before playback gets stuck due to insufficient available memory.
    • Close the Tracing "doSomeWork" block when offload is enabled.
    • Fix session tracking problem with fast seeks in PlaybackStatsListener ( #180 ).
    • Send missing onMediaItemTransition callback when calling seekToNext or seekToPrevious in a single-item playlist ( #10667 ).
    • Add Player.getSurfaceSize that returns the size of the surface on which the video is rendered.
    • Fix bug where removing listeners during the player release can cause an IllegalStateException ( #10758 ).
  • নির্মাণ:
    • Enforce minimum compileSdkVersion to avoid compilation errors ( #10684 ).
    • Avoid publishing block when included in another gradle build.
  • Track selection:
    • Prefer other tracks to Dolby Vision if display does not support it. ( #8944 ).
  • ডাউনলোড:
    • Fix potential infinite loop in ProgressiveDownloader caused by simultaneous download and playback with the same PriorityTaskManager ( #10570 ).
    • Make download notification appear immediately ( #183 ).
    • Limit parallel download removals to 1 to avoid excessive thread creation ( #10458 ).
  • ভিডিও:
    • Try alternative decoder for Dolby Vision if display does not support it. ( #9794 ).
  • অডিও:
    • Use SingleThreadExecutor for releasing AudioTrack instances to avoid OutOfMemory errors when releasing multiple players at the same time ( #10057 ).
    • Adds AudioOffloadListener.onExperimentalOffloadedPlayback for the AudioTrack offload state. ( #134 ).
    • Make AudioTrackBufferSizeProvider a public interface.
    • Add ExoPlayer.setPreferredAudioDevice to set the preferred audio output device ( #135 ).
    • Rename androidx.media3.exoplayer.audio.AudioProcessor to androidx.media3.common.audio.AudioProcessor .
    • Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions ( #10701 ).
  • মেটাডেটা:
    • MetadataRenderer can now be configured to render metadata as soon as they are available. Create an instance with MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) to specify whether the renderer will output metadata early or in sync with the player position.
  • DRM:
    • Work around a bug in the Android 13 ClearKey implementation that returns a non-empty but invalid license URL.
    • Fix setMediaDrmSession failed: session not opened error when switching between DRM schemes in a playlist (eg Widevine to ClearKey).
  • পাঠ্য:
    • CEA-608: Ensure service switch commands on field 2 are handled correctly ( #10666 ).
  • ড্যাশ:
    • Parse EventStream.presentationTimeOffset from manifests ( #10460 ).
  • UI:
    • Use current overrides of the player as preset in TrackSelectionDialogBuilder ( #10429 ).
  • অধিবেশন:
    • Ensure commands are always executed in the correct order even if some require asynchronous resolution ( #85 ).
    • Add DefaultMediaNotificationProvider.Builder to build DefaultMediaNotificationProvider instances. The builder can configure the notification ID, the notification channel ID and the notification channel name used by the provider. Also, add method DefaultMediaNotificationProvider.setSmallIcon(int) to set the notifications small icon. ( #104 ).
    • Ensure commands sent before MediaController.release() are not dropped ( #99 ).
    • SimpleBitmapLoader can load bitmap from file:// URIs ( #108 ).
    • Fix assertion that prevents MediaController to seek over an ad in a period ( #122 ).
    • When playback ends, the MediaSessionService is stopped from the foreground and a notification is shown to restart playback of the last played media item ( #112 ).
    • Don't start a foreground service with a pending intent for pause ( #167 ).
    • Manually hide the 'badge' associated with the notification created by DefaultNotificationProvider on API 26 and API 27 (the badge is automatically hidden on API 28+) ( #131 ).
    • Fix bug where a second binder connection from a legacy MediaSession to a Media3 MediaController causes IllegalStateExceptions ( #49 ).
  • RTSP:
    • Add H263 fragmented packet handling ( #119 ).
    • Add support for MP4A-LATM ( #162 ).
  • আইএমএ:
    • Add timeout for loading ad information to handle cases where the IMA SDK gets stuck loading an ad ( #10510 ).
    • Prevent skipping mid-roll ads when seeking to the end of the content ( #10685 ).
    • Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI ( #10764 ).
  • FFmpeg extension:
    • Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above ( #9933 ).
  • AV1 extension:
    • Update CMake version to avoid incompatibilities with the latest Android Studio releases ( #9933 ).
  • Cast extension:
    • Implement getDeviceInfo() to be able to identify CastPlayer when controlling playback with a MediaController ( #142 ).
  • ট্রান্সফরমার:
    • Add muxer watchdog timer to detect when generating an output sample is too slow.
  • Remove deprecated symbols:
    • Remove Transformer.Builder.setOutputMimeType(String) . This feature has been removed. The MIME type will always be MP4 when the default muxer is used.

Version 1.0.0-beta02

জুলাই 21, 2022

androidx.media3:media3-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

This release corresponds to the ExoPlayer 2.18.1 release .

  • Core library:
    • Ensure that changing the ShuffleOrder with ExoPlayer.setShuffleOrder results in a call to Player.Listener#onTimelineChanged with reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED ( #9889 ).
    • For progressive media, only include selected tracks in buffered position ( #10361 ).
    • Allow custom logger for all ExoPlayer log output ( #9752 ).
    • Fix implementation of setDataSourceFactory in DefaultMediaSourceFactory , which was non-functional in some cases ( #116 ).
  • Extractors:
    • Fix parsing of H265 short term reference picture sets ( #10316 ).
    • Fix parsing of bitrates from esds boxes ( #10381 ).
  • ড্যাশ:
    • Parse ClearKey license URL from manifests ( #10246 ).
  • UI:
    • Ensure TalkBack announces the currently active speed option in the playback controls menu ( #10298 ).
  • RTSP:
    • Add VP8 fragmented packet handling ( #110 ).
  • Leanback extension:
    • Listen to playWhenReady changes in LeanbackAdapter ( 10420 ).
  • কাস্ট:
    • Use the MediaItem that has been passed to the playlist methods as Window.mediaItem in CastTimeline ( #25 , #8212 ).
    • Support Player.getMetadata() and Listener.onMediaMetadataChanged() with CastPlayer ( #25 ).

Version 1.0.0-beta01

16 জুন, 2022

androidx.media3:media3-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

This corresponds to the ExoPlayer 2.18.0 release .

  • Core library:
    • Enable support for Android platform diagnostics via MediaMetricsManager . ExoPlayer will forward playback events and performance data to the platform, which helps to provide system performance and debugging information on the device. This data may also be collected by Google if sharing usage and diagnostics data is enabled by the user of the device. Apps can opt-out of contributing to platform diagnostics for ExoPlayer with ExoPlayer.Builder.setUsePlatformDiagnostics(false) .
    • Fix bug that tracks are reset too often when using MergingMediaSource , for example when side-loading subtitles and changing the selected subtitle mid-playback ( #10248 ).
    • Stop detecting 5G-NSA network type on API 29 and 30. These playbacks will assume a 4G network.
    • Disallow passing null to MediaSource.Factory.setDrmSessionManagerProvider and MediaSource.Factory.setLoadErrorHandlingPolicy . Instances of DefaultDrmSessionManagerProvider and DefaultLoadErrorHandlingPolicy can be passed explicitly if required.
    • Add MediaItem.RequestMetadata to represent metadata needed to play media when the exact LocalConfiguration is not known. Also remove MediaMetadata.mediaUrl as this is now included in RequestMetadata .
    • Add Player.Command.COMMAND_SET_MEDIA_ITEM to enable players to allow setting a single item.
  • Track selection:
    • Flatten TrackSelectionOverrides class into TrackSelectionParameters , and promote TrackSelectionOverride to a top level class.
    • Rename TracksInfo to Tracks and TracksInfo.TrackGroupInfo to Tracks.Group . Player.getCurrentTracksInfo and Player.Listener.onTracksInfoChanged have also been renamed to Player.getCurrentTracks and Player.Listener.onTracksChanged . This includes 'un-deprecating' the Player.Listener.onTracksChanged method name, but with different parameter types.
    • Change DefaultTrackSelector.buildUponParameters and DefaultTrackSelector.Parameters.buildUpon to return DefaultTrackSelector.Parameters.Builder instead of the deprecated DefaultTrackSelector.ParametersBuilder .
    • Add DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities which is enabled by default. When enabled, the DefaultTrackSelector will prefer audio tracks whose channel count does not exceed the device output capabilities. On handheld devices, the DefaultTrackSelector will prefer stereo/mono over multichannel audio formats, unless the multichannel format can be Spatialized (Android 12L+) or is a Dolby surround sound format. In addition, on devices that support audio spatialization, the DefaultTrackSelector will monitor for changes in the Spatializer properties and trigger a new track selection upon these. Devices with a television UI mode are excluded from these constraints and the format with the highest channel count will be preferred. To enable this feature, the DefaultTrackSelector instance must be constructed with a Context .
  • ভিডিও:
    • Rename DummySurface to PlaceholderSurface .
    • Add AV1 support to the MediaCodecVideoRenderer.getCodecMaxInputSize .
  • অডিও:
    • Use LG AC3 audio decoder advertising non-standard MIME type.
    • Change the return type of AudioAttributes.getAudioAttributesV21() from android.media.AudioAttributes to a new AudioAttributesV21 wrapper class, to prevent slow ART verification on API < 21.
    • Query the platform (API 29+) or assume the audio encoding channel count for audio passthrough when the format audio channel count is unset, which occurs with HLS chunkless preparation ( 10204 ).
    • Configure AudioTrack with channel mask AudioFormat.CHANNEL_OUT_7POINT1POINT4 if the decoder outputs 12 channel PCM audio ( #10322 .
  • ডিআরএম
    • Ensure the DRM session is always correctly updated when seeking immediately after a format change ( 10274 ).
  • পাঠ্য:
    • Change Player.getCurrentCues() to return CueGroup instead of List<Cue> .
    • SSA: Support OutlineColour style setting when BorderStyle == 3 (ie OutlineColour sets the background of the cue) ( #8435 ).
    • CEA-708: Parse data into multiple service blocks and ignore blocks not associated with the currently selected service number.
    • Remove RawCcExtractor , which was only used to handle a Google-internal subtitle format.
  • Extractors:
    • Add support for AVI ( #2092 ).
    • Matroska: Parse DiscardPadding for Opus tracks.
    • MP4: Parse bitrates from esds boxes.
    • Ogg: Allow duplicate Opus ID and comment headers ( #10038 ).
  • UI:
    • Fix delivery of events to OnClickListener s set on PlayerView in the case that useController=false ( #9605 ). Also fix delivery of events to OnLongClickListener for all view configurations.
    • Fix incorrectly treating a sequence of touch events that exit the bounds of PlayerView before ACTION_UP as a click ( #9861 ).
    • Fix PlayerView accessibility issue where tapping might toggle playback rather than hiding the controls ( #8627 ).
    • Rewrite TrackSelectionView and TrackSelectionDialogBuilder to work with the Player interface rather than ExoPlayer . This allows the views to be used with other Player implementations, and removes the dependency from the UI module to the ExoPlayer module. This is a breaking change.
    • Don't show forced text tracks in the PlayerView track selector, and keep a suitable forced text track selected if "None" is selected ( #9432 ).
  • ড্যাশ:
    • Parse channel count from DTS AudioChannelConfiguration elements. This re-enables audio passthrough for DTS streams ( #10159 ).
    • Disallow passing null to DashMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • HLS:
    • Fallback to chunkful preparation if the playlist CODECS attribute does not contain the audio codec ( #10065 ).
    • Disallow passing null to HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory , HlsMediaSource.Factory.setPlaylistParserFactory , and HlsMediaSource.Factory.setPlaylistTrackerFactory . Instances of DefaultCompositeSequenceableLoaderFactory , DefaultHlsPlaylistParserFactory , or a reference to DefaultHlsPlaylistTracker.FACTORY can be passed explicitly if required.
  • Smooth Streaming:
    • Disallow passing null to SsMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
  • RTSP:
    • Add RTP reader for H263 ( #63 ).
    • Add RTP reader for MPEG4 ( #35 ).
    • Add RTP reader for HEVC ( #36 ).
    • Add RTP reader for AMR. Currently only mono-channel, non-interleaved AMR streams are supported. Compound AMR RTP payload is not supported. ( #46 )
    • Add RTP reader for VP8 ( #47 ).
    • Add RTP reader for WAV ( #56 ).
    • Fix RTSP basic authorization header. ( #9544 ).
    • Stop checking mandatory SDP fields as ExoPlayer doesn't need them ( #10049 ).
    • Throw checked exception when parsing RTSP timing ( #10165 ).
    • Add RTP reader for VP9 ( #47 ).
    • Add RTP reader for OPUS ( #53 ).
  • তথ্য সূত্র:
    • Rename DummyDataSource to PlaceholderDataSource .
    • Workaround OkHttp interrupt handling.
  • অধিবেশন:
    • Replace MediaSession.MediaItemFiller with MediaSession.Callback.onAddMediaItems to allow asynchronous resolution of requests.
    • Support setMediaItems(s) methods when MediaController connects to a legacy media session.
    • Remove MediaController.setMediaUri and MediaSession.Callback.onSetMediaUri . The same functionality can be achieved by using MediaController.setMediaItem and MediaSession.Callback.onAddMediaItems .
    • Forward legacy MediaController calls to play media to MediaSession.Callback.onAddMediaItems instead of onSetMediaUri .
    • Add MediaNotification.Provider and DefaultMediaNotificationProvider to provide customization of the notification.
    • Add BitmapLoader and SimpleBitmapLoader for downloading artwork images.
    • Add MediaSession.setCustomLayout() to provide backwards compatibility with the legacy session.
    • Add MediaSession.setSessionExtras() to provide feature parity with legacy session.
    • Rename MediaSession.MediaSessionCallback to MediaSession.Callback , MediaLibrarySession.MediaLibrarySessionCallback to MediaLibrarySession.Callback and MediaSession.Builder.setSessionCallback to setCallback .
    • Fix NPE in MediaControllerImplLegacy ( #59 ).
    • Update session position info on timeline change( #51 ).
    • Fix NPE in MediaControllerImplBase after releasing controller ( #74 ).
  • Ad playback / IMA:
    • Decrease ad polling rate from every 100ms to every 200ms, to line up with Media Rating Council (MRC) recommendations.
  • FFmpeg extension:
    • Update CMake version to 3.21.0+ to avoid a CMake bug causing AndroidStudio's gradle sync to fail ( #9933 ).
  • Remove deprecated symbols:
    • Remove Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) . Use Player.Listener.onTracksChanged(Tracks) instead.
    • Remove Player.getCurrentTrackGroups and Player.getCurrentTrackSelections . Use Player.getCurrentTracks instead. You can also continue to use ExoPlayer.getCurrentTrackGroups and ExoPlayer.getCurrentTrackSelections , although these methods remain deprecated.
    • Remove DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT and DEFAULT_TRACK_SELECTOR_PARAMETERS constants. Use getDefaultTrackSelectorParameters(Context) instead when possible, and DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT otherwise.
    • Remove constructor DefaultTrackSelector(ExoTrackSelection.Factory) . Use DefaultTrackSelector(Context, ExoTrackSelection.Factory) instead.
    • Remove Transformer.Builder.setContext . The Context should be passed to the Transformer.Builder constructor instead.

Version 1.0.0-alpha03

14 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

This corresponds to the ExoPlayer 2.17.1 release .

  • অডিও:
    • Fix error checking audio capabilities for Dolby Atmos (E-AC3-JOC) in HLS.
  • Extractors:
    • FMP4: Fix issue where emsg sample metadata could be output in the wrong order for streams containing both v0 and v1 emsg atoms ( #9996 ).
  • পাঠ্য:
    • Fix the interaction of SingleSampleMediaSource.Factory.setTrackId and MediaItem.SubtitleConfiguration.Builder.setId to prioritise the SubtitleConfiguration field and fall back to the Factory value if it's not set ( #10016 ).
  • Ad playback:
    • Fix audio underruns between ad periods in live HLS SSAI streams.

Version 1.0.0-alpha02

2 মার্চ, 2022

androidx.media3:media3-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

This corresponds to the ExoPlayer 2.17.0 release .

  • Core Library:
    • Add protected method DefaultRenderersFactory.getCodecAdapterFactory() so that subclasses of DefaultRenderersFactory that override buildVideoRenderers() or buildAudioRenderers() can access the codec adapter factory and pass it to MediaCodecRenderer instances they create.
    • Propagate ICY header fields name and genre to MediaMetadata.station and MediaMetadata.genre respectively so that they reach the app via Player.Listener.onMediaMetadataChanged() ( #9677 ).
    • Remove null keys from DefaultHttpDataSource#getResponseHeaders .
    • Sleep and retry when creating a MediaCodec instance fails. This works around an issue that occurs on some devices when switching a surface from a secure codec to another codec ( #8696 ).
    • Add MediaCodecAdapter.getMetrics() to allow users obtain metrics data from MediaCodec . ( #9766 ).
    • Fix Maven dependency resolution ( #8353 ).
    • Disable automatic speed adjustment for live streams that neither have low-latency features nor a user request setting the speed ( #9329 ).
    • Rename DecoderCounters#inputBufferCount to queuedInputBufferCount .
    • Make SimpleExoPlayer.renderers private. Renderers can be accessed via ExoPlayer.getRenderer .
    • Updated some AnalyticsListener.EventFlags constant values to match values in Player.EventFlags .
    • Split AnalyticsCollector into an interface and default implementation to allow it to be stripped by R8 if an app doesn't need it.
  • Track selection:
    • Support preferred video role flags in track selection ( #9402 ).
    • Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation ( #9519 ).
    • Update video and audio track selection logic to only choose formats for adaptive selections that have the same level of decoder and hardware support ( #9565 ).
    • Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders ( #4835 ).
    • Prefer audio content preferences (for example, the "default" audio track or a track matching the system locale language) over technical track selection constraints (for example, preferred MIME type, or maximum channel count).
    • Fix track selection issue where overriding one track group did not disable other track groups of the same type ( #9675 ).
    • Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly ( #9649 ).
    • Prohibit duplicate TrackGroup s in a TrackGroupArray . TrackGroup s can always be made distinguishable by setting an id in the TrackGroup constructor. This fixes a crash when resuming playback after backgrounding the app with an active track override ( #9718 ).
    • Amend logic in AdaptiveTrackSelection to allow a quality increase under sufficient network bandwidth even if playback is very close to the live edge ( #9784 ).
  • ভিডিও:
    • Fix decoder fallback logic for Dolby Vision to use a compatible H264/H265 decoder if needed.
  • অডিও:
    • Fix decoder fallback logic for Dolby Atmos (E-AC3-JOC) to use a compatible E-AC3 decoder if needed.
    • Change AudioCapabilities APIs to require passing explicitly AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES instead of null .
    • Allow customization of the AudioTrack buffer size calculation by injecting an AudioTrackBufferSizeProvider to DefaultAudioSink . ( #8891 ).
    • Retry AudioTrack creation if the requested buffer size was > 1MB. ( #9712 ).
  • Extractors:
    • WAV: Add support for RF64 streams ( #9543 ).
    • Fix incorrect parsing of H.265 SPS NAL units ( #9719 ).
    • Parse Vorbis Comments (including METADATA_BLOCK_PICTURE ) in Ogg Opus and Ogg Vorbis files.
  • পাঠ্য:
    • Add a MediaItem.SubtitleConfiguration.id field which is propagated to the Format.id field of the subtitle track created from the configuration ( #9673 ).
    • Add basic support for WebVTT subtitles in Matroska containers ( #9886 ).
    • Prevent Cea708Decoder from reading more than the declared size of a service block.
  • DRM:
    • Remove playbackLooper from DrmSessionManager.(pre)acquireSession . When a DrmSessionManager is used by an app in a custom MediaSource , the playbackLooper needs to be passed to DrmSessionManager.setPlayer instead.
  • Ad playback / IMA:
    • Add support for IMA Dynamic Ad Insertion (DAI) ( #8213 ).
    • Add a method to AdPlaybackState to allow resetting an ad group so that it can be played again ( #9615 ).
    • Enforce playback speed of 1.0 during ad playback ( #9018 ).
    • Fix issue where an ad group that failed to load caused an immediate playback reset ( #9929 ).
  • UI:
    • Fix the color of the numbers in StyledPlayerView rewind and fastforward buttons when using certain themes ( #9765 ).
    • Correctly translate playback speed strings ( #9811 ).
  • ড্যাশ:
    • Add parsed essential and supplemental properties to the Representation ( #9579 ).
    • Support the forced-subtitle track role ( #9727 ).
    • Stop interpreting the main track role as C.SELECTION_FLAG_DEFAULT .
    • Fix base URL exclusion logic for manifests that do not declare the DVB namespace ( #9856 ).
    • Support relative MPD.Location URLs ( #9939 ).
  • HLS:
    • Correctly populate Format.label for audio only HLS streams ( #9608 ).
    • Use chunkless preparation by default to improve start up time. If your renditions contain muxed closed-caption tracks that are not declared in the master playlist, you should add them to the master playlist to be available for playback, or turn off chunkless preparation with HlsMediaSource.Factory.setAllowChunklessPreparation(false) .
    • Support key-frame accurate seeking in HLS ( #2882 ).
  • RTSP:
    • Provide a client API to override the SocketFactory used for any server connection ( #9606 ).
    • Prefer DIGEST authentication method over BASIC if both are present ( #9800 ).
    • Handle when RTSP track timing is not available ( #9775 ).
    • Ignore invalid RTP-Info header values ( #9619 ).
  • ট্রান্সফরমার:
    • Increase required min API version to 21.
    • TransformationException is now used to describe errors that occur during a transformation.
    • Add TransformationRequest for specifying the transformation options.
    • Allow multiple listeners to be registered.
    • Fix Transformer being stuck when the codec output is partially read.
    • Fix potential NPE in Transformer.getProgress when releasing the muxer throws.
    • Add a demo app for applying transformations.
  • MediaSession extension:
    • By default, MediaSessionConnector now clears the playlist on stop. Apps that want the playlist to be retained can call setClearMediaItemsOnStop(false) on the connector.
  • Cast extension:
    • Fix bug that prevented CastPlayer from calling onIsPlayingChanged correctly ( #9792 ).
    • Support audio metadata including artwork with DefaultMediaItemConverter ( #9663 ).
  • FFmpeg extension:
    • Make build_ffmpeg.sh depend on LLVM's bin utils instead of GNU's ( #9933 ).
  • Android 12 compatibility:
    • Upgrade the Cast extension to depend on com.google.android.gms:play-services-cast-framework:20.1.0 . Earlier versions of play-services-cast-framework are not compatible with apps targeting Android 12, and will crash with an IllegalArgumentException when creating PendingIntent s ( #9528 ).
  • Remove deprecated symbols:
    • Remove Player.EventListener . Use Player.Listener instead.
    • Remove MediaSourceFactory#setDrmSessionManager , MediaSourceFactory#setDrmHttpDataSourceFactory , and MediaSourceFactory#setDrmUserAgent . Use MediaSourceFactory#setDrmSessionManagerProvider instead.
    • Remove MediaSourceFactory#setStreamKeys . Use MediaItem.Builder#setStreamKeys instead.
    • Remove MediaSourceFactory#createMediaSource(Uri) . Use MediaSourceFactory#createMediaSource(MediaItem) instead.
    • Remove setTag from DashMediaSource , HlsMediaSource and SsMediaSource . Use MediaItem.Builder#setTag instead.
    • Remove DashMediaSource#setLivePresentationDelayMs(long, boolean) . Use MediaItem.Builder#setLiveConfiguration and MediaItem.LiveConfiguration.Builder#setTargetOffsetMs to override the manifest, or DashMediaSource#setFallbackTargetLiveOffsetMs to provide a fallback value.
    • Remove (Simple)ExoPlayer.setThrowsWhenUsingWrongThread . Opting out of the thread enforcement is no longer possible.
    • Remove ActionFile and ActionFileUpgradeUtil . Use ExoPlayer 2.16.1 or before to use ActionFileUpgradeUtil to merge legacy action files into DefaultDownloadIndex .
    • Remove ProgressiveMediaSource#setExtractorsFactory . Use ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) constructor instead.
    • Remove ProgressiveMediaSource.Factory#setTag and, and ProgressiveMediaSource.Factory#setCustomCacheKey . Use MediaItem.Builder#setTag and MediaItem.Builder#setCustomCacheKey instead.
    • Remove DefaultRenderersFactory(Context, @ExtensionRendererMode int) and DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) constructors. Use the DefaultRenderersFactory(Context) constructor, DefaultRenderersFactory#setExtensionRendererMode , and DefaultRenderersFactory#setAllowedVideoJoiningTimeMs instead.
    • Remove all public CronetDataSource constructors. Use CronetDataSource.Factory instead.
  • Change the following IntDefs to @Target(TYPE_USE) only. This may break the compilation of usages in Kotlin, which can be fixed by moving the annotation to annotate the type ( 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 (in com.google.android.exoplayer2.ext.flac package)
    • @FlacExtractor.Flags (in com.google.android.exoplayer2.extractor.flac package)
    • @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

Version 1.0.0-alpha01

27 অক্টোবর, 2021

androidx.media3:media3-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

নতুন বৈশিষ্ট্য

Media3 হল ExoPlayer সহ মিডিয়া সাপোর্ট লাইব্রেরির জন্য নতুন হোম। The first alpha contains early, functional implementations of libraries for implementing media use cases, including:

  • ExoPlayer, an application-level media player for Android that is easy to customize and extend.
  • Media session functionality, for exposing and controlling playbacks. This new session module uses the same Player interface as ExoPlayer.
  • UI components for building media playback user interfaces.
  • Modules wrapping functionality in other libraries for use with ExoPlayer, for example, ad insertion via the IMA SDK.

For more information, see the Media3 GitHub project .

ExoPlayer was previously hosted in a separate ExoPlayer GitHub project . In Media3 its package name is androidx.media3.exoplayer . We plan to continue to maintain and release the ExoPlayer GitHub project for a while to give apps time to migrate to Media3. Media3 has replacements for all the ExoPlayer modules, except for the legacy media2 and mediasession extensions, which are replaced by the new media3-session module. This provides direct integration between players and media sessions without needing to use an adapter/connector class.