Mediarouter

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

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

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

الإصدار ‎1.9.0-alpha02

‫9 سبتمبر 2026

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

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

  • تعديل MediaRouter#setDeviceSuggestions لتلقّي RouteInfo بدلاً من SuggestedDeviceInfo (Id1d8c)
  • أضِف واجهة برمجة تطبيقات لتحديد مصدر حدث اختيار مسار. (I6ce8d)
  • إضافة واجهة برمجة تطبيقات جديدة MediaRouter#isMediaTransferEnabled (I92f6f)
  • أضِف MediaRouteDescriptor#getRoutingControllerId جديدًا لعرض رقم تعريف عنصر التحكّم في التوجيه المرتبط بالمسارات المحدّدة من MediaRouter2. (Iadae8)

- إضافة إمكانية استخدام MediaRouterParams لتفعيل ميزة نقل الوسائط بدون الحاجة إلى علامة بيان (Iec56b)

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

  • تم إصلاح ClassCastException محتمل في MediaRouter2Utils عند التعامل مع فلاتر الأهداف من مزوّدي المسارات الخارجيين. (Ifa880)
  • تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية من JSpecify، وهي تعليقات توضيحية خاصة باستخدام النوع. (I06c8c، b/326456246)
  • تم إصلاح الخطأ الذي يتسبب في حدوث أعطال عند عدم تحديد ألوان معيّنة في المظهر النشط. (cedecb
  • إصلاح عُطل ناتج عن تطبيقات ضارة ترسل حِزمًا غير صالحة (مثل MediaRouteDescriptors) عبر Binder (I47b8e وIfa880)
  • تحسين التسجيل عند حدوث سلوك غير متوقّع في MediaRouteProvider (I65e3d).

الإصدار ‎1.9.0-alpha01

‫11 فبراير 2026

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

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

  • إضافة واجهات برمجة التطبيقات MediaRouter لدعم اقتراحات الأجهزة (I34cf1، b/438200509)
  • إضافة طرق لتحديد مستوى ظهور المسار استنادًا إلى الأذونات (I8f814، b/395174487)
  • تمّت إضافة أداة إنشاء جديدة للفئة MediaRouteDiscoveryRequest تقبل مَعلمة جديدة إلى جانب المَعلمات الحالية للإشارة إلى ما إذا كان يجب إجراء عملية الفحص حتى عندما تكون الشاشة مطفأة. (I987c8، b/451842800)

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

  • تغيير القيمة التلقائية minSdk من المستوى 21 إلى المستوى 23 من واجهة برمجة التطبيقات (Ibdfca، b/380448311، b/435705964، b/435705223)

المساهمة الخارجية

  • استبدِل معظم مواد عرض PNG برسومات متجهة قابلة للرسم.

الإصدار 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 هذه التعديلات.

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

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

الإصدار ‎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 callback باستخدام كل من المسارات التي تم قطع الاتصال بها والمسارات المطلوبة (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 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (AGP) (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من AGP (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (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 عندما لا يتم تمرير أي مسار تم اختياره أو يتم اختياره. (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 هذه التعديلات.

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

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

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

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

  • إصلاح عناصر التحكّم في مستوى الصوت لمسارات المجموعة
  • عند إنشاء مسار مجموعة، يتم إنشاء مسار مجموعة أولاً ثم مسارات الأعضاء لاحقًا.
  • إصلاح مشكلة عدم عمل زر "إيقاف" في أداة التبديل بين أجهزة التشغيل
  • حلّ المشاكل المتعلّقة بوظائف معاودة الاتصال التي لا يتم استدعاؤها كما هو متوقّع
    • 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
    • تمت إضافة تجربة مستخدم جديدة إلى مربّعات حوار أداة اختيار المسار ووحدة التحكّم لمسارات المجموعات الديناميكية