الوسائط

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

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

لإضافة تبعية إلى الوسائط، يجب إضافة مستودع Google Maven إلى مشروعك. يمكنك الاطّلاع على مستودع Maven الذي يضم أدوات Google للحصول على مزيد من المعلومات.

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

رائع

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 على هذه الالتزامات.

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

  • تحديث التبعية على Core للوسائط إلى 1.6.0

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

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

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

  • بالنسبة إلى المستوى 30 لواجهة برمجة التطبيقات أو مستوى أعلى، لن تُدخل المكتبة فلتر مستوى رؤية الحزمة في MediaBrowserCompat. يجب تحديد عنصر <queries> في بيان التطبيقات.
  • إصلاح التغيير غير المتوقع في الإضافات الإضافية getMediaDescription() على واجهة برمجة التطبيقات 21
  • يمكنك إصلاح الاستخدام غير الفعّال لـ ArrayList من خلال ضبط الحجم التلقائي.
  • منع بعض EXISTStateException على واجهة برمجة التطبيقات 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() على API 21 (I5c05f)

الإصدار 1.4.1

4 آب (أغسطس) 2021

تم إصدار "androidx.media:media:1.4.1". يتضمّن الإصدار 1.4.1 هذه الالتزامات.

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

  • إصلاح علامة قابلية التغيّر لإنشاء PendingIntent لمنع التعطُّل عند استهداف Android S.
  • إصلاح تعذُّر إكمال عملية التحقّق من صحة البيانات في خدمة 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 إلى فئة النتائج
  • إصلاح عدم توفّر EXTRA_KEY_EVENT من الهدف لـ MediaButtonReceivedr

الإصدار 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 إلى فئة النتائج (I2d617)

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

  • إصلاح عدم توفُّر EXTRA_KEY_EVENT من intent في MediaButtonReceivedr (If7557)

الإصدار 1.3.1

الإصدار 1.3.1

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

تم إصدار "androidx.media:media:1.3.1". يتضمّن الإصدار 1.3.1 هذه الالتزامات.

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

  • إصلاح عدم توفّر EXTRA_KEY_EVENT من الغرض لـ MediaButtonReceivedr (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 of MediaButtonReceivedr، المطلوبة للتطبيقات التي تستهدف الإصدار 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" لأجزاء واجهة برمجة التطبيقات قبل عام 2021.

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

  • تمت إضافة 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 على هذه الالتزامات.

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

  • تم توفير طريقة لإتاحة التحكّم في مستوى الصوت في مكتبة جهاز توجيه الوسائط.

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

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

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

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

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

  • التعديل على ثابت اختبار النسخة المتوافقة (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".

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

  • تم إصلاح خطأ NetzDG غير متوقع أثناء استخدام 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