Mediarouter

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

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

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

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

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

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

الملاحظات

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

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

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

الإصدار 1.9

الإصدار ‎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 يوليو 2022

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

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

• تم تفعيل فحص 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
  • تمت إضافة تجربة مستخدم جديدة إلى مربّعات حوار أداة اختيار المسار ووحدة التحكّم لمسارات المجموعات الديناميكية