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-beta01

‫23 سبتمبر 2026

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

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

• تم إصلاح NullPointerException في RegisteredMediaRouteProvider عند تلقّي ردود غير مرغوب فيها من وحدة التحكّم في المسار الديناميكي أو حِزم واصفات فارغة من مقدّمي المسارات. (I94579)

الإصدار ‎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 باستخدام كل من المسارات التي تم قطع الاتصال بها والمسارات المطلوبة

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