این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

رسانه 3

از کتابخانه ها برای موارد استفاده از رسانه پشتیبانی کنید.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
15 مه 2025	1.7.1	-	-	1.8.0-alpha01

اعلام وابستگی ها

برای افزودن یک وابستگی به Media3، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

dependencies {
    def media3_version = "1.6.1"

    // For media playback using ExoPlayer
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // For DASH playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // For HLS playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // For SmoothStreaming playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version"
    // For RTSP playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version"
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation "androidx.media3:media3-exoplayer-midi:$media3_version"
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    // For loading data using the Cronet network stack
    implementation "androidx.media3:media3-datasource-cronet:$media3_version"
    // For loading data using the OkHttp network stack
    implementation "androidx.media3:media3-datasource-okhttp:$media3_version"
    // For loading data using librtmp
    implementation "androidx.media3:media3-datasource-rtmp:$media3_version"

    // For building media playback UIs using Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs using Views
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs using Jetpack Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

    // For exposing and controlling media sessions
    implementation "androidx.media3:media3-session:$media3_version"

    // For extracting data from media containers
    implementation "androidx.media3:media3-extractor:$media3_version"

    // For 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.6.1"

    // For media playback using ExoPlayer
    implementation("androidx.media3:media3-exoplayer:$media3_version")

    // For DASH playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-dash:$media3_version")
    // For HLS playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-hls:$media3_version")
    // For SmoothStreaming playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version")
    // For RTSP playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version")
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation("androidx.media3:media3-exoplayer-midi:$media3_version")
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-ima:$media3_version")

    // For loading data using the Cronet network stack
    implementation("androidx.media3:media3-datasource-cronet:$media3_version")
    // For loading data using the OkHttp network stack
    implementation("androidx.media3:media3-datasource-okhttp:$media3_version")
    // For loading data using librtmp
    implementation("androidx.media3:media3-datasource-rtmp:$media3_version")

    // For building media playback UIs using Compose
    implementation("androidx.media3:media3-ui-compose:$media3_version")
    // For building media playback UIs using Views
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs using Jetpack Compose
    implementation("androidx.media3:media3-ui-compose:$media3_version")
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation("androidx.media3:media3-ui-leanback:$media3_version")

    // For exposing and controlling media sessions
    implementation("androidx.media3:media3-session:$media3_version")

    // For extracting data from media containers
    implementation("androidx.media3:media3-extractor:$media3_version")

    // For 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")
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت مراجعه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. می‌توانید از ردیاب Media3 برای یافتن پاسخ به سؤالات، مسائل شناخته شده و درخواست‌های ویژگی‌ها و پرونده‌سازی مسائل جدید استفاده کنید.

نسخه 1.8.0

نسخه 1.8.0-alpha01

19 مه 2025

androidx.media3:media3-*:1.8.0-alpha01 منتشر شد. نسخه 1.8.0-alpha01 حاوی این تعهدات است.

ExoPlayer:
- روش ExoPlayer.setScrubbingModeEnabled(boolean) را اضافه کنید. این کار پخش کننده را برای بسیاری از جستجوهای مکرر بهینه می کند (مثلاً از زمانی که کاربر یک نوار اسکرابر را به اطراف می کشد). رفتار حالت اسکراب را می توان با setScrubbingModeParameters(..) در ExoPlayer و ExoPlayer.Builder سفارشی کرد.
- اجازه سفارشی کردن تحمل جستجوی کسری را در حالت تمیز کردن بدهید.
- نرخ عملیات کدک را در حالت تمیز کردن افزایش دهید.
- رفع اشکال که در آن خطاهای آماده سازی در محتوای AdsMediaSource ممکن است هرگز گزارش نشود ( #2337 ).
- رفع نشت حافظه در MergingMediaSource ، به عنوان مثال هنگام بارگذاری جانبی زیرنویس استفاده می شود ( #2338 ).
- به CmcdConfiguration.Factory برای غیرفعال کردن گزارش CMCD برای موارد رسانه خاص ( #2386 ) اجازه دهید null را برگرداند.
- اندازه بافر پیش‌فرض تصویر را از 128 کیلوبایت (اشتباه کپی-پیست از تراک‌های متن) به 26 مگابایت افزایش دهید، که برای تصاویر 50 مگاپیکسلی Ultra HDR ( #2417 ) به اندازه کافی بزرگ است.
- PreCacheHelper اضافه کنید که به برنامه‌ها اجازه می‌دهد یک رسانه واحد را با موقعیت شروع و مدت زمان مشخص، از پیش ذخیره کنند.
ترانسفورماتور:
- پر کردن شکاف اولیه (اضافه شده از طریق addGap() ) با صدای بی صدا اکنون نیاز به تنظیم صریح experimentalSetForceAudioTrack(true) در EditedMediaItemSequence.Builder دارد. اگر شکاف در وسط دنباله باشد، پس این پرچم مورد نیاز نیست.
- رابط Muxer از media3-transformer به media3-muxer منتقل کنید.
- تنظیم MediaItem.Builder().setImageDuration(long) را برای وارد کردن یک آیتم رسانه به عنوان تصویر اجباری کنید.
- Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean) را اضافه کنید که شامل یک لیست ویرایش MP4 در هنگام پیرایش است تا به بازیکنان دستور دهد نمونه‌هایی را بین قاب کلید قبل از نقطه شروع برش و نقطه شروع برش نادیده بگیرند.
- برای استفاده از Kotlin و Jetpack Compose، برنامه Composition Demo را به‌روزرسانی کنید و یک VideoCompositorSettings سفارشی اضافه کنید تا دنباله‌ها را در یک طرح‌بندی 2x2 یا PiP مرتب کنید.
استخراج کننده ها:
- MP3: هنگام بازگشت به جستجوی نرخ بیت ثابت به دلیل FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS) ( #2194 ) از مدت زمان و اندازه داده از فراداده های غیرقابل جستجو Xing، VBRI و نرخ بیت متغیر مشابه استفاده کنید.
صوتی:
- در DefaultAudioMixer اجازه می‌دهد تا اختلاط/downmixing با قدرت ثابت وجود داشته باشد.
- ChannelMappingAudioProcessor ، TrimmingAudioProcessor و ToFloatPcmAudioProcessor را عمومی کنید ( #2339 ).
- AudioTrack#getUnderrunCount() در AudioTrackPositionTracker برای تشخیص افت در DefaultAudioSink به جای تخمین بهترین تلاش استفاده کنید.
- برای جابجایی موقعیت غیرمنتظره از دستگاه خروجی صدا، هموارسازی مهر زمانی صدا را بهبود دهید.
- رفع اشکالی که در آن همگام‌سازی A/V برای 10 ثانیه اول پس از از سرگیری توقف موقت هنگام اتصال به دستگاه‌های بلوتوث خراب است.
- رفع اشکالی که AnalyticsListener.onAudioPositionAdvancing زمان شروع پیشرفت صدا را گزارش نمی کرد، بلکه زمان اولین اندازه گیری را گزارش می کرد.
ویدئو:
- API آزمایشی ExoPlayer را برای اضافه کردن پرچم MediaCodec.BUFFER_FLAG_DECODE_ONLY در صف بافرهای ورودی فقط رمزگشایی اضافه کنید. این پرچم به رمزگشا سیگنال می‌دهد تا از بافرهای فقط رمزگشایی صرفنظر کند و در نتیجه جستجوی سریع‌تری را به دنبال داشته باشد. آن را با DefaultRenderersFactory.experimentalSetEnableMediaCodecBufferDecodeOnlyFlag فعال کنید.
- بهبود بررسی عملکرد کدک برای کدک های ویدیویی نرم افزار. این ممکن است منجر به علامت گذاری برخی از تراک های اضافی به عنوان EXCEEDS_CAPABILITIES شود.
- خطاهای پخش VP9 Widevine را در برخی دستگاه ها برطرف کنید ( #2408 ).
متن:
- SSA و SubRip را اصلاح کنید تا هنگام فعال کردن زیرنویس، یک نشانه در حال انجام نمایش داده شود ( #2309 ).
- رفع گیرکردن پخش هنگام جابجایی از یک جریان با خطای زیرنویس به یک پخش زنده با یک آهنگ زیرنویس خالی ( #2328 ).
- هنگام پخش جریان‌های H.262 حاوی B-frames ( #2372 ) زیرنویس‌های آشفته CEA-608 را برطرف کنید.
- پشتیبانی از زیرنویس‌های SSA را با CodecId = S_TEXT/SSA در فایل‌های Matroska اضافه کنید. قبلاً MatroskaExtractor فقط از CodecId = S_TEXT/ASS پشتیبانی می کرد که به معنای نشان دادن نوع پیشرفته (v4+) زیرنویس SubStation Alpha است (اما منطق تجزیه ExoPlayer برای هر دو نوع یکسان است) ( #2384 ).
- پشتیبانی از ویژگی layer را در فایل‌های زیرنویس SubStation Alpha (SSA) اضافه کنید که برای تعریف مرتبه z نشانه‌ها زمانی که بیش از یک به طور همزمان روی صفحه نمایش داده می‌شود استفاده می‌شود ( #2124 ).
اثر:
- Presentation.createForShortSide(int) را اضافه کنید که Presentation ایجاد می‌کند که تضمین می‌کند کوتاه‌ترین طرف همیشه با مقدار داده شده مطابقت دارد، صرف نظر از جهت ورودی.
موکسرها:
- API writeSampleData() اکنون از کلاس BufferInfo خاص muxer به جای MediaCodec.BufferInfo استفاده می کند.
- Muxer.Factory#supportsWritingNegativeTimestampsInEditList را اضافه کنید که پیش‌فرض false است.
پسوند IMA:
- رفع اشکالی که در آن خطای بارگذاری در یک تبلیغ ممکن است به طور تصادفی گروه تبلیغات دیگری را باطل کند.
- رفع اشکال که در آن گروه های تبلیغاتی پس از پایان پنجره VOD بازپخش متوقف می شود. گروه های تبلیغاتی با زمان شروع بعد از پنجره دیگر در صف MediaPeriodQueue قرار نمی گیرند ( #2215 ).
جلسه:
- رفع اشکالی که در آن ارسال null به getLibraryRoot یک MediaBrowser متصل به یک MediaBrowserServiceCompat قدیمی یک NullPointerException ایجاد کرد.
- رفع اشکالی که در آن ارسال کنش‌های سفارشی، نتیجه جستجو یا درخواست getItem برنامه جلسه قدیمی را با یک ClassNotFoundException خراب می‌کند.
- رفع اشکالی که در آن MediaItem.LocalConfiguration.uri در MediaMetadata جلسات پلتفرم به اشتراک گذاشته شده است. برای به اشتراک گذاشتن عمدی یک URI برای اجازه دادن به کنترلرها برای درخواست مجدد رسانه، به جای آن MediaItem.RequestMetadata.mediaUri را تنظیم کنید.
UI:
- رفع یک اشکال نوشتن که منجر به شکاف بین تنظیم حالت های دکمه اولیه و مشاهده تغییر حالت (به عنوان مثال شکل نمادها یا فعال شدن) می شود. هر گونه تغییری که خارج از دوره مشاهده در بازیکن ایجاد شود اکنون برداشت می شود ( #2313 ).
- دارندگان حالت و ترکیب‌پذیرها را به ماژول media3-ui-compose برای SeekBackButtonState و SeekForwardButtonState اضافه کنید.
- پشتیبانی از حالت اسکراب ExoPlayer را به PlayerControlView اضافه کنید. وقتی فعال باشد، وقتی کاربر شروع به کشیدن نوار اسکرابر می‌کند، پخش‌کننده را در حالت تمیز کردن قرار می‌دهد، برای هر حرکت یک player.seekTo فراخوانی صادر می‌کند، و پس از برداشتن لمس از روی صفحه، از حالت تمیز کردن خارج می‌شود. این ادغام را می توان با time_bar_scrubbing_enabled = true در XML یا متد setTimeBarScrubbingEnabled(boolean) از جاوا/Kotlin فعال کرد.
- کاری کنید که PlayerSurface آرگومان Player قابل تهی را بپذیرد.
دانلودها:
- اضافه کردن پشتیبانی دانلود جزئی برای جریان های مترقی. برنامه‌ها می‌توانند یک جریان پیشرونده را با DownloadHelper آماده کنند و با مشخص کردن موقعیت‌های شروع و پایان رسانه مبتنی بر زمان که دانلود باید پوشش دهد، از Helper درخواست DownloadRequest کنند. DownloadRequest برگشتی دارای محدوده بایت حل شده است، که با آن می توان یک ProgressiveDownloader ایجاد کرد و محتوا را به ترتیب دانلود کرد.
- DownloadHelper.Factory اضافه کنید که با آن متدهای استاتیک DownloadHelper.forMediaItem() جایگزین شوند.
- افزودن Factory برای اجرای SegmentDownloader .
- پشتیبانی دانلود جزئی را برای جریان های تطبیقی اضافه کنید. برنامه‌ها می‌توانند یک جریان تطبیقی با DownloadHelper آماده کنند و با مشخص کردن موقعیت‌های شروع و پایان رسانه مبتنی بر زمان که دانلود باید پوشش دهد، از Helper درخواست DownloadRequest کنند. DownloadRequest برگشتی دارای محدوده زمانی حل‌شده است، که با آن می‌توان یک SegmentDownloader مشخص ایجاد کرد و محتوا را به ترتیب دانلود کرد.
پسوند HLS:
- با HlsInterstitialsAdsLoader از X-ASSET-LIST و پخش جریانی زنده پشتیبانی کنید.
پسوند RTSP:
- پشتیبانی تجزیه را برای SessionDescriptions حاوی خطوط با نویسه‌های خالی انتهایی اضافه کنید ( #2357 ).
پسوند بازیگران:
- برای getDeviceVolume() ، setDeviceVolume() ، getDeviceMuted() و setDeviceMuted() ( #2089 ) پشتیبانی اضافه کنید.
ابزارهای آزمایشی:
- transformer.TestUtil.addAudioDecoders(String...) ، transformer.TestUtil.addAudioEncoders(String...) و transformer.TestUtil.addAudioEncoders(ShadowMediaCodec.CodecConfig, String...) حذف شد. به جای آن از ShadowMediaCodecConfig برای پیکربندی رمزگذارها و رمزگشاهای سایه استفاده کنید.
- پیشوند «exotest» با «media3» در نام‌های کدک گزارش‌شده توسط ShadowMediaCodecConfig جایگزین شد.
حذف نمادهای منسوخ شده:
- سازنده SegmentDownloader منسوخ شده SegmentDownloader(MediaItem, Parser<M>, CacheDataSource.Factory, Executor) و سازنده های مربوطه در زیر کلاس های آن DashDownloader ، HlsDownloader و SsDownloader حذف شد.
- Player.hasNext() منسوخ شده، Player.hasNextWindow() حذف شد. به جای آن از Player.hasNextMediaItem() استفاده کنید.
- Player.next() منسوخ شده حذف شد. به جای آن Player.seekToNextMediaItem() استفاده کنید.
- Player.seekToPreviousWindow() . به جای آن Player.seekToPreviousMediaItem() استفاده کنید.
- Player.seekToNextWindow() منسوخ شده حذف شد. به جای آن از Player.seekToNextMediaItem() استفاده کنید.
- BaseAudioProcessor منسوخ شده در ماژول exoplayer حذف شد. از BaseAudioProcessor تحت ماژول common استفاده کنید.
- حذف سازنده MediaCodecVideoRenderer منسوخ شده MediaCodecVideoRenderer(Context, MediaCodecAdapter.Factor, MediaCodecSelector, long, boolean, @Nullable Handler, @Nullable VideoRendererEventListener, int, float, @Nullable VideoSinkProvider) .

نسخه 1.7.0

نسخه 1.7.1

16 مه 2025

این نسخه دارای کد مشابه با 1.6.1 است و برای اطمینان از اینکه به عنوان یک نسخه جدیدتر از نسخه 1.7.0 به نظر می رسد منتشر می شود، که یک نسخه آلفا به طور تصادفی به عنوان پایدار برچسب گذاری شده بود (به زیر مراجعه کنید).

نسخه 1.7.0

16 مه 2025

این نسخه باید 1.7.0-alpha01 می بود، اما به طور تصادفی با 1.7.0 (یعنی پایدار) در maven.google.com برچسب گذاری شد. لطفا از آن استفاده نکنید. در 1.6.1 بمانید یا به 1.7.1 (که همان کد 1.6.1 است) ارتقا دهید.

نسخه 1.6.0

1.6.1

14 آوریل 2025

androidx.media3:media3-*:1.6.1 منتشر شد. نسخه 1.6.1 شامل این commit ها است.

کتابخانه مشترک:
- روش PlaybackParameters.withPitch(float) را اضافه کنید تا به راحتی یک PlaybackParameters با یک مقدار pitch جدید ( #2257 ) کپی کنید.
ExoPlayer:
- مشکلی را که در آن انتقال آیتم رسانه به دلیل خطای رندر قابل بازیابی در حین اولیه سازی آیتم رسانه بعدی ( #2229 ) انجام نمی شود، برطرف کنید.
- مشکلی را برطرف کنید که در آن ProgressiveMediaPeriod یک IllegalStateException ایجاد می کند زیرا PreloadMediaSource تلاش می کند تا getBufferedDurationUs() خود را قبل از آماده شدن فراخوانی کند ( #2315 ).
- ارسال CmcdData در درخواست‌های مانیفست برای DASH، HLS و SmoothStreaming را برطرف کنید ( #2253 ).
- اطمینان حاصل کنید که AdPlaybackState.withAdDurationsUs(long[][]) بعد از حذف گروه های تبلیغاتی قابل استفاده است. کاربر همچنان نیاز به ارسال آرایه ای از مدت زمان برای گروه های تبلیغاتی حذف شده دارد که می تواند خالی یا تهی باشد ( #2267 ).
استخراج کننده ها:
- MP4: alternate_group از کادر tkhd تجزیه کنید و آن را به عنوان ورودی Mp4AlternateGroupData در Format.metadata هر آهنگ نمایش دهید ( #2242 ).
صوتی:
- مشکل تخلیه بار را که در آن موقعیت ممکن است هنگام پخش یک لیست پخش محتوای کوتاه گیر کند، برطرف کنید ( #1920 ).
جلسه:
- زمان جمع‌آوری را برای تماس‌های پلتفرم MediaSession از 500 تا 100 میلی‌ثانیه کاهش دهید و یک تنظیم‌کننده آزمایشی اضافه کنید تا برنامه‌ها بتوانند این مقدار را پیکربندی کنند.
- رفع مشکلی که اعلان‌ها پس از رد شدن توسط کاربر دوباره ظاهر می‌شوند ( #2302 ).
- اشکالی را برطرف کنید که در آن جلسه یک جدول زمانی تک موردی را زمانی که پخش کننده پیچیده شده واقعاً خالی است برمی گرداند. این زمانی اتفاق می‌افتد که پخش‌کننده پیچیده‌شده COMMAND_GET_TIMELINE در دسترس نداشته باشد در حالی که COMMAND_GET_CURRENT_MEDIA_ITEM در دسترس است و پخش‌کننده بسته‌شده خالی است ( #2320 ).
- رفع اشکالی که در آن فراخوانی MediaSessionService.setMediaNotificationProvider پس از سایر تعاملات با سرویس مانند setForegroundServiceTimeoutMs ( #2305 ) بی‌صدا نادیده گرفته می‌شود.
UI:
- PlayerSurface برای کار با ExoPlayer.setVideoEffects و CompositionPlayer فعال کنید.
- رفع اشکال که در آن PlayerSurface نمی تواند با یک Player جدید دوباره ترکیب شود.
پسوند HLS:
- مشکلی را که در آن مدت قطعه در CmcdData برای رسانه HLS تنظیم نشده بود، برطرف کنید، که باعث شکست ادعا در پردازش بخش‌های رسانه رمزگذاری‌شده می‌شود ( #2312 ).
پسوند RTSP:
- پشتیبانی از URI با طرح RTSPT را به عنوان راهی برای پیکربندی جلسه RTSP برای استفاده از TCP اضافه کنید ( #1484 ).
پسوند بازیگران:
- پشتیبانی از فراداده لیست پخش را اضافه کنید ( #2235 ).

1.6.0

26 مارس 2025

androidx.media3:media3-*:1.6.0 منتشر شد. نسخه 1.6.0 شامل این commit ها است.

کتابخانه مشترک:
- AudioManagerCompat و AudioFocusRequestCompat را برای جایگزینی کلاس های معادل در androidx.media اضافه کنید.
- Kotlin را از 1.9.20 به 2.0.20 ارتقا دهید و از افزونه Compose Compiler Gradle استفاده کنید. کتابخانه KotlinX Coroutines را از 1.8.1 به 1.9.0 ارتقا دهید.
- روش Format.toBundle(boolean excludeMetadata) حذف کنید، به جای آن از Format.toBundle() استفاده کنید.
- رفع اشکال در SimpleBasePlayer که در آن تنظیم یک currentMediaItemIndex جدید در State بعد از setPlaylist با MediaMetadata null ، ابرداده را دوباره ارزیابی نمی کند ( #1940 ).
- دسترسی SimpleBasePlayer.State را از محافظت شده به عمومی تغییر دهید تا مدیریت به‌روزرسانی‌ها در کلاس‌های دیگر آسان‌تر شود ( #2128 ).
ExoPlayer:
- اضافه کردن MediaExtractorCompat ، یک کلاس جدید که ویژگی های معادل آن را برای Platform MediaExtractor ارائه می دهد.
- برای پخش با استفاده از MediaCodecVideoRenderer پشتیبانی آزمایشی پیش گرم کردن «ExoPlayer» را اضافه کنید. شما می توانید DefaultRenderersFactory از طریق experimentalSetEnableMediaCodecVideoRendererPrewarming پیکربندی کنید تا یک MediaCodecVideoRenderer ثانویه برای ExoPlayer ارائه دهید. اگر فعال باشد، ExoPlayer ویدیوی موارد رسانه متوالی را در حین پخش از قبل پردازش می کند تا تأخیر انتقال آیتم رسانه را کاهش دهد.
- مقادیر پیش‌فرض bufferForPlaybackMs و bufferForPlaybackAfterRebufferMs را در DefaultLoadControl به ترتیب به 1000 و 2000 میلی‌ثانیه کاهش دهید.
- DeviceInfo و حجم دستگاه را به صورت ناهمزمان راه اندازی کنید (اگر با استفاده از setDeviceVolumeControlEnabled فعال باشد). این مقادیر بلافاصله پس از ExoPlayer.Builder.build() در دسترس نیستند و Player.Listener تغییرات را از طریق onDeviceInfoChanged و onDeviceVolumeChanged اطلاع می دهد.
- شناسه جلسه صوتی اولیه بلافاصله پس از ایجاد پخش کننده دیگر در دسترس نیست. در صورت نیاز می توانید از AnalyticsListener.onAudioSessionIdChanged برای گوش دادن به به روز رسانی اولیه استفاده کنید.
- هنگام انتخاب یک آهنگ ویدیویی، زبان را در نظر بگیرید. به‌طور پیش‌فرض، در صورت موجود بودن، یک آهنگ ویدیویی «اصلی» را انتخاب کنید که با زبان آهنگ صوتی انتخاب‌شده مطابقت داشته باشد. ترجیحات زبان ویدیویی صریح را می توان با TrackSelectionParameters.Builder.setPreferredVideoLanguage(s) بیان کرد.
- پارامتر selectedAudioLanguage را به متد DefaultTrackSelector.selectVideoTrack() اضافه کنید.
- پارامتر retryCount به روش MediaSourceEventListener.onLoadStarted و MediaSourceEventListener.EventDispatcher مربوطه اضافه کنید.
- رفع اشکال که آیتم‌های فهرست پخش یا دوره‌های جریان‌های چند دوره‌ای DASH با مدت‌زمان‌هایی که با محتوای واقعی مطابقت ندارند، می‌توانند باعث توقف فریم در انتهای مورد شوند ( #1698 ).
- BasePreloadManager.Listener به PreloadManagerListener سطح بالا منتقل کنید.
- RenderersFactory.createSecondaryRenderer می توان برای ارائه رندرهای ثانویه برای پیش گرم کردن پیاده سازی کرد. پیش گرم کردن، انتقال سریع‌تر آیتم‌های رسانه را در حین پخش فعال می‌کند.
- ارسال CmcdData برای درخواست‌های مانیفست در قالب‌های جریان تطبیقی DASH، HLS، و SmoothStreaming فعال کنید ( #1951 ).
- MediaCodecInfo کدک را ارائه کنید که در MediaCodecRenderer.onReadyToInitializeCodec ( #1963 ) مقداردهی اولیه می شود.
- AdsMediaSource تغییر دهید تا AdPlaybackStates با افزودن گروه های تبلیغاتی رشد کنند. تغییرات نامعتبر شناسایی می شوند و یک استثنا ایجاد می کنند.
- مشکلی را که ممکن است در هنگام انتقال به رسانه محتوا پس از تبلیغات میان‌پول، به‌سرعت، فریم‌های فقط رمزگشایی اضافی نمایش داده شوند، برطرف کنید.
- DefaultRenderersFactory انتخاب کنید تا دو نمونه MetadataRenderer اضافه کنید تا برنامه‌ها بتوانند به طور پیش‌فرض دو طرح متفاوت از ابرداده را دریافت کنند.
- مجدداً ارزیابی کنید که آیا بارگیری در حال انجام یک قطعه باید با توقف پخش لغو شود ( #1785 ).
- گزینه ای را به ClippingMediaSource اضافه کنید تا امکان برش در رسانه های غیرقابل جستجو فراهم شود.
- رفع اشکال که جستجو با پیش گرم کردن می تواند انتقال آیتم رسانه ای را مسدود کند.
- رفع اشکالی که در آن ExoPlayer.isLoading() true باقی می ماند در حالی که به STATE_IDLE یا STATE_ENDED منتقل شده است ( #2133 ).
- lastRebufferRealtimeMs به LoadControl.Parameter اضافه کنید ( #2113 ).
ترانسفورماتور:
- اضافه کردن پشتیبانی برای transmuxing به فرمت های جایگزین سازگار با عقب.
- پشتیبانی از رمزگذاری و انتقال فرمت Dolby Vision (پروفایل 8) را اضافه کنید.
- پارامترهای VideoFrameProcessor.registerInputStream و VideoFrameProcessor.Listener.onInputStreamRegistered را برای استفاده از Format به روز کنید.
- هنگام استفاده از DefaultEncoderFactory ابرداده استاتیک HDR ایجاد کنید.
- با استفاده از MediaMetricsManager پشتیبانی از تشخیص پلت فرم اندروید را فعال کنید. Transformer رویدادهای ویرایش و داده‌های عملکرد را به پلتفرم ارسال می‌کند، که به ارائه عملکرد سیستم و اطلاعات اشکال‌زدایی در دستگاه کمک می‌کند. اگر کاربر دستگاه به اشتراک گذاری داده های استفاده و تشخیصی را فعال کرده باشد، ممکن است این داده ها نیز توسط Google جمع آوری شود. برنامه‌ها می‌توانند از مشارکت در تشخیص پلتفرم برای Transformer با Transformer.Builder.setUsePlatformDiagnostics(false) انصراف دهند.
- InAppMuxer به InAppMp4Muxer و InAppFragmentedMp4Muxer تقسیم کنید. شما InAppMp4Muxer برای تولید یک فایل MP4 غیرقطعی استفاده می کنید، در حالی که InAppFragmentedMp4Muxer برای تولید یک فایل MP4 تکه تکه شده است.
- رابط Muxer از media3-muxer به media3-transformer منتقل کنید.
- MediaProjectionAssetLoader را اضافه کنید، که رسانه‌ای را از MediaProjection برای ضبط صفحه فراهم می‌کند و پشتیبانی از ضبط صفحه را به برنامه نمایشی Transformer اضافه کنید.
- #getInputFormat() را به رابط Codec اضافه کنید.
- مسئولیت آزادسازی GlObjectsProvider را در صورت امکان در DefaultVideoFrameProcessor و DefaultVideoCompositor بر عهده تماس گیرنده قرار دهید.
استخراج کننده ها:
- AVI: رسیدگی به فایل‌ها را با صدای فشرده‌شده با نرخ بیت ثابت که در آن هدر جریان، تعداد بایت‌ها را به جای تعداد تکه‌ها ذخیره می‌کند، برطرف کنید.
- رسیدگی به واحدهای NAL را با طول های بیان شده در 1 یا 2 بایت (به جای 4) برطرف کنید.
- هنگامی که فهرست ویرایش در یک قاب غیر همگام و بدون قاب همگام قبلی شروع می شود، در لیست های ویرایش MP4 ArrayIndexOutOfBoundsException برطرف کنید ( #2062 ).
- مشکلی را که در آن جریان‌های TS در برخی دستگاه‌ها گیر می‌کنند، برطرف کنید ( #2069 ).
- FLAC: پشتیبانی از فایل های FLAC 32 بیتی را اضافه کنید. قبلاً اینها نمی توانستند با IllegalStateException: Playback stuck buffering and not loading ( #2197 ).
صوتی:
- onAudioPositionAdvancing رفع کنید تا هنگام ازسرگیری پخش فراخوانی شود (قبلاً زمانی که پخش متوقف می شد، فراخوانی می شد).
- هنگامی که SpeedChangingAudioProcessor با پارامترهای پیش فرض پیکربندی شده است، از SonicAudioProcessor عبور نکنید.
- رفع underflow در Sonic#getOutputSize() که می تواند باعث توقف DefaultAudioSink شود.
- MediaCodecAudioRenderer.getDurationToProgressUs() و DecoderAudioRenderer.getDurationToProgressUs() را برطرف کنید تا به دنبال بازنشانی صحیح مدت زمان ارائه شده باشد.
- androidx.media3.common.audio.SonicAudioProcessor را نهایی کنید.
- پشتیبانی از float PCM را به ChannelMappingAudioProcessor و TrimmingAudioProcessor اضافه کنید.
ویدئو:
- MediaCodecVideoRenderer.shouldUsePlaceholderSurface را به محافظت شده تغییر دهید تا برنامه ها بتوانند استفاده از سطوح نگهدارنده مکان را مسدود کنند ( #1905 ).
- برای سرعت بخشیدن به جستجو، تجزیه وابستگی نمونه آزمایشی ExoPlayer AV1 را اضافه کنید. آن را با DefaultRenderersFactory.experimentalSetParseAv1SampleDependencies API جدید فعال کنید.
- API آزمایشی ExoPlayer اضافه کنید تا بافرهای ورودی رمزگشای دیررس MediaCodecVideoRenderer را که به آنها وابسته نیستند، حذف کنید. آن را با DefaultRenderersFactory.experimentalSetLateThresholdToDropDecoderInputUs فعال کنید.
- مشکلی را که در آن بازیکن بدون سطح آماده بود بلافاصله و رمزگشایی بسیار کند فریم های معلق را برطرف کنید ( #1973 ).
- دستگاه های شیائومی و OPPO را از حالت سطح جدا شده حذف کنید تا از لرزش صفحه جلوگیری شود ( #2059 ).
متن:
- پشتیبانی از زیرنویس‌های VobSub ( #8260 ) را اضافه کنید.
- بارگیری تمام فایل‌های زیرنویس پیکربندی شده با MediaItem.Builder.setSubtitleConfigurations را مشتاقانه متوقف کنید و در عوض فقط یکی را در صورتی بارگیری کنید که با انتخاب آهنگ انتخاب شده باشد ( #1721 ).
- TTML: برای ارجاع به tts:origin و tts:extent با استفاده از style پشتیبانی اضافه کنید ( #2953 ).
- مهرهای زمانی WebVTT و SubRip را دقیقاً به 3 رقم اعشار محدود کنید. قبلاً هر تعداد رقم اعشار را به اشتباه تجزیه می‌کردیم، اما همیشه مقدار را بر حسب میلی‌ثانیه فرض می‌کردیم که منجر به مهرهای زمانی نادرست می‌شد ( #1997 ).
- هنگامی که فهرست پخش حاوی موارد بریده شده با زیرنویس CEA-608 یا CEA-708 است، هنگ کردن پخش را برطرف کنید.
- هنگامی که یک فایل SSA حاوی نشانه ای با مدت زمان صفر (زمان شروع و پایان برابر است) IllegalStateException برطرف کنید ( #2052 ).
- وقتی زیرنویس‌ها در همان محفظه‌ای که صدا و ویدیو قرار می‌گیرند، خطاهای تجزیه زیرنویس را سرکوب کنید (و ثبت کنید) ( #2052 ).
- مدیریت کاراکترهای چند بایتی UTF-8 را در فایل‌های WebVTT با استفاده از انتهای خط CR ( #2167 ) برطرف کنید.
DRM:
- رفع MediaCodec$CryptoException: Operation not supported in this configuration هنگام پخش محتوای ClearKey در API < 27 دستگاه ( #1732 ) پشتیبانی نمی‌شود.
اثر:
- عملکرد OverlaySettings را به StaticOverlaySettings منتقل کرد. OverlaySettings می توان به صورت زیر طبقه بندی کرد تا تنظیمات همپوشانی پویا امکان پذیر باشد.
موکسرها:
- MuxerException از رابط Muxer خارج کرد تا از نام بسیار طولانی و کاملا واجد شرایط جلوگیری شود.
- متد setSampleCopyEnabled() به setSampleCopyingEnabled() در هر دو Mp4Muxer.Builder و FragmentedMp4Muxer.Builder تغییر نام داد.
- Mp4Muxer.addTrack() و FragmentedMp4Muxer.addTrack() اکنون به جای TrackToken یک شناسه آهنگ int برمی گردانند.
- Mp4Muxer و FragmentedMp4Muxer دیگر رابط Muxer پیاده سازی نمی کنند.
- به طور پیش فرض دسته بندی و کپی نمونه Mp4Muxer را غیرفعال کنید.
- رفع یک اشکال در FragmentedMp4Muxer که در هنگام نوشتن تنها آهنگ صوتی، قطعات زیادی ایجاد می کند.
جلسه:
- هنگامی که پخش متوقف می شود، متوقف می شود یا با شکست مواجه می شود، وضعیت سرویس پیش زمینه را برای 10 دقیقه دیگر نگه دارید. این به کاربران اجازه می‌دهد تا در این بازه زمانی بدون خطر محدودیت‌های خدمات پیش‌زمینه در دستگاه‌های مختلف، پخش را از سر بگیرند. توجه داشته باشید که فقط فراخوانی player.pause() دیگر نمی تواند برای متوقف کردن سرویس پیش زمینه قبل از stopSelf() در هنگام لغو onTaskRemoved استفاده شود، به جای آن MediaSessionService.pauseAllPlayersAndStopSelf() استفاده کنید.
- هنگامی که پخش وارد حالت خطا یا توقف می شود، اعلان را قابل مشاهده نگه دارید. اعلان فقط در صورتی حذف می شود که لیست پخش پاک شود یا پخش کننده آزاد شود.
- مدیریت عملکردهای MediaSession ACTION_PLAY و ACTION_PAUSE پلتفرم Android را بهبود ببخشید تا فقط یکی از آنها را مطابق دستورات موجود تنظیم کنید و همچنین اگر فقط یکی از آنها تنظیم شده باشد، بپذیرید.
- Context به عنوان پارامتر به MediaButtonReceiver.shouldStartForegroundService اضافه کنید ( #1887 ).
- رفع اشکالی که در آن فراخوانی یک متد Player در MediaController متصل به جلسه قدیمی باعث حذف تغییرات از یک به‌روزرسانی معلق می‌شود.
- MediaSession.setSessionActivity(PendingIntent) را باطل کنید ( #2109 ).
- رفع اشکال که در آن یک اعلان قدیمی در هنگام پاک شدن لیست پخش قابل مشاهده است ( #2211 ).
UI:
- دارندگان حالت و ترکیب‌کننده‌ها را به ماژول media3-ui-compose برای PlayerSurface ، PresentationState ، PlayPauseButtonState ، NextButtonState ، PreviousButtonState ، RepeatButtonState ، ShuffleButtonState و PlaybackSpeedState اضافه کنید.
دانلودها:
- رفع اشکال در CacheWriter که منابع داده را باز می‌گذارد و مناطق کش را قفل می‌کند در صورتی که منبع داده Exception غیر از IOException ( #9760 ) ایجاد کند.
پسوند HLS:
- اولین نسخه HlsInterstitialsAdsLoader را اضافه کنید. بارکننده تبلیغات، میان‌اثرهای HLS یک فهرست پخش رسانه HLS را می‌خواند و آنها را به AdPlaybackState که به AdsMediaSource ارسال می‌شود، نگاشت می‌کند. این نسخه اولیه فقط از جریان های VOD HLS با ویژگی های X-ASSET-URI پشتیبانی می کند.
- اضافه کردن HlsInterstitialsAdsLoader.AdsMediaSourceFactory . برنامه‌ها می‌توانند از آن برای ایجاد نمونه‌های AdsMediaSource استفاده کنند که از HlsInterstitialsAdsLoader به روشی راحت و ایمن استفاده می‌کنند.
- تگ SUPPLEMENTAL-CODECS را از لیست پخش HLS برای شناسایی قالب‌های Dolby Vision ( #1785 ) تجزیه کنید.
- شرایط جستجو برای همگام‌سازی موقعیت‌ها در یک جریان HLS را شل کنید ( #2209 ).
پسوند DASH:
- پشتیبانی از فرمت AC-4 Level-4 برای DASH ( #1898 ) را اضافه کنید.
- مشکل را هنگام محاسبه فاصله به‌روزرسانی برای درج آگهی در پخش‌های زنده چند دوره ای برطرف کنید ( #1698 ).
- ویژگی scte214:supplementalCodecs را از مانیفست DASH برای شناسایی قالب‌های Dolby Vision ( #1785 ) تجزیه کنید.
- مدیریت انتقال دوره را در جریان‌های زنده که در آن دوره حاوی نمونه‌های رسانه فراتر از مدت زمان اعلام شده ( #1698 ) است، بهبود دهید.
- مشکل را برطرف کنید که در آن مجموعه‌های انطباق علامت‌گذاری شده با adaptation-set-switching ، اما زبان‌های مختلف یا پرچم‌های نقش با هم ادغام شده‌اند ( #2222 ).
پسوندهای رمزگشا (FFmpeg، VP9، AV1 و غیره):
- ماژول رمزگشای MPEG-H را اضافه کنید که از رمزگشای داخلی MPEG-H برای رمزگشایی صدای MPEG-H استفاده می کند ( #1826 ).
پسوند MIDI:
- نمونه های AudioSink و AudioRendererEventListener سفارشی را به MidiRenderer وارد کنید.
پسوند بازیگران:
- وابستگی play-services-cast-framework را به 21.5.0 برسانید تا خرابی FLAG_MUTABLE در برنامه‌هایی که API 34+ را هدف قرار می‌دهند در دستگاه‌هایی که سرویس‌های Google Play نصب شده اما غیرفعال هستند برطرف شود ( #2178 ).
برنامه دمو:
- demo-compose با دکمه‌های اضافی گسترش دهید و ادغام PlayerSurface با پشتیبانی از مقیاس‌بندی و شاتر افزایش دهید.
حذف نمادهای منسوخ شده:
- روش منسوخ AudioMixer.create() را حذف کنید. به جای آن DefaultAudioMixer.Factory().create() استفاده کنید.
- متدهای منسوخ Transformer.Builder زیر را حذف کنید:
  - setTransformationRequest() ، از setAudioMimeType() ، setVideoMimeType() و setHdrMode() استفاده کنید.
  - setAudioProcessors() ، پردازنده صوتی را در EditedMediaItem.Builder.setEffects() تنظیم کنید و به جای آن به Transformer.start() ارسال کنید.
  - setVideoEffects() ، جلوه ویدیویی را در EditedMediaItem.Builder.setEffects() تنظیم کنید و به جای آن به Transformer.start() ارسال کنید.
  - setRemoveAudio() ، از EditedMediaItem.Builder.setRemoveAudio() استفاده کنید تا صدا را از EditedMediaItem که به Transformer.start() ارسال شده است حذف کنید.
  - setRemoveVideo() ، از EditedMediaItem.Builder.setRemoveVideo() استفاده کنید تا ویدیو را از EditedMediaItem که به Transformer.start() ارسال شده است حذف کنید.
  - setFlattenForSlowMotion() ، از EditedMediaItem.Builder.setFlattenForSlowMotion() استفاده کنید تا EditedMediaItem را که به Transformer.start() منتقل شده است صاف کنید.
  - setListener() ، از addListener() ، removeListener() یا removeAllListeners() استفاده کنید.
- متدهای منسوخ Transformer.Listener زیر را حذف کنید:
  - onTransformationCompleted(MediaItem) ، به جای آن onCompleted(Composition, ExportResult) استفاده کنید.
  - onTransformationCompleted(MediaItem, TransformationResult) ، به جای آن onCompleted(Composition, ExportResult) استفاده کنید.
  - onTransformationError(MediaItem, Exception) ، به جای آن onError(Composition, ExportResult, ExportException) استفاده کنید.
  - onTransformationError(MediaItem, TransformationException) ، به جای آن onError(Composition, ExportResult, ExportException) استفاده کنید.
  - onTransformationError(MediaItem, TransformationResult, TransformationException) ، به جای آن onError(Composition, ExportResult, ExportException) استفاده کنید.
  - onFallbackApplied(MediaItem, TransformationRequest, TransformationRequest) ، به جای آن onFallbackApplied(Composition, TransformationRequest, TransformationRequest) استفاده کنید.
- کلاس منسوخ شده TransformationResult حذف کنید. به جای آن از ExportResult استفاده کنید.
- کلاس منسوخ شده TransformationException حذف کنید. به جای آن از ExportException استفاده کنید.
- Transformer.PROGRESS_STATE_NO_TRANSFORMATION منسوخ شده را حذف کنید.PROGRESS_STATE_NO_TRANSFORMATION. به جای آن از Transformer.PROGRESS_STATE_NOT_STARTED استفاده کنید.
- Transformer.setListener() منسوخ شده را حذف کنید. به جای آن از Transformer.addListener() ، Transformer.removeListener() یا Transformer.removeAllListeners() استفاده کنید.
- Transformer.startTransformation() منسوخ شده را حذف کنید. به جای آن از Transformer.start(MediaItem, String) استفاده کنید.
- SingleFrameGlShaderProgram منسوخ شده را حذف کنید. به جای آن از BaseGlShaderProgram استفاده کنید.
- Transformer.flattenForSlowMotion را حذف کنید. به جای آن از EditedMediaItem.flattenForSlowMotion استفاده کنید.
- حذف شده ExoPlayer.VideoComponent ، ExoPlayer.AudioComponent ، ExoPlayer.TextComponent و ExoPlayer.DeviceComponent .
- androidx.media3.exoplayer.audio.SonicAudioProcessor حذف شد.
- متدهای منسوخ شده DownloadHelper زیر را حذف کرد:
  - Constructor DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilities[]) ، به جای آن از DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilitiesList) استفاده کنید.
  - getRendererCapabilities(RenderersFactory) ، عملکردی معادل را می توان با ایجاد یک DefaultRendererCapabilitiesList با RenderersFactory و فراخوانی DefaultRendererCapabilitiesList.getRendererCapabilities() به دست آورد.
- روش PlayerNotificationManager.setMediaSessionToken(MediaSessionCompat) حذف شد. از PlayerNotificationManager.setMediaSessionToken(MediaSession.Token) استفاده کنید و به جای آن (MediaSession.Token) compatToken.getToken() ارسال کنید.

1.6.0-rc02

19 مارس 2025

از نسخه پایدار 1.6.0 استفاده کنید.

1.6.0-rc01

12 مارس 2025

از نسخه پایدار 1.6.0 استفاده کنید.

1.6.0-beta01

26 فوریه 2025

از نسخه پایدار 1.6.0 استفاده کنید.

نسخه 1.6.0-alpha03

06 فوریه 2025

از نسخه پایدار 1.6.0 استفاده کنید.

نسخه 1.6.0-alpha02

30 ژانویه 2025

از نسخه پایدار 1.6.0 استفاده کنید.

نسخه 1.6.0-alpha01

20 دسامبر 2024

از نسخه پایدار 1.6.0 استفاده کنید.

نسخه 1.5

نسخه 1.5.1

19 دسامبر 2024

androidx.media3:media3-*:1.5.1 منتشر شد. نسخه 1.5.1 شامل این commit ها است.

ExoPlayer:
- استفاده از رمزگشایی ناهمزمان را در MediaCodec غیرفعال کنید تا از مشکلات گزارش‌شده مهلت زمانی کدک با این API پلت فرم ( #1641 ) جلوگیری کنید.
استخراج کننده ها:
- MP3: هنگامی که فهرست محتویات یک فریم VBRI تمام داده های MP3 را در یک فایل پوشش نمی دهد، پخش را زود متوقف نکنید ( #1904 ).
ویدئو:
- بازگشت استفاده از MediaCodecAdapter در هنگام پردازش onOutputFormatChanged ( #1371 ) مقادیر نسبت ابعاد پیکسل را ارائه کرد.
متن:
- رفع اشکال در ReplacingCuesResolver.discardCuesBeforeTimeUs که در آن نشانه فعال در timeUs (قبل از شروع اما هنوز به پایان نرسیده) به اشتباه نادیده گرفته شده است ( #1939 ).
فراداده:
- شماره گذاری دیسک/تراک و ژانر را از نظرات Vorbis در MediaMetadata ( #1958 ) استخراج کنید.

نسخه 1.5.0

27 نوامبر 2024

androidx.media3:media3-*:1.5.0 منتشر شد. نسخه 1.5.0 شامل این commit ها است.

کتابخانه مشترک:
- ForwardingSimpleBasePlayer اضافه کنید که به بازیکن دیگری با تنظیمات کوچک امکان حمل و نقل را می دهد و در عین حال از سازگاری کامل و کنترل شنونده اطمینان حاصل می کند ( #1183 ).
- SimpleBasePlayer.State.playlist با متد getPlaylist() جایگزین کنید.
- برای SimpleBasePlayer.State.Builder.setPlaylist() override اضافه کنید تا به‌جای ساختن ساختار لیست پخش، مستقیماً Timeline و Tracks و Metadata فعلی را مشخص کنید.
- minSdk به 21 (Android Lollipop) افزایش دهید. این با سایر کتابخانه‌های AndroidX هماهنگ است.
- افزودن androidx.media3:media3-common-ktx artifact که عملکردهای مخصوص Kotlin را که در بالای کتابخانه مشترک ساخته شده است، ارائه می دهد.
- تابع افزونه تعلیق Player.listen برای چرخاندن یک برنامه برای گوش دادن به Player.Events به کتابخانه media3-common-ktx اضافه کنید.
- حاشیه‌نویسی‌های @DoNotInline را از کلاس‌های داخلی خارج از خط دستی که برای جلوگیری از خرابی تأیید کلاس در زمان اجرا طراحی شده‌اند، حذف کنید. نسخه‌های اخیر R8 اکنون به‌طور خودکار خارج از خط مانند اینها تماس می‌گیرد تا از خرابی‌های زمان اجرا جلوگیری شود (بنابراین دیگر نیازی به خارج کردن خط دستی نیست). همه کاربران Gradle کتابخانه باید قبلاً یک نسخه استفاده کننده از پلاگین Gradle Android باشند که از نسخه R8 استفاده می کند که این کار را انجام می دهد، به دلیل compileSdk = 35 . کاربران کتابخانه با سیستم‌های ساخت غیر Gradle باید اطمینان حاصل کنند که مرحله کوچک کردن/مبهم‌سازی معادل R8 آن‌ها یک فرآیند خودکار خارج از خط را انجام می‌دهد تا از خرابی تأیید کلاس در زمان اجرا جلوگیری کنند. این تغییر قبلاً در سایر کتابخانه های AndroidX انجام شده است .
ExoPlayer:
- اکنون 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() را اضافه کنید.
- MediaCodec.CryptoException را ثابت کنید که گاهی اوقات به عنوان "خطای زمان اجرا غیر منتظره" گزارش می شود که MediaCodec در حالت ناهمزمان عمل می کند (رفتار پیش فرض در API 31+).
- Pass bufferedDurationUs به جای bufferedPositionUs با PreloadMediaSource.PreloadControl.onContinueLoadingRequested() عبور دهید. همچنین DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS به DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS تغییر می دهد ، برنامه ها پس از آن باید یک مقدار را نشان دهند که یک مدت زمان خاص را از موقعیت شروع پیش فرض که برای آن منبع رسانه مربوطه باید با این intdef از قبل بارگذاری شود ، به جای یک موقعیت.
- اجرای ForwardingRenderer اضافه کنید که تمام روش های فراخوانی را به یک رندر دیگر ( 1703 ) منتقل می کند.
- لیست پخش را برای مورد بعدی در لیست پخش اضافه کنید. برنامه ها می توانند با فراخوانی ExoPlayer.setPreloadConfiguration(PreloadConfiguration) از پیش بارگذاری را فعال کنند. به طور پیش فرض از پیش بارگیری غیرفعال است. هنگام انتخاب و عدم دخالت در پخش ، DefaultLoadControl از پیش بارگذاری برای شروع و ادامه کار فقط در صورت بارگیری بازیکن برای پخش استفاده می کند. برنامه ها می توانند این رفتار را با اجرای LoadControl.shouldContinuePreloading() بر این اساس تغییر دهند (مانند هنگام غلبه بر این روش در DefaultLoadControl ). اجرای پیش فرض LoadControl در صورت استفاده از یک برنامه از اجرای سفارشی LoadControl ، پیش بارگذاری را غیرفعال می کند.
- روش اضافه کردن MediaSourceEventListener.EventDispatcher.dispatchEvent() را اضافه کنید تا امکان فراخوانی رویدادهای شنوندگان زیر کلاس ( 1736 ) فراهم شود.
- DefaultPreloadManager.Builder را اضافه کنید که موارد DefaultPreloadManager و ExoPlayer را با تنظیمات به طور مداوم مشترک ایجاد می کند.
- پارامتر Renderer[] از LoadControl.onTracksSelected() حذف کنید زیرا اجرای DefaultLoadControl می تواند انواع جریان را از ExoTrackSelection[] .
- deprecated DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) و روش مشخص شده به عنوان نهایی برای جلوگیری از غلبه. به جای آن باید از DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) استفاده شود.
- گزارش MediaSourceEventListener از منابع ثانویه در MergingMediaSource . این امر منجر به شروع/خطا/وقایع لغو/تکمیل شده برای زیرنویس های جانبی (موارد اضافه شده با MediaItem.LocalConfiguration.subtitleConfigurations ) می شود ، که ممکن است به عنوان رویدادهای بار کپی منتشر شده از AnalyticsListener ظاهر شود.
- جلوگیری از خطاهای زیرنویس و ابرداده از متوقف کردن پخش کامل. در عوض ، آهنگ مشکل ساز غیرفعال است و پخش آهنگ های باقی مانده ادامه می یابد ( شماره 1722 ).
  - در رسیدگی به زیرنویس جدید (در حین استخراج) ، پارس مرتبط (به عنوان مثال داده های زیرنویس نامعتبر) و خطاهای بار (به عنوان مثال HTTP 404) از طریق تماس های onLoadError منتشر می شود.
  - در رسیدگی به زیرنویس میراث (در حین ارائه) ، فقط خطاهای بار مرتبط از طریق تماس های onLoadError منتشر می شود در حالی که خطاهای تجزیه شده در سکوت نادیده گرفته می شوند (این رفتار از قبل موجود است).
- رفع اشکال در جایی که موارد لیست پخش یا دوره های موجود در جریان های چند دوره ای با مدت زمان هایی که با محتوای واقعی مطابقت ندارند می تواند باعث انجماد قاب در انتهای مورد شود ( #1698 ).
- یک تنظیم کننده را به SntpClient اضافه کنید تا حداکثر زمان سپری شده را از آخرین بروزرسانی تنظیم کنید و پس از آن مشتری مجدداً شروع شود ( شماره 1794 ).
ترانسفورماتور:
- SurfaceAssetLoader را اضافه کنید ، که از داده های ویدیوی صف پشتیبانی از طریق یک Surface پشتیبانی می کند.
- ImageAssetLoader به جای پرتاب یک IllegalStateException ورودی پشتیبانی نشده را از طریق AssetLoader.onError گزارش می دهد.
- تنظیم مدت زمان تصویر را با استفاده از MediaItem.Builder.setImageDurationMs برای صادرات تصویر اجباری کنید.
- پشتیبانی از صادرات را برای شکاف ها در توالی ویرایش های صوتی اضافه کنید.
انتخاب آهنگ:
- DefaultTrackSelector : وقتی سایر عوامل برابر هستند ، صدای مبتنی بر شی را از صوتی مبتنی بر کانال ترجیح می دهید.
استخراج کننده ها:
- به Mp4Extractor و FragmentedMp4Extractor اجازه دهید تا نمونه های H264 را که توسط نمونه های بعدی به عنوان مرجع استفاده نمی شوند ، شناسایی کنند.
- Add option to enable index-based seeking in AmrExtractor .
- فایلهای MP3 را با بیش از 128 کیلوبایت بین قاب های معتبر به صورت کوتاه (به جای نامعتبر) درمان کنید. این بدان معنی است که پرونده هایی با داده های غیر MP3 در پایان ، بدون ابرداده دیگر برای نشان دادن طول بایت های MP3 ، اکنون به جای عدم موفقیت با ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1}
- هنگام پردازش لیست های ویرایش در پرونده های MP4 ( #1659 ) ، استفاده از نمونه preroll را برای رسانه های غیر keyframe شروع کنید (شماره 1659).
- محاسبه نرخ فریم بهبود یافته با استفاده از مدت زمان رسانه از جعبه mdhd در Mp4Extractor و FragmentedMp4Extractor ( #1531 ).
- مقیاس نادرست media_time را در لیست های ویرایش MP4 برطرف کنید. در حالی که segment_duration قبلاً با استفاده از بازه زمانی فیلم به درستی مقیاس بندی شده بود ، اکنون media_time با استفاده از Track Timescale به درستی مقیاس بندی شده است ، همانطور که توسط استاندارد قالب MP4 ( #1792 ) مشخص شده است.
- قاب های خارج از سفارش را در محاسبه endIndices برای MP4 با لیست ویرایش ( شماره 1797 ) انجام دهید.
- تجزیه و تحلیل مدت زمان رسانه در جعبه mdhd از پرونده های MP4 برای رسیدگی به مقادیر -1 ( #1819 ).
- برای شناسایی کادر h263 در پرونده های MP4 برای ویدیوی H.263 ( #1821 ) پشتیبانی اضافه کنید.
- پشتیبانی از فرمت فایل رسانه ای پایه ISO AC-4 سطح 4 ISO ( #1265 ) را اضافه کنید.
منبع داده:
- HttpEngineDataSource به روز کنید تا به جای API سطح 34 ( #1262 ) از نسخه S برنامه 7 استفاده کنید.
- DataSourceContractTest : ادعا کنید که DataSource.getUri() URI حل شده (طبق مستند) را برمی گرداند. در جایی که این با URI درخواستی متفاوت است ، آزمایشات می توانند این موضوع را با استفاده از روش جدید DataSourceContractTest.TestResource.Builder.setResolvedUri() نشان دهند.
- DataSourceContractTest : ادعا کنید که DataSource.getUri() و getResponseHeaders() مقدار "باز" خود را پس از یک تماس ناموفق برای open() (به دلیل یک منبع "یافت نشده" و قبل از تماس close() باز می گردانند.
  - مهمترین DataSourceContractTest.getNotFoundResources() به زیر کلاسهای آزمایش اجازه می دهد تا چندین منبع "یافت نشده" را ارائه دهند و هر هدست مورد انتظار را نیز فراهم کنند. این اجازه می دهد تا بین HTTP 404 (با هدر) و "سرور یافت نشد" (بدون هدر) تمایز قائل شود.
صوتی:
- در صورت وجود در رسانه ، به طور خودکار ابرداده بلندی CTA-2075 را بر روی کدک پیکربندی کنید.
- در هنگام جستجوی ، از سطح صاف و صاف برخورد کنید.
- صداهای پاپ را که ممکن است در حین جستجوی رخ دهد ، برطرف کنید.
- تجمع خطای کوتاه را برای الگوریتم کشش/تغییر زمان Sonic رفع کنید.
- رفع اشکال در SpeedChangingAudioProcessor که باعث ایجاد فریم های خروجی شده است ، برطرف کنید.
ویدئو:
- MediaCodecVideoRenderer از رمزگشایی نمونه هایی که نه ارائه می شوند و نه به عنوان مرجع توسط نمونه های دیگر استفاده می شود ، جلوگیری می کند.
- در API 35 و بالاتر ، MediaCodecAdapter اکنون ممکن است یک Surface null را در configure دریافت کند و به یک روش جدید detachOutputSurface فراخوانی می کند تا اگر کدک از این پشتیبانی کند ، Surface تنظیم شده قبلی را حذف کند ( MediaCodecInfo.detachedSurfaceSupported ).
- در صورت ارائه پردازش MediaCodecAdapter ( #1371 ) onOutputFormatChanged مقادیر نسبت ابعاد پیکسل استفاده کنید.
- راه حل را برای مسئله دستگاه در Galaxy Tab S7 Fe اضافه کنید که باعث می شود جریان های امن H264 60fps به عنوان پشتیبانی نشده مشخص شوند ( شماره 1619 ).
- برای کدک هایی که بعد از آخرین نمونه گیر می شوند بدون بازگشت سیگنال انتهای جریان ، راه حل اضافه کنید.
متن:
- یک VoiceSpan سفارشی اضافه کنید و آن را برای دهانه های صوتی WebVTT ( شماره 1632 ) جمع کنید.
- اطمینان حاصل کنید که WebVTT در HLS با جدول زمانی زیرنویس بسیار بزرگ (که در هنگام نمایش به عنوان میکرو ثانیه و ضرب و شتم 90,000 MPEG) نمایش داده می شود ( #1763 ) long 64 بیتی را سرریز می کند.
- زیرنویس CEA-608 را در محتوای Dolby Vision ( شماره 1820 ) پشتیبانی کنید.
- هنگامی که زیرنویس های CEA-608 فعال هستند ، پخش را روی جریان های چند دوره ای داش حل کنید ( #1863 ).
فراداده:
- نوع C.TRACK_TYPE_METADATA به آهنگ های حاوی محتوای یخی یا vnd.dvb.ait اختصاص دهید.
تصویر:
- برای ادغام ساده شده با کتابخانه های بارگیری تصویر خارجی مانند Glide یا Coil ، ExternallyLoadedImageDecoder اضافه کنید.
منبع داده:
- اضافه کردن FileDescriptorDataSource ، یک DataSource جدید که می تواند برای خواندن از یک FileDescriptor ( #3757 ) استفاده شود.
اثر:
- برای مقیاس بندی جزئی SurfaceTexture راه حل DefaultVideoFrameProcessor اضافه کنید. SurfaceTexture ممکن است شامل یک مقیاس کوچک باشد که یک مرز 1-Texel را در حاشیه یک بافر خرد شده قطع می کند. این اکنون به گونه ای اداره می شود که خروجی به انتظار نزدیکتر است.
- سرعت بخش DefaultVideoFrameProcessor.queueInputBitmap() . در نتیجه ، صادرات تصاویر به فیلم ها با Transformer سریعتر است.
پسوند IMA:
- رفع اشکال در جایی که پاکسازی لیست پخش ممکن است باعث ایجاد ArrayIndexOutOfBoundsException ImaServerSideAdInsertionMediaSource شود.
- اشکال را برطرف کنید که در آن سرور جریان های DAI را بدون یک پیشرو درج کرده است ، می تواند هنگام بازی گذشته از آخرین میانی ( شماره 1741 ) به یک ArrayIndexOutOfBoundsException منجر شود.
جلسه:
- اضافه کردن MediaButtonReceiver.shouldStartForegroundService(Intent) برای اجازه دادن به برنامه ها برای سرکوب یک دستور بازی که برای بازپرداخت پخش با غلبه بر این روش وارد می شود. به طور پیش فرض ، این سرویس همیشه شروع می شود و پخش نمی تواند سرکوب شود بدون اینکه سیستم با استفاده از ForegroundServiceDidNotStartInTimeException خدمات با پیش زمینه ، SINTIDNOTSTARTINTimeException ( شماره 1528 ) را خراب کند.
- رفع اشکال که باعث شده دستورات سفارشی ارسال شده از یک MediaBrowser ارسال شده به MediaSessionCompat.Callback به جای نوع MediaBrowserServiceCompat در هنگام اتصال به یک سرویس میراث. این امر مانع از دریافت MediaBrowser می شود که ارزش واقعی بازگشت ارسال شده توسط سرویس Legacy ( شماره 1474 ) را دریافت کند.
- هنگام تنظیم گیرنده پخش برای اهداف دکمه رسانه ( شماره 1730 ) توسط دستگاه های برخی از تولید کنندگان توسط دستگاه های خاص تولید کنندگان IllegalArgumentException شود (شماره 1730).
- دکمه های فرمان را برای موارد رسانه ای اضافه کنید. این امر API Media3 را برای آنچه به عنوان Custom browse actions با کتابخانه میراث با MediaBrowserCompat شناخته می شد ، اضافه می کند. توجه داشته باشید که با دکمه های فرمان Media3 برای موارد رسانه ای برای هر دو ، MediaBrowser و MediaController در دسترس است. به اقدامات سفارشی AAOS مراجعه کنید.
- رفع اشکال در جایی که یک کنترلر Media3 گاهی اوقات قادر به اجازه دادن به یک برنامه جلسه پس از درخواست play() نیست.
- CommandButton.Builder.setIconUri را فقط به پذیرش URI های محتوا محدود کنید.
- نکات اتصال از یک مرورگر Media3 به MediaBrowserCompat اولیه هنگام اتصال به یک MediaBrowserCompat Legacy. این سرویس می تواند نکات اتصال به عنوان نکات ریشه را با اولین تماس برای onGetRoot() دریافت کند.
- رفع اشکال در جایی که یک MediaBrowser متصل به یک سرویس مرورگر Legacy ، خطایی را که توسط سرویس ارسال شده است پس از مشترک شدن مرورگر در یک parentid دریافت نکرد.
- رفتار قابلیت همکاری را بهبود بخشید ، به طوری که یک مرورگر Media3 که به میراث MediaBrowserService متصل است ، هنگام عضویت در والدین ، دو بار از فرزندان یک parentId درخواست نمی کند.
UI:
- به دلیل مشکلات مربوط به انتقال مشترک مبتنی بر XML ، فیلم های کشیده/خرد شده را در PlayerView -in-Composion- AndroidView Workaround Opt-In بسازید. برنامه هایی که با استفاده از PlayerView در AndroidView برای تماس با PlayerView.setEnableComposeSurfaceSyncWorkaround تماس می گیرند ( #1237 ، #1594 ).
- setFullscreenButtonState به PlayerView اضافه کنید تا به روزرسانی نماد دکمه Fullscreen را در صورت تقاضا ، یعنی خارج از باند و به طور واکنشی به تعامل کلیک ( #1590 ، #184 ) اضافه کنید.
- Fix bug where the "None" choice in the text selection is not working if there are app-defined text track selection preferences.
پسوند داش:
- برای دوره های شروع از وسط یک بخش ( شماره 1440 ) پشتیبانی را اضافه کنید.
پسوند جریان صاف:
- هنگام پخش جریان های صاف و صاف با آهنگ های متن ( شماره 1779 ) یک Bad magic number for Bundle برطرف کنید.
پسوند RTSP:
- حذف اطلاعات کاربر را برای URL هایی که حاوی کاراکترهای رمزگذاری شده @ ( #1138 ) هستند ، برطرف کنید.
- هنگام تجزیه بسته های RTP با پسوند هدر ، تصادف را برطرف کنید ( #1225 ).
پسوندهای رمزگشایی (FFMPEG ، VP9 ، AV1 و غیره):
- ماژول رمزگشایی IAMF را اضافه کنید ، که پشتیبانی از پخش فایلهای MP4 حاوی آهنگ های IAMF را با استفاده از کتابخانه بومی Libiamf برای سنتز صدا فراهم می کند.
  - پخش با یک طرح استریو و همچنین 5.1 با فضایی سازی همراه با ردیابی سر اختیاری فعال می شود ، اما پشتیبانی پخش دو گوش در حال حاضر در دسترس نیست.
- پشتیبانی از صفحه 16 کیلوبایت برای پسوندهای رمزگشایی در Android 15 ( #1685 ) را اضافه کنید.
پسوند بازیگران:
- تمیز کردن جدول زمانی را پس از قطع ارتباط ، متوقف کنید ، که برنامه فرستنده را قادر می سازد پس از قطع ارتباط ، پخش را به صورت محلی از سر بگیرد.
- دستگاه Castplayer DeviceInfo هنگام ارائه Context . این امکان پیوند MediaSession را به یک RoutingSession امکان پذیر می کند ، که برای ادغام سوئیچ خروجی ( #1056 ) لازم است.
خدمات تست:
- DataSourceContractTest اکنون شامل تست هایی برای تأیید است:
  - read position جریان ورودی به روز می شود.
  - offset بافر خروجی به درستی اعمال می شود.
برنامه آزمایشی
- نشت حافظه را در برنامه کوتاه نمایشی ( شماره 1839 ) حل کنید.
نمادهای کاهش یافته را حذف کنید:
- Player.hasPrevious را حذف کنید. hasprevious ، Player.hasPreviousWindow() . به جای آن Player.hasPreviousMediaItem() استفاده کنید.
- روش Player.previous() پخش شده را حذف کنید. به جای آن Player.seekToPreviousMediaItem() استفاده کنید.
- روش drecated DrmSessionEventListener.onDrmSessionAcquired را حذف کنید.
- سازندگان DefaultEncoderFactory را حذف کنید. به جای آن از DefaultEncoderFactory.Builder استفاده کنید.

نسخه 1.5.0-RC02

19 نوامبر 2024

از نسخه 1.5.0 پایدار استفاده کنید.

نسخه 1.5.0-RC01

13 نوامبر 2024

از نسخه 1.5.0 پایدار استفاده کنید.

نسخه 1.5.0-beta01

30 اکتبر 2024

از نسخه 1.5.0 پایدار استفاده کنید.

نسخه 1.5.0-alpha01

10 سپتامبر 2024

از نسخه 1.5.0 پایدار استفاده کنید.

نسخه 1.4.0

نسخه 1.4.1

27 آگوست 2024

androidx.media3:media3-*:1.4.1 منتشر شده است. نسخه 1.4.1 شامل این تعهدات است.

سیارات فراتر:
- تماسهای برگشتی را از پیش بارگذاری به صورت غیر همزمان در PreloadMediaSource ( #1568 ) کنترل کنید.
- اجازه پخش بدون در نظر گرفتن مدت زمان بافر هنگام بارگیری ( شماره 1571 ).
استخراج کننده ها:
- MP3: با نادیده گرفتن صحیح داده های غیر MP3 بر اساس قسمت طول در یک قاب Info ( شماره 1480 ) ، خطای Searched too many bytes .
متن:
- TTML: رسیدگی به درصد tts:fontSize اندازه گیری کنید تا اطمینان حاصل شود که آنها به درستی از گره های والدین با درصد tts:fontSize .
- رفع IndexOutOfBoundsException در LegacySubtitleUtil به دلیل نادرست رسیدگی به پرونده زمان شروع خروجی درخواست شده بیشتر از زمان یا برابر با زمان رویداد نهایی در Subtitle ( شماره 1516 ).
DRM:
- رفع android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE خطای در دستگاه های API 31+ با پخش محتوای L1 Widevine. این خطا با اجرای ناقص از چارچوب MediaDrm.requiresSecureDecoder ( #1603 ) ایجاد می شود.
اثر:
- یک روش release() را به GlObjectsProvider اضافه کنید.
جلسه:
- همانطور که مستند شده است ( #1493 ) ، یک ضربه مضاعف از KEYCODE_HEADSETHOOK را به یک عمل "به دنبال بعدی" تبدیل کنید.
- هنگام تصمیم گیری در مورد اینکه آیا آن را نادیده بگیرید ، برای جلوگیری از یک ForegroundServiceDidNotStartInTimeException ( #1581 ) ، به عنوان یک دستور "بازی" در MediaButtonReceiver KEYCODE_HEADSETHOOK کنید (شماره 1581).
پسوند RTSP:
- توضیحات رسانه ای نامعتبر در تجزیه SDP ( #1087 ).

نسخه 1.4.0

25 جولای 2024

androidx.media3:media3-*:1.4.0 منتشر می شود. نسخه 1.4.0 شامل این تعهدات است.

کتابخانه مشترک:
- پیش بینی می شود که به جای نادیده گرفتن آنها ، به جستجوی No-Op Seeking با BasePlayer.seekTo() و SimpleBasePlayer.handleSeek() فراخوانی می شود. اگر این روش ها را در یک پخش کننده سفارشی اجرا می کنید ، ممکن است لازم باشد این تماس های اضافی را با mediaItemIndex == C.INDEX_UNSET انجام دهید.
- وابستگی کامپایل را بر روی جاوا 8 دفع ( #1312 ) حذف کنید.
- اطمینان حاصل کنید که مدت زمان گذشت به MediaItem.Builder.setImageDurationMs() برای یک MediaItem غیر تصویری (همانطور که مستند شده است) نادیده گرفته می شود.
- Format.customData برای ذخیره اطلاعات سفارشی ارائه شده در برنامه در مورد نمونه های Format اضافه کنید.
سیارات فراتر:
- BasePreloadManager را اضافه کنید که پیش از بارگذاری منابع مختلف را بر اساس اولویت های تعریف شده توسط rankingData آنها ، هماهنگ می کند. سفارشی سازی با گسترش این کلاس امکان پذیر است. DefaultPreloadManager اضافه کنید که از PreloadMediaSource استفاده می کند تا نمونه های رسانه ای از منابع را به حافظه بارگذاری کند و از یک rankingData integer استفاده می کند که نشان دهنده شاخص یک مورد در UI است.
- PlayerId به اکثر روش های LoadControl اضافه کنید تا اجرای LoadControl را برای پشتیبانی از چندین بازیکن فعال کنید.
- Buffer.isDecodeOnly() و C.BUFFER_FLAG_DECODE_ONLY را حذف کنید. نیازی به تنظیم این پرچم نیست زیرا رندر ها و رمزگشایی ها تصمیم می گیرند بر اساس Timestamp از بافرها پرش کنند. پیاده سازی های Renderer سفارشی باید بررسی کنند که آیا زمان بافر حداقل BaseRenderer.getLastResetPositionUs() است تا تصمیم بگیرد که آیا یک نمونه باید نشان داده شود. پیاده سازی های SimpleDecoder سفارشی می توانند در صورت لزوم isAtLeastOutputStartTimeUs() بررسی کنند یا سایر بافرها را با DecoderOutputBuffer.shouldBeSkipped برای پرش از آنها علامت گذاری کنند.
- اجازه دهید یک مقدار تهی توسط TargetPreloadStatusControl.getTargetPreloadStatus(T) برگردانده شود تا نشان ندهد که از پیش بارگیری MediaSource با rankingData داده شده استفاده نکنید.
- remove(MediaSource) به BasePreloadManager اضافه کنید.
- reset() به BasePreloadManager اضافه کنید تا تمام منابع هلدینگ را آزاد کنید در حالی که نمونه مدیر Preload را نگه دارید.
- ExoPlayer.setPriority() (و Builder.setPriority() ) را اضافه کنید تا مقدار اولویت مورد استفاده در PriorityTaskManager و برای اهمیت MediaCodec از API 35 تعریف کنید.
- مشکل را با به روزرسانی آخرین زمان رجوع که منجر به کلید نادرست bs (گرسنگی بافر) در CMCD ( شماره 1124 ) شد ، رفع کنید.
- PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) را اضافه کنید تا نشان دهد که منبع تا پایان بارگذاری شده است. این اجازه می دهد تا DefaultPreloadManager و پیاده سازی های PreloadMediaSource.PreloadControl Custom Custom.PreloadControl برای از پیش بارگذاری منبع بعدی یا انجام اقدامات دیگر.
- رفع اشکال در جایی که سکوت در انتهای موارد می تواند یک استثناء پخش را ایجاد کند.
- برای دور انداختن دوره بارگذاری ، به PreloadMediaSource clear اضافه کنید.
- اضافه کردن کد خطای جدید PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED که هنگام استفاده از منابع کدک برای کارهای اولویت بالاتر استفاده می شود.
- قبل از اتمام آماده سازی رسانه های محتوای اولیه ، اجازه دهید تبلیغات AdsMediaSource را بارگیری کند ( شماره 1358 ).
- رفع اشکال در جایی که پخش هنگام آماده سازی مجدد یک جریان پخش چند دوره ای پس از حذف دوره اصلی از مانیفست ، به STATE_ENDED منتقل شد.
- تغییر نام onTimelineRefreshed() به onSourcePrepared() و onPrepared() به onTracksSelected() در PreloadMediaSource.PreloadControl . بر همین اساس ، IntDefs را در DefaultPreloadManager.Stage تغییر نام دهید.
- پشتیبانی آزمایشی را برای برنامه ریزی پویا اضافه کنید تا کار بهتر با چرخه های Wake CPU را تراز کنید و از خواب بیدار شوید که در هنگام پیشرفت ارائه می شود. می توانید هنگام تنظیم نمونه سیارات خود ، این کار را با استفاده از experimentalSetDynamicSchedulingEnabled() فعال کنید.
- Renderer.getDurationToProgressUs() را اضافه کنید. یک Renderer می تواند این روش را برای بازگشت به سیارات فراتر از مدت زمانی که پخش باید برای پیشرفت رندر پیشرفت کند ، پیاده سازی کند. اگر ExoPlayer با experimentalSetDynamicSchedulingEnabled() تنظیم شده باشد ، در هنگام محاسبه زمان برای برنامه ریزی کار خود ، ExoPlayer با این روش تماس می گیرند.
- اضافه کردن MediaCodecAdapter#OnBufferAvailableListener برای هشدار در هنگام بافر ورودی و خروجی برای استفاده توسط MediaCodecRenderer در دسترس است. MediaCodecRenderer هنگام دریافت این تماس های تماس تلفنی سیگنال می کند و اگر ExoPlayer با experimentalSetDynamicSchedulingEnabled() تنظیم شوند ، پس از آن ExoPlayer برنامه ExoPlayer برنامه ریزی حلقه کار خود را به عنوان ارائه دهنده ها می تواند پیشرفت کند.
- به جای پارامترهای جداگانه از کلاس داده برای روشهای LoadControl استفاده کنید.
- Exoplayer.release() ExoPlayer.isReleased() را اضافه کنید تا بررسی کنید که آیا فراخوانده شده است.
- ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() را اضافه کنید تا حداکثر موقعیتی را که seekToPrevious() به دنبال مورد قبلی ( شماره 1425 ) است ، پیکربندی کنید.
- برخی از ناسازگاری های تمرکز صوتی را برطرف کنید ، به عنوان مثال گزارش از دست دادن تمرکز کامل یا گذرا در حالی که بازیکن مکث می شود ( شماره 1436 ).
- IndexOutOfBoundsException بالقوه ناشی از استخراج کننده های گزارش آهنگ های اضافی پس از مرحله آماده سازی اولیه ( شماره 1476 ) را برطرف کنید.
- Effects in ExoPlayer.setVideoEffect() will receive the timestamps with the renderer offset removed ( #1098 ).
- هنگام رسیدگی به خطای بازیکن که هنگام خواندن در یک مورد لیست پخش دیگر ( شماره 1483 ) اتفاق افتاد IllegalArgumentException برطرف کنید.
ترانسفورماتور:
- audioConversionProcess و videoConversionProcess را به ExportResult اضافه کنید که نشان می دهد چگونه آهنگ مربوطه در پرونده خروجی ساخته شده است.
- بهینه سازی تریم بهینه سازی H.264 را بررسی کنید.
- پشتیبانی از تغییر بین رسانه های ورودی SDR و HDR را در یک دنباله اضافه کنید.
- پشتیبانی از اثرات صوتی سطح ترکیب را اضافه کنید.
- پشتیبانی از تصاویر Transcoding Ultra HDR را در فیلم های HDR اضافه کنید.
- مسئله ای را که DefaultAudioMixer پس از تنظیم مجدد و استفاده مجدد از آن ، مقدار صحیح بایت را تولید نمی کند ، رفع کنید.
- در حدود یک اشکال رمزگشایی کار کنید که در آن تعداد کانال های صوتی هنگام استفاده از ورودی PCM در استریو قرار گرفته است.
- هنگام انتخاب آهنگ در ExoPlayerAssetLoader ، محدودیت های شمارش کانال صوتی را نادیده بگیرید زیرا آنها فقط برای پخش درخواست می کنند.
- androidx.media3.transformer.Muxer رابط با androidx.media3.muxer.Muxer را جایگزین کنید و androidx.media3.transformer.Muxer حذف کنید.
- بارگیری تصویر HEIC از طرح های URI محتوا را برطرف کنید. ( شماره 1373 ).
- برای بهبود همگام سازی AV ، مدت زمان آهنگ صوتی را در AudioGraphInput تنظیم کنید.
- قسمت ExportResult.processedInputs حذف کنید. اگر از این قسمت برای جزئیات کدک استفاده می کنید ، به جای آن از DefaultDecoderFactory.listener استفاده کنید. در صورت استثناء کدک ، جزئیات کدک در ExportException.codecInfo در دسترس خواهد بود.
استخراج کننده ها:
- MPEG-TS: با عبور از آخرین واحد دسترسی یک جریان به صف نمونه ( شماره 7909 ) ، تغییر را تضمین می کند. شامل اصلاحات برای حل مسائلی که فقط در جریان های HLS ( #1150 ) و جریان H.262 HLS ( #1126 ) پدیدار شده است.
- MP3: اندازه داده ها را از یک قاب Info نسبت به اندازه گزارش شده توسط جریان زیرین (به عنوان مثال اندازه پرونده یا Content-Length HTTP) ترجیح دهید. این به شما کمک می کند تا داده های تریلر غیر قابل پخش (به عنوان مثال آثار هنری آلبوم) را از محاسبات مداوم بیتریت محروم کند ، و به دنبال دقیق تر است ( #1376 ).
- MP3: از شمارش فریم و سایر داده ها در یک قاب Info (در صورت وجود) برای محاسبه یک بیت میانگین برای جستجوی بیت ثابت استفاده کنید ، نه اینکه از بیت فریم پس از قاب Info خارج شوید ، که ممکن است از نظر مصنوعی کوچک باشد ، به عنوان مثال قاب PCUT ( #1376 ).
- استخراج فرمت صوتی PCM را در ظروف AVI رفع کنید.
صوتی:
- رفع DTS: X پروفایل 2 ویژگی های رمزگذاری برای پخش Passthrough ( #1299 ).
- برای پخش بارگذاری شده ، قبل از فراخوانی AudioTrack.stop() قسمت ردیابی را برای تکمیل جریان در DefaultAudioSink تنظیم کنید تا AudioTrack.StreamEventCallback#onPresentationEnded به درستی مشخص شود که تمام داده های در انتظار پخش شده است.
- رفع اشکال در SilenceSkippingAudioProcessor که در آن انتقال بین قالب های مختلف صوتی (به عنوان مثال استریو به مونو) می تواند باعث شود پردازنده یک استثنا را پرتاب کند ( شماره 1352 ).
- MediaCodecAudioRenderer.getDurationToProgressUs() را پیاده سازی کنید تا سیارات ساز به طور پویا حلقه کار اصلی خود را به زمانی که MediaCodeCaudiorenderer می تواند پیشرفت کند ، برنامه ریزی کند.
ویدئو:
- مسئله را در جایی که Listener.onRenderedFirstFrame() .
- رفع منطق دکوراسیون DECODER برای Dolby Vision برای استفاده از یک رمزگذار سازگار AV1 در صورت لزوم ( #1389 ).
- رفع استثناء کدک که ممکن است با فعال کردن یک پخش ویدئویی میانه پخش شود.
متن:
- مسئله ای را که زیرنویس ها قبل از شروع موقعیت جستجو شروع می شوند ، برطرف کنید. این شماره فقط در Media3 1.4.0-alpha01 معرفی شد.
- رفتار تجزیه و تحلیل زیرنویس پیش فرض را تغییر دهید ، بنابراین در حین استخراج به جای در هنگام ارائه ، در حین استخراج اتفاق می افتد (برای تفاوت بین استخراج و ارائه به نمودار معماری Exoplayer مراجعه کنید).
  - این تغییر را می توان با فراخوانی هر دو MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) و TextRenderer.experimentalSetLegacyDecodingEnabled(true) . اسناد مربوط به سفارشی سازی را برای نحوه لوله کشی این مؤلفه ها در یک نمونه ExoPlayer مشاهده کنید. این روشها (و همه پشتیبانی از رمزگشایی زیرنویس میراث) در نسخه بعدی حذف می شوند.
  - برنامه هایی با پیاده سازی های SubtitleDecoder سفارشی باید آنها را به روز کنند تا به جای آن SubtitleParser اجرا کنند (و به جای SubtitleDecoderFactory SubtitleParser.Factory آنها را به روز کنید.
- PGS: رمزگشایی طول اجرا را برای حل 0 به عنوان شاخص رنگ ، به جای یک مقدار رنگ تحت اللفظی ( شماره 1367 ) برطرف کنید.
- CEA-708: مقدار rowLock را نادیده بگیرید. مشخصات CEA-708-E S-2023 بیان می کند که بدون توجه به مقادیر موجود در جریان ، باید هر دو rowLock و columnLock درست فرض شوند (پشتیبانی columnLock اجرا نمی شود ، بنابراین به طور مؤثر فرض می شود که همیشه نادرست است).
  - این در ابتدا در یادداشت های انتشار 1.3.0-alpha01 گنجانده شده بود ، اما این تغییر به طور تصادفی قبل از انتشار 1.3.0-rc01 برگردانده شد. این اکنون برطرف شده است ، بنابراین تغییر دوباره وجود دارد.
- CEA-708: از اضافه کردن خطوط جدید کپی توسط استفاده ساده لوحانه از دستور "مکان قلم تنظیم شده" ( شماره 1315 ) خودداری کنید.
- هنگامی که یک نمونه زیرنویس WebVTT حاوی هیچ نشانه ای نیست ، به عنوان مثال به عنوان بخشی از یک جریان داش ( شماره 1516 ) ، یک IllegalArgumentException از LegacySubtitleUtil برطرف کنید.
فراداده:
- نقشه برداری MP4 را به ID3 تگ های مرتب سازی برطرف کنید. پیش از این "مرتب سازی آلبوم" ( soal ) ، "Sort Artist" ( soar ) و "آلبوم هنرمند مرتب سازی" ( soaa ) برچسب های MP4 به اشتباه به برچسب های TSO2 ، TSOA و TSOP ID3 ( شماره 1302 ) نقشه برداری شده بودند.
- Fix reading of MP4 (/iTunes) numeric gnre (genre) and tmpo (tempo) tags when the value is more than one byte long.
- قاب ID3 TCON به MediaMetadata.genre ( #1305 ).
تصویر:
- پشتیبانی از شبکه های تصویر کوچک پارچه غیر مربع ( #1300 ) را اضافه کنید.
- پشتیبانی از AVIF را برای API 34+ اضافه کنید.
- اجازه دهید null به عنوان پارامتر برای ExoPlayer.setImageOutput() برای پاک کردن یک ImageOutput قبلی تنظیم شده.
منبع داده:
- پشتیبانی از android.resource://package/id منابع خام URIS که در آن package با بسته برنامه فعلی متفاوت است. این قبلاً برای کار مستند نشده بود ، اما یک روش کارآمدتر برای دسترسی به منابع در بسته دیگری از نام است.
- url با اشتیاق در سازندگان DataSpec غیر تهی است. این پارامتر قبلاً حاشیه نویسی شده بود.
- به جای اینکه در ساخت و ساز سخت باشد ( #1405 ) ، اجازه دهید ByteArrayDataSource یک URI را به یک آرایه بایت در حین open() برطرف کند.
DRM:
- اجازه دهید یک LoadErrorHandlingPolicy را در DefaultDrmSessionManagerProvider ( #1271 ) تنظیم کنید.
اثر:
- از تغییرات چند سرعته در همان EditedMediaItem یا Composition در SpeedChangeEffect پشتیبانی کنید.
- پشتیبانی از خروجی HLG و PQ از ورودی BITMAP ULTRA HDR.
- پشتیبانی از EGL_GL_COLORSPACE_BT2020_HLG_EXT را اضافه کنید ، که باعث بهبود خروجی سطح HLG در Exoplayer.setVideoeffect و Transformer's Debug Surfaceview می شود.
- اجرای ماتریس روکش را به روز کنید تا با تلنگر مقادیر X و Y اعمال شده در setOverlayFrameAnchor() آن را با مستندات سازگار کند. در صورت استفاده از OverlaySettings.Builder.setOverlayFrameAnchor() ، مقادیر X و Y خود را با ضرب آنها توسط -1 بچرخانید.
- رفع اشکال در جایی که TimestampWrapper هنگام استفاده از ExoPlayer#setVideoEffects ( #821 ) خراب می شود.
- فضای کار پیش فرض رنگ SDR را از رنگهای خطی به ویدیوی SDR برقی BT 709 تغییر دهید. همچنین گزینه سوم را برای حفظ فضای اصلی Colorspace ارائه دهید.
- اجازه می دهد تعریف نامعین z از تعارفات ویرایش شده ( #1055 ).
- دامنه درخشندگی مداوم را در قطعات مختلف محتوای HDR حفظ کنید (از محدوده HLG استفاده می کند).
- پشتیبانی از پوشش Ultra HDR (Bitmap) را در محتوای HDR اضافه کنید.
- اجازه می دهد تا از اثرات SeparableConvolution قبل از API 26 استفاده شود.
- OverlaySettings.useHdr را حذف نکنید.
- پشتیبانی HDR را برای TextOverlay اضافه کنید. درخشش پوشش متن را می توان با OverlaySettings.Builder.setHdrLuminanceMultiplier() تنظیم کرد.
پسوند IMA:
- تبلیغ API را که برای برنامه ها برای پخش جریان های AD DAI به پایدار لازم است ، تبلیغ کنید.
- اضافه کردن replaceAdTagParameters(Map <String, String>) به ImaServerSideAdInsertionMediaSource.AdLoader اضافه کنید که اجازه می دهد تا پارامترهای برچسب تبلیغاتی را در زمان اجرا جایگزین کنید.
- رفع اشکال در جایی که VideoAdPlayer.VideoAdPlayerCallback.onError() هنگامی که خطای بازیکن در حین پخش آگهی اتفاق افتاد ( شماره 1334 ) فراخوانده نشد.
- Bump IMA SDK نسخه به 3.33.0 برای رفع یک NullPointerException هنگام استفاده از data:// ad tag uris ( شماره 700 ).
جلسه:
- تغییر پیش فرض CommandButton.enabled to true و اطمینان حاصل کنید که مقدار می تواند برای کنترل کننده ها نادرست بماند حتی اگر دستور مرتبط در دسترس باشد.
- ثابت های نماد را برای CommandButton اضافه کنید که باید به جای منابع نماد سفارشی استفاده شود.
- اضافه کردن MediaSessionService.isPlaybackOngoing() برای اینکه برنامه ها را بپرسید که آیا این سرویس باید در onTaskRemoved() ( #1219 ) متوقف شود.
- اضافه کردن MediaSessionService.pauseAllPlayersAndStopSelf() که به راحتی امکان مکث پخش همه جلسات را فراهم می کند و از stopSelf() برای خاتمه چرخه عمر MediaSessionService .
- Override MediaSessionService.onTaskRemoved(Intent) برای ارائه یک پیش فرض ایمن که در صورت ادامه پخش یا سرویس ، سرویس را در پیش زمینه نگه می دارد یا سرویس را متوقف می کند.
- Hide Seekbar را در اعلان رسانه برای جریان های زنده با تنظیم مدت زمان در ابرداده جلسه سکو ( #1256 ) پنهان کنید.
- تبدیل MediaMetadata به MediaDescriptionCompat ، برای استفاده از همان ترتیب و منطق ارجح هنگام انتخاب خصوصیات ابرداده مانند Media1.
- اضافه کردن MediaSession.sendError() که امکان ارسال خطاهای غیر کشنده به Media3 Controller را فراهم می کند. هنگام استفاده از کنترل کننده اعلان (به MediaSession.getMediaNotificationControllerInfo() ) مراجعه کنید ، از خطای سفارشی برای به روزرسانی PlaybackState جلسه پلتفرم به حالت خطا با اطلاعات خطای داده شده استفاده می شود ( شماره 543 ).
- اضافه کردن MediaSession.Callback.onPlayerInteractionFinished() برای اطلاع از جلسات هنگامی که یک سری از تعامل پخش کننده از یک کنترلر خاص به پایان رسید.
- SessionError اضافه کنید و از آن در SessionResult و LibraryResult به جای کد خطا استفاده کنید تا اطلاعات بیشتری در مورد خطا و نحوه حل خطا در صورت امکان ارائه دهید.
- کد برنامه کنترلر Media3 را منتشر کنید که می تواند برای آزمایش تعامل با برنامه های انتشار یک جلسه رسانه ای استفاده شود.
- موارد اضافی تبلیغاتی که به Media3 MediaSession[Builder].setSessionExtras() منتقل شده است PlaybackStateCompat.getExtras()
- خطاهای مهلک و غیر کشنده را به جلسه سکو و از آن ترسیم کنید. یک PlaybackException به حالت خطای مهلک از PlaybackStateCompat نقشه برداری می شود. SessionError ارسال شده به کنترل کننده اعلان رسانه با MediaSession.sendError(ControllerInfo, SessionError) در PlaybackStateCompat با خطای غیر کشنده نقشه برداری می شود ، این بدان معنی است که کد خطا و پیام تنظیم شده است اما وضعیت جلسه پلتفرم با STATE_ERROR متفاوت است.
- اجازه دهید فعالیت جلسه در هر کنترلر تنظیم شود تا فعالیت جلسه جهانی را نادیده بگیرد. فعالیت جلسه را می توان برای یک کنترلر در زمان اتصال با ایجاد یک ConnectionResult با پذیرفته شده با AcceptedResultBuilder.setSessionActivivty(PendingIntent) تعریف کرد. پس از اتصال ، فعالیت جلسه را می توان با MediaSession.setSessionActivity(ControllerInfo, PendingIntent) به روز کرد.
- بهبود خطا در تماس با MediaLibrarySession.Callback را بهبود بخشید. تکثیر خطا اکنون می تواند با استفاده از MediaLibrarySession.Builder.setLibraryErrorReplicationMode() برای انتخاب نوع خطا یا انتخاب خارج از تکرار خطا که به طور پیش فرض روشن است ، پیکربندی شود.
UI:
- پشتیبانی از صفحه نمایش تصویر را به PlayerView هنگام اتصال به یک ExoPlayer اضافه کنید ( شماره 1144 ).
- 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:
- Play 'clear lead' unencrypted samples in DRM content immediately by default, even if the keys for the later encrypted samples aren't ready yet. This may lead to mid-playback stalls if the keys still aren't ready when the playback position reaches the encrypted samples (but previously playback wouldn't have started at all by this point). This behavior can be disabled with MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey or DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys .
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.

Version 1.3.0-rc01

22 فوریه 2024

Use the 1.3.0 stable version .

Version 1.3.0-beta01

7 فوریه 2024

Use the 1.3.0 stable version .

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.

Version 1.2.0-rc01

1 نوامبر 2023

Use the 1.2.0 stable version .

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 .

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 ).
IMA:
- 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) . این ویژگی حذف شده است. 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 .
DRM
- 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 is the new home for media support libraries, including 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.