الوسائط

مشاركة محتوى الوسائط وعناصر التحكّم فيه مع تطبيقات أخرى تم استبداله بـ media3.
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
29 تشرين الثاني (نوفمبر) 2023 1.7.0 - - -

الإعلان عن التبعيات

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

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

Groovy

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

Kotlin

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

ملاحظات

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

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

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.7

الإصدار 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 لintent في MediaButtonReceiver (If7557)

الإصدار 1.3.1

الإصدار 1.3.1

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

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

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

  • إصلاح عدم توفّر EXTRA_KEY_EVENT للintent في 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 على هذه المراجعات.

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

  • إصلاح خطأ "عدم توفّر مثيل للعنصر" بعد استدعاء 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 عند تمرير عنصر حِزمة عبر طلب 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. يمكن العثور على عمليات الربط المضمّنة في هذا الإصدار هنا.

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

  • تعديل على الثابت version-compat-test (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