Mediarouter

تتيح هذه السمة عرض الوسائط وتشغيلها على أجهزة الاستقبال عن بُعد باستخدام واجهة مستخدم مشتركة.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫2 يوليو 2025 1.8.1 - - -

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

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

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

Groovy

dependencies {
    implementation "androidx.mediarouter:mediarouter:1.8.1"
}

Kotlin

dependencies {
    implementation("androidx.mediarouter:mediarouter:1.8.1")
}

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

الملاحظات

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

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

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

الإصدار 1.8

الإصدار 1.8.1

‫2 يوليو 2025

تم طرح androidx.mediarouter:mediarouter:1.8.1 وandroidx.mediarouter:mediarouter-testing:1.8.1. يحتوي الإصدار 1.8.1 على عمليات الدمج هذه.

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

  • جعل عملية اختيار مسار محدّد عملية غير قابلة للتنفيذ (a2953f)

الإصدار 1.8.0

‫4 يونيو 2025

تم طرح androidx.mediarouter:mediarouter:1.8.0 وandroidx.mediarouter:mediarouter-testing:1.8.0. يتضمّن الإصدار 1.8.0 عمليات الدمج هذه.

التغييرات المهمة منذ MediaRouter 1.7.0

  • إضافة واجهة برمجة تطبيقات جديدة تتيح الاتصال بالمسارات (وقطع الاتصال بها) بدون التأثير في عملية اختيار المسار
  • إضافة واجهة برمجة تطبيقات جديدة تتيح للموفّرين استخدام المَعلمات عند إنشاء أداة تحكّم
  • إضافة واجهة برمجة تطبيقات جديدة للاستماع إلى التغييرات في قائمة عملاء MediaRouteProviderService المرتبطين
  • واجهة برمجة تطبيقات جديدة تتيح توسيع نطاق البث من خلال ربط المسار
  • تعديل دالة الاستدعاء onRouteDisconnected لتشمل كلاً من المسارات التي تم قطع الاتصال بها والمسارات المطلوبة

الإصدار 1.8.0-rc01

‫20 مايو 2025

تم طرح androidx.mediarouter:mediarouter:1.8.0-rc01 وandroidx.mediarouter:mediarouter-testing:1.8.0-rc01. يحتوي الإصدار 1.8.0-rc01 على عمليات الدمج هذه.

الإصدار 1.8.0-beta01

‫7 مايو 2025

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

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

  • تضمين اسم حزمة العميل في RouteControllerOptions (Ieac03)

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

  • إصلاح الخطأ NullPointerException عند محاولة فصل وحدة تحكّم غير متوفّرة عن جهاز (8e61574).

الإصدار 1.8.0-alpha04

‫23 أبريل 2025

تم طرح androidx.mediarouter:mediarouter:1.8.0-alpha04 وandroidx.mediarouter:mediarouter-testing:1.8.0-alpha04. يحتوي الإصدار 1.8.0-alpha04 على عمليات الدمج هذه.

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

  • إصلاح الخطأ NullPointerException الذي يحدث نتيجة عرض وحدة تحكّم مسار فارغة في سيناريوهات معيّنة (Ib7efe)

الإصدار 1.8.0-alpha03

‫12 فبراير 2025

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

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

  • إزالة واجهة برمجة تطبيقات في مرحلة الإصدار الأولي GroupRouteInfo#updateRoutes (Ib3d70)
  • تعديل javadoc لواجهات برمجة التطبيقات الخاصة باختيار المسار والاتصال بالمسار (I85bc5)

الإصدار 1.8.0-alpha02

‫15 يناير 2025

تم طرح androidx.mediarouter:mediarouter:1.8.0-alpha02 وandroidx.mediarouter:mediarouter-testing:1.8.0-alpha02. يحتوي الإصدار 1.8.0-alpha02 على عمليات الدمج هذه.

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

  • واجهة برمجة تطبيقات جديدة تتيح توسيع نطاق البث من خلال ربط المسار (I87373)
  • تعديل دالة الاستدعاء onRouteDisconnected لتشمل كلاً من المسارات التي تم قطع الاتصال بها والمسارات المطلوبة (Iae5f3)

الإصدار 1.8.0-alpha01

‫11 ديسمبر 2024

تم طرح androidx.mediarouter:mediarouter:1.8.0-alpha01 وandroidx.mediarouter:mediarouter-testing:1.8.0-alpha01. يحتوي الإصدار 1.8.0-alpha01 على عمليات الدمج هذه.

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

  • إضافة واجهة برمجة تطبيقات جديدة تتيح الاتصال بالمسارات (وقطع الاتصال بها) بدون التأثير في عملية اختيار المسار (I64a8e).
  • إضافة واجهة برمجة تطبيقات جديدة تتيح للموفّرين استخدام المَعلمات عند إنشاء أداة تحكّم (I703b9).
  • إضافة واجهة برمجة تطبيقات جديدة للاستماع إلى التغييرات في قائمة عملاء MediaRouteProviderService المرتبطين (I69996)

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

  • تم حلّ المشكلة التي كانت تؤدي إلى توجيه التشغيل بشكل غير صحيح إلى مكبّرات الصوت المدمجة أثناء توصيل جهاز بلوتوث.
  • تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة للمنصة لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون AGP بالترقية إلى الإصدار 8.1 أو إصدار أحدث من D8. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (If6b4c، b/345472586)
  • تم إصلاح مشكلة استدعاء أداة التبديل بين أجهزة التشغيل في سيناريوهات WearOs معيّنة (Iab44a).
  • أصلِح بعض الترجمات الخاصة بـ MediaRouteChooserDialog. (26da14).

الإصدار 1.7

الإصدار 1.7.0

‫20 مارس 2024

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

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

  • أضِف isSystemRoute() إلى MediaRouteDescriptor وRouteInfo، ما يؤدي إلى عرض القيمة "صحيح" إذا كان المسار المقابل مسارًا يديره النظام، ما يعني أنّ النظام هو موفّر المسار وأنّ التطبيق مسؤول عن تزويد النظام بعيّنات الوسائط لعرضها (I949e4). تُعد سمّاعات الرأس التي تعمل بالبلوتوث وسمّاعات الرأس السلكية ومكبّرات الصوت المدمجة أمثلة على مسارات النظام.
  • إيقاف MediaRouter.removeRemoteControlClient عليك استدعاء setMediaSessionCompat(MediaSessionCompat) بدلاً من addRemoteControlClient(Object) حتى لا تحتاج إلى استدعاء removeRemoteControlClient(Object). (I8fc5e).
  • اجعل MediaRouteButton يمتد إلى AppCompatImageView. (Ib455e).
  • أضِف DEVICE_TYPE_SMARTPHONE، ما يشير إلى أنّ مسار الوسائط هو هاتف ذكي. (I39837)
  • تحسين عمليات ربط أنواع الأجهزة من MediaRouter2 إلى AndroidX MediaRouter لوصف مسارات النظام (مثل البلوتوث وHDMI والاتصال السلكي) (Iccffa)

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

  • تمت إضافة دقة الرموز الناقصة لزر المسار الذي كان من المحتمل أن يتسبّب في بعض الأعطال المعزولة. (cddba9 وb/261878418).
  • تم إصلاح الخطأ الذي يؤدي إلى عرض القيمة "صحيح" في isSystemRoute لمسارات المستخدمين التي تمت إضافتها من خلال android.media.MediaRouter#addUserRoute() (a27f6b).

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

  • ارفع قيمة minSdk إلى 19. (e8c4463)

الإصدار 1.7.0-rc01

‫6 مارس 2024

تم طرح androidx.mediarouter:mediarouter:1.7.0-rc01 وandroidx.mediarouter:mediarouter-testing:1.7.0-rc01. يحتوي الإصدار 1.7.0-rc01 على عمليات الدمج هذه.

الإصدار 1.7.0-beta01

‫21 فبراير 2024

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

الإصدار 1.7.0-alpha02

‫7 فبراير 2024

تم طرح androidx.mediarouter:mediarouter:1.7.0-alpha02 وandroidx.mediarouter:mediarouter-testing:1.7.0-alpha02. يتضمّن الإصدار 1.7.0-alpha02 عمليات الإيداع هذه.

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

  • ارفع قيمة minSdk إلى 19. (e8c4463)

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

  • تحسين عمليات ربط أنواع الأجهزة من MediaRouter2 إلى AndroidX MediaRouter لوصف مسارات النظام (مثل البلوتوث وHDMI والاتصال السلكي) (Iccffa)

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

  • تم إصلاح الخطأ الذي يؤدي إلى عرض القيمة "صحيح" في isSystemRoute لمسارات المستخدمين التي تمت إضافتها من خلال android.media.MediaRouter#addUserRoute() (a27f6b).

الإصدار 1.7.0-alpha01

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

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

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

  • أضِف isSystemRoute() إلى MediaRouteDescriptor وRouteInfo، ما يؤدي إلى عرض القيمة "صحيح" إذا كان المسار المقابل مسارًا يديره النظام، ما يعني أنّ النظام هو موفّر المسار وأنّ التطبيق مسؤول عن تزويد النظام بعيّنات الوسائط لعرضها (I949e4). تُعد سمّاعات الرأس التي تعمل بالبلوتوث وسمّاعات الرأس السلكية ومكبّرات الصوت المدمجة أمثلة على مسارات النظام.
  • إيقاف MediaRouter.removeRemoteControlClient عليك استدعاء setMediaSessionCompat(MediaSessionCompat) بدلاً من addRemoteControlClient(Object) حتى لا تحتاج إلى استدعاء removeRemoteControlClient(Object). (I8fc5e).
  • اجعل MediaRouteButton يمتد إلى AppCompatImageView. (Ib455e).
  • أضِف DEVICE_TYPE_SMARTPHONE، ما يشير إلى أنّ مسار الوسائط هو هاتف ذكي. (I39837)

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

  • تمت إضافة دقة الرموز الناقصة لزر المسار الذي كان من المحتمل أن يتسبّب في بعض الأعطال المعزولة. (cddba9 وb/261878418).

الإصدار 1.6

الإصدار 1.6.0

‫20 سبتمبر 2023

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

الميزات الرئيسية منذ الإصدار 1.4.0

  • إعدادات قائمة المسارات المفضّلة لأداة تبديل الإخراج
  • إضافة إمكانية تحديد الإعدادات المفضّلة لعرض قوائم المسارات إلى MediaRouter في AndroidX
  • إضافة إمكانية ضبط مستوى الظهور لـ MediaRouteDescriptor
  • تعديل MediaRouteButton لتقديم تجربة أفضل للمستخدم ((I9dbcb)[https://android-review.googlesource.com/#/q/I9dbcb8d9e5ee4902d48f1bfb4133e04781c6ae35]). بما في ذلك:
    • أضِف تلميحًا للمستخدم للتحقّق من أنّ الجهاز الذي تم البحث عنه متصل بشبكة Wi-Fi نفسها.
    • أضِف حالة نهائية مع رسالة خطأ سيتم عرضها في نهاية فترة زمنية محدّدة مسبقًا.
  • تمت إضافة إغلاق تلقائي لمربّع حوار MediaRouter عند إيقاف تشغيل الشاشة.

الإصدار 1.6.0-rc01

‫23 أغسطس 2023

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

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

  • تمت إضافة إغلاق تلقائي لمربّع الحوار MediaRouter عند إيقاف تشغيل الشاشة. (Ib25ee).

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

  • تم تغيير علامة تسجيل MediaRouter إلى AxMediaRouter لتجنُّب الالتباس مع MediaRouter على المنصة. (Ib619f).

الإصدار 1.6.0-beta01

‫9 أغسطس 2023

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

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

  • إصلاح المشاكل المتعلّقة بتوافق واجهات برمجة التطبيقات لنظام التشغيل Android U (Ie9117، b/289269026)

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

  • إصلاح الترجمات في MediaRouteChooserDialog (d39a7f)

الإصدار 1.6.0-alpha05

‫21 حزيران (يونيو) 2023

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

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

  • تحسين واجهة المستخدم MediaRouteChooserDialog للتعامل مع عدم العثور على أجهزة من خلال تقديم إرشادات مكتوبة للمستخدم (I0cad9، I3d445)

الإصدار 1.6.0-alpha04

‫7 يونيو 2023

تم طرح androidx.mediarouter:mediarouter:1.6.0-alpha04 وandroidx.mediarouter:mediarouter-testing:1.6.0-alpha04. تم تطوير هذا الإصدار في فرع داخلي.

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

  • تجديد MediaRouteButton لتوفير تجربة أفضل للمستخدم (I9dbcb) بما في ذلك:
    • أضِف تلميحًا للمستخدم للتحقّق من أنّ الجهاز الذي تم البحث عنه متصل بشبكة Wi-Fi نفسها.
    • أضِف حالة نهائية مع رسالة خطأ سيتم عرضها في نهاية فترة زمنية محدّدة مسبقًا.

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

  • إضافة أنواع أجهزة MediaRouteDescriptor جديدة من المنصة (I75ba6).

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

  • تم إصلاح مشكلة ضبط مستوى الصوت في أدوات التحكّم في المسار غير الديناميكي (I730ec).
  • اجعل MediaRouteButton مفعَّلاً دائمًا (I1e9ff).
  • إصلاح بعض عمليات التحقّق من وقت التشغيل لإصدار Android التي تمنع الوصول إلى ميزات Android U باستخدام مكتبة أداة توجيه الوسائط AndroidX (I97cab)

الإصدار 1.6.0-alpha03

‫12 أبريل 2023

تم طرح androidx.mediarouter:mediarouter:1.6.0-alpha03 وandroidx.mediarouter:mediarouter-testing:1.6.0-alpha03. تم إصدار هذا التحديث من فرع داخلي.

  • أجرينا بعض التغييرات على واجهة برمجة التطبيقات الخاصة بإمكانية ظهور MediaRouteDescriptor.
  • إيقاف MediaRouteActionProvider.setAlwaysVisible وMediaRouteButton.setAlwaysVisible نهائيًا، ما يؤدي إلى إظهار زر مسار الوسائط دائمًا، بغض النظر عن الاتصال بالشبكة أو توفّر مسارات الوسائط
  • إصلاح مشكلة ضبط مستوى الصوت في أدوات التحكّم في المسار غير الديناميكي يحلّ هذا الإصلاح خطأً كان يؤدي إلى إعادة مستوى الصوت إلى قيمته الأصلية عند محاولة ضبط مستوى صوت مسار في أداة تبديل الإخراج (93f409).

الإصدار 1.6.0-alpha02

‫8 مارس 2023

تم طرح androidx.mediarouter:mediarouter:1.6.0-alpha02 وandroidx.mediarouter:mediarouter-testing:1.6.0-alpha02. تم تطويره على فرع داخلي.

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

  • إضافة إمكانية تحديد الإعدادات المفضّلة لقوائم المسارات إلى AndroidX MediaRouter
  • أضِف إمكانية ضبط مستوى الظهور للسمة MediaRouteDescriptor.

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

  • تحسين طريقة استدعاء أداة التبديل بين أجهزة التشغيل في SystemUI على نظام التشغيل Android U+‎

الإصدار 1.6.0-alpha01

‫10 فبراير 2023

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

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

  • إعدادات قائمة المسارات المفضّلة لأداة تبديل الإخراج

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

  • آلية تتيح للتطبيق ضبط أداة التبديل بين أجهزة التشغيل

الإصدار 1.4

الإصدار 1.4.0

‫3 مايو 2023

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

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

  • أضِف SystemOutputSwitcherDialogController#showDialog لعرض مربّع حوار مبدّل الإخراج في النظام، أو جزء إعدادات البلوتوث على أجهزة Wear التي لا يتوفّر فيها مبدّل الإخراج في النظام. (Ic3d78)
  • تم إصلاح مشكلة تراجع تؤدي إلى تعطُّل التطبيقات بسبب IllegalArgumentException في MediaRouterProvider.notifyDynamicRoutesChanged (7d17ea).
  • إضافة MediaRouteDescriptor.Builder.clearControlFilters (I3a4e1)
  • أضِف تعليقات MainThread التوضيحية الناقصة في MediaRouter. (I3ef6e)
  • إضافة علامات تصدير أداة استقبال البث على الإصدار 33 من واجهة برمجة التطبيقات أو الإصدارات الأحدث (b2a663)

الإصدار 1.4.0-rc01

‫5 أبريل 2023

تم طرح androidx.mediarouter:mediarouter:1.4.0-rc01 وandroidx.mediarouter:mediarouter-testing:1.4.0-rc01. يتضمّن الإصدار 1.4.0-rc01 عمليات الإيداع هذه.

  • إزالة القوائم الفارغة في MediaRouteProviderDescriptor

الإصدار 1.4.0-beta02

‫22 فبراير 2023

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

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

  • تم إصلاح مشكلة تراجع تؤدي إلى تعطُّل التطبيقات بسبب IllegalArgumentException في MediaRouterProvider.notifyDynamicRoutesChanged (7d17ea).

الإصدار 1.4.0-beta01

‫25 كانون الثاني (يناير) 2023

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

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

تعرض الدالة DynamicGroupRouteController.notifyDynamicRoutesChanged() الآن الخطأ IllegalArgumentException عندما لا يتم تمرير أي مسار إلى الحالة SELECTED أو SELECTING. (8f6b3e)

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

  • إصلاح عُطل ناتج عن تنفيذ خدمة مقدِّم متوافق مع واجهة برمجة التطبيقات يعرض مقدِّم مسار فارغًا (63f16d)
  • يمكنك جعل مستقبِلات البث المحمية تعمل على التطبيقات التي تستهدف الإصدار 33 من واجهة برمجة التطبيقات أو الإصدارات الأحدث من خلال وضع علامة "غير مُصدَّر" عليها. (784f8b)
  • إصلاح بعض التعليقات التوضيحية غير الصحيحة بشأن إمكانية القيم الفارغة في OverlayListView (472e3f)
  • تم إصلاح الخطأ الذي كان يؤدي إلى إغلاق جزء إعدادات البلوتوث فجأة على أجهزة Wear عند استخدام EXTRA_CLOSE_ON_CONNECT في SystemOutputSwitcherDialogController.showDialog. (28c9d8)
  • تم تغييرها إلى Javadoc للطُرق العلنية لأداة التبديل بين أجهزة التشغيل. (f0ae94, 44d2c9)

الإصدار 1.4.0-alpha01

‫9 نوفمبر 2022

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

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

  • أضِف SystemOutputSwitcherDialogController#showDialog لعرض مربّع حوار مبدّل الإخراج في النظام، أو جزء إعدادات البلوتوث على أجهزة Wear التي لا يتوفّر فيها مبدّل الإخراج في النظام. (Ic3d78)

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

  • إضافة MediaRouteDescriptor.Builder.clearControlFilters (I3a4e1)
  • أضِف تعليقات MainThread التوضيحية الناقصة في MediaRouter. (I3ef6e)

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

  • إصلاح عُطل خاص بالجهاز ناتج عن استدعاء MediaRouter.removeUserRoute (b/202931542)
  • تم إصلاح مشكلة عدم تلقّي واصفات المجموعات لتعديلات معالجة مستوى الصوت بشكلٍ متّسق (461303).
  • إضافة علامات تصدير أداة استقبال البث على الإصدار 33 من واجهة برمجة التطبيقات أو الإصدارات الأحدث (b2a663)
  • تم إصلاح عُطل ناتج عن تلقّي أوصاف مسار غير صالحة من المنصة (dd5c09).

الإصدار 1.3

الإصدار 1.3.1

‫27 يوليو 2022

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

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

  • حلّ مشكلة خاصة بجهاز معيّن حيث يعرض MediaRouter.removeUserRoute() الخطأ غير المتوقّع IllegalArgumentException (b/202931542).

الإصدار 1.3.0

‫20 أبريل 2022

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

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

  • أضِف علامة إلى MediaRouterParams يمكن استخدامها لإيقاف ميزة "النقل السلس" في وقت التشغيل.
  • تمت إضافة عنصر اختبار يمكنه إعادة ضبط MediaRouter.
  • أضِف مَعلمة جهاز توجيه لإجراء تعديل على تجربة المستخدم في MediaRouterControllerDialog.
  • تحديد قيمة فارغة مشروحة للطُرق العامة
  • تم تفعيل فحص API lint لـ MissingGetterMatchingBuilder في androidx.
  • تعديل التبعية على الإصدار الأساسي من MediaRouter إلى 1.6.0

الإصدار 1.3.0-rc01

‫23 مارس 2022

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

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

الإصدار 1.3.0-beta01

‫9 مارس 2022

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

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

الإصدار 1.3.0-alpha01

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

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

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

  • إضافة علامة إلى MediaRouterParams يمكن استخدامها لإيقاف النقل السلس في وقت التشغيل (I53d68)
  • تمت إضافة عنصر اختبار يمكنه إعادة ضبط MediaRouter. (Id167c)
  • إضافة مَعلمة موجّه لإجراء تعديل على تجربة المستخدم في MediaRouterControllerDialog (I7e574)
  • القيم الفارغة المشروحة للطُرق العامة (Ifc901)

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

  • تم تفعيل فحص API lint للإصدار MissingGetterMatchingBuilder في androidx (I4bbea وb/138602561).

الإصدار 1.2

الإصدار 1.2.6

‫26 يناير 2022

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

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

  • إصلاح عُطل الدالة الإنشائية RemotePlaybackClient على نظام التشغيل Android 12 b/210684559

الإصدار 1.2.5

‫1 سبتمبر 2021

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

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

  • إخفاء زر مسار الوسائط في "أداة التبديل بين أجهزة التشغيل" عندما لا تتوفّر مسارات لنقل الوسائط
  • إصلاح المشاكل المتعلّقة بالتحكّم في مستوى صوت مسارات أعضاء المجموعة

الإصدار 1.2.4

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

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

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

  • تم إصلاح مشكلة كانت تؤدي إلى إعادة تشغيل الرسوم المتحركة الخاصة بالاتصال في MediaRouteButton.
  • تم إصلاح المحاذاة العمودية للطرق في MediaRouteChooserDialog.

الإصدار 1.2.3

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

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

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

  • تم إصلاح الخطأ NullPointerException في مربّع حوار أداة الاختيار المخصّص.
  • تم إصلاح المشكلة التي كان فيها الزر MediaRouteButton يعرض حالة قطع الاتصال حتى عندما يكون متصلاً، إذا تم إيقافه مؤقتًا.

الإصدار 1.2.2

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

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

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

  • لا تحاول إعادة اختيار المسار المحدّد عند استدعاء OnDynamicRouteChangedListener.onRouteChanged.

الإصدار 1.2.1

13 كانون الثاني (يناير) 2021

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

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

  • حلّ مشكلة اختيار مكبّر صوت الهاتف عند الاتصال بـ "unselect()" أثناء توفّر البلوتوث
  • إصلاح توقيت MediaRouter.Callback سيتم استدعاء Callback#onRouteSelected وCallback#onRouteUnselected بعد اكتمال OnPrepareTransferListener#onPrepareTransfer.

الإصدار 1.2.0

‫14 أكتوبر 2020

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

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

  • إتاحة نقل الوسائط بسلاسة من خلال واجهة مستخدم النظام: يمكنك الاطّلاع على الميزات الجديدة في فيديو الوسائط لمزيد من التفاصيل
  • تم تغيير الإرشادات المتعلّقة بتسجيل وظيفة معالجة الردّ. يمكنك الاطّلاع على مثال الرمز البرمجي في Javadoc الخاص بـ MediaRouter.addCallback()
  • أضِف أداة معالجة جديدة MediaRouter#OnPrepareTransferListener لتلقّي الأحداث عندما يكون المسار المحدّد على وشك التغيير
  • أضِف MediaRouterParams للإشارة إلى وظائف التوجيه وأنواع واجهة المستخدِم.
  • منع الاستخدامات التجريبية للطُرق المخصّصة للاستخدام الداخلي فقط مع @RestrictTo(LIBRARY)

الإصدار 1.2.0-rc02

1 تشرين الأول (أكتوبر) 2020

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

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

  • تم إصلاح المشكلة التي قد لا يتم فيها استدعاء RouteController#onUnselect عندما يتوقف المستخدم عن البث من خلال واجهة مستخدم النظام.

الإصدار 1.2.0-rc01

‫16 سبتمبر 2020

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

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

  • تم إصلاح مشكلة قطع اتصال البث الحالي عند توصيل جهاز صوت يعمل بالبلوتوث.
  • تم إصلاح مشكلة الرمي الثابت IllegalArgumentException في MediaRouteProvider#notifyDynamicRoutesChanged().
  • إتاحة إيقاف الإرسال من مبدّل الإخراج

الإصدار 1.2.0-beta01

‫2 سبتمبر 2020

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

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

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

  • استخدام MediaRouter.OnPrepareTransferListener مع ListenableFuture

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

  • إصلاح عناصر التحكّم في مستوى الصوت لمسارات المجموعة
  • عند إنشاء مسار مجموعة، يتم إنشاء مسار المجموعة أولاً ثم مسارات الأعضاء لاحقًا.
  • تفعيل خيار "إيقاف" في أداة تبديل الإخراج
  • إصلاح عمليات معاودة الاتصال التي لم يتم تنفيذها كما هو متوقّع
    • RouteController#onSelect عند إنشاء جلسة توجيه
    • MediaRouter.Callback#onRouteSelected عند نقل المحتوى إلى الهاتف من البث
    • MediaRouter.Callback#onRouteSelected مع معلومات مسار المجموعة الصحيحة.
  • إزالة عمليات معاودة الاتصال

الإصدار 1.2.0-alpha02

‫22 تموز (يوليو) 2020

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

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

  • أضِف MediaRouter.Callback#onRouteSelected لتلقّي إشعار عندما يختلف المسار المحدّد عن المسار المطلوب (Ieee16).
  • إضافة أداة معالجة جديدة MediaRouter#OnPrepareTransferListener لتلقّي الأحداث عندما يكون المسار المحدّد على وشك التغيير (I6ace1)
  • إضافة MediaRouterParam (I33150)
  • تم تغيير الإرشادات المتعلّقة بتسجيل وظيفة معالجة الردّ. اطّلِع على مثال الرمز البرمجي في Javadoc الخاص بـ MediaRouter.addCallback() (I58112)

الإصدار 1.2.0-alpha01

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

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

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

  • منع الاستخدامات التجريبية للطُرق المخصّصة للاستخدام الداخلي فقط مع @RestrictTo(LIBRARY)

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

  • تم حلّ مشكلة TalkBack في مربّع حوار البث
  • حماية مستمع DynamicGroupRouterController باستخدام قفل

الإصدار 1.1

الإصدار 1.1.0

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

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

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

  • إتاحة المجموعات الديناميكية
    • يسمح هذا الإذن للمستخدمين بإضافة أجهزة مسار أو إزالتها بشكل ديناميكي.
    • لتفعيل مجموعة ديناميكية، اتّصِل بـ MediaRouteButton.enableDynamicGroup()؛ يعرض التطبيق مربّع حوار جديدًا للمجموعة الديناميكية.
    • يجب أن يتيح MediaRouteProvider المثبَّت أيضًا المجموعات الديناميكية لتفعيل الوظيفة.

الإصدار 1.1.0-rc01

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

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

الإصدار 1.1.0-beta02

‫5 يونيو 2019

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

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

  • إتاحة اللغات التي تُكتب من اليمين إلى اليسار في مربّعات حوار MediaRouter

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

  • إصلاح المساحة المتروكة في أسفل مربّعات حوار MediaRoute

الإصدار 1.1.0-beta01

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

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

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

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

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

  • تم تغيير منطق معاودة الاتصال الخاص بـ DynamicRouteDescriptor. الآن، سيطلب MediaRouteProvider من MediaRouterProvider.DynamicGroupController.notifyDynamicRoutesChanged تنفيذ طريقة رد الاتصال بدلاً من تنفيذها مباشرةً.

الإصدار 1.1.0-alpha03

‫3 أبريل 2019

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

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

  • تم إصلاح الأعطال في MediaRouteVolumeSlider وRegisteredMediaRouteProvider.

الإصدار 1.1.0-alpha02

‫13 مارس 2019

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

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

  • إتاحة MediaRouteButton في معاينة التصميم في "استوديو Android"

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

  • تمت إضافة طريقة enableDynamicGroup() في MediaRouteActionProvider وMediaRouteButton لتفعيل ميزة المجموعة الديناميكية
  • تمت إضافة طريقة setAlwaysVisible(boolean) في MediaRouteActionProvider وMediaRouteButton للسماح بعرض MediaRouteButton دائمًا

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

  • تسهيل النقر على MediaRouteCastDialog صف
  • تمت إزالة عمليات الاستدعاء غير الضرورية للدالة onRouteChanged

الإصدار 1.1.0-alpha01

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

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

  • تمت إضافة مسارات المجموعات الديناميكية
    • تمت إضافة واجهات برمجة تطبيقات لدعم مسارات المجموعات الديناميكية من خلال MediaRouteProviders
    • تمت إضافة تجربة مستخدم جديدة إلى مربّعات حوار أداة اختيار المسار ووحدة التحكّم لمسارات المجموعات الديناميكية