الوسائط

مشاركة محتوى الوسائط وعناصر التحكّم مع تطبيقات أخرى حلّت مكتبة Media3 محلّها.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫13 أغسطس 2025 1.7.1 - - -

تعريف التبعيات

لإضافة تبعية على Media، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

dependencies {
    implementation "androidx.media:media:1.7.1"
}

Kotlin

dependencies {
    implementation("androidx.media:media:1.7.1")
}

لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.7

الإصدار 1.7.1

‫13 أغسطس 2025

تم طرح androidx.media:media:1.7.1. يحتوي الإصدار 1.7.1 على عمليات الدمج هذه.

إصلاح الأخطاء

  • تحسين أداء MediaSession.setMetadata() من خلال تقليل عدد عمليات التخصيص الوسيطة وإزالة عمليات التجميع/التفكيك غير الضرورية لخرائط البتات

الإصدار 1.7.0

‫29 نوفمبر 2023

تم طرح androidx.media:media:1.7.0. يتضمّن الإصدار 1.7.0 عمليات الإيداع هذه.

التغييرات المهمة منذ الإصدار 1.6.0

  • يمكنك مشاهدة مباراة ForegroundServiceStartNotAllowedException في MediaButtonReceiver وإعادة توجيهها إلى onForegroundServiceStartNotAllowedException. (I0c939)
  • أضِف BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM لتمرير ملف الوسائط المفضّل في الإضافات الجذرية MediaBrowserCompat. (Id3a11)
  • أضِف عناصر إضافية لضبط الإجراءات المخصّصة للتصفّح في العناصر الإضافية للجذر MediaBrowserCompat والأوصاف MediaItem. (Iab163)
  • إصلاح الخطأ IllegalStateException الناتج عن عرض قيمة فارغة من MediaBrowserService.onLoadChildren على إصدارات Android القديمة

الإصدار 1.7.0-rc01

‫15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.media:media:1.7.0-rc01 بدون أي تغييرات. يحتوي الإصدار 1.7.0-rc01 على عمليات الإيداع هذه.

الإصدار 1.7.0-beta01

‫1 نوفمبر 2023

تم طرح androidx.media:media:1.7.0-beta01. يحتوي الإصدار 1.7.0-beta01 على عمليات الإيداع هذه.

إصلاح الأخطاء

  • تم إصلاح تسرب محتمل للذاكرة في MediaBrowserService وMediaBrowserServiceCompat. b/37137738.
  • إصلاح الخطأ IllegalStateException الناتج عن عرض قيمة فارغة من MediaBrowserService.onLoadChildren على إصدارات Android القديمة

الإصدار 1.7.0-alpha01

‫8 شباط (فبراير) 2023

تم طرح androidx.media:media:1.7.0-alpha01. يحتوي الإصدار 1.7.0-alpha01 على عمليات الإيداع هذه.

الميزات الجديدة

  • يمكنك مشاهدة مباراة ForegroundServiceStartNotAllowedException في MediaButtonReceiver وإعادة توجيهها إلى onForegroundServiceStartNotAllowedException. (I0c939)
  • أضِف BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM لتمرير ملف الوسائط المفضّل في الإضافات الجذرية MediaBrowserCompat. (Id3a11)
  • أضِف عناصر إضافية لضبط الإجراءات المخصّصة للتصفّح في العناصر الإضافية للجذر MediaBrowserCompat والأوصاف MediaItem. (Iab163)

الإصدار 1.6.0

الإصدار 1.6.0

‫20 أبريل 2022

تم طرح androidx.media:media:1.6.0. يحتوي الإصدار 1.6.0 على عمليات الدمج هذه.

التغييرات المهمة منذ الإصدار 1.5.0

  • أضِف الإضافات اللازمة لإعداد صفحة تسجيل الدخول/الإعدادات باستخدام CarAppLibrary على تطبيق وسائط متوافق مع Android Auto.

الإصدار 1.6.0-rc01

‫6 أبريل 2022

تم طرح androidx.media:media:1.6.0-rc01. يحتوي الإصدار 1.6.0-rc01 على عمليات الإيداع هذه.

الإصدار 1.6.0-beta01

‫23 مارس 2022

تم طرح androidx.media:media:1.6.0-beta01. يحتوي الإصدار 1.6.0-beta01 على عمليات الإيداع هذه.

  • لم يتم إجراء أي تغييرات منذ آخر إصدار أولي.

الإصدار 1.6.0-alpha01

‫23 فبراير 2022

تم طرح androidx.media:media:1.6.0-alpha01. يحتوي الإصدار 1.6.0-alpha01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • أضِف الإضافات اللازمة لإعداد صفحة تسجيل الدخول/الإعدادات باستخدام CarAppLibrary على تطبيق وسائط متوافق مع Android Auto. (Ifb3ca)

الإصدار 1.5

الإصدار 1.5.0

‫9 فبراير 2022

تم طرح androidx.media:media:1.5.0. يحتوي الإصدار 1.5.0 على عمليات الإيداع هذه.

التغييرات المهمة منذ الإصدار 1.4.0

  • إضافة isVolumeFixed إلى AudioManagerCompat
  • أضِف MediaConstants لتحديد نمط عنصر واحد ونسبة الإكمال.
  • بالنسبة إلى المستوى 30 أو أعلى لواجهة برمجة التطبيقات، لن تُدرِج المكتبة فلتر مستوى ظهور الحزمة لـ MediaBrowserCompat. عليك تحديد عنصر <queries> في بيان تطبيقاتك.
  • إصلاح التغيير غير المتوقّع في البيانات الإضافية لـ getMediaDescription() على الإصدار 21 من واجهة برمجة التطبيقات
  • منع بعض IllegalStateException على الإصدار 19 من واجهة برمجة التطبيقات
  • إصلاح عُطل في MediaSessionCompat عند استهداف Android 12
  • إصلاح عُطل في NotificationCompat على KitKat

الإصدار 1.5.0-rc01

‫26 يناير 2022

تم إصدار androidx.media:media:1.5.0-rc01 بدون أي تغييرات منذ 1.5.0-beta01. يحتوي الإصدار 1.5.0-rc01 على عمليات الإيداع هذه.

الإصدار 1.5.0-beta01

‫1 كانون الأول (ديسمبر) 2021

تم إصدار androidx.media:media:1.5.0-beta01 بدون أي تغييرات منذ 1.5.0-alpha01. يحتوي الإصدار 1.5.0-beta01 على عمليات الإيداع هذه.

الإصدار 1.5.0-alpha01

‫3 نوفمبر 2021

تم طرح androidx.media:media:1.5.0-alpha01. يحتوي الإصدار 1.5.0-alpha01 على عمليات الإيداع هذه.

الميزات الجديدة

  • تعديل التبعية على الإصدار 1.6.0 من حزمة الوسائط الأساسية

تغييرات واجهة برمجة التطبيقات

  • إضافة isVolumeFixed إلى AudioManagerCompat
  • أضِف MediaConstants لتحديد نمط عنصر واحد ونسبة الإكمال.

إصلاح الأخطاء

  • بالنسبة إلى المستوى 30 أو أعلى لواجهة برمجة التطبيقات، لن تُدرِج المكتبة فلتر مستوى ظهور الحزمة لـ MediaBrowserCompat. عليك تحديد عنصر <queries> في بيان تطبيقاتك.
  • إصلاح التغيير غير المتوقّع في الإضافات الخاصة بدالة getMediaDescription() على الإصدار 21 من واجهة برمجة التطبيقات
  • إصلاح الاستخدام غير الفعّال لـ ArrayList من خلال ضبط الحجم التلقائي
  • منع بعض IllegalStateException على الإصدار 19 من واجهة برمجة التطبيقات
  • إصلاح عُطل في MediaSessionCompat عند استهداف Android 12
  • إصلاح عُطل في NotificationCompat على KitKat

الإصدار 1.4

الإصدار 1.4.3

‫13 أكتوبر 2021

تم طرح androidx.media:media:1.4.3. يتضمّن الإصدار 1.4.3 عمليات الدمج هذه.

إصلاح الأخطاء

  • لن تُدرج المكتبة فلتر إذن الوصول إلى الحزمة للتطبيق MediaBrowserCompat بعد الآن. يُرجى تحديد عنصر <queries> في بيان التطبيقات عند استهداف المستوى 30 أو مستوى أحدث لواجهة برمجة التطبيقات. (I0a964، b/185314633)

الإصدار 1.4.2

‫15 سبتمبر 2021

تم طرح androidx.media:media:1.4.2. يتضمّن الإصدار 1.4.2 عمليات الإيداع هذه.

إصلاح الأخطاء

  • إصلاح التأثير الجانبي لـ getMediaDescription() على الإصدار 21 من واجهة برمجة التطبيقات (I5c05f)

الإصدار 1.4.1

‫4 أغسطس 2021

تم طرح androidx.media:media:1.4.1. يحتوي الإصدار 1.4.1 على عمليات الدمج هذه.

إصلاح الأخطاء

  • إصلاح علامة قابلية التغيير لإنشاء PendingIntent لتجنُّب حدوث عُطل عند استهداف الإصدار Android S
  • إصلاح الخطأ ClassVerificationFailure في NotificationCompat.MediaStyle

الإصدار 1.4.0

‫21 تموز (يوليو) 2021

تم طرح androidx.media:media:1.4.0. يتضمّن الإصدار 1.4.0 عمليات الإيداع هذه.

التغييرات المهمة منذ الإصدار 1.3.0

  • تمت إضافة مفتاح حزمة جديد METADATA_KEY_SERIES_CONTENT_ID يُستخدَم لمعرّف محتوى الوسائط الخاص بالمسلسل التلفزيوني في MediaMetadataCompat
  • تمت إضافة مفتاح حزمة جديد METADATA_KEY_NEXT_EPISODE_CONTENT_ID يُستخدَم لمعرّف محتوى الحلقة التالية من البرنامج التلفزيوني في MediaMetadataCompat
  • إيقاف MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE نهائيًا وإضافة MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE بدلاً منها
  • إضافة مفتاح إضافي لترتيب الوسائط بشكل عشوائي في playFromUri
  • إضافة التعليق التوضيحي ‎ @Nullable إلى فئة Result
  • حلّ مشكلة عدم توفّر EXTRA_KEY_EVENT من Intent لـ MediaButtonReceiver

الإصدار 1.4.0-rc01

‫30 حزيران (يونيو) 2021

تم إصدار androidx.media:media:1.4.0-rc01 بدون أي تغييرات منذ 1.4.0-beta01. يتضمّن الإصدار 1.4.0-rc01 عمليات الإيداع هذه.

الإصدار 1.4.0-beta01

‫17 يونيو 2021

تم طرح androidx.media:media:1.4.0-beta01. يحتوي الإصدار 1.4.0-beta01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة مفتاح حزمة جديد METADATA_KEY_SERIES_CONTENT_ID يُستخدم لمعرّف محتوى الوسائط الخاص بالمسلسل التلفزيوني في MediaMetadataCompat

  • تمت إضافة مفتاح حزمة جديد METADATA_KEY_NEXT_EPISODE_CONTENT_ID يُستخدم لمعرّف المحتوى الخاص بالحلقة التالية من الحلقة التلفزيونية في MediaMetadataCompat

الإصدار 1.4.0-alpha01

‫5 أيار (مايو) 2021

تم طرح androidx.media:media:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • إيقاف MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE نهائيًا وإضافة MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE بدلاً منه (I62f17)
  • إضافة مفتاح إضافي لترتيب الوسائط عشوائيًا من أجل playFromUri (Ibc63c)
  • إضافة التعليق التوضيحي ‎ @Nullable إلى فئة Result (I2d617)

إصلاح الأخطاء

  • إصلاح الخطأ EXTRA_KEY_EVENT في بيان الأهداف الخاص بفئة MediaButtonReceiver (If7557)

الإصدار 1.3.1

الإصدار 1.3.1

‫5 أيار (مايو) 2021

تم طرح androidx.media:media:1.3.1. يتضمّن الإصدار 1.3.1 عمليات الدمج هذه.

إصلاح الأخطاء

  • إصلاح EXTRA_KEY_EVENT المفقود في هدف MediaButtonReceiver (If7557)

الإصدار 1.3.0

الإصدار 1.3.0

‫7 نيسان (أبريل) 2021

تم طرح androidx.media:media:1.3.0. يحتوي الإصدار 1.3.0 على عمليات الإيداع هذه.

التغييرات الرئيسية منذ الإصدار 1.2.0

  • نقلنا إضافات Android Auto إلى MediaConstants.

الإصدار 1.3.0-rc02

‫24 مارس 2021

تم طرح androidx.media:media:1.3.0-rc02. يتضمّن الإصدار 1.3.0-rc02 عمليات الدمج التالية.

إصلاح الأخطاء

  • اضبط قيمة FLAG_IMMUTABLE على PendingIntent الخاص بفئة MediaButtonReceiver، وهو أمر مطلوب للتطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android.
  • تم إصلاح NullPointerException في MediaSessionCompat باستخدام الإصدار 27 من واجهة برمجة التطبيقات بعد setCallback(null).

الإصدار 1.3.0-rc01

‫10 مارس 2021

تم طرح androidx.media:media:1.3.0-rc01. يحتوي الإصدار 1.3.0-rc01 على عمليات الإيداع هذه.

لم يتم إجراء أي تغييرات منذ ‎1.3.0-beta01.

الإصدار 1.3.0-beta01

10 شباط (فبراير) 2021

تم طرح androidx.media:media:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة ثابت جديد PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076)
  • نقل إضافات Android Auto إلى MediaConstants (I290ab)
  • إضافة ثوابت لتقييد العناصر الفرعية الجذرية في MediaBrowserService (Ifcebd)

إصلاح الأخطاء

  • أضِف FLAG_RECEIVER_FOREGROUND لغرض معلّق لزر الوسائط.

الإصدار 1.2.1

إصدار الوسائط 1.2.1

‫2 ديسمبر 2020

تم طرح androidx.media:media:1.2.1. يحتوي الإصدار 1.2.1 على عمليات الإيداع هذه.

إصلاح الأخطاء

  • إصلاح خطأ NPE بعد استدعاء MediaSessionCompat#setCallback(null) في الإصدار 27 من واجهة برمجة التطبيقات

الإصدار 1.2.0

الإصدار 1.2.0

‫16 سبتمبر 2020

تم طرح androidx.media:media:1.2.0. يتضمّن الإصدار 1.2.0 عمليات الإيداع هذه.

التغييرات الرئيسية منذ الإصدار 1.1.0

  • إتاحة استخدام AudioAttributesCompat#setLegacyStreamType في حزمة تطوير البرامج (SDK) التي تقلّ عن الإصدار 21
  • إتاحة التحكّم في مستوى الصوت لمكتبة "androidx.mediarouter"
  • تحسين إمكانية التشغيل التفاعلي بين androidx.media وandroidx.media2

الإصدار 1.2.0-rc01

‫2 سبتمبر 2020

تم إصدار androidx.media:media:1.2.0-rc01 بدون أي تغييرات منذ 1.2.0-beta01. يحتوي الإصدار 1.2.0-rc01 على عمليات الإيداع هذه.

الإصدار 1.2.0-beta01

19 آب (أغسطس) 2020

تم طرح androidx.media:media:1.2.0-beta01. يحتوي الإصدار 1.2.0-beta01 على عمليات الإيداع هذه.

الميزات الجديدة

  • تمّت إضافة دعم AudioAttributesCompat#setLegacyStreamType لمستويات واجهة برمجة التطبيقات قبل 21

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID لمعرّف الوسائط في إضافات PlaybackStateCompat، ومن المتوقّع أن يكون هو نفسه MediaMetadataCompat#METADATA_KEY_MEDIA_ID للبيانات الوصفية الحالية.

إصلاح الأخطاء

  • تم حلّ مشكلة في AudioAttributesCompat.Builder#setContentType

الإصدار 1.2.0-alpha04

‫24 يونيو 2020

تم طرح androidx.media:media:1.2.0-alpha04. يحتوي الإصدار 1.2.0-alpha04 على عمليات الإيداع هذه.

الميزات الجديدة

  • توفير طريقة لدعم التحكّم في مستوى الصوت لمكتبة mediarouter

تغييرات واجهة برمجة التطبيقات

  • تمّت إضافة "AudioManagerCompat#getStreamMaxVolume"
  • تمّت إضافة "AudioManagerCompat#getStreamMinVolume"

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم التوافق بين حزمتَي media وmedia2 على حزمة تطوير البرامج (SDK) التي تقلّ عن 21

الإصدار 1.2.0-alpha03

‫10 يونيو 2020

تم طرح androidx.media:media:1.2.0-alpha03. يحتوي الإصدار 1.2.0-alpha03 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN.

إصلاح الأخطاء

  • تم إصلاح مشكلة في equals() من RemoteUserInfo

الإصدار 1.2.0-alpha02

نيسان (أبريل) 2020

تم طرح androidx.media:media:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على عمليات الإيداع هذه.

إصلاح الأخطاء

  • منع تعديل فئات VersionedParcelable

الإصدار 1.2.0-alpha01

‫23 تشرين الأول (أكتوبر) 2019

تم طرح androidx.media:media:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة الطرق التالية:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

إصلاح الأخطاء

  • تم تنفيذ إجراء وقائي ضد BadParcelableException عند تمرير عنصر Bundle من خلال طلب IPC
  • لم يعُد منشئ MediaControllerCompat يعرض الخطأ RemoteException
  • تم تنفيذ إجراء وقائي لمنع استدعاء طرق رد الاتصال بعد MediaSessionCompat.release()

الإصدار 1.1.0

الإصدار 1.1.0

‫5 أيلول (سبتمبر) 2019

تم طرح androidx.media:media:1.1.0. يمكنك الاطّلاع على عمليات الإيداع المضمَّنة في هذا الإصدار هنا.

استيراد التغييرات منذ الإصدار 1.0.0

  • تم طرحها في AudioAttributesCompat

الإصدار 1.1.0-rc01

13 حزيران (يونيو) 2019

تم إصدار androidx.media:media:1.1.0-rc01 بدون أي تغييرات عن 1.1.0-beta02. يمكنك الاطّلاع على عمليات الإيداع المضمَّنة في هذا الإصدار هنا.

الإصدار 1.1.0-beta02

‫5 يونيو 2019

تم طرح androidx.media:media:1.1.0-beta02. يمكنك الاطّلاع على عمليات الإيداع المضمَّنة في هذا الإصدار هنا.

إصلاح الأخطاء

  • تم تخفيف نطاق القيود المفروضة على الطرق المخفية التي تستخدمها media2-session إلى LIBRARY_GROUP_PREFIX.

الإصدار 1.1.0-beta01

7 أيار (مايو) 2019

تم طرح androidx.media:media:1.1.0-beta01. يمكنك الاطّلاع على عمليات الإيداع المضمَّنة في هذا الإصدار هنا.

الميزات الجديدة

  • تم تغيير IllegalPointerException إلى NullPointerException للوسيطات الفارغة التي تم وضع علامة @NonNull عليها.

الإصدار 1.1.0-alpha04

‫3 أبريل 2019

تم طرح androidx.media:media:1.1.0-alpha04. يمكنك الاطّلاع على عمليات الإيداع المضمَّنة في هذا الإصدار هنا.

إصلاح الأخطاء

  • تعديل على ثابت اختبار التوافق مع الإصدار (aosp/933656)

الإصدار 1.1.0-alpha03

‫21 آذار (مارس) 2019

تم طرح androidx.media:media:1.1.0-alpha03. يمكنك الاطّلاع على القائمة الكاملة لعمليات الإضافة إلى المستودع المضمّنة في هذا الإصدار هنا.

إصلاح الأخطاء

  • تم إصلاح مشكلة تعطُّل MedaBrowserServiceCompat عند محاولة ربط عدة أجهزة MediaBrowserCompat به. (aosp/930246)

الإصدار 1.1.0-alpha02

‫13 مارس 2019

تم طرح androidx.media:media:1.1.0-alpha02. يمكنك الاطّلاع على القائمة الكاملة لعمليات الإضافة إلى المستودع المضمّنة في هذا الإصدار هنا.

إصلاح الأخطاء

  • تم إصلاح تعطُّل MediaBrowserCompat أثناء الاتصال
  • تم إصلاح الخطأ IllegalStateException في getCurrentBrowserInfo()/getBrowserRootHints()
  • اجعل MediaBrowserServiceCompat.getCurrentBrowserInfo() تعرض مثيل RemoteUserInfo نفسه للرمز MediaBrowserCompat نفسه في onGetRoot()

الإصدار 1.0.1

الإصدار 1.0.1

‫30 يناير 2019

تم طرح androidx.media:media 1.0.1.

إصلاح الأخطاء

  • تم إصلاح الخطأ IllegalStateException غير المتوقّع أثناء استخدام MediaBrowserCompat.connect() (aosp/858075)

الإصدار 1.0.0

الإصدار 1.0.0-alpha06

‫17 كانون الأول (ديسمبر) 2018

تغييرات واجهة برمجة التطبيقات

تمت إعادة تسمية أسماء الحزم والفئات media.widget على النحو التالي:

  • ‫androidx.media.widget.VideoView2 ← androidx.media2.widget.VideoView
  • ‫androidx.media.widget.MediaControlView2 ← androidx.media2.widget.MediaControlView

الإصدار 1.0.0-alpha01

‫3 كانون الأول (ديسمبر) 2018

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف علامتَي MediaSessionCompat نهائيًا:
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS