الوسائط

الوسائط

دليل المستخدم  نموذج الرمز

مرجع واجهة برمجة التطبيقات
androidx.media
androidx.media.app
androidx.media.session

مشاركة محتوى الوسائط وعناصر التحكّم مع تطبيقات أخرى حلّت مكتبة Media3 محلّها.

آخر الأخبار	الإصدار الثابت	إصدار محتمل	الإصدار التجريبي	الإصدار الأولي
‫8 أبريل 2026	1.7.1	-	-	1.8.0-alpha01

تحديد الاعتماديات

لإضافة اعتمادية على 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.8

الإصدار ‎1.8.0-alpha01

‫8 أبريل 2026

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

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

• إيقاف androidx.media استخدِم androidx.media3 بدلاً من ذلك.

الإصدار 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 من الغرض في 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

ملاحظة: يُرجى الترقية إلى الإصدار 1.1.0-alpha03 إذا كنت تريد استخدام هذه الميزات الجديدة. يتضمّن الإصدار 1.1.0-alpha03 إصلاحًا مهمًا للخطأ MedaBrowserServiceCompat؛ aosp/930246.

تم طرح 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