رسانه 3

از کتابخانه ها برای موارد استفاده از رسانه پشتیبانی کنید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
20 دسامبر 2024 1.5.1 - - 1.6.0-alpha01

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

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

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

شیار 

dependencies {
    def media3_version = "1.4.1"

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

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

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

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

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

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

    // For integrating with Cast
    implementation "androidx.media3:media3-cast:$media3_version"

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version"

    // For transforming media files
    implementation "androidx.media3:media3-transformer:$media3_version"

    // For applying effects on video frames
    implementation "androidx.media3:media3-effect:$media3_version"

    // For muxing media files
    implementation "androidx.media3:media3-muxer:$media3_version"

    // Utilities for testing media components (including ExoPlayer components)
    implementation "androidx.media3:media3-test-utils:$media3_version"
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation "androidx.media3:media3-test-utils-robolectric:$media3_version"

    // Common functionality for reading and writing media containers
    implementation "androidx.media3:media3-container:$media3_version"
    // Common functionality for media database components
    implementation "androidx.media3:media3-database:$media3_version"
    // Common functionality for media decoders
    implementation "androidx.media3:media3-decoder:$media3_version"
    // Common functionality for loading data
    implementation "androidx.media3:media3-datasource:$media3_version"
    // Common functionality used across multiple media libraries
    implementation "androidx.media3:media3-common:$media3_version"
    // Common Kotlin-specific functionality
    implementation "androidx.media3:media3-common-ktx:$media3_version"
}

کاتلین

dependencies {
    val media3_version = "1.4.1"

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

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

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

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

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

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

    // For integrating with Cast
    implementation("androidx.media3:media3-cast:$media3_version")

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version")

    // For transforming media files
    implementation("androidx.media3:media3-transformer:$media3_version")

    // For applying effects on video frames
    implementation("androidx.media3:media3-effect:$media3_version")

    // For muxing media files
    implementation("androidx.media3:media3-muxer:$media3_version")

    // Utilities for testing media components (including ExoPlayer components)
    implementation("androidx.media3:media3-test-utils:$media3_version")
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation("androidx.media3:media3-test-utils-robolectric:$media3_version")

    // Common functionality for reading and writing media containers
    implementation("androidx.media3:media3-container:$media3_version")
    // Common functionality for media database components
    implementation("androidx.media3:media3-database:$media3_version")
    // Common functionality for media decoders
    implementation("androidx.media3:media3-decoder:$media3_version")
    // Common functionality for loading data
    implementation("androidx.media3:media3-datasource:$media3_version")
    // Common functionality used across multiple media libraries
    implementation("androidx.media3:media3-common:$media3_version")
    // Common Kotlin-specific functionality
    implementation("androidx.media3:media3-common-ktx:$media3_version")
}

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

بازخورد

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

نسخه 1.6.0

نسخه 1.6.0-alpha01

20 دسامبر 2024

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

  • کتابخانه مشترک:
    • روش Format.toBundle(boolean excludeMetadata) حذف کنید، به جای آن از Format.toBundle() استفاده کنید.
    • AudioManagerCompat و AudioFocusRequestCompat را برای جایگزینی کلاس های معادل در androidx.media اضافه کنید.
  • ExoPlayer:
    • هنگام انتخاب یک آهنگ ویدیویی، زبان را در نظر بگیرید. به‌طور پیش‌فرض، در صورت موجود بودن، یک آهنگ ویدیویی «اصلی» را انتخاب کنید که با زبان آهنگ صوتی انتخاب‌شده مطابقت داشته باشد. ترجیحات زبان ویدیویی صریح را می توان با TrackSelectionParameters.Builder.setPreferredVideoLanguage(s) بیان کرد.
    • پارامتر selectedAudioLanguage را به متد DefaultTrackSelector.selectVideoTrack() اضافه کنید.
    • پارامتر retryCount به روش MediaSourceEventListener.onLoadStarted و MediaSourceEventListener.EventDispatcher مربوطه اضافه کنید.
    • رفع اشکال که آیتم‌های فهرست پخش یا دوره‌های جریان‌های چند دوره‌ای DASH با مدت‌زمان‌هایی که با محتوای واقعی مطابقت ندارند، می‌توانند باعث توقف فریم در انتهای مورد شوند ( #1698 ).
    • مقادیر پیش‌فرض bufferForPlaybackMs و bufferForPlaybackAfterRebufferMs در DefaultLoadControl به ترتیب به 1000 و 2000 میلی‌ثانیه کاهش دهید.
    • MediaExtractorCompat را اضافه کنید، یک کلاس جدید که ویژگی های معادل پلتفرم MediaExtractor را فراهم می کند.
    • BasePreloadManager.Listener به PreloadManagerListener سطح بالا منتقل کنید.
    • RenderersFactory.createSecondaryRenderer می توان برای ارائه رندرهای ثانویه برای پیش گرم کردن پیاده سازی کرد. پیش گرم کردن، انتقال سریع‌تر آیتم‌های رسانه را در حین پخش فعال می‌کند.
    • ارسال CmcdData را برای درخواست‌های مانیفست در قالب‌های جریان تطبیقی ​​DASH، HLS، و SmoothStreaming فعال کنید ( #1951 ).
    • MediaCodecInfo کدک را ارائه کنید که در MediaCodecRenderer.onReadyToInitializeCodec ( #1963 ) مقداردهی اولیه می شود.
    • AdsMediaSource تغییر دهید تا AdPlaybackStates با افزودن گروه های تبلیغاتی رشد کنند. تغییرات نامعتبر شناسایی می شوند و یک استثنا ایجاد می کنند.
  • ترانسفورماتور:
    • پارامترهای VideoFrameProcessor.registerInputStream و VideoFrameProcessor.Listener.onInputStreamRegistered را برای استفاده از Format به روز کنید.
    • اضافه کردن پشتیبانی برای transmuxing به فرمت های جایگزین سازگار با عقب.
    • هنگام استفاده از DefaultEncoderFactory ابرداده استاتیک HDR ایجاد کنید.
  • استخراج کننده ها:
    • AVI: رسیدگی به فایل‌ها را با صدای فشرده‌شده با نرخ بیت ثابت که در آن هدر جریان، تعداد بایت‌ها را به جای تعداد تکه‌ها ذخیره می‌کند، برطرف کنید.
  • صوتی:
    • onAudioPositionAdvancing رفع کنید تا هنگام ازسرگیری پخش فراخوانی شود (قبلاً زمانی که پخش متوقف می شد، فراخوانی می شد).
  • ویدئو:
    • MediaCodecVideoRenderer طوری برطرف کنید که وقتی بدون Surface باشد، تنها در صورتی که VideoFrameReleaseControl.getFrameReleaseAction FRAME_RELEASE_TRY_AGAIN_LATER نباشد، رندر فریم های اولیه را رد می کند.
  • متن:
    • بارگیری تمام فایل‌های زیرنویس پیکربندی شده با MediaItem.Builder.setSubtitleConfigurations را مشتاقانه متوقف کنید و در عوض فقط یکی را در صورتی بارگیری کنید که با انتخاب آهنگ انتخاب شده باشد ( #1721 ).
  • اثر:
    • عملکرد OverlaySettings را به StaticOverlaySettings منتقل کرد. OverlaySettings می توان به صورت زیر طبقه بندی کرد تا تنظیمات همپوشانی پویا امکان پذیر باشد.
  • موکسرها:
    • MuxerException از رابط Muxer خارج کرد تا از نام بسیار طولانی و کاملا واجد شرایط جلوگیری شود.
  • جلسه:
    • "Context" را به عنوان یک پارامتر به "MediaButtonReceiver.shouldStartForegroundService" ( #1887 ) اضافه کنید.
  • UI:
    • PlayerSurface Composable را به ماژول media3-ui-compose اضافه کنید.
    • کلاس های PlayPauseButtonState ، NextButtonState ، PreviousButtonState ، RepeatButtonState ، ShuffleButtonState و مربوط به rememberPlayPauseButtonState ، rememberNextButtonState ، rememberPreviousButtonState ، rememberRepeatButtonState ، rememberShuffleButtonState را اضافه کنید. composable به مدول media3-ui-compose .
  • برنامه افزودنی HLS:
    • اولین نسخه HlsInterstitialsAdsLoader را اضافه کنید. بارکننده تبلیغات، میان‌اثرهای HLS یک فهرست پخش رسانه HLS را می‌خواند و آنها را به AdPlaybackState که به AdsMediaSource ارسال می‌شود، نگاشت می‌کند. این نسخه اولیه فقط از جریان های VOD HLS با ویژگی های X-ASSET-URI پشتیبانی می کند.
    • HlsInterstitialsAdsLoader.AdsMediaSourceFactory را اضافه کنید. برنامه‌ها می‌توانند از آن برای ایجاد نمونه‌های AdsMediaSource استفاده کنند که از HlsInterstitialsAdsLoader به روشی راحت و ایمن استفاده می‌کنند.
  • پسوند DASH:
    • پشتیبانی از فرمت AC-4 Level-4 برای DASH ( #1898 ) را اضافه کنید.
  • پسوندهای رمزگشا (FFmpeg، VP9، AV1، و غیره):
    • ماژول رمزگشای MPEG-H را اضافه کنید که از ماژول رمزگشای اصلی MPEG-H برای رمزگشایی صدای MPEG-H استفاده می کند ( #1826 ).
  • برنامه نمایشی:
    • افزودن MinimalControls ( PlayPauseButton ، NextButton ، PreviousButton ) و ExtraControls ( RepeatButton ، ShuffleButton ) عناصر رابط کاربری قابل تنظیم برای demo-compose با استفاده از PlayPauseButtonState ، NextButtonState ، PreviousButtonState ، RepeatButtonState ShuffleButtonState .
  • حذف نمادهای منسوخ شده:
    • روش منسوخ 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 استفاده کنید.

نسخه 1.5

نسخه 1.5.1

19 دسامبر 2024

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

  • ExoPlayer:
    • استفاده از رمزگشایی ناهمزمان را در MediaCodec غیرفعال کنید تا از مشکلات گزارش‌شده مهلت زمانی کدک با این API پلت فرم ( #1641 ) جلوگیری کنید.
  • استخراج کننده ها:
    • MP3: Don't stop playback early when a VBRI frame's table of contents doesn't cover all the MP3 data in a file ( #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 در حالت ناهمزمان کار می‌کند (رفتار پیش‌فرض در API 31+) گاهی اوقات MediaCodec.CryptoException به‌عنوان یک «خطای زمان اجرا غیرمنتظره» گزارش می‌شود.
    • با PreloadMediaSource.PreloadControl.onContinueLoadingRequested() به جای bufferedPositionUs bufferedDurationUs ارسال کنید. همچنین DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS به DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS تغییر می‌دهد، سپس برنامه‌ها باید مقداری را ارسال کنند که نشان‌دهنده مدت زمان مشخصی از موقعیت شروع پیش‌فرض است که منبع رسانه مربوطه باید به‌جای یک موقعیت از پیش بارگذاری شود.
    • پیاده سازی ForwardingRenderer اضافه کنید که همه فراخوانی های متد را به رندر دیگری هدایت می کند ( 1703 ).
    • اضافه کردن پیش بارگذاری لیست پخش برای مورد بعدی در لیست پخش. برنامه‌ها می‌توانند با فراخوانی ExoPlayer.setPreloadConfiguration(PreloadConfiguration) پیش‌بارگیری را فعال کنند. به طور پیش فرض بارگیری از قبل غیرفعال است. هنگام انتخاب و عدم تداخل در پخش، DefaultLoadControl بارگذاری اولیه را محدود می کند تا فقط زمانی که پخش کننده برای پخش بارگیری نمی شود شروع شود و ادامه یابد. برنامه‌ها می‌توانند با اجرای LoadControl.shouldContinuePreloading() بر این اساس این رفتار را تغییر دهند (مانند زمانی که این روش را در DefaultLoadControl نادیده می‌گیریم). اجرای پیش‌فرض LoadControl در صورتی که برنامه‌ای از پیاده‌سازی سفارشی LoadControl استفاده می‌کند، بارگذاری پیش‌بار را غیرفعال می‌کند.
    • روش MediaSourceEventListener.EventDispatcher.dispatchEvent() را اضافه کنید تا امکان فراخوانی رویدادهای شنوندگان زیر کلاس ( 1736 ) فراهم شود.
    • DefaultPreloadManager.Builder را اضافه کنید که نمونه های DefaultPreloadManager و ExoPlayer را با پیکربندی های به اشتراک گذاشته شده پیوسته می سازد.
    • پارامتر Renderer[] از LoadControl.onTracksSelected() حذف کنید زیرا اجرای DefaultLoadControl می تواند انواع جریان را از ExoTrackSelection[] بازیابی کند.
    • DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) منسوخ شد و برای جلوگیری از لغو، روش به عنوان نهایی علامت گذاری شد. به جای آن باید از DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) جدید استفاده شود.
    • گزارش رویدادهای MediaSourceEventListener از منابع ثانویه در MergingMediaSource . این باعث می‌شود که رویدادهای شروع/خطا/لغو/تکمیل بار برای زیرنویس‌های جانبی (آنهایی که با MediaItem.LocalConfiguration.subtitleConfigurations اضافه شده‌اند) گزارش شود، که ممکن است به‌عنوان رویدادهای بار تکراری منتشر شده از AnalyticsListener ظاهر شوند.
    • از توقف کامل پخش توسط خطاهای زیرنویس و ابرداده جلوگیری کنید. در عوض آهنگ مشکل دار غیرفعال می شود و پخش آهنگ های باقی مانده ادامه می یابد ( #1722 ).
      • در مدیریت جدید زیرنویس (در حین استخراج)، خطاهای تجزیه مرتبط (مثلاً داده‌های زیرنویس نامعتبر) و خطاهای بارگذاری (مانند HTTP 404) از طریق تماس‌های onLoadError منتشر می‌شوند.
      • در مدیریت زیرنویس قدیمی (در طول رندر)، فقط خطاهای بار مرتبط از طریق تماس‌های onLoadError منتشر می‌شوند در حالی که خطاهای تجزیه بی‌صدا نادیده گرفته می‌شوند (این یک رفتار از قبل موجود است).
    • رفع اشکال که آیتم‌های فهرست پخش یا دوره‌های جریان‌های چند دوره‌ای DASH با مدت‌زمان‌هایی که با محتوای واقعی مطابقت ندارند، می‌توانند باعث توقف فریم در انتهای مورد شوند ( #1698 ).
    • یک تنظیم کننده به SntpClient اضافه کنید تا حداکثر زمان سپری شده از آخرین به روز رسانی که پس از آن کلاینت مجدداً مقداردهی می شود تنظیم شود ( #1794 ).
  • ترانسفورماتور:
    • SurfaceAssetLoader را اضافه کنید که از صف بندی داده های ویدیویی به Transformer از طریق Surface پشتیبانی می کند.
    • ImageAssetLoader به جای ارسال یک IllegalStateException ورودی پشتیبانی نشده را از طریق AssetLoader.onError گزارش می دهد.
    • تنظیم مدت زمان تصویر را با استفاده از MediaItem.Builder.setImageDurationMs برای صادرات تصویر اجباری کنید.
    • اضافه کردن پشتیبانی صادرات برای شکاف در دنباله های صوتی EditedMediaItems.
  • انتخاب آهنگ:
    • DefaultTrackSelector : هنگامی که سایر عوامل برابر هستند، صدای مبتنی بر شی را به صدای مبتنی بر کانال ترجیح دهید.
  • استخراج کننده ها:
    • به Mp4Extractor و FragmentedMp4Extractor اجازه دهید نمونه‌های H264 را که در نمونه‌های بعدی به عنوان مرجع استفاده نمی‌شوند شناسایی کنند.
    • گزینه ای را برای فعال کردن جستجوی مبتنی بر فهرست در AmrExtractor اضافه کنید.
    • فایل های MP3 با بیش از 128 کیلوبایت بین فریم های معتبر را به عنوان کوتاه شده (به جای نامعتبر) در نظر بگیرید. این بدان معناست که فایل‌هایی با داده‌های غیر MP3 در انتها، بدون هیچ ابرداده دیگری برای نشان دادن طول بایت‌های MP3، اکنون به جای شکستن با ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} ( #1563 ).
    • هنگام پردازش فهرست‌های ویرایش در فایل‌های MP4 ( #1659 ) مدیریت نمونه پیش‌پرول را برای موقعیت‌های شروع رسانه‌های غیرکلیدی برطرف کنید.
    • بهبود محاسبه نرخ فریم با استفاده از مدت زمان رسانه از جعبه mdhd در Mp4Extractor و FragmentedMp4Extractor ( #1531 ).
    • اصلاح مقیاس نادرست media_time در لیست های ویرایش MP4. در حالی که segment_duration قبلاً با استفاده از مقیاس زمانی فیلم به درستی مقیاس‌بندی شده بود، media_time اکنون با استفاده از مقیاس زمانی مسیر به درستی مقیاس‌بندی می‌شود، همانطور که توسط استاندارد فرمت MP4 ( #1792 ) مشخص شده است.
    • فریم های نامرتب را در محاسبه endIndices برای MP4 با لیست ویرایش ( #1797 ) مدیریت کنید.
    • تجزیه مدت زمان رسانه را در جعبه mdhd فایل های MP4 برای رسیدگی به مقادیر -1 ( #1819 ) برطرف کنید.
    • پشتیبانی برای شناسایی جعبه h263 در فایل های MP4 برای ویدیوی H.263 ( #1821 ) اضافه کنید.
    • پشتیبانی از فرمت فایل رسانه پایه ISO AC-4 Level-4 ( #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 ).
    • اگر هنگام پردازش onOutputFormatChanged ( #1371 ) از مقادیر نسبت تصویر ارائه شده توسط MediaCodecAdapter استفاده کنید.
    • راه‌حلی برای مشکل دستگاه در Galaxy Tab S7 FE اضافه کنید که باعث می‌شود جریان‌های H264 ایمن 60 فریم بر ثانیه به‌عنوان پشتیبانی‌نشده علامت‌گذاری شوند ( #1619 ).
    • برای کدک هایی که پس از آخرین نمونه بدون بازگشت سیگنال پایان جریان گیر می کنند، راه حلی اضافه کنید.
  • متن:
    • یک VoiceSpan سفارشی اضافه کنید و آن را برای دامنه های صوتی WebVTT پر کنید ( #1632 ).
    • اطمینان حاصل کنید که WebVTT در HLS با مهرهای زمانی زیرنویس بسیار بزرگ (که زمانی که به صورت میکروثانیه نمایش داده می‌شوند 64 long سرریز می‌کنند و در پایگاه زمانی 90,000 MPEG ضرب می‌شوند) نمایش داده می‌شوند ( #1763 ).
    • از زیرنویس‌های CEA-608 در محتوای Dolby Vision ( #1820 ) پشتیبانی کنید.
    • هنگامی که زیرنویس‌های CEA-608 فعال هستند، تعلیق پخش در جریان‌های چند دوره‌ای DASH را برطرف کنید ( #1863 ).
  • فراداده:
    • نوع C.TRACK_TYPE_METADATA را به آهنگ های حاوی محتوای یخی یا vnd.dvb.ait اختصاص دهید.
  • تصویر:
    • ExternallyLoadedImageDecoder برای ادغام ساده با کتابخانه های بارگذاری تصویر خارجی مانند Glide یا Coil اضافه کنید.
  • منبع داده:
    • FileDescriptorDataSource را اضافه کنید، یک DataSource جدید که می تواند برای خواندن از یک FileDescriptor استفاده شود ( #3757 ).
  • اثر:
    • راه‌حل DefaultVideoFrameProcessor را برای مقیاس‌بندی جزئی SurfaceTexture اضافه کنید. SurfaceTexture ممکن است شامل یک مقیاس کوچک باشد که یک حاشیه 1 تکسلی را در اطراف لبه یک بافر برش خورده قطع می کند. اکنون این کار به گونه ای انجام می شود که خروجی به حد انتظار نزدیک تر است.
    • افزایش سرعت DefaultVideoFrameProcessor.queueInputBitmap() . در نتیجه، صادرات تصاویر به ویدیوها با Transformer سریعتر است.
  • پسوند IMA:
    • رفع اشکال که در آن پاک کردن لیست پخش ممکن است باعث ایجاد یک ArrayIndexOutOfBoundsException در ImaServerSideAdInsertionMediaSource شود.
    • رفع اشکالی که در آن جریان‌های DAI درج‌شده در سمت سرور بدون پیش‌پرول می‌تواند منجر به ArrayIndexOutOfBoundsException در هنگام پخش گذشته از آخرین میان‌افزار ( #1741 ) شود.
  • جلسه:
    • MediaButtonReceiver.shouldStartForegroundService(Intent) را اضافه کنید تا به برنامه‌ها اجازه دهید با نادیده گرفتن این روش، فرمان پخشی را که برای ازسرگیری پخش ارسال می‌شود، سرکوب کنند. به‌طور پیش‌فرض، سرویس همیشه راه‌اندازی می‌شود و بدون اینکه سیستم سرویس را با یک ForegroundServiceDidNotStartInTimeException ( #1528 ) خراب کند، نمی‌توان پخش را متوقف کرد.
    • رفع اشکالی که باعث می‌شود دستورات سفارشی ارسال شده از MediaBrowser به MediaSessionCompat.Callback به جای نوع MediaBrowserServiceCompat روش هنگام اتصال به یک سرویس قدیمی ارسال شود. این امر باعث شد MediaBrowser نتواند مقدار بازگشتی واقعی را که توسط سرویس قدیمی ارسال شده است ( #1474 ) دریافت کند.
    • کنترل IllegalArgumentException پرتاب شده توسط دستگاه های سازنده خاص هنگام تنظیم گیرنده پخش برای اهداف دکمه رسانه ( #1730 ).
    • دکمه های فرمان را برای آیتم های رسانه اضافه کنید. این API Media3 را برای آنچه به عنوان Custom browse actions با کتابخانه قدیمی با MediaBrowserCompat شناخته می‌شود، اضافه می‌کند. توجه داشته باشید که با Media3 دکمه های فرمان برای آیتم های رسانه برای هر دو، MediaBrowser و MediaController در دسترس هستند. اقدامات مرور سفارشی AAOS را ببینید.
    • رفع اشکال که در آن یک کنترلر Media3 گاهی اوقات نمی توانست به برنامه جلسه اجازه دهد پس از درخواست play() سرویس پیش زمینه را شروع کند.
    • CommandButton.Builder.setIconUri را محدود کنید تا فقط Uris محتوا را بپذیرد.
    • هنگام اتصال به MediaBrowserCompat قدیمی، نکات اتصال مرورگر Media3 را به MediaBrowserCompat اولیه منتقل کنید. این سرویس می‌تواند راهنمایی‌های اتصال را که به‌عنوان راهنمایی ریشه ارسال می‌شود، با اولین تماس با onGetRoot() دریافت کند.
    • رفع اشکالی که در آن MediaBrowser به یک سرویس مرورگر قدیمی متصل است، پس از اینکه مرورگر در یک parentid مشترک شد، خطایی توسط سرویس ارسال نشده است.
    • رفتار قابلیت همکاری را بهبود بخشید، به طوری که مرورگر Media3 که به یک MediaBrowserService قدیمی متصل است، هنگام اشتراک در یک والدین، دو بار از فرزندان یک parentId درخواست نکند.
  • UI:
    • به دلیل مشکلات مربوط به انتقال مشترک مبتنی بر XML، ویدیوی کشیده/برش‌شده را در PlayerView -in-Compose- راه‌حل AndroidView انتخاب کنید. برنامه‌هایی که از PlayerView در AndroidView استفاده می‌کنند، باید با PlayerView.setEnableComposeSurfaceSyncWorkaround تماس بگیرند تا بتوانند شرکت کنند ( #1237 ، #1594 ).
    • setFullscreenButtonState به PlayerView اضافه کنید تا به‌روزرسانی نماد دکمه تمام‌صفحه در صورت تقاضا، یعنی خارج از باند و نه به صورت واکنش‌گرا در تعامل کلیکی امکان‌پذیر باشد ( #1590 ، #184 ).
    • اگر تنظیمات برگزیده انتخاب آهنگ متنی تعریف شده توسط برنامه وجود داشته باشد، اشکالی را که در آن گزینه «هیچ‌کدام» در انتخاب متن کار نمی‌کند، برطرف کنید.
  • پسوند DASH:
    • برای دوره‌هایی که از وسط یک بخش شروع می‌شوند، پشتیبانی اضافه کنید ( #1440 ).
  • پسوند جریان روان:
    • هنگام پخش جریان‌های SmoothStreaming با آهنگ‌های متنی، یک Bad magic number for Bundle برطرف کنید ( #1779 ).
  • پسوند RTSP:
    • رفع اطلاعات کاربر برای URL هایی که حاوی نویسه های @ رمزگذاری شده هستند ( #1138 ).
    • رفع خرابی هنگام تجزیه بسته های RTP با پسوند هدر ( #1225 ).
  • پسوندهای رمزگشا (FFmpeg، VP9، AV1، و غیره):
    • ماژول رمزگشای IAMF را اضافه کنید که از پخش فایل های MP4 حاوی آهنگ های IAMF با استفاده از کتابخانه بومی libiamf برای ترکیب صدا پشتیبانی می کند.
      • پخش با طرح استریو و همچنین 5.1 با فضایی سازی همراه با ردیابی سر اختیاری فعال است، اما پشتیبانی از پخش دو گوش در حال حاضر در دسترس نیست.
    • پشتیبانی از صفحه 16 کیلوبایتی برای برنامه‌های افزودنی رمزگشا در Android 15 ( #1685 ) اضافه کنید.
  • پسوند بازیگران:
    • پس از قطع ارتباط CastSession، تمیز کردن جدول زمانی را متوقف کنید، که به برنامه فرستنده امکان می‌دهد پس از قطع ارتباط، پخش را به صورت محلی از سر بگیرد.
    • هنگامی که یک Context ارائه می شود، DeviceInfo CastPlayer را پر کنید. این امکان پیوند MediaSession را به RoutingSession می‌دهد، که برای یکپارچه کردن خروجی سوئیچر ( #1056 ) ضروری است.
  • ابزارهای آزمایشی:
    • DataSourceContractTest اکنون شامل آزمایش هایی برای تأیید است:
      • read position جریان ورودی به روز شده است.
      • offset بافر خروجی به درستی اعمال می شود.
  • برنامه نمایشی
    • نشت حافظه را در برنامه فرم کوتاه نمایشی ( #1839 ) حل کنید.
  • حذف نمادهای منسوخ شده:
    • Player.hasPrevious ، Player.hasPreviousWindow() منسوخ شده را حذف کنید. به جای آن از Player.hasPreviousMediaItem() استفاده کنید.
    • روش منسوخ شده Player.previous() را حذف کنید. به جای آن از Player.seekToPreviousMediaItem() استفاده کنید.
    • روش منسوخ DrmSessionEventListener.onDrmSessionAcquired را حذف کنید.
    • سازنده های DefaultEncoderFactory منسوخ شده را حذف کنید. به جای آن از DefaultEncoderFactory.Builder استفاده کنید.

نسخه 1.5.0-rc02

19 نوامبر 2024

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

نسخه 1.5.0-rc01

13 نوامبر 2024

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

نسخه 1.5.0-beta01

30 اکتبر 2024

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

نسخه 1.5.0-alpha01

10 سپتامبر 2024

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

نسخه 1.4.0

نسخه 1.4.1

27 آگوست 2024

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

  • ExoPlayer:
    • در 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 اضافه کنید.
  • جلسه:
    • همانطور که مستند شده است، یک ضربه دوبار از KEYCODE_HEADSETHOOK را به یک اقدام «جستجوی بعدی» تبدیل کنید ( #1493 ).
    • هنگامی که تصمیم می گیرید برای جلوگیری از ForegroundServiceDidNotStartInTimeException ( #1581 ) آن را نادیده بگیرید، KEYCODE_HEADSETHOOK به عنوان یک فرمان «play» در MediaButtonReceiver مدیریت کنید.
  • پسوند RTSP:
    • رد شدن از توضیحات رسانه نامعتبر در تجزیه SDP ( #1087 ).

نسخه 1.4.0

25 جولای 2024

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

  • کتابخانه مشترک:
    • به جای نادیده گرفتن فراخوان‌های جستجوی بدون عملیات به متدهای حفاظت‌شده BasePlayer.seekTo() و SimpleBasePlayer.handleSeek() ارسال کنید. اگر این روش‌ها را در یک پخش‌کننده سفارشی پیاده‌سازی می‌کنید، ممکن است لازم باشد این تماس‌های اضافی را با mediaItemIndex == C.INDEX_UNSET مدیریت کنید.
    • حذف وابستگی کامپایل به حذف قند بهبود یافته جاوا 8 ( #1312 ).
    • مطمئن شوید که مدت زمان ارسال شده به MediaItem.Builder.setImageDurationMs() برای یک MediaItem غیر تصویری نادیده گرفته شده است (طبق مستند).
    • Format.customData برای ذخیره اطلاعات سفارشی ارائه شده توسط برنامه در مورد نمونه های Format اضافه کنید.
  • ExoPlayer:
    • BasePreloadManager اضافه کنید که پیش بارگذاری را برای چندین منبع بر اساس اولویت های تعریف شده توسط rankingData آنها هماهنگ می کند. سفارشی سازی با گسترش این کلاس امکان پذیر است. DefaultPreloadManager را اضافه کنید که از PreloadMediaSource برای از پیش بارگذاری نمونه های رسانه ای از منابع در حافظه استفاده می کند و از یک rankingData عدد صحیح استفاده می کند که نمایه یک آیتم را در رابط کاربری نشان می دهد.
    • PlayerId به اکثر متدهای LoadControl اضافه کنید تا اجرای LoadControl را برای پشتیبانی از چندین بازیکن فعال کنید.
    • Buffer.isDecodeOnly() و C.BUFFER_FLAG_DECODE_ONLY را حذف کنید. نیازی به تنظیم این پرچم نیست زیرا رندرها و رمزگشاها تصمیم می‌گیرند از بافرها بر اساس مهر زمانی عبور کنند. اجرای سفارشی Renderer باید بررسی کند که آیا زمان بافر حداقل BaseRenderer.getLastResetPositionUs() است تا تصمیم بگیرد که آیا نمونه باید نشان داده شود یا خیر. پیاده سازی های سفارشی SimpleDecoder می توانند در صورت نیاز isAtLeastOutputStartTimeUs() بررسی کنند یا بافرهای دیگر را با DecoderOutputBuffer.shouldBeSkipped علامت گذاری کنند تا از آنها رد شود.
    • اجازه دهید یک مقدار تهی توسط TargetPreloadStatusControl.getTargetPreloadStatus(T) برگردانده شود تا نشان دهد که MediaSource با rankingData داده شده از قبل بارگیری نمی شود.
    • remove(MediaSource) را به BasePreloadManager اضافه کنید.
    • reset() را به BasePreloadManager اضافه کنید تا تمام منابع نگهدارنده را آزاد کنید و در عین حال نمونه مدیریت پیش بارگذاری را حفظ کنید.
    • ExoPlayer.setPriority() و Builder.setPriority() ) را برای تعریف مقدار اولویت مورد استفاده در PriorityTaskManager و برای اهمیت MediaCodec از API 35 اضافه کنید.
    • مشکل به‌روزرسانی آخرین زمان بافر را که منجر به کلید bs (گرسنگی بافر) نادرست در CMCD شد ( #1124 ) برطرف کنید.
    • PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) را اضافه کنید تا نشان دهید منبع تا پایان بارگذاری شده است. این به DefaultPreloadManager و پیاده سازی های سفارشی PreloadMediaSource.PreloadControl اجازه می دهد تا منبع بعدی را از قبل بارگذاری کنند یا اقدامات دیگری را انجام دهند.
    • رفع اشکال که در آن پرش بی‌صدا در انتهای موارد می‌تواند باعث ایجاد استثنا در پخش شود.
    • برای صرف‌نظر کردن از دوره پیش‌بارگیری، clear به PreloadMediaSource اضافه کنید.
    • کد خطای جدید PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED را اضافه کنید.ERROR_CODE_DECODING_RESOURCES_RECLAIMED که زمانی استفاده می شود که منابع کدک برای کارهای با اولویت بالاتر بازیابی می شوند.
    • اجازه دهید AdsMediaSource تبلیغات پیش از پخش را قبل از تکمیل آماده سازی رسانه محتوای اولیه بارگیری کند ( #1358 ).
    • رفع اشکال انتقال پخش به STATE_ENDED هنگام آماده‌سازی مجدد جریان زنده چند دوره‌ای DASH پس از اینکه دوره اصلی قبلاً از مانیفست حذف شده بود.
    • نام onTimelineRefreshed() به onSourcePrepared() و onPrepared() به onTracksSelected() در PreloadMediaSource.PreloadControl تغییر نام دهید. همچنین نام IntDefs را در DefaultPreloadManager.Stage بر این اساس تغییر دهید.
    • پشتیبانی آزمایشی برای زمان‌بندی پویا اضافه کنید تا کار را با چرخه‌های بیداری CPU تراز کنید و بیدار شدن را تا زمانی که رندرها می‌توانند پیشرفت کنند به تاخیر بیاندازید. هنگام تنظیم نمونه ExoPlayer، می‌توانید این را با استفاده از experimentalSetDynamicSchedulingEnabled() فعال کنید.
    • Renderer.getDurationToProgressUs() را اضافه کنید. یک Renderer می‌تواند این روش را پیاده‌سازی کند تا مدت زمانی را که پخش برای پیشرفت رندر باید پیش برود، به ExoPlayer بازگرداند. اگر ExoPlayer با experimentalSetDynamicSchedulingEnabled() تنظیم شده باشد، ExoPlayer این متد را هنگام محاسبه زمان برنامه ریزی کار خود فراخوانی می کند.
    • MediaCodecAdapter#OnBufferAvailableListener را اضافه کنید تا زمانی که بافرهای ورودی و خروجی برای استفاده توسط MediaCodecRenderer در دسترس هستند، هشدار دهید. MediaCodecRenderer هنگام دریافت این تماس‌ها به ExoPlayer سیگنال می‌دهد و اگر ExoPlayer با experimentalSetDynamicSchedulingEnabled() تنظیم شده باشد، ExoPlayer حلقه کار خود را برنامه‌ریزی می‌کند زیرا رندرها می‌توانند پیشرفت کنند.
    • از کلاس داده برای متدهای LoadControl به جای پارامترهای فردی استفاده کنید.
    • ExoPlayer.isReleased() را اضافه کنید تا بررسی کنید که Exoplayer.release() فراخوانی شده است یا خیر.
    • ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() را برای پیکربندی حداکثر موقعیتی که seekToPrevious() برای آن جستجو می کند به آیتم قبلی ( #1425 ) اضافه کنید.
    • برخی از تناقضات فوکوس صوتی را برطرف کنید، به عنوان مثال گزارش نکردن از دست دادن فوکوس کامل یا گذرا در حالی که پخش کننده متوقف شده است ( #1436 ).
    • اصلاح IndexOutOfBoundsException بالقوه ناشی از استخراج کننده هایی که آهنگ های اضافی را پس از مرحله آماده سازی اولیه گزارش می کنند ( #1476 ).
    • Effects در ExoPlayer.setVideoEffect() مهرهای زمانی را دریافت می‌کنند که افست رندر حذف شده است ( #1098 ).
    • هنگام رسیدگی به خطای پخش کننده که هنگام خواندن پیش رو در یکی دیگر از آیتم های لیست پخش ( #1483 ) رخ داده است، بالقوه IllegalArgumentException برطرف کنید.
  • ترانسفورماتور:
    • audioConversionProcess و videoConversionProcess به ExportResult اضافه کنید که نشان می دهد آهنگ مربوطه در فایل خروجی چگونه ساخته شده است.
    • بررسی سطح H.264 بهینه سازی تریم آرام.
    • پشتیبانی برای تغییر بین رسانه ورودی SDR و HDR به صورت متوالی اضافه کنید.
    • پشتیبانی از جلوه های صوتی در سطح ترکیب را اضافه کنید.
    • پشتیبانی از رمزگذاری تصاویر Ultra HDR به ویدیوهای HDR را اضافه کنید.
    • مشکلی را که DefaultAudioMixer پس از تنظیم مجدد و استفاده مجدد، مقدار صحیح بایت را تولید نمی کند، برطرف کنید.
    • در مورد یک اشکال رمزگشا کار کنید که در آن تعداد کانال های صوتی در هنگام مدیریت ورودی PCM در حالت استریو محدود شده است.
    • هنگام انتخاب آهنگ‌ها در ExoPlayerAssetLoader ، محدودیت‌های تعداد کانال‌های صوتی را نادیده بگیرید زیرا فقط برای پخش اعمال می‌شوند.
    • رابط androidx.media3.transformer.Muxer را با androidx.media3.muxer.Muxer جایگزین کنید و androidx.media3.transformer.Muxer حذف کنید.
    • رفع بارگذاری تصویر HEIC از طرح‌های URI محتوا. ( #1373 ).
    • برای بهبود همگام سازی AV، مدت آهنگ صوتی را در AudioGraphInput تنظیم کنید.
    • قسمت ExportResult.processedInputs حذف کنید. اگر از این فیلد برای جزئیات کدک استفاده می کنید، به جای آن از DefaultDecoderFactory.listener استفاده کنید. در صورت استثناء کدک، جزئیات کدک در ExportException.codecInfo در دسترس خواهد بود.
  • استخراج کننده ها:
    • MPEG-TS: تغییر را به جلو بچرخانید تا مطمئن شوید آخرین فریم با عبور دادن آخرین واحد دسترسی یک جریان به صف نمونه ( #7909 ) رندر شده است. افزودن راه‌حل‌هایی برای حل مشکلاتی که در I-frame فقط در جریان‌های HLS ( #1150 ) و H.262 HLS ( #1126 ) ظاهر شدند.
    • MP3: اندازه داده را از یک قاب Info به اندازه گزارش شده توسط جریان اصلی ترجیح دهید (مثلاً اندازه فایل یا سرصفحه Content-Length HTTP). این به حذف داده‌های تریلر غیرقابل پخش (مثلاً آثار هنری آلبوم) از محاسبات جستجوی نرخ بیت ثابت کمک می‌کند و جستجوها را دقیق‌تر می‌کند ( #1376 ).
    • MP3: از تعداد فریم و سایر داده‌ها در یک قاب Info (در صورت وجود) برای محاسبه نرخ بیت متوسط ​​برای جستجوی نرخ بیت ثابت استفاده کنید، به جای برون یابی از نرخ بیت فریم بعد از قاب Info ، که ممکن است به طور مصنوعی کوچک باشد، به عنوان مثال فریم PCUT ( #1376 ).
    • رفع فرمت صوتی PCM در ظروف AVI.
  • صوتی:
    • اصلاح ویژگی های رمزگذاری DTS:X Profile 2 برای پخش گذرا ( #1299 ).
    • For offloaded playback, reset the tracking field for stream completion in DefaultAudioSink prior to calling AudioTrack.stop() so that AudioTrack.StreamEventCallback#onPresentationEnded correctly identifies when all pending data has been played.
    • رفع اشکال در SilenceSkippingAudioProcessor که در آن انتقال بین فرمت‌های صوتی مختلف (به عنوان مثال استریو به مونو) می‌تواند باعث شود پردازنده یک استثنا ایجاد کند ( #1352 ).
    • MediaCodecAudioRenderer.getDurationToProgressUs() را پیاده سازی کنید تا ExoPlayer به صورت پویا حلقه کار اصلی خود را تا زمانی که MediaCodecAudioRenderer می تواند پیشرفت کند برنامه ریزی کند.
  • ویدئو:
    • مشکلی را که در آن Listener.onRenderedFirstFrame() خیلی زود می رسد، هنگام تعویض سطوح در اواسط پخش، برطرف کنید.
    • منطق برگشتی رمزگشا را برای Dolby Vision اصلاح کنید تا در صورت نیاز از رمزگشای AV1 سازگار استفاده کند ( #1389 ).
    • رفع استثنا کدک که ممکن است با فعال کردن رندر ویدیو در اواسط پخش ایجاد شود.
  • متن:
    • مشکل شروع زیرنویس‌ها قبل از نادیده گرفتن موقعیت جستجو را برطرف کنید. این موضوع فقط در Media3 1.4.0-alpha01 معرفی شد.
    • رفتار تجزیه پیش‌فرض زیرنویس را تغییر دهید تا در حین استخراج به جای رندر کردن اتفاق بیفتد (برای تفاوت بین استخراج و رندر به نمودار معماری ExoPlayer مراجعه کنید).
      • این تغییر را می توان با فراخوانی MediaSource.Factory.experimentalParseSubtitlesDuringExtraction MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) و TextRenderer.experimentalSetLegacyDecodingEnabled(true) لغو کرد. برای نحوه وارد کردن این اجزا به یک نمونه ExoPlayer ، به اسناد سفارشی‌سازی مراجعه کنید. این روش ها (و همه پشتیبانی از رمزگشایی زیرنویس قدیمی) در نسخه بعدی حذف خواهند شد.
      • برنامه‌های دارای پیاده‌سازی سفارشی SubtitleDecoder باید برای پیاده‌سازی SubtitleParser (و SubtitleParser.Factory به جای SubtitleDecoderFactory ) آنها را به‌روزرسانی کنند.
    • PGS: رمزگشایی طول اجرا را تصحیح کنید تا 0 به‌عنوان شاخص رنگ، به جای مقدار واقعی رنگ ( #1367 ) حل کنید.
    • CEA-708: مقدار rowLock نادیده بگیرید. مشخصات CEA-708-E S-2023 بیان می کند که rowLock و columnLock هر دو باید درست فرض شوند، صرف نظر از مقادیر موجود در جریان (پشتیبانی columnLock اجرا نمی شود، بنابراین عملاً فرض می شود همیشه نادرست است).
      • این در ابتدا در یادداشت های انتشار 1.3.0-alpha01 گنجانده شده بود، اما این تغییر به طور تصادفی قبل از انتشار 1.3.0-rc01 برگردانده شد. اکنون این مشکل برطرف شده است، بنابراین تغییر دوباره وجود دارد.
    • CEA-708: از اضافه شدن خطوط جدید تکراری با مدیریت ساده ExoPlayer دستور 'set pen location' ( #1315 ) خودداری کنید.
    • هنگامی که یک نمونه زیرنویس WebVTT هیچ نشانه ای ندارد، مثلاً به عنوان بخشی از جریان DASH ( #1516 )، یک IllegalArgumentException از LegacySubtitleUtil را برطرف کنید.
  • فراداده:
    • نگاشت برچسب های مرتب سازی MP4 به ID3 را برطرف کنید. قبلاً برچسب‌های MP4 «مرتب‌سازی آلبوم» ( soal )، «مرتب‌سازی هنرمند» ( soar ) و «مرتب‌سازی هنرمند آلبوم» ( soaa ) به اشتباه با برچسب‌های TSO2 ، TSOA و TSOP ID3 ( #1302 ) نگاشت شده بودند.
    • خواندن برچسب‌های MP4 (/iTunes) عددی gnre (ژانر) و tmpo (تمپو) را هنگامی که مقدار آن بیش از یک بایت است برطرف کنید.
    • فریم ID3 TCON را در MediaMetadata.genre ( #1305 ) منتشر کنید.
  • تصویر:
    • پشتیبانی از شبکه‌های تصویر کوچک DASH غیر مربعی ( #1300 ) را اضافه کنید.
    • پشتیبانی از AVIF برای API 34+ را اضافه کنید.
    • برای پاک کردن یک ImageOutput از قبل تنظیم شده، به null به عنوان پارامتر برای ExoPlayer.setImageOutput() اجازه دهید.
  • منبع داده:
    • پشتیبانی از android.resource://package/id URI های منبع خام را در جایی که package با بسته برنامه فعلی متفاوت است، اجرا کنید. این قبلاً برای کار مستند نشده بود، اما روشی کارآمدتر برای دسترسی به منابع در بسته‌ای دیگر به جای نام است.
    • Eagerly check url is non-null in the DataSpec constructors. این پارامتر قبلاً به عنوان غیر تهی توضیح داده شده بود.
    • به ByteArrayDataSource اجازه دهید یک URI را در یک آرایه بایتی در حین open() حل کند، به جای اینکه در ساخت و ساز به صورت سخت کدگذاری شود ( #1405 ).
  • 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 بهبود می بخشد.
    • اجرای ماتریس Overlay را با برگرداندن مقادیر x و y اعمال شده در setOverlayFrameAnchor() به‌روزرسانی کنید تا با مستندات مطابقت داشته باشد. اگر از OverlaySettings.Builder.setOverlayFrameAnchor() استفاده می کنید، مقادیر x و y آنها را با ضرب آنها در -1 برگردانید.
    • رفع اشکال زمانی که TimestampWrapper هنگام استفاده با ExoPlayer#setVideoEffects ( #821 ) از کار می افتد.
    • فضای کار رنگ SDR پیش‌فرض را از رنگ‌های خطی به ویدیوی الکتریکی BT 709 SDR تغییر دهید. همچنین گزینه سوم را برای حفظ فضای رنگ اصلی ارائه دهید.
    • اجازه تعریف مرتبه z نامعین EditedMediaItemSequences ( #1055 ).
    • محدوده روشنایی ثابتی را در قطعات مختلف محتوای HDR حفظ کنید (از محدوده HLG استفاده می کند).
    • پشتیبانی از پوشش‌های Ultra HDR (bitmap) روی محتوای HDR را اضافه کنید.
    • اجازه استفاده از جلوه‌های SeparableConvolution قبل از API 26 را بدهید.
    • OverlaySettings.useHdr استفاده نشده را حذف کنید زیرا محدوده دینامیکی پوشش و فریم باید مطابقت داشته باشند.
    • پشتیبانی HDR را برای TextOverlay اضافه کنید. درخشندگی روکش متن را می توان با OverlaySettings.Builder.setHdrLuminanceMultiplier() تنظیم کرد.
  • پسوند IMA:
    • API مورد نیاز برای برنامه‌ها برای پخش جریان‌های تبلیغات DAI را به پایداری ارتقا دهید.
    • به ImaServerSideAdInsertionMediaSource.AdLoader جایگزینی پارامترهای تگ آگهی را در زمان اجرا، replaceAdTagParameters(Map <String, String>) اضافه کنید.
    • رفع اشکالی که در آن هنگام پخش یک خطای پخش کننده در حین پخش آگهی ( #1334 ) فراخوانی نشد VideoAdPlayer.VideoAdPlayerCallback.onError() .
    • نسخه IMA SDK را به 3.33.0 برسانید تا یک NullPointerException در هنگام استفاده از URIهای برچسب آگهی data:// ( #700 ) برطرف شود.
  • جلسه:
    • پیش‌فرض CommandButton.enabled را به true تغییر دهید و اطمینان حاصل کنید که مقدار ممکن است برای کنترل‌کننده‌ها نادرست بماند، حتی اگر دستور مربوطه در دسترس باشد.
    • ثابت های نماد را برای CommandButton اضافه کنید که باید به جای منابع آیکون سفارشی استفاده شود.
    • MediaSessionService.isPlaybackOngoing() را اضافه کنید تا به برنامه ها اجازه دهید پرس و جو کنند که آیا سرویس باید در onTaskRemoved() متوقف شود ( #1219 ).
    • MediaSessionService.pauseAllPlayersAndStopSelf() را اضافه کنید که به راحتی امکان توقف پخش تمام جلسات و فراخوانی stopSelf() را برای پایان دادن به چرخه عمر MediaSessionService فراهم می کند.
    • MediaSessionService.onTaskRemoved(Intent) را نادیده بگیرید تا یک پیاده‌سازی پیش‌فرض ایمن ارائه کنید که اگر پخش ادامه دارد، سرویس را در پیش‌زمینه در حال اجرا نگه می‌دارد یا در غیر این صورت سرویس را متوقف می‌کند.
    • با تنظیم نکردن مدت زمان در فراداده جلسه پلت فرم ( #1256 )، نوار جستجو را در اعلان رسانه برای پخش‌های زنده پنهان کنید.
    • Align conversion of MediaMetadata to MediaDescriptionCompat , to use the same preferred order and logic when selecting metadata properties as in media1.
    • MediaSession.sendError() را اضافه کنید که امکان ارسال خطاهای غیر کشنده را به کنترلر Media3 می دهد. هنگام استفاده از کنترلر اعلان (به MediaSession.getMediaNotificationControllerInfo() مراجعه کنید)، از خطای سفارشی برای به روز رسانی PlaybackState جلسه پلت فرم به حالت خطا با اطلاعات خطای داده شده ( #543 ) استفاده می شود.
    • Add MediaSession.Callback.onPlayerInteractionFinished() to inform sessions when a series of player interactions from a specific controller finished.
    • SessionError اضافه کنید و از آن به جای کد خطا در SessionResult و LibraryResult استفاده کنید تا در صورت امکان اطلاعات بیشتری در مورد خطا و نحوه رفع خطا ارائه دهید.
    • کد برنامه آزمایشی کنترلر media3 را منتشر کنید که می تواند برای آزمایش تعامل با برنامه هایی که یک جلسه رسانه را منتشر می کنند استفاده شود.
    • موارد اضافی ارسال شده به MediaSession[Builder].setSessionExtras() media3 را به PlaybackStateCompat.getExtras() کنترلر media1 منتشر کنید.
    • خطاهای کشنده و غیرکشنده را به و از جلسه پلت فرم نقشه برداری کنید. یک PlaybackException به حالت خطای مرگبار PlaybackStateCompat نگاشت می شود. یک SessionError که با MediaSession.sendError(ControllerInfo, SessionError) به کنترل‌کننده اعلان رسانه ارسال می‌شود به یک خطای غیرمرگبار در PlaybackStateCompat نگاشت می‌شود که به این معنی است که کد خطا و پیام تنظیم شده‌اند اما وضعیت جلسه پلتفرم با STATE_ERROR متفاوت است.
    • اجازه دهید فعالیت جلسه برای هر کنترل کننده تنظیم شود تا فعالیت جلسه سراسری را لغو کند. فعالیت جلسه را می توان برای یک کنترلر در زمان اتصال با ایجاد یک ConnectionResult با AcceptedResultBuilder.setSessionActivivty(PendingIntent) تعریف کرد. پس از اتصال، فعالیت جلسه را می توان با MediaSession.setSessionActivity(ControllerInfo, PendingIntent) به روز کرد.
    • تکرار خطای تماس ها به MediaLibrarySession.Callback را بهبود بخشید. تکرار خطا را می توان با استفاده از MediaLibrarySession.Builder.setLibraryErrorReplicationMode() برای انتخاب نوع خطا یا انصراف از تکرار خطا که به طور پیش فرض روشن است پیکربندی کرد.
  • UI:
    • هنگام اتصال به ExoPlayer پشتیبانی از نمایش تصویر را به PlayerView اضافه کنید ( #1144 ).
    • سفارشی‌سازی نمادهای مختلف در PlayerControlView را از طریق ویژگی‌های xml اضافه کنید تا به جای بازنویسی‌های سراسری، نقشه‌های مختلف در هر نمونه PlayerView مجاز شود ( #1200 ).
    • هنگام استفاده از SurfaceView در داخل Compose AndroidView در API 34 ( #1237 ) باگ پلتفرمی را که باعث کشیدگی/برش ویدیو می‌شود، حل کنید.
  • دانلودها:
    • اطمینان حاصل کنید که DownloadHelper نمونه‌های Renderer منتشر نشده را لو نمی‌دهد، که در نهایت می‌تواند منجر به از کار افتادن برنامه با IllegalStateException: Too many receivers, total of 1000, registered for pid ( #1224 ).
  • پسوند کرونت:
    • SocketTimeoutException در CronetDataSource رفع کنید. در برخی از نسخه های Cronet، درخواست ارائه شده توسط callback همیشه یکسان نیست. این منجر به تکمیل نشدن تماس و اتمام زمان درخواست می شود (https://issuetracker.google.com/328442628).
  • برنامه افزودنی HLS:
    • رفع اشکال که در آن نمونه‌های معلق EMSG در انتظار یک ناپیوستگی در HlsSampleStreamWrapper با یک افست نادرست که باعث یک IndexOutOfBoundsException یا یک IllegalArgumentException می‌شود ( #1002 ) تفویض شده است.
    • رفع اشکال که در آن لیست‌های پخش غیراصلی برای جریان‌های LL-HLS بارگیری مجدد می‌شوند ( #1240 ).
    • رفع اشکال که در آن فعال کردن CMCD برای HLS با بخش های اولیه منجر به Source Error و IllegalArgumentException شد.
    • رفع اشکال که در آن لیست‌های پخش غیراصلی در حین پخش زنده به روز نمی‌شوند ( #1240 ).
    • رفع اشکال که در آن فعال کردن CMCD برای پخش‌های زنده HLS باعث ایجاد ArrayIndexOutOfBoundsException ( #1395 ) می‌شود.
  • پسوند DASH:
    • رفع اشکال که در آن آماده‌سازی مجدد یک پخش زنده چند دوره‌ای می‌تواند IndexOutOfBoundsException ایجاد کند ( #1329 ).
    • پشتیبانی از dashif:Laurl ( #1345 ) را اضافه کنید.
  • پسوند بازیگران:
    • رفع اشکالی که عنوان آلبوم MediaQueueItem را به هنرمند در آیتم رسانه Media3 ( #1255 ) تبدیل کرده است.
  • ابزارهای آزمایشی:
    • onInit() و onRelease() در FakeRenderer پیاده سازی کنید.
    • روش‌های TestPlayerRunHelper.runUntil()/playUntil() تغییر دهید تا در خطاهای غیرمرگبار (مثلاً مواردی که به AnalyticsListener.onVideoCodecError() ) گزارش شده‌اند با شکست مواجه شوند. برای غیرفعال کردن این رفتار از زنجیره روش TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() جدید استفاده کنید.
  • برنامه نمایشی:
    • از DefaultPreloadManager در برنامه نمایشی فرم کوتاه استفاده کنید.
    • اجازه تنظیم حالت تکرار با آرگومان های Intent از خط فرمان ( #1266 ).
    • هنگامی که دستگاه پشتیبانی می کند، از HttpEngineDataSource به عنوان HttpDataSource استفاده کنید.
  • حذف نمادهای منسوخ شده:
    • CronetDataSourceFactory حذف کنید. به جای آن از CronetDataSource.Factory استفاده کنید.
    • برخی از سازنده های DataSpec را حذف کنید. Use DataSpec.Builder instead.
    • متد setContentTypePredicate(Predicate) را از DefaultHttpDataSource ، OkHttpDataSource و CronetDataSource حذف کنید. به جای آن از روش معادل در هر XXXDataSource.Factory استفاده کنید.
    • سازنده های OkHttpDataSource و OkHttpDataSourceFactory را حذف کنید. به جای آن از OkHttpDataSource.Factory استفاده کنید.
    • PlayerMessage.setHandler(Handler) را حذف کنید. به جای آن از setLooper(Looper) استفاده کنید.
    • قسمت Timeline.Window.isLive را حذف کنید. به جای آن از متد isLive() استفاده کنید.
    • سازندگان DefaultHttpDataSource حذف کنید. به جای آن از DefaultHttpDataSource.Factory استفاده کنید.
    • DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS را حذف کنید. به جای آن از DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS استفاده کنید.
    • MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) را حذف کنید. به جای آن از MediaCodecInfo.canReuseCodec(Format, Format) استفاده کنید.
    • روش DrmSessionManager.DUMMY و getDummyDrmSessionManager() را حذف کنید. به جای آن از DrmSessionManager.DRM_UNSUPPORTED استفاده کنید.
    • حذف AnalyticsListener.onAudioInputFormatChanged(EventTime, Format) , AnalyticsListener.onVideoInputFormatChanged(EventTime, Format) , AudioRendererEventListener.onAudioInputFormatChanged(Format) , VideoRendererEventListener.onVideoInputFormatChanged(Format) . به جای آن از بارهای اضافه استفاده کنید که DecoderReuseEvaluation می گیرند.
    • RendererSupport.FormatSupport IntDef و FORMAT_HANDLED ، FORMAT_EXCEEDS_CAPABILITIES ، FORMAT_UNSUPPORTED_DRM ، FORMAT_UNSUPPORTED_SUBTYPE ، FORMAT_UNSUPPORTED_TYPE را حذف کنید. به جای آن از IntDef و ثابت های معادل در androidx.media3.common.C استفاده کنید (مثلاً C.FORMAT_HANDLED ).
    • رابط Bundleable را حذف کنید. این شامل حذف تمام فیلدهای ثابت Bundleable.Creator<Foo> CREATOR است. تماس گیرندگان باید از روش های Bundle toBundle() و static Foo fromBundle(Bundle) در هر نوع استفاده کنند.

نسخه 1.4.0-rc01

10 جولای 2024

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

نسخه 1.4.0-beta01

26 ژوئن 2024

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

نسخه 1.4.0-alpha02

07 ژوئن 2024

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

نسخه 1.4.0-alpha01

17 آوریل 2024

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

نسخه 1.3.0

نسخه 1.3.1

11 آوریل 2024

androidx.media3:media3-*:1.3.1 منتشر شد. نسخه 1.3.1 حاوی این commit ها است.

  • کتابخانه مشترک:
    • Format.labels اضافه کنید تا به برچسب‌های محلی یا جایگزین دیگر اجازه دهید.
  • ExoPlayer:
    • Fix issue where PreloadMediaPeriod cannot retain the streams when it is preloaded again.
    • TrackSelectionResult صحیح مربوطه را به دوره پخش در انتخاب مجدد آهنگ اعمال کنید.
    • رندرهای فعال اولیه را فقط پس از پیشبرد دوره پخش هنگام انتقال بین آیتم های رسانه ( #1017 ) شروع کنید.
    • نوع بازگشت گمشده را به قانون proguard -keepclasseswithmembers برای DefaultVideoFrameProcessor.Factory.Builder.build() ( #1187 ) اضافه کنید.
  • ترانسفورماتور:
    • به دلیل عدم پشتیبانی MediaMuxer از مهرهای زمانی ارائه منفی قبل از API 30، راه حلی را برای استثناء ایجاد شده اضافه کنید.
  • انتخاب آهنگ:
    • DefaultTrackSelector : آهنگ‌های ویدیویی با نرخ فریم «معقول» (>=10 فریم در ثانیه) را به آهنگ‌هایی با نرخ فریم پایین‌تر یا تنظیم‌نشده ترجیح دهید. این تضمین می‌کند که پخش‌کننده آهنگ ویدیویی «واقعی» را در MP4‌های استخراج‌شده از عکس‌های متحرک که می‌تواند حاوی دو آهنگ HEVC باشد، انتخاب کند که یکی از آنها وضوح بالاتر اما تعداد فریم‌های بسیار کمی دارد ( #1051 ).
  • استخراج کننده ها:
    • مشکلی را که در آن هنگام خواندن تکه‌هایی با اندازه عجیب و غریب از فایل‌های WAV حذف نمی‌شد، برطرف کنید ( #1117 ).
    • MP3: Format.averageBitrate از فریم های ابرداده مانند XING و VBRI پر کنید.
    • MPEG-TS: تغییری را که هدف آن اطمینان از رندر شدن آخرین فریم با ارسال آخرین واحد دسترسی یک جریان به صف نمونه ( #7909 ) است، برگردانید. این به دلیل تغییری است که باعث ایجاد مشکلات جدید در جریان‌های HLS فقط با I-frame ( #1150 ) و جریان‌های H.262 HLS ( #1126 ) شده است.
  • صوتی:
    • در صورتی که تراک صوتی در حالت بارگذاری اولیه نشد، با غیرفعال کردن بارگذاری، بازیابی رندر را مجاز کنید.
  • ویدئو:
    • راه‌حلی برای مشکل دستگاه در Galaxy Tab S7 FE، Chromecast با Google TV و Lenovo M10 FHD Plus اضافه کنید که باعث می‌شود جریان‌های H265 با سرعت 60 فریم در ثانیه به‌عنوان پشتیبانی‌نشده علامت‌گذاری شوند.
    • راه حلی را اضافه کنید که اطمینان حاصل کند که اولین فریم همیشه در حین تونل زدن رندر می شود، حتی اگر دستگاه این کار را به طور خودکار همانطور که توسط API لازم است انجام ندهد ( #1169 ). ( #966 ).
    • مشکلی را که در آن مدیریت اطلاعات رنگ HDR باعث رفتار نادرست کدک می‌شود و از تغییر فرمت تطبیقی ​​برای آهنگ‌های ویدیوی SDR جلوگیری می‌کند، برطرف کنید ( #1158 ).
  • متن:
    • WebVTT: از ایجاد نمونه های جعلی اضافی CuesWithTiming از WebvttParser.parse ( #1177 ) از نشانه های مستقیم متوالی جلوگیری کنید.
  • DRM:
    • یک NoSuchMethodError حل کنید که می تواند توسط چارچوب MediaDrm به جای ResourceBusyException یا NotProvisionedException در برخی از دستگاه های Android 14 ( #1145 ) پرتاب شود.
  • اثر:
    • با تبدیل فضاهای رنگی، نگاشت تن PQ به SDR بهبود یافته است.
  • جلسه:
    • Fix issue where the current position jumps back when the controller replaces the current item ( #951 ).
    • مشکلی را که در آن MediaMetadata فقط با extras غیر تهی بین کنترل‌کننده‌های رسانه و جلسات ارسال نمی‌شود برطرف کنید ( #1176 ).
  • UI:
    • در صورتی که Locale نتواند نام نمایشی را شناسایی کند ( #988 ).
  • پسوند DASH:
    • همه عناصر Label از مانیفست در Format.labels پر کنید ( #1054 ).
  • پسوند RTSP:
    • از مقادیر اطلاعات جلسه خالی (i-tags) در تجزیه SDP صرفنظر کنید ( #1087 ).
  • پسوندهای رمزگشا (FFmpeg، VP9، AV1، MIDI و غیره):
    • افزونه MIDI را به‌عنوان یک وابستگی محلی به‌طور پیش‌فرض غیرفعال کنید، زیرا به یک مخزن Maven اضافی برای پیکربندی نیاز دارد. کاربرانی که به این ماژول از یک وابستگی محلی نیاز دارند ، می توانند آن را دوباره فعال کنند .

نسخه 1.3.0

6 مارس 2024

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

  • کتابخانه مشترک:
    • پشتیبانی از android.resource://package/[type/]name URIهای منبع خام را در جایی که package با بسته برنامه فعلی متفاوت است، اجرا کنید. این همیشه برای کار مستند بوده است، اما تا کنون به درستی اجرا نشده است.
    • انواع MIME را که توسط کد برنامه تنظیم شده اند یا از رسانه خوانده می شوند عادی کنید تا کاملاً حروف کوچک باشند.
    • تبلیغات را با یک MediaItem کامل به جای یک Uri در AdPlaybackState تعریف کنید.
    • minSdk به 19 (Android KitKat) افزایش دهید. این با سایر کتابخانه‌های AndroidX هماهنگ است و برای ارتقاء به آخرین نسخه‌های وابستگی‌های AndroidX خود لازم است.
    • هر دو artworkUri و artworkData در MediaMetadata.Builder.populate(MediaMetadata) پر کنید که حداقل یکی از آنها غیر تهی باشد ( #964 ).
  • ExoPlayer:
    • PreloadMediaSource و PreloadMediaPeriod را اضافه کنید که به برنامه‌ها اجازه می‌دهد قبل از پخش، منبع رسانه محتوا را در یک موقعیت شروع خاص بارگذاری کنند. PreloadMediaSource آماده سازی منبع رسانه محتوا برای دریافت Timeline ، آماده سازی و ذخیره سازی دوره در موقعیت شروع مشخص، انتخاب آهنگ ها و بارگیری داده های رسانه برای دوره است. برنامه‌ها با پیاده‌سازی PreloadMediaSource.PreloadControl پیشرفت پیش‌بارگذاری را کنترل می‌کنند و منبع از پیش بارگذاری‌شده را روی پخش‌کننده برای پخش تنظیم می‌کنند.
    • ExoPlayer.setImageOutput را اضافه کنید که به برنامه ها اجازه می دهد ImageRenderer.ImageOutput تنظیم کنند.
    • اکنون DefaultRenderersFactory یک ImageRenderer به طور پیش فرض با ImageOutput null و ImageDecoder.Factory.DEFAULT در اختیار پخش کننده قرار می دهد.
    • هنگامی که سکوت حذف می شود، رویداد Player.Listener.onPositionDiscontinuity را منتشر کنید ( #765 ).
    • پشتیبانی آزمایشی برای تجزیه زیرنویس ها در حین استخراج اضافه کنید. شما می توانید این را با استفاده از MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() فعال کنید.
    • Support adaptive media sources with PreloadMediaSource .
    • HttpEngineDataSource ، یک HttpDataSource را با استفاده از HttpEngine API پیاده سازی کنید.
    • جلوگیری از زیر کلاس بندی CompositeSequenceableLoader . این مؤلفه قبلاً قابل توسعه بود اما هرگز در کتابخانه زیر کلاس قرار نگرفت. سفارشی‌سازی‌ها را می‌توان با بسته‌بندی یک نمونه با استفاده از الگوی دکوراتور و پیاده‌سازی یک CompositeSequenceableLoaderFactory سفارشی انجام داد.
    • مشکل را برطرف کنید که تکرار همان زمان باعث پاک شدن ابرداده از این مورد می‌شود ( #1007 ).
    • متدهای experimentalSetSubtitleParserFactory در BundledChunkExtractor.Factory و DefaultHlsExtractorFactory به setSubtitleParserFactory تغییر نام دهید و اجازه ارسال null را ممنوع کنید. برای کنترل رفتار تجزیه از روش‌های جدید experimentalParseSubtitlesDuringExtraction(boolean) استفاده کنید.
    • پشتیبانی برای سفارشی کردن SubtitleParser.Factory مورد استفاده در حین استخراج اضافه کنید. این را می توان با MediaSource.Factory.setSubtitleParserFactory() به دست آورد.
    • پیشوند منبع را به تمام فیلدهای Format.id که از MergingMediaSource ایجاد شده است اضافه کنید. این کمک می کند تا مشخص شود کدام منبع یک Format را تولید کرده است ( #883 ).
    • Regex مورد استفاده برای اعتبارسنجی نام‌های کلید سفارشی Common Media Client Data (CMCD) را با تغییر آن به گونه‌ای که فقط خط فاصله ( #1028 ) بررسی شود، برطرف کنید.
    • رمزگذاری دوگانه پارامترهای پرس و جو CMCD را متوقف کنید ( #1075 ).
  • ترانسفورماتور:
    • برای صاف کردن ویدیوهای حرکت آهسته H.265/HEVC SEF پشتیبانی اضافه کنید.
    • سرعت transmuxing را افزایش دهید، به خصوص برای ویرایش های "حذف ویدئو".
    • API را اضافه کنید تا مطمئن شوید که فایل خروجی روی یک فریم ویدیو شروع می شود. این می‌تواند خروجی عملیات برش را با پیاده‌سازی‌های پخش‌کننده‌ای که اولین فریم ویدیو را تا زمان نمایش آن نشان نمی‌دهند سازگارتر کند ( #829 ).
    • اضافه کردن پشتیبانی برای بهینه سازی عملیات تریم MP4 تک دارایی.
    • برای اطمینان از اینکه یک فریم ویدیو دارای اولین مهر زمانی در فایل خروجی است، پشتیبانی اضافه کنید. فایل‌های خروجی را که با فریم سیاه شروع می‌شوند در پخش‌کننده‌های مبتنی بر iOS برطرف می‌کند ( #829 ).
  • انتخاب آهنگ:
    • برای فعال کردن انتخاب مسیر تصویر، DefaultTrackSelector.selectImageTrack را اضافه کنید.
    • TrackSelectionParameters.isPrioritizeImageOverVideoEnabled اضافه کنید تا تعیین کنید در صورت در دسترس بودن تراک تصویر و تراک ویدیو، یک آهنگ تصویر را انتخاب کنید یا خیر. مقدار پیش‌فرض false است که به این معنی است که انتخاب یک آهنگ ویدیویی در اولویت است.
  • استخراج کننده ها:
    • برای بازیابی مقادیر ColorInfo.colorSpace ، ColorInfo.colorTransfer و ColorInfo.colorRange ( #692 )، تجزیه AV1C اضافی را به استخراج کننده MP4 اضافه کنید.
    • MP3: از جستجوی نرخ بیت ثابت (CBR) برای فایل هایی با هدر Info (معادل CBR هدر Xing ) استفاده کنید. قبلاً از جدول جستجو از هدر Info استفاده می‌کردیم، اما این باعث می‌شود که جستجوی دقیق‌تری نسبت به زمانی که آن را نادیده بگیریم و فایل را CBR فرض کنیم، کمتر می‌شود.
    • MPEG2-TS: پشتیبانی از DTS، DTS-LBR و DTS:X Profile2 را اضافه کنید ( #275 ).
    • انواع صدا را از توصیفگرهای TS استخراج کنید و آنها را به پرچم‌های نقش نگاشت کنید، که به کاربران امکان می‌دهد انتخاب آهنگ‌های صوتی با اطلاعات بهتری انجام دهند ( #973 ).
  • صوتی:
    • بهبود الگوریتم پرش سکوت با سطح شیبدار حجمی صاف. حداقل سکوت و مدت زمان سکوت طبیعی تر را حفظ کرد ( #7423 ).
    • سکوت نادیده گرفته شده را با قطعیت بیشتری گزارش کنید ( #1035 ).
  • ویدئو:
    • سازنده MediaCodecVideoRenderer را تغییر دهید که آرگومان VideoFrameProcessor.Factory را می گیرد و آن را با سازنده ای که آرگومان VideoSinkProvider می گیرد جایگزین کنید. برنامه‌هایی که می‌خواهند VideoFrameProcessor.Factory سفارشی تزریق کنند، می‌توانند CompositingVideoSinkProvider را که از VideoFrameProcessor.Factory سفارشی استفاده می‌کند، نمونه‌سازی کنند و ارائه‌دهنده سینک ویدئو را به MediaCodecVideoRenderer ارسال کنند.
  • متن:
    • تصحیح سریال‌سازی نشانه‌های بیت‌مپ برای حل کردن، هنگام استفاده از DefaultExtractorsFactory.setTextTrackTranscodingEnabled ( #836 ) Tried to marshall a Parcel that contained Binder objects .
    • CEA-708: مقدار rowLock نادیده بگیرید. مشخصات CEA-708-E S-2023 بیان می کند که rowLock و columnLock هر دو باید درست فرض شوند، صرف نظر از مقادیر موجود در جریان (پشتیبانی columnLock اجرا نمی شود، بنابراین عملاً فرض می شود همیشه نادرست است).
  • تصویر:
    • پشتیبانی از تصاویر کوچک DASH را اضافه کنید. تصاویر شبکه‌ای برش داده می‌شوند و تصاویر کوچک فردی نزدیک به زمان ارائه‌شان در اختیار ImageOutput قرار می‌گیرند.
  • DRM:
    • به‌طور پیش‌فرض، نمونه‌های رمزگذاری‌نشده «سرنخ پاک» را بلافاصله در محتوای DRM پخش کنید، حتی اگر کلیدهای نمونه‌های رمزگذاری‌شده بعدی هنوز آماده نباشند. اگر زمانی که موقعیت پخش به نمونه‌های رمزگذاری‌شده برسد، کلیدها هنوز آماده نباشند، ممکن است منجر به توقف در اواسط پخش شود (اما قبلاً پخش اصلاً تا این لحظه شروع نمی‌شد). این رفتار را می توان با MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey یا DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys غیرفعال کرد.
  • پسوند IMA:
    • مشکلی را برطرف کنید که در آن تبلیغات DASH و HLS بدون پسوند فایل مناسب قابل پخش نیستند.
  • جلسه:
    • غیرفعال کردن تشخیص دوبار کلیک برای برنامه های تلویزیون ( #962 ).
    • مشکلی را برطرف کنید که MediaItem.RequestMetadata فقط با موارد اضافی غیر تهی بین کنترلرهای رسانه و جلسات ارسال نمی شود.
    • Add constructor to MediaLibrarySession.Builder that only takes a Context instead of a MediaLibraryService .
  • برنامه افزودنی HLS:
    • HlsMediaPeriod به نمای بسته-خصوصی کاهش دهید. این نوع نباید مستقیماً به خارج از بسته HLS وابسته باشد.
    • Resolve به دنبال شروع یک بخش کارآمدتر است ( #1031 ).
  • پسوندهای رمزگشا (FFmpeg، VP9، AV1، MIDI و غیره):
    • رمزگشای MIDI: پیام های رویداد SysEx را نادیده بگیرید ( #710 ).
  • ابزارهای آزمایشی:
    • پخش را در TestPlayerRunHelper.playUntilPosition متوقف نکنید. تست پخش را در حالت پخش نگه می‌دارد، اما پیشرفت را تا زمانی که تست قادر به اضافه کردن ادعاها و اقدامات بیشتر باشد به حالت تعلیق در می‌آورد.
  • برنامه نمایشی:
    • یک ماژول دمو فرم کوتاه به نسخه نمایشی استفاده از PreloadMediaSource با استفاده از محتوای کوتاه فرم اضافه کنید.

نسخه 1.3.0-rc01

22 فوریه 2024

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

نسخه 1.3.0-beta01

7 فوریه 2024

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

نسخه 1.3.0-alpha01

15 ژانویه 2024

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

نسخه 1.2.0

نسخه 1.2.1

9 ژانویه 2024

  • ExoPlayer:
    • رفع مشکلی که به صورت دستی به دنبال جستجوی خارج از محدوده LiveConfiguration.min/maxOffset است، به تنظیم افست به min/maxOffset ادامه دهید.
    • مشکل اشتباه بودن طرح‌بندی کانال OPUS و VORBIS برای کانال‌های 3، 5، 6، 7 و 8 ( #8396 ) را برطرف کنید.
    • مشکلی را برطرف کنید که در آن انتخاب‌های آهنگ پس از صفر شدن در یک پخش زنده به اشتباه اجازه می‌دهد جریان در موقعیت پیش‌فرض خود ( #9347 ) شروع شود.
    • مشکل را برطرف کنید که در آن نمونه‌های جدید CmcdData.Factory مقادیر منفی برای bufferedDurationUs از منابع تکه دریافت می‌کردند که منجر به یک IllegalArgumentException ( #888 ) می‌شد.
  • ترانسفورماتور:
    • مشکلی را حل کنید که در آن رمزگذار در زمان پیکربندی به دلیل تنظیم نرخ عملیاتی بالا پرتاب می‌شود.
  • استخراج کننده ها:
    • 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.
    • تشخیص اشتباه فریم کلیدی برای جریان های TS H264 ( #864 ) را برطرف کنید.
    • برآورد مدت زمان جریان‌های TS که بیشتر از 47721 ثانیه هستند را برطرف کنید ( #855 ).
  • صوتی:
    • مدیریت EOS برای SilenceSkippingAudioProcessor هنگامی که چندین بار فراخوانی می شود را برطرف کنید ( #712 ).
  • ویدئو:
    • راه حلی را برای مشکل دستگاه در Galaxy Tab S7 FE، Chromecast با Google TV و Lenovo M10 FHD Plus اضافه کنید که باعث می‌شود جریان‌های AVC با سرعت ۶۰ فریم در ثانیه به‌عنوان پشتیبانی‌نشده علامت‌گذاری شوند ( #۶۹۳ ).
  • فراداده:
    • رفع اشکال که در آن MediaMetadata فقط از نظرات Vorbis با کلیدهای بزرگ پر شده بود ( #876 ).
    • هنگام تجزیه فریم های ID3 بسیار بزرگ، OutOfMemoryError بگیرید، به این معنی که پخش می تواند بدون اطلاعات برچسب ادامه یابد، به جای اینکه پخش به طور کامل شکست بخورد.
  • DRM:
    • راه حل برای آدرس اینترنتی مجوز ClearKey https://default.url جعلی را به API 33+ گسترش دهید (قبلاً این راه حل فقط در API 33 دقیقاً اعمال می شد) ( #837 ).
    • ERROR_DRM_SESSION_NOT_OPENED هنگام تغییر از محتوای رمزگذاری شده به محتوای پاک بدون سطح متصل به پخش کننده برطرف کنید. این خطا به دلیل استفاده نادرست از رمزگشای ایمن برای پخش محتوای واضح بود.
  • جلسه:
    • کلیدها و مقادیر سفارشی را در MediaMetadataCompat در MediaMetadata.extras و MediaMetadata.extras در MediaMetadataCompat قرار دهید ( #756 ، #802 ).
    • پخش notifyChildrenChanged برای کنترل‌کننده‌های قدیمی برطرف کنید ( #644 ).
    • رفع اشکال در تنظیم زمان منفی برای یک setWhen غیرفعال هنگامی که تایمر اعلان باعث خرابی در برخی دستگاه‌ها شد ( #903 ).
    • وقتی اولین به‌روزرسانی اعلان درخواست می‌شود، اتصال کنترل‌کننده اعلان رسانه را کامل نکرده است، IllegalStateException برطرف کنید ( #917 ).
  • UI:
    • Fix issue where forward and rewind buttons are not visible when used with Material Design in a BottomSheetDialogFragment ( #511 ).
    • مشکل عدم تراز اعداد موجود در دکمه فوروارد سریع PlayerControlView را برطرف کنید ( #547 ).
  • پسوند DASH:
    • "f800" را به عنوان تعداد کانال 5 برای Dolby در مانیفست DASH ( #688 ) تجزیه کنید.
  • پسوندهای رمزگشا (FFmpeg، VP9، AV1، MIDI و غیره):
    • MIDI: مشکلی را که جستجوی رو به جلو از رویدادهای تغییر برنامه پرش می‌کند ( #704 ) برطرف کنید.
    • به FFmpeg 6.0 مهاجرت کنید و NDK پشتیبانی شده را به r26b به روز کنید ( #707 ، #867 ).
  • پسوند بازیگران:
    • ایجاد یک Timeline را پاکسازی کنید تا در هنگام بارگیری رسانه در دستگاه Cast ( #708 ) برنامه خراب نشود.

نسخه 1.2.0

15 نوامبر 2023

  • کتابخانه مشترک:
    • یک پارامتر @Nullable Throwable به متدهای رابط Log.Logger اضافه کنید. پارامتر message به این متدها دیگر حاوی اطلاعاتی درباره Throwable نیست که به Log.{d,i,w,e}() ارسال شده است، بنابراین پیاده‌سازی‌ها باید در صورت تمایل این اطلاعات را به صورت دستی اضافه کنند (احتمالاً با استفاده از Logger.appendThrowableString(String, Throwable) ).
    • مشکل سازگاری Kotlin را برطرف کنید که در آن پارامترهای نوع عمومی قابل تهی و انواع عناصر آرایه قابل تهی به عنوان تهی تشخیص داده نمی شوند. به عنوان مثال پارامترهای روش TrackSelectorResult و SimpleDecoder ( #6792 ) هستند.
    • رابط کاربری پیش‌فرض و رفتار اعلان‌ها را در Util.shouldShowPlayButton تغییر دهید تا زمانی که پخش موقتاً متوقف می‌شود (مثلاً به دلیل از دست دادن فوکوس صوتی گذرا) دکمه «پخش» نشان داده شود. رفتار قدیمی را می توان با استفاده از PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) یا MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) ( #11213 ) حفظ کرد.
    • androidx.annotation:annotation-experimental به 1.3.1 ارتقا دهید تا https://issuetracker.google.com/251172715 برطرف شود.
    • ExoPlayer.setAudioAttributes به رابط Player منتقل کنید.
  • ExoPlayer:
    • مشکلات جستجو در جریان‌های AC4 را که به دلیل عدم شناسایی صحیح نمونه‌های فقط رمزگشایی ایجاد می‌شود، برطرف کنید ( #11000 ).
    • هنگامی که این ویژگی از طریق ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput فعال است، توقف پخش را در دستگاه های خروجی صوتی نامناسب (مانند بلندگوی داخلی در دستگاه های Wear OS) اضافه کنید. دلیل توقف پخش به‌عنوان Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT به‌روزرسانی می‌شود. PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT اگر زمانی که خروجی‌های صوتی مناسبی در دسترس نیست، پخش انجام شود، یا اگر همه خروجی‌های مناسب در حین پخش قطع شده باشند. دلیل سرکوب زمانی که یک خروجی مناسب وصل شود حذف خواهد شد.
    • MediaSource.canUpdateMediaItem و MediaSource.updateMediaItem را اضافه کنید تا بروزرسانی های MediaItem را پس از ایجاد از طریق Player.replaceMediaItem(s) بپذیرید.
    • Allow MediaItem updates for all MediaSource classes provided by the library via Player.replaceMediaItem(s) ( #33 , #9978 ).
    • تغییر نام MimeTypes.TEXT_EXOPLAYER_CUES به MimeTypes.APPLICATION_MEDIA3_CUES .
    • PngExtractor اضافه کنید که یک فایل PNG کامل را به عنوان یک نمونه در TrackOutput می فرستد و می خواند.
    • روش SequenceableLoader.continueLoading(long) را در رابط SequenceableLoader به SequenceableLoader.continueLoading(LoadingInfo loadingInfo) ارتقا دهید. LoadingInfo شامل پارامترهای اضافی، از جمله playbackSpeed و lastRebufferRealtimeMs علاوه بر playbackPositionUs موجود است.
    • روش ChunkSource.getNextChunk(long, long, List, ChunkHolder) را در رابط ChunkSource به ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) ارتقا دهید.
    • فیلدهای اضافی را به گزارش Common Media Client Data (CMCD) اضافه کنید: گرسنگی بافر ( bs )، مهلت ( dl )، نرخ پخش ( pr ) و راه اندازی ( su ) ( #8699 ).
    • luma و chroma bitdepth را به ColorInfo اضافه کنید ( #491 ).
    • فیلدهای اضافی را به گزارش Common Media Client Data (CMCD) اضافه کنید: درخواست شی بعدی ( nor ) و درخواست محدوده بعدی ( nrr ) ( #8699 ).
    • برای انتقال داده های Common Media Client Data (CMCD) با استفاده از پارامترهای پرس و جو ( #553 ) قابلیت اضافه کنید.
    • رفع ConcurrentModificationException در ExperimentalBandwidthMeter ( #612 ).
    • پارامتر MediaPeriodId را به CompositeMediaSource.getMediaTimeForChildMediaTime اضافه کنید.
    • پشتیبانی از ClippingMediaSource (و سایر منابع با جبران زمان/پنجره) در ConcatenatingMediaSource2 ( #11226 ).
    • BaseRenderer.onStreamChanged() نیز تغییر دهید تا یک استدلال MediaPeriodId نیز دریافت کنید.
  • ترانسفورماتور:
    • تجزیه و تحلیل داده های چرخش Exif برای ورودی های تصویر.
    • نوع حاشیه نویسی TransformationRequest.HdrMode و ثابت های مرتبط با آن را حذف کنید. به جای آن از Composition.HdrMode و ثابت های مرتبط با آن استفاده کنید.
    • برای رفع مشکلات چرخش ، OverlaySettings ساده کنید.
    • پارامترهای frameRate و durationUs تغییر یافته از SampleConsumer.queueInputBitmap به TimestampIterator .
  • انتخاب آهنگ:
    • اضافه کردن DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness را برای صریح یا مجاز بودن سازگاری غیر یککاره ای اضافه کنید. پیش فرض در رفتار فعلی خود از true باقی می ماند.
  • استخراج کننده ها:
    • MPEG-TS: اطمینان حاصل کنید که آخرین قاب با عبور آخرین واحد دسترسی یک جریان به صف نمونه ( شماره 7909 ) ارائه می شود.
    • هنگام تعیین rotationDegrees تایپی را برطرف کنید. projectionPosePitch به projectionPoseRoll تغییر داد ( شماره 461 ).
    • این فرض را حذف کنید که نمونه های Extractor می توانند مستقیماً با instanceof مورد بازرسی قرار گیرند. اگر می خواهید دسترسی به زمان اجرا به جزئیات اجرای یک Extractor ابتدا با Extractor.getUnderlyingInstance تماس بگیرید.
    • BmpExtractor اضافه کنید.
    • WebpExtractor اضافه کنید.
    • HeifExtractor اضافه کنید.
    • پشتیبانی QuickTime Classic را به Mp4Extractor اضافه کنید.
  • صوتی:
    • Add support for 24/32-bit big-endian PCM in MP4 and Matroska, and parse PCM encoding for lpcm in MP4.
    • پشتیبانی از استخراج صوتی Vorbis را در MP4 اضافه کنید.
    • AudioSink.getFormatOffloadSupport(Format) را که بازیابی سطح Offload پشتیبانی می کند DefaultAudioOffloadSupportProvider اضافه کنید. این AudioOffloadSupport جدید را که شامل isFormatSupported ، isGaplessSupported و isSpeedChangeSupported است ، برمی گرداند.
    • AudioSink.setOffloadMode() را که از طریق آن پیکربندی Offload روی سینک صوتی پیکربندی شده است ، اضافه کنید. پیش فرض AudioSink.OFFLOAD_MODE_DISABLED است.
    • بارگیری را می توان از طریق setAudioOffloadPreference در TrackSelectionParameters فعال کرد. اگر اولویت تنظیم شده برای فعال کردن باشد ، دستگاه از بارگیری برای قالب پشتیبانی می کند و انتخاب آهنگ یک آهنگ صوتی واحد است ، سپس بارگیری صوتی فعال می شود.
    • اگر audioOffloadModePreference روی AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED تنظیم شده باشد ، آنگاه DefaultTrackSelector فقط یک آهنگ صوتی را انتخاب می کند و تنها در صورتی که فرمت آهنگ در Offload پشتیبانی شود. اگر هیچ آهنگ صوتی در بارگیری پشتیبانی نشود ، هیچ آهنگ انتخاب نمی شود.
    • غیرفعال کردن پشتیبانی بدون شکاف برای بارگیری در هنگام قبل از API سطح 33 به دلیل مشکل موقعیت پخش پس از انتقال آهنگ.
    • پارامتر enableOffload از DefaultRenderersFactory.buildAudioSink امضا کنید.
    • روش DefaultAudioSink.Builder.setOffloadMode را حذف کنید.
    • حذف مقدار intdef DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED .
    • پشتیبانی از ابرداده بدون شکاف OPUS را در حین پخش بارگیری اضافه کنید.
    • در صورت عدم موفقیت در ابتدا نوشتن ، بازیابی رندر را با غیرفعال کردن بارگیری مجاز می کند ( شماره 627 ).
    • برنامه ریزی Offload را به طور پیش فرض برای پخش بارگذاری شده فقط صوتی فعال کنید.
    • حذف ExoPlayer.experimentalSetOffloadSchedulingEnabled و AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged .
    • با نام onExperimentalSleepingForOffloadChanged به عنوان onSleepingForOffloadChanged و onExperimentalOffloadedPlayback به عنوان onOffloadedPlayback تغییر نام داد.
    • جابجایی رابط ها و تعاریف مربوط به TrackSelectionParameters به ​​حالت Offload Audio Offload Mode را به یک کلاس داخلی AudioOffloadPreferences منتقل کنید.
    • تماسهای برگشتی و onAudioTrackInitialized و onAudioTrackReleased به AnalyticsListener ، AudioRendererEventListener و AudioSink.Listener اضافه کنید.
    • مشکل زیر جریان بافر صوتی DTS Express را برطرف کنید ( #650 ).
    • رفع اشکال در جایی که قابلیت های E-AC3-JOC را بررسی می کند ، یک IllegalArgumentException ( #677 ) را پرتاب می کند.
  • ویدئو:
    • به MediaCodecVideoRenderer اجازه دهید از یک VideoFrameProcessor.Factory سفارشی استفاده کند.
    • در صورت شروع جریان صوتی با جدول زمانی منفی ( شماره 291 ) ، اشکال را در جایی که قاب اول قابل ارائه نیست ، برطرف کنید.
  • متن:
    • ExoplayerCuesDecoder حذف کنید. آهنگ های متنی با sampleMimeType = application/x-media3-cues اکنون مستقیماً توسط TextRenderer بدون نیاز به یک نمونه SubtitleDecoder به طور مستقیم اداره می شوند.
  • فراداده:
    • MetadataDecoder.decode دیگر برای نمونه های "فقط رمزگشایی" فراخوانی نمی شود زیرا اجرای به هر حال باید تهی شود.
  • اثر:
    • اضافه کردن VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) ورودی بیت مپ توسط Timestamp.
    • تغییر VideoFrameProcessor.registerInputStream() به غیر مسدود کننده. برنامه ها باید VideoFrameProcessor.Listener#onInputStreamRegistered() را پیاده سازی کنند.
    • پارامترهای frameRate و durationUs تغییر یافته از VideoFrameProcessor.queueInputBitmap به TimestampIterator .
  • پسوند IMA:
    • رفع اشکال در جایی که یک جریان مستقیم چند دوره ای که اولین مورد در لیست پخش نیست می تواند یک استثنا را پرتاب کند ( شماره 571 ).
    • Release StreamManager before calling AdsLoader.destroy()
    • نسخه IMA SDK BUMP به 3.31.0.
  • جلسه:
    • اعلان های پیش زمینه خدمات پیش زمینه را روی FOREGROUND_SERVICE_IMMEDIATE در DefaultMediaNotificationProvider ( شماره 167 ) تنظیم کنید.
    • فقط از android.media.session.MediaSession.setMediaButtonBroadcastReceiver() در بالا API 31 استفاده کنید تا از مشکلات مربوط به API کاهش یافته در دستگاه های سامسونگ جلوگیری کنید ( شماره 167 ).
    • برای تنظیم دستورات موجود و طرح بندی سفارشی که برای جمع آوری اعلان و جلسه پلتفرم استفاده می شود ، از کنترلر اعلان رسانه به عنوان پروکسی استفاده کنید.
    • به جای اینکه آنها را به جلسه پلتفرم و بازگشت به Media3 برگردانید ، رویدادهای دکمه رسانه ای را که توسط MediaSessionService.onStartCommand() در Media3 دریافت می شود ، تبدیل کنید. با این کار ، کنترلر تماس گیرنده همیشه کنترل کننده اعلان رسانه است و برنامه ها می توانند به راحتی تماس های حاصل از اعلان را به همان روش در تمام سطوح API پشتیبانی شده تشخیص دهند.
    • رفع اشکال در جایی که MediaController.getCurrentPosition() هنگام اتصال به یک MediaSessionCompat میراث پیش نمی رود.
    • برای راحتی ، MediaLibrarySession.getSubscribedControllers(mediaId) را اضافه کنید.
    • برای ادعای در دسترس بودن شناسه والدین که کنترل کننده در آن مشترک است ، MediaLibrarySession.Callback.onSubscribe() را نادیده بگیرید. در صورت موفقیت ، اشتراک پذیرفته می شود و notifyChildrenChanged() بلافاصله برای اطلاع رسانی به مرورگر ( شماره 561 ) فراخوانی می شود.
    • ماژول نسخه ی نمایشی جلسه را برای سیستم عامل خودرو اضافه کرده و نسخه آزمایشی جلسه را برای Android Auto فعال کنید.
    • وقتی COMMAND_GET_TIMELINE برای کنترل کننده اعلان رسانه در دسترس نیست ، صف جلسه Framework را تنظیم نکنید. 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 ).
    • به جای SimpleBitmapLoader ( #271 ، #327 ) به طور پیش فرض از DataSourceBitmapLoader استفاده کنید.
    • اضافه کردن MediaSession.Callback.onMediaButtonEvent(Intent) که به برنامه ها اجازه می دهد تا از اجرای رویداد پیش فرض دکمه رسانه استفاده کنند.
  • UI:
    • با راه اندازی یک گفتگوی سیستم ، یک Player.Listener برای دستگاه های سیستم عامل Wear که سرکوب پخش را به دلیل Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT انجام می دهد ، اضافه کنید. اگر یک دستگاه مناسب در یک زمان تنظیم قابل تنظیم (پیش فرض 5 دقیقه باشد) ، شنونده پخش خودکار را پخش می کند.
  • دانلودها:
    • برای DownloadService Android 14 نوع سرویس پیش زمینه "Data Sync" را اعلام کنید. هنگام استفاده از این سرویس ، برنامه همچنین باید dataSync به عنوان foregroundServiceType در مانیفست اضافه کرده و مجوز FOREGROUND_SERVICE_DATA_SYNC را اضافه کند ( #11239 ).
  • برنامه افزودنی HLS:
    • لیست پخش زنده HLS را با فاصله ای محاسبه شده از آخرین زمان شروع بار به جای آخرین بار زمان تکمیل شده ( #663 ) تازه کنید.
  • پسوند DASH:
    • اجازه دهید چندین مورد از همان شناسه DASH در URL الگوی قطعه.
    • پشتیبانی آزمایشی برای زیرنویس تجزیه در هنگام استخراج. این پشتیبانی بهتری برای ادغام زیرنویس های همپوشانی دارد ، از جمله حل سوسو هنگام انتقال بین بخش های زیرنویس. شما می توانید این کار را با استفاده از DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ( #288 ) فعال کنید.
  • پسوند RTSP:
    • یک وضعیت مسابقه را برطرف کنید که می تواند هنگام بازگشت به TCP یا پخش در برخی از مواقع ، به IndexOutOfBoundsException منجر شود.
    • هنگام بازگشت حالت بارگذاری RtspMediaPeriod ( #577 ) حالت را در تنظیم RTSP بررسی کنید.
    • روشهای درخواست RTSP سفارشی را در گزینه های پاسخ دهی عمومی ( شماره 613 ) نادیده بگیرید.
    • از مقدار زمان پاسخگویی تنظیم RTSP در فاصله زمانی ارسال درخواست گزینه های گزینه RTSP ( شماره 662 ) استفاده کنید.
  • پسوندهای رمزگشایی (FFMPEG ، VP9 ، AV1 ، MIDI و غیره):
    • ماژول Decoder MIDI را منتشر کنید ، که پشتیبانی از پخش پرونده های استاندارد MIDI را با استفاده از کتابخانه JSYN برای سنتز صوتی فراهم می کند.
    • به DecoderOutputBuffer.shouldBeSkipped اضافه کنید تا مستقیماً بافرهای خروجی را که نیازی به ارائه ندارند ، علامت گذاری کنید. این بیش از C.BUFFER_FLAG_DECODE_ONLY ترجیح داده می شود که کاهش می یابد.
    • Decoder.setOutputStartTimeUs و SimpleDecoder.isAtLeastOutputStartTimeUs را اضافه کنید تا به رمزگشایی ها اجازه دهید نمونه های رمزگشایی را قبل از زمان شروع رها کنند. این باید به Buffer.isDecodeOnly ترجیح داده شود که کاهش یابد.
    • تصحیح آثار باستانی MIDI را به مخزن Maven Fix کنید. مصنوعات به media3-exoplayer-midi ( شماره 734 ) تغییر نام داده می شود.
  • پسوند Leanback:
    • رفع اشکال در جایی که غیرفعال کردن یک سطح می تواند باعث ArithmeticException در کد Leanback شود ( شماره 617 ).
  • ابزارهای آزمایشی:
    • TestExoPlayerBuilder و FakeClock با تست های UI اسپرسو سازگار و تست های UI سازگار کنید. این یک اشکال را برطرف می کند که در آن پخش به طور غیر قطعی در طول اسپرسو پیشرفت می کند یا تعامل نمای را ایجاد می کند.
  • حذف نمادهای منسوخ شده:
    • حذف TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) و TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) . از Composition.Builder.setHdrMode(int) استفاده کنید و به جای آن Composition به Transformer.start(Composition, String) منتقل کنید.
    • حذف Deadcated DownloadNotificationHelper.buildProgressNotification ، از یک روش غیر مستهجن استفاده کنید که به جای آن یک پارامتر notMetRequirements را می گیرد.

نسخه 1.2.0-RC01

1 نوامبر 2023

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

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 .

نسخه 1.2.0-alpha01

17 آگوست 2023

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

نسخه 1.1.0

نسخه 1.1.1

16 آگوست 2023

  • کتابخانه مشترک:
    • وابستگی multidex به طور تصادفی اضافه شده را از همه ماژول ها حذف کنید ( شماره 499 ).
  • ExoPlayer:
    • مشکل را در PlaybackStatsListener که در آن PlaybackStats Spurious پس از پاکسازی لیست پخش ایجاد می شوند ، رفع کنید.
    • زمینه های اضافی را به داده های مشتری متداول (CMCD) وارد کنید: فرمت جریان (SF) ، نوع جریان (ST) ، نسخه (V) ، Top Birate (TB) ، مدت زمان شی (D) ، توان اندازه گیری شده (MTP) و نوع شیء (ot) ( #8699 ).
  • صوتی:
    • اشکال را برطرف کنید که در آن Player.getState() هنگام پخش پرونده های بسیار کوتاه به STATE_ENDED منتقل نشد ( شماره 538 ).
  • بارگیری صوتی:
    • صفحه اصلی OGG ID و صفحات هدر نظر را به BitStream برای پخش OPUS بارگیری شده مطابق با RFC 7845 ارائه دهید.
  • ویدئو:
    • H.265/HEVC: اطلاعات مربوط به تصویر مرجع کوتاه مدت و بلند مدت SPS را برطرف کنید.
  • متن:
    • CEA-608: منطق کوتاه کردن نشانه را تغییر دهید تا فقط متن قابل مشاهده را در نظر بگیرید. پیش از این ، هنگام محدود کردن طول نشانه به 32 کاراکتر (که از نظر فنی توسط مشخصات صحیح بود) (که از نظر فنی صحیح بود) ( #11019 ) ( #11019).
  • پسوند IMA:
    • نسخه Bump IMA SDK تا 3.30.3.
  • جلسه:
    • طرح سفارشی را به حالت کنترلر اضافه کنید و یک گیرنده را برای دسترسی به آن فراهم کنید. هنگامی که طرح بندی سفارشی تغییر می کند ، MediaController.Listener.onCustomLayoutChanged خوانده می شود. برنامه هایی که می خواهند طرح های مختلف سفارشی را به کنترل کننده Media3 مختلف ارسال کنند می توانند این کار را در MediaSession.Callback.onConnect با استفاده از یک AcceptedResultBuilder انجام دهند تا مطمئن شوید که هنگام اتمام اتصال ، طرح سفارشی در دسترس کنترلر است.
    • مواردی را برطرف کنید که MediaLibraryServiceLegacyStub خطایی را به Result ای ارسال کند که از این امر پشتیبانی نمی کند که باعث ایجاد UnsupportedOperationException ( شماره 78 ) می شود.
    • با تعیین volumeControlType از طریق هر دو دستور Legacy ( COMMAND_ADJUST_DEVICE_VOLUME و COMMAND_SET_DEVICE_VOLUME ) و دستورات جدید ( COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS و Command_Adjust_SEVICE_VOLUME) یک PlayerWrapper ایجاد می کند VolumeProviderCompat COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS ) ( #554 ).

نسخه 1.1.0

5 جولای 2023

  • کتابخانه مشترک:
    • دلیل سرکوب را برای مسیر صوتی نامناسب اضافه کنید و در هنگام تغییر آماده برای سرکوب بیش از حد طولانی ، بازی کنید. ( شماره 15 ).
    • دستورات را به بازیکن اضافه کنید:
      • COMMAND_GET_METADATA
      • COMMAND_SET_PLAYLIST_METADATA
      • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
      • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
    • روشهای اضافه بار را به بازیکن اضافه کنید که به کاربران امکان می دهد پرچم های حجم را مشخص کنند:
      • void setDeviceVolume(int, int)
      • void increaseDeviceVolume(int)
      • void decreaseDeviceVolume(int)
      • void setDeviceMuted(boolean, int)
    • Builder برای DeviceInfo اضافه کنید و سازنده موجود را کاهش دهید.
    • برای مشخص کردن شناسه کنترل کننده مسیریابی برای پخش از راه دور DeviceInfo.routingControllerId اضافه کنید.
    • Player.replaceMediaItem(s) را به عنوان میانبر اضافه کردن و حذف موارد در همان موقعیت ( شماره 8046 ) اضافه کنید.
  • ExoPlayer:
    • اجازه دهید سیاخلایر بتواند روشهای حجم دستگاه را فقط در صورت انتخاب صریح کنترل کند. از ExoPlayer.Builder.setDeviceVolumeControlEnabled استفاده کنید تا به این موارد دسترسی داشته باشید:
      • getDeviceVolume()
      • isDeviceMuted()
      • setDeviceVolume(int) و setDeviceVolume(int, int)
      • increaseDeviceVolume(int) و increaseDeviceVolume(int, int)
      • decreaseDeviceVolume(int) و decreaseDeviceVolume(int, int)
    • FilteringMediaSource اضافه کنید که امکان فیلتر کردن انواع آهنگ های موجود را از MediaSource فراهم می کند.
    • پشتیبانی از داده های مشتری مشترک رسانه (CMCD) را در درخواست های خروجی قالب های جریان سازگار ، HLS و Smoothstreaming اضافه کنید. زمینه های زیر ، br ، bl ، cid ، rtp و sid گنجانیده شده اند ( #8699 ). ساختار API و روش های API:
      • ورود به سیستم CMCD به طور پیش فرض غیرفعال است ، از MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) استفاده کنید تا آن را فعال کنید.
      • تمام کلیدها به طور پیش فرض فعال می شوند ، CmcdConfiguration.RequestConfig.isKeyAllowed(String key) را نادیده می گیرند تا از کدام کلیدها وارد شوند.
      • برای فعال کردن ورود به سیستم کلید سفارشی CmcdConfiguration.RequestConfig.getCustomData() را نادیده بگیرید.
    • Add additional action to manifest of main demo to make it easier to start the demo app with a custom *.exolist.json file ( #439 ).
    • ExoPlayer.setVideoEffects() را برای استفاده از Effect در هنگام پخش ویدیویی اضافه کنید.
    • SampleQueue به روز کنید تا sourceId به عنوان یک int long ذخیره کنید. This changes the signatures of public methods SampleQueue.sourceId and SampleQueue.peekSourceId .
    • پارامترها را به روشهای LoadControl اضافه کنید shouldStartPlayback و onTracksSelected استفاده کنید که امکان ارتباط این روش ها را با MediaPeriod مربوطه فراهم می کند.
    • تغییر امضا از ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) با اضافه کردن یک پارامتر جدول زمانی که شامل دوره هایی با UID های مورد استفاده به عنوان کلیدهای موجود در نقشه است. این مورد برای جلوگیری از مشکلات همزمانی با جریان های زنده چند دوره ای لازم است.
    • deprecate EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) و BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs) . به جای آن ، نوع روش های بدون mediaTimeOffsetUs را می توان نامید. توجه داشته باشید که حتی برای انواع مستهجن ، افست دیگر به startTimeUs و endTimeUs از اشیاء MediaLoadData که توسط توزیع کننده ارسال می شوند اضافه نمی شود.
    • تغییر نام ExoTrackSelection.blacklist to excludeTrack و isBlacklisted به isTrackExcluded .
    • رفتار متناقض بین ExoPlayer.setMediaItem(s) و addMediaItem(s) را هنگام فراخوانی در لیست پخش خالی برطرف کنید.
  • ترانسفورماتور:
    • حذف Transformer.Builder.setMediaSourceFactory(MediaSource.Factory) . به جای آن از ExoPlayerAssetLoader.Factory(MediaSource.Factory) و Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory) استفاده کنید.
    • حذف Transformer.startTransformation(MediaItem, ParcelFileDescriptor) .
    • در صورتی که پایان جریان ویدیو در لحظه ای که یک قاب ورودی در انتظار پردازش بود ، یک اشکال را برطرف کرد (که منجر به زمان موکسی می شود).
    • کد های پرس و جو از طریق MediaCodecList به جای استفاده از برنامه های findDecoder/EncoderForFormat ، برای گسترش پشتیبانی.
    • پیکربندی B-Frame را در DefaultEncoderFactory حذف کنید زیرا در برخی از دستگاه ها کار نمی کند.
  • انتخاب آهنگ:
    • اضافه کردن DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange که به طور پیش فرض غیرفعال است. در صورت فعال شدن ، DefaultTrackSelector با تغییر قابلیت های Renderer ، انتخاب آهنگ جدیدی را ایجاد می کند.
  • استخراج کننده ها:
    • OGG: هنگام جستجوی پرونده هایی با مدت زمان طولانی ، اشکال را برطرف کنید ( #391 ).
    • FMP4: مسئله ای را که در آن TimestampAdjuster یک جبران زمان بندی اشتباه با زمان نمونه ابرداده از اتم EMSG ( #356 ) آغاز می کند ، رفع کنید.
  • صوتی:
    • رفع اشکال در جایی که برخی از پخش ها در هنگام فعال کردن تونل سازی شکست می خورند و AudioProcessors فعال هستند ، به عنوان مثال برای پیرایش بدون شکاف ( #10847 ).
    • فریم های Opus را در بسته های OGG در پخش مستقیم (Offload) محصور کنید.
    • موقعیت فعلی را در هنگام خواب با برنامه ریزی خاموش برون یابی کنید.
    • Renderer.release() و AudioSink.release() را برای انتشار منابع در پایان چرخه حیات بازیکن اضافه کنید.
    • به تغییرات قابلیت های صوتی در DefaultAudioSink گوش دهید. یک context پارامتر مورد نیاز را در سازنده DefaultAudioSink اضافه کنید ، که با استفاده از آن DefaultAudioSink به عنوان شنونده AudioCapabilitiesReceiver ثبت می شود و در صورت اطلاع از قابلیت های تغییر ، ویژگی audioCapabilities آن را به روز می کند.
    • قابلیت های صوتی را از طریق یک رویداد جدید onAudioCapabilitiesChanged در AudioSink.Listener Interface و یک رابط جدید RendererCapabilities.Listener onRendererCapabilitiesChanged دهد.
    • برای استفاده از مقیاس گذاری/مخلوط کردن در کانال های صوتی ChannelMixingAudioProcessor اضافه کنید.
    • اضافه کردن مقدار int جدید DISCARD_REASON_AUDIO_BYPASS_POSSIBLE to DecoderDiscardReasons برای دور انداختن رمزگشایی صوتی در هنگام تغییر حالت بای پس از تغییر قابلیت های صوتی.
    • پشتیبانی مستقیم پخش برای DTS Express و DTS: X ( #335 ) را اضافه کنید.
  • ویدئو:
    • در هنگام غیرفعال شدن رندر VideoSize MediaCodecVideoRenderer با عرض و ارتفاع 0 گزارش دهید. Player.Listener.onVideoSizeChanged بر این اساس وقتی Player.getVideoSize() تغییر می کند ، نامیده می شود. با این تغییر ، اندازه ویدیوی Exoplayer با MediaCodecVideoRenderer Player.getCurrentTracks WHITH و ارتفاع 0 برخوردار است.
  • 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:
    • یک کتابخانه جدید Muxer را اضافه کنید که می تواند برای ایجاد یک فایل کانتینر MP4 استفاده شود.
  • پسوند IMA:
    • جریان های داش زنده چند دوره ای را برای DAI فعال کنید. لطفاً توجه داشته باشید که اجرای فعلی هنوز از جستجوی جریان های مستقیم پشتیبانی نمی کند ( #10912 ).
    • رفع اشکال در جایی که یک گروه تبلیغات جدید در جریان های مستقیم وارد می شود زیرا موقعیت محتوای محاسبه شده در جدول زمانی متوالی کمی متفاوت است.
  • جلسه:
    • برای به دست آوردن اطلاعات در مورد کنترلر که در حال حاضر یک روش Player است ، به MediaSession.getControllerForCurrentRequest بیاورید.
    • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset ( #167 ).
    • اجرای پیش فرض را به MediaSession.Callback.onAddMediaItems اضافه کنید تا در صورت داشتن MediaItems LocalConfiguration (به عنوان مثال URI) به Player منتقل شود (به عنوان مثال URI) ( شماره 282 ).
    • دکمه های فرمان "Seek to قبلی" و "Seek to Next" را در نمای اعلان رسانه جمع و جور به طور پیش فرض برای Android 12 و زیر ( شماره 410 ) اضافه کنید.
    • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
    • دکمه های فرمان "Seek to قبلی" و "Seek to Next" را در نمای اعلان رسانه جمع و جور به طور پیش فرض برای Android 12 و زیر ( شماره 410 ) اضافه کنید.
  • UI:
    • برای نوشتن عناصر UI سفارشی با یک دکمه پخش/مکث ، روش های استفاده را shouldShowPlayButton و handlePlayPauseButtonAction اضافه کنید.
  • پسوند RTSP:
    • برای MPEG4-LATM ، اگر در توصیف پیام SDP پاسخ ( #302 ) وجود ندارد ، از مقدار پیش فرض سطح-سطح-ID استفاده کنید.
    • در صورت وجود در هدر پاسخ ( شماره 11160 ) از URI پایه برای وضوح مسیر نسبی از جلسه RTSP استفاده کنید.
  • پسوند DASH:
    • حذف زمان رسانه را از MediaLoadData.startTimeMs و MediaLoadData.endTimeMs برای جریان های چند دوره ای حذف کنید.
    • Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException ( #10838 ).
  • برنامه افزودنی HLS:
    • Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. اگر اولیه سازی قبل از زمان پایان کامل نشود ، یک PlaybackException پرتاب می شود تا از پخش بی پایان پخش جلوگیری شود. زمان بندی به طور پیش فرض روی صفر تنظیم می شود ( شماره 323 ).
  • ابزارهای آزمایشی:
    • عدم حساسیت به پرونده URI را در DataSourceContractTest بررسی کنید.
  • حذف نمادهای منسوخ شده:
    • سازندگان DefaultAudioSink حذف کنید ، به جای آن از DefaultAudioSink.Builder استفاده کنید.
    • HlsMasterPlaylist حذف کنید ، به جای آن از HlsMultivariantPlaylist استفاده کنید.
    • Player.stop(boolean) را حذف کنید. به جای آن از Player.stop() و Player.clearMediaItems() (اگر reset true است) استفاده کنید.
    • دو سازنده SimpleCache را حذف کنید ، از یک سازنده غیر منسجم استفاده کنید که به جای آن یک DatabaseProvider را برای عملکرد بهتر می گیرد.
    • سازنده DefaultBandwidthMeter حذف کنید ، به جای آن از DefaultBandwidthMeter.Builder استفاده کنید.
    • سازندگان DefaultDrmSessionManager حذف کنید ، به جای آن از DefaultDrmSessionManager.Builder استفاده کنید.
    • دو سازنده HttpDataSource.InvalidResponseCodeException را حذف کنید ، از یک سازنده غیر منسجم استفاده کنید که زمینه های اضافی ( cause ، responseBody ) را برای تقویت ورود به خطا می پذیرد.
    • DownloadHelper.forProgressive ، DownloadHelper.forHls ، DownloadHelper.forDash و DownloadHelper.forSmoothStreaming را حذف کنید ، به جای آن DownloadHelper.forMediaItem استفاده کنید.
    • حذف سازنده DownloadService مستهجن ، از یک سازنده غیر مستهجن استفاده کنید که شامل گزینه ارائه یک پارامتر channelDescriptionResourceId است.
    • حذف ثابت های رشته ای مستهلک شده برای charsets ( ASCII_NAME ، UTF8_NAME ، ISO88591_NAME ، UTF16_NAME و UTF16LE_NAME ) ، از بسته های kotlin.text استفاده کنید ، java.nio.charset.StandardCharsets یا com.google.common.base.Charsets .
    • سازنده WorkManagerScheduler Deprecated را حذف کنید ، از یک سازنده غیر مستهجن استفاده کنید که شامل گزینه ای برای ارائه یک پارامتر Context به جای آن است.
    • روشهای مستهلک شده createVideoSampleFormat ، createAudioSampleFormat ، createContainerFormat و createSampleFormat را که برای فوری کلاس Format استفاده می شود ، حذف کنید. در عوض از Format.Builder برای ایجاد نمونه های Format استفاده کنید.
    • روشهای مستهلک شده copyWithMaxInputSize ، copyWithSubsampleOffsetUs ، copyWithLabel ، copyWithManifestFormatInfo ، copyWithGaplessInfo ، copyWithFrameRate ، copyWithDrmInitData ، copyWithMetadata ، copyWithBitrate و به جای copyWithVideoSize ، از روشهای Format.buildUpon() و setter استفاده کنید.
    • ExoPlayer.retry() را حذف کنید ، به جای آن prepare() استفاده کنید.
    • سازنده DefaultTrackSelector DefaultTrackector Deprecated را حذف کنید ، به جای آن از DefaultTrackSelector(Context) استفاده کنید.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • سازنده Deprecated DownloadManager حذف کنید ، از سازنده ای که به جای آن یک Executor می گیرد استفاده کنید.
    • سازندگان Cue مستهلک شده را حذف کنید ، به جای آن از Cue.Builder استفاده کنید.
    • Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
    • چهار روش AnalyticsListener کاهش یافته را حذف کنید:
      • onDecoderEnabled ، به جای آن از onAudioEnabled و/یا onVideoEnabled استفاده کنید.
      • onDecoderInitialized ، به جای آن از onAudioDecoderInitialized و/یا onVideoDecoderInitialized استفاده کنید.
      • onDecoderInputFormatChanged ، به جای آن onAudioInputFormatChanged و/یا onVideoInputFormatChanged استفاده کنید.
      • onDecoderDisabled ، به جای آن onAudioDisabled و/یا onVideoDisabled استفاده کنید.
    • Remove the deprecated Player.Listener.onSeekProcessed and AnalyticsListener.onSeekProcessed , use onPositionDiscontinuity with DISCONTINUITY_REASON_SEEK instead.
    • ExoPlayer.setHandleWakeLock(boolean) حذف کنید ، به جای آن از setWakeMode(int) استفاده کنید.
    • حذف شده DefaultLoadControl.Builder.createDefaultLoadControl() حذف کنید ، به جای آن از build() استفاده کنید.
    • حذف شده MediaItem.PlaybackProperties ، به جای آن از MediaItem.LocalConfiguration استفاده کنید. Field Field MediaItem.playbackProperties اکنون از نوع MediaItem.LocalConfiguration است.

نسخه 1.1.0-RC01

21 ژوئن 2023

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

نسخه 1.1.0-beta01

7 ژوئن 2023

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

نسخه 1.1.0-alpha01

10 مه 2023

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

نسخه 1.0.0

نسخه 1.0.2

18 مه 2023

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

This release corresponds to the ExoPlayer 2.18.7 release .

این نسخه شامل تغییرات زیر از نسخه 1.0.1 است:

  • کتابخانه اصلی:
    • Buffer.isLastSample() را اضافه کنید که نشان می دهد اگر Buffer حاوی پرچم C.BUFFER_FLAG_LAST_SAMPLE باشد.
    • اگر آخرین نمونه با فریم بدون خواندن نمونه "انتهای جریان" از بین برود ، مسئله ای را که آخرین قاب در آن ممکن است ارائه نشود ، رفع کنید. ( شماره 11079 ).
  • استخراج کننده ها:
    • با استفاده از منطق تجزیه شده قبلاً توسط استخراج کننده های RTSP و MP4 ( #303 ) تجزیه و تحلیل H.265 SPS در پرونده های MPEG-TS را برطرف کنید.
  • متن:
    • SSA: در صورت شروع با علامت سفارش بایت ( شماره 319 ) ، از پرونده های UTF-16 پشتیبانی کنید.
  • جلسه:
    • مسئله را در جایی که MediaController دستورات موجود خود را هنگام اتصال به میراث MediaSessionCompat که اقدامات خود را به روز می کند ، به روز نمی کند.
    • رفع اشکالی که مانع از بازگشت MediaLibraryService برای تماس NULL برای تماس با سیستم UI به params.isRecent == true Callback.onGetLibraryRoot .
    • نشت حافظه MediaSessionService یا MediaLibraryService را برطرف کنید ( شماره 346 ).
    • رفع اشکال در جایی که یک Timeline ترکیبی و به روزرسانی موقعیت در یک MediaSession ممکن است باعث شود یک MediaController بتواند IllegalStateException را پرتاب کند.

نسخه 1.0.1

18 آوریل 2023

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

این نسخه مطابق با انتشار برنامه سیارات 2.18.6 است.

  • کتابخانه اصلی:
    • تنظیم مجدد Target Live Stream هنگام جستجوی موقعیت پیش فرض ( #11051 ).
    • اشکال را برطرف کنید که در آن جریان های نمونه خالی در رسانه ها می توانند باعث ایجاد پخش شوند.
  • جلسه:
    • رفع اشکال در جایی که چندین مورد یکسان در صف منتشر شده توسط یک MediaSessionCompat میراث به استثناء در MediaController ( شماره 290 ) منجر می شود.
    • ارسال از دست رفته MediaSession.broadcastCustomCommand به Legacy MediaControllerCompat.Callback.onSessionEvent ( #293 ).
    • Fix bug where calling MediaSession.setPlayer doesn't update the available commands.
    • مسئله را برطرف کنید که نمونه های TrackSelectionOverride ارسال شده از یک MediaController در صورت مراجعه به گروهی با Format.metadata ( شماره 296 ) نادیده گرفته می شوند.
    • مشکل را در جایی که Player.COMMAND_GET_CURRENT_MEDIA_ITEM برای دسترسی به ابرداده از طریق میراث MediaSessionCompat باید در دسترس باشد ، رفع کنید.
    • مسئله ای را برطرف کنید که در آن نمونه های MediaSession در یک موضوع پس زمینه باعث تصادف در هنگام استفاده در MediaSessionService ( شماره 318 ) شود.
    • مسئله را در جایی که یک گیرنده دکمه رسانه ای توسط کتابخانه اعلام شده است بدون اینکه برنامه ای در نظر داشته باشد ( شماره 314 ) اعلام کرد.
  • داش:
    • رسیدگی به جدول زمانی بخش خالی ( #11014 ) را برطرف کنید.
  • RTSP:
    • اگر RTSP با UDP با خطای RTSP 461 UnsupportedTransport ( #11069 ) انجام شود ، با TCP دوباره امتحان کنید.

نسخه 1.0.0

22 مارس 2023

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

این نسخه مطابق با انتشار برنامه سیارات 2.18.5 است.

از 1.0.0-RC02 هیچ تغییری وجود ندارد.

نسخه 1.0.0-RC02

2 مارس 2023

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

این نسخه مربوط به انتشار برنامه سیارات 2.18.4 است.

  • کتابخانه اصلی:
    • رفع نوع شبکه در API 33 ( #10970 ).
    • هنگام فراخوانی ExoPlayer.isTunnelingEnabled ( #10977 ) ، NullPointerException رفع کنید.
  • دانلودها:
    • حداکثر تفاوت زمان شروع دو بخش را برای ادغام قابل تنظیم در SegmentDownloader و زیر کلاس ها ایجاد کنید ( شماره 248 ).
  • صوتی:
    • پخش MP3 Broken Gapless را در دستگاه های سامسونگ ( #8594 ) برطرف کنید.
    • رفع اشکال در جایی که سرعت پخش بلافاصله پس از غیرفعال کردن صدا ممکن است با تغییر سرعت قبلی ( #10882 ) تنظیم شود.
  • ویدئو:
    • قالب HEVC HDR10 را به جای HEVCProfileMain10HDR10 به HEVCProfileMain10 .
    • راه حل را برای مسئله دستگاه در Chromecast با Google TV و Lenovo M10 FHD Plus اضافه کنید که باعث می شود جریان های AVC 60 فریم در ثانیه به صورت پشتیبانی نشود ( #10898 ).
    • هنگام پخش رسانه با نرخ فریم به مراتب بالاتر از نرخ تازه سازی صفحه ، مشکلات عملکرد انتشار فریم را برطرف کنید.
  • بازیگران:
    • هنگام انتقال بین موارد رسانه ای ( #245 ) STATE_IDLE گذرا را برطرف کنید.
  • RTSP:
    • Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ( #10971 ).
  • جلسه:
    • اشکال را برطرف کنید که دکمه پخش/مکث با Notification با حالت پخش کننده به روز نشود ( #192 ).
  • پسوند IMA:
    • اشکالی را برطرف کنید که مانع از شروع جریان های DAI بدون هیچ گونه تبلیغات شود زیرا اولین (و در مورد تنها ADS تنها) رویداد LOADED دریافت نشده است.

نسخه 1.0.0-RC01

16 فوریه 2023

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

این نسخه مطابق با انتشار برنامه سیارات 2.18.3 است.

  • کتابخانه اصلی:
    • منطق سفارش رمزگشایی رندر را برای حمایت از ترجیحات MediaCodecSelector ، حتی اگر یک رمزگشگر گزارش دهد ممکن است نتواند رسانه ها را به طور اجرا بازی کند. به عنوان مثال با انتخاب پیش فرض ، رمزگذار سخت افزار با پشتیبانی فقط کاربردی نسبت به رمزگذار نرم افزاری که کاملاً از فرمت پشتیبانی می کند ( #10604 ) ترجیح می دهد.
    • ExoPlayer.Builder.setPlaybackLooper را اضافه کنید که یک موضوع پخش از قبل موجود را برای یک نمونه جدید از سیارات جدید تنظیم می کند.
    • اجازه دهید یاران مدیر بارگیری شوند ( #10776 ).
    • Add parameter to BasePlayer.seekTo to also indicate the command used for seeking.
    • هنگام بارگذاری Drawables در API 21+ ( شماره 220 ) از تم استفاده کنید.
    • ConcatenatingMediaSource2 را اضافه کنید که امکان ترکیب چندین مورد رسانه را در یک پنجره واحد ( #247 ) فراهم می کند.
  • استخراج کننده ها:
    • اگر جدول نمونه (STBL) در هنگام تجزیه اتم های Trak ، یک توضیحات نمونه مورد نیاز (STSD) را از دست داده است ، به جای یک NullPointerException یک ParserException پرتاب کنید.
    • نمونه ها را هنگام جستجوی مستقیم به یک قاب همگام سازی در FMP4 ( #10941 ) به درستی پرش کنید.
  • صوتی:
    • برای محاسبه اندازه حداقل بافر برای AudioTrack در پخش مستقیم (Passthrough) از قالب صوتی فشرده شده استفاده کنید.
  • متن:
    • اگر یک پرونده زیرنویس حاوی هیچ نشانه ای نیست Subtitle.getEventTime TextRenderer کنید.
    • Subrip: در صورت شروع با علامت سفارش بایت ، پشتیبانی از پرونده های UTF-16 را اضافه کنید.
  • فراداده:
    • مقادیر جدا شده از تهی چندگانه را از فریم های ID3 تجزیه کنید ، همانطور که توسط ID3 v2.4 مجاز است.
    • برای نشان دادن نوع محتوا یا نوع پوشه ای که توسط ابرداده شرح داده شده است ، MediaMetadata.mediaType را اضافه کنید.
    • MediaMetadata.isBrowsable به عنوان جایگزینی برای MediaMetadata.folderType اضافه کنید. The folder type will be deprecated in the next release.
  • داش:
    • تجزیه کامل برای مجموعه های سازگاری تصویر ، از جمله تعداد کاشی ( شماره 3752 ) اضافه کنید.
  • UI:
    • برای اطمینان از اینکه تغییرات دید به شنونده ثبت شده ( شماره 229 ) منتقل می شود ، PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) را برطرف کنید.
    • هنگام استفاده از یک طرح راست به چپ (RTL) ( شماره 227 ) ، ترتیب کنترل بازیکن مرکز را در PlayerView رفع کنید.
  • جلسه:
    • برای کمک به اجرای رابط Player برای بازیکنان سفارشی ، چکیده SimpleBasePlayer اضافه کنید.
    • روش Helper را برای تبدیل نشانه های جلسه سکوی به Media3 SessionToken ( شماره 171 ) اضافه کنید.
    • برای شروع به روزرسانی جلسه رسانه های پلتفرم ( شماره 219 ) از onMediaMetadataChanged استفاده کنید.
    • جلسه رسانه ای را به عنوان استدلال getMediaButtons() از DefaultMediaNotificationProvider اضافه کرده و از لیست های تغییر ناپذیر برای وضوح استفاده کنید ( شماره 216 ).
    • اضافه کردن شنونده پاسخ به تماس با شروع onSetMediaItems برای ارائه وسیله ای برای تغییر/تنظیم لیست MediaItem ، شروع شاخص و موقعیت توسط جلسه قبل از تنظیم روی بازیکن ( شماره 156 ).
    • از تشخیص دو ضربه برای رویدادهای دکمه رسانه غیر بلوتوث ( شماره 233 ) خودداری کنید.
    • در صورت وجود جلسه جلسه میراث سایه دار ، QueueTimeline قوی تر کنید ( شماره 241 ).
  • فراداده:
    • مقادیر جدا شده از تهی چندگانه را از فریم های ID3 تجزیه کنید ، همانطور که توسط ID3 v2.4 مجاز است.
    • برای نشان دادن نوع محتوا یا نوع پوشه ای که توسط ابرداده شرح داده شده است ، MediaMetadata.mediaType را اضافه کنید.
    • MediaMetadata.isBrowsable به عنوان جایگزینی برای MediaMetadata.folderType اضافه کنید. نوع پوشه در نسخه بعدی کاهش می یابد.
  • پسوند بازیگران:
    • نسخه SDK Bump Cast به 21.2.0.
  • پسوند IMA:
    • شنونده بازیکن را از ImaServerSideAdInsertionMediaSource در موضوع برنامه حذف کنید تا از مشکلات موضوع جلوگیری شود.
    • 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.
  • برنامه نمایشی:
    • 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 Transformer.Builder.setOutputMimeType(String) . This feature has been removed. The MIME type will always be MP4 when the default muxer is used.

Version 1.0.0-beta02

21 جولای 2022

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

This release corresponds to the ExoPlayer 2.18.1 release .

  • Core library:
    • Ensure that changing the ShuffleOrder with ExoPlayer.setShuffleOrder results in a call to Player.Listener#onTimelineChanged with reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED ( #9889 ).
    • For progressive media, only include selected tracks in buffered position ( #10361 ).
    • Allow custom logger for all ExoPlayer log output ( #9752 ).
    • Fix implementation of setDataSourceFactory in DefaultMediaSourceFactory , which was non-functional in some cases ( #116 ).
  • استخراج کننده ها:
    • 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.
  • استخراج کننده ها:
    • 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. این یک تغییر شکسته است.
    • 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 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.
  • استخراج کننده ها:
    • 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 ).
  • استخراج کننده ها:
    • 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 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. به جای آن از CronetDataSource.Factory استفاده کنید.
  • 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.