Mediarouter

הפעלת הצגה והפעלה של מדיה במכשירי מקלט מרוחקים באמצעות ממשק משתמש משותף.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫11 בפברואר 2026 1.8.1 - - ‎1.9.0-alpha01

הצהרה על יחסי תלות

כדי להוסיף תלות ב-MediaRouter, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

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

Kotlin

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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את 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 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת ממשקי API‏ MediaRouter לתמיכה בהצעות למכשירים (I34cf1, ‏ b/438200509)
  • הוספת שיטות לראות מסלולים לפי הרשאה (I8f814, b/395174487)
  • נוסף בנאי חדש ל-MediaRouteDiscoveryRequest שמקבל פרמטר חדש לצד הפרמטרים הקיימים, כדי לציין אם הסריקה צריכה להתבצע גם כשהמסך כבוי. (I987c8,‏ b/451842800)

תיקוני באגים

External Contribution

  • החלפת רוב נכסי ה-PNG בנכסים מסוג vector drawables.

גרסה 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

  • הוספנו API חדש לתמיכה בחיבור (ובניתוק) למסלולים בלי להשפיע על בחירת המסלול.
  • הוספנו API חדש שמאפשר לספקים להשתמש בפרמטרים כשהם יוצרים בקר.
  • הוספנו API חדש להאזנה לשינויים ברשימת הלקוחות המקושרים MediaRouteProviderService.
  • ‫API חדש לתמיכה בהרחבת הזרם באמצעות חיבור מסלול.
  • מעדכנים את הקריאה החוזרת (callback) של 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 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת שם חבילת הלקוח אל 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 שמתרחש כתוצאה מהחזרת בקר מסלול null בתרחישים ספציפיים (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 מכילה את השמירות האלה.

שינויים ב-API

  • הסרה של API בגרסת אלפא GroupRouteInfo#updateRoutes. (Ib3d70)
  • עדכון של javadoc של ממשקי API לבחירת מסלול וחיבור מסלול (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 מכילה את השמירות האלה.

שינויים ב-API

  • ‫API חדש לתמיכה בהרחבת הזרם באמצעות חיבור מסלול. (I87373)
  • מעדכנים את הקריאה החוזרת (callback) של 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 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו API חדש לתמיכה בחיבור (ובניתוק) למסלולים בלי להשפיע על בחירת המסלול. (I64a8e).
  • הוספנו API חדש שמאפשר לספקים להשתמש בפרמטרים כשהם יוצרים בקר. ‫(I703b9).
  • הוספנו API חדש להאזנה לשינויים ברשימת הלקוחות המקושרים MediaRouteProviderService. (I69996)

תיקוני באגים

  • תוקנה בעיה שגרמה להפניה שגויה של הפעלת מדיה לרמקולים המובנים בזמן שמכשיר Bluetooth מחובר.
  • הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה באופן אוטומטי באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3) ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-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 מכילה את השמירות האלה.

שינויים ב-API

  • מוסיפים את isSystemRoute() אל MediaRouteDescriptor ואל RouteInfo. הפונקציה מחזירה true אם המסלול התואם הוא מסלול שמנוהל על ידי המערכת, כלומר המערכת היא ספק המסלול והאפליקציה אחראית להעברת דגימות מדיה למערכת לצורך עיבוד (I949e4). אוזניות Bluetooth עם מיקרופון, אוזניות חוטיות ורמקולים מובנים הם דוגמאות לניתובים של המערכת.
  • הוצאה משימוש של MediaRouter.removeRemoteControlClient. במקום addRemoteControlClient(Object), צריך לקרוא ל-setMediaSessionCompat(MediaSessionCompat) כדי שלא יהיה צורך לקרוא ל-removeRemoteControlClient(Object). ‫(I8fc5e).
  • ‫Make MediaRouteButton extend AppCompatImageView. ‫(Ib455e).
  • מוסיפים את DEVICE_TYPE_SMARTPHONE, שמציין שמסלול המדיה הוא סמארטפון. (I39837).
  • שיפור המיפויים של סוגי המכשירים מ-MediaRouter2 ל-AndroidX MediaRouter כדי לתאר מסלולים במערכת (לדוגמה: Bluetooth, ‏ HDMI, ‏ wired). (Iccffa)

תיקוני באגים

  • נוספו רזולוציות חסרות של סמלים לכפתור המסלול, שאולי גרמו לקריסות מבודדות. ‫(cddba9, ‏ b/261878418).
  • תוקן באג שגרם לכך שהפונקציה isSystemRoute החזירה את הערך true עבור נתיבי משתמשים שנוספו באמצעות 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)

שינויים ב-API

  • שיפור המיפויים של סוגי המכשירים מ-MediaRouter2 ל-AndroidX MediaRouter כדי לתאר מסלולים במערכת (לדוגמה: Bluetooth, ‏ HDMI, ‏ wired). (Iccffa)

תיקוני באגים

  • תוקן באג שגרם לכך שהפונקציה isSystemRoute החזירה את הערך true עבור נתיבי משתמשים שנוספו באמצעות 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 מכילה את השמירות האלה.

שינויים ב-API

  • מוסיפים את isSystemRoute() אל MediaRouteDescriptor ואל RouteInfo. הפונקציה מחזירה true אם המסלול התואם הוא מסלול שמנוהל על ידי המערכת, כלומר המערכת היא ספק המסלול והאפליקציה אחראית להעברת דגימות מדיה למערכת לצורך עיבוד (I949e4). אוזניות Bluetooth עם מיקרופון, אוזניות חוטיות ורמקולים מובנים הם דוגמאות לניתובים של המערכת.
  • הוצאה משימוש של MediaRouter.removeRemoteControlClient. במקום addRemoteControlClient(Object), צריך לקרוא ל-setMediaSessionCompat(MediaSessionCompat) כדי שלא יהיה צורך לקרוא ל-removeRemoteControlClient(Object). ‫(I8fc5e).
  • ‫Make MediaRouteButton extend 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

  • העדפות של רשימת המסלולים למתג מעבר למכשיר אחר
  • הוספת תמיכה בהעדפות של רשימת נתיבים ל-AndroidX MediaRouter.
  • הוספנו תמיכה בנראות של 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 מכילה את השמירות האלה.

שינויים ב-API

  • תיקון התמיכה בממשקי API של פלטפורמת 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.
    • מוסיפים מצב סיום עם הודעת שגיאה שתוצג בסוף תקופה מוגדרת מראש.

שינויים ב-API

  • הוספת סוגים חדשים של מכשירי 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 מופצים. הגרסה הזו פורסמה מענף פנימי.

  • אנחנו מבצעים כמה שינויים ב-API של החשיפה של 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 מכילה את השמירות האלה.

תכונות חדשות

  • העדפות של רשימת המסלולים למתג מעבר למכשיר אחר

שינויים ב-API

  • מנגנון שמאפשר לאפליקציה להגדיר את מתג המעבר למכשיר אחר.

גרסה 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 כדי להציג את תיבת הדו-שיח של מתג הפלט של המערכת, או את קטע ההגדרות של Bluetooth במכשירי Wear שבהם מתג הפלט של המערכת לא זמין. (Ic3d78)
  • תוקנה רגרסיה שגרמה לקריסות של אפליקציות בגלל IllegalArgumentException ב-MediaRouterProvider.notifyDynamicRoutesChanged (7d17ea).
  • הוספה MediaRouteDescriptor.Builder.clearControlFilters (I3a4e1)
  • הוספת הערות חסרות של MainThread ב-MediaRouter. (I3ef6e)
  • הוספה של דגלי ייצוא של מקלט שידור ב-API 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 מכילה את השמירות האלה.

  • הסרה של רשימות null ב-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 מכילה את השמירות האלה.

שינויים ב-API

DynamicGroupRouteController.notifyDynamicRoutesChanged() מחזירה עכשיו IllegalArgumentException אם לא הועבר מסלול שנבחר או נמצא בתהליך בחירה. (8f6b3e)

תיקוני באגים

  • תוקנה קריסה שנגרמה בגלל הטמעה של שירות ספק שתואם ל-API, שמחזיר ספק מסלול null. (63f16d)
  • כדי שמקלטי שידורים מוגנים יפעלו באפליקציות שמטרגטות API בגרסה 33 ומעלה, צריך לסמן אותם כלא מיוצאים. (784f8b)
  • תיקון של כמה הערות שגויות לגבי אפשרות קבלת ערך null ב-OverlayListView. (472e3f)
  • תיקון באג שבו EXTRA_CLOSE_ON_CONNECT ב-SystemOutputSwitcherDialogController.showDialog גורם לסגירה פתאומית של קטע ההגדרות של Bluetooth במכשירי Wear. (28c9d8)
  • השתנה ל-Javadoc של השיטות הציבוריות של מתג מעבר למכשיר אחר. ‫(f0ae94, ‏ 44d2c9)

גרסה ‎1.4.0-alpha01

9 בנובמבר 2022

androidx.mediarouter:mediarouter:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • מוסיפים את SystemOutputSwitcherDialogController#showDialog כדי להציג את תיבת הדו-שיח של מתג הפלט של המערכת, או את קטע ההגדרות של Bluetooth במכשירי Wear שבהם מתג הפלט של המערכת לא זמין. (Ic3d78)

שינויים ב-API

  • הוספה MediaRouteDescriptor.Builder.clearControlFilters (I3a4e1)
  • הוספת הערות חסרות של MainThread ב-MediaRouter. (I3ef6e)

תיקוני באגים

  • תוקנה קריסה שספציפית למכשיר מסוים שנגרמה כתוצאה מהתקשרות אל MediaRouter.removeUserRoute (b/202931542).
  • תוקנה בעיה שבה תיאורי קבוצות לא קיבלו עדכונים לגבי טיפול בנפח באופן עקבי (461303).
  • הוספה של דגלי ייצוא של מקלט שידור ב-API 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.
  • הערות לגבי ערכי null בשיטות ציבוריות.
  • ב-androidx מופעלת בדיקת lint של API עבור MissingGetterMatchingBuilder.
  • עדכון התלות בליבה של 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 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת דגל ל-MediaRouterParams שאפשר להשתמש בו כדי להשבית את ההעברה החלקה בזמן הריצה (I53d68)
  • נוסף ארטיפקט לבדיקה שיכול לאפס את MediaRouter. (Id167c)
  • הוספת פרמטר של נתב לשיפור חוויית המשתמש ב-MediaRouterControllerDialog (I7e574)
  • הערות לגבי ערכי null ב-methods ציבוריות (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() בזמן ש-Bluetooth זמין
  • תיקון התזמון של 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()
  • הוספת פונקציית event listener חדשה MediaRouter#OnPrepareTransferListener לקבלת אירועים כשהמסלול שנבחר עומד להשתנות
  • מוסיפים את התג MediaRouterParams כדי לציין את הפונקציונליות של הניתוב ואת סוגי ממשק המשתמש.
  • איך מונעים שימוש ניסיוני בשיטות לשימוש פנימי בלבד באמצעות @RestrictTo(LIBRARY)

גרסה ‎1.2.0-rc02

‫1 באוקטובר 2020

androidx.mediarouter:mediarouter:1.2.0-rc02 מופץ. גרסה ‎1.2.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שבה יכול להיות שלא מתבצעת קריאה ל-RouteController#onUnselect כשהמשתמש מפסיק את ה-Cast דרך ממשק המשתמש של המערכת.

גרסה ‎1.2.0-rc01

‫16 בספטמבר 2020

androidx.mediarouter:mediarouter:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה בעיה שגרמה לניתוק של ההפעלה הנוכחית של Cast כשמחובר התקן אודיו ב-Bluetooth.
  • תוקנה בעיה שקשורה לזריקת IllegalArgumentException ב-MediaRouteProvider#notifyDynamicRoutesChanged().
  • איך גורמים להפסקת ה-Cast לפעול מתוך הכלי למעבר בין מקורות

גרסה ‎1.2.0-beta01

‫2 בספטמבר 2020

androidx.mediarouter:mediarouter:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בהעברת מדיה חלקה שמאפשרת העברת מדיה דרך ממשק המשתמש של המערכת: פרטים נוספים מופיעים במאמר מה חדש בסרטון בנושא מדיה

שינויים ב-API

  • שימוש ב-MediaRouter.OnPrepareTransferListener ListenableFuture

תיקוני באגים

  • תיקון של אמצעי הבקרה לעוצמת הקול של קבוצות ערוצים.
  • כשיוצרים נתיב לקבוצה, המערכת יוצרת קודם נתיב לקבוצה ואחר כך נתיבים לחברים.
  • לגרום לכך שהאפשרות 'הפסקה' במעבר בין פלט תפעל.
  • תיקון של קריאות חוזרות שלא מתבצעות כמצופה
    • RouteController#onSelect כשנוצר סשן ניתוב.
    • MediaRouter.Callback#onRouteSelected כשמעבירים לטלפון מ-Cast.
    • MediaRouter.Callback#onRouteSelected עם פרטי המסלול הנכונים של הקבוצה.
  • הסרת השיחות החוזרות

גרסה ‎1.2.0-alpha02

22 ביולי 2020

androidx.mediarouter:mediarouter:1.2.0-alpha02 מופץ. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • מוסיפים MediaRouter.Callback#onRouteSelected חדש כדי לקבל התראה אם המסלול שנבחר שונה מהמסלול המבוקש (Ieee16)
  • הוספת listener חדש MediaRouter#OnPrepareTransferListener לקבלת אירועים כשהמסלול שנבחר עומד להשתנות (I6ace1)
  • הוספת MediaRouterParam ‏ (I33150)
  • שינינו את ההנחיות לגבי רישום בקשה לקבלת שיחה חוזרת. אפשר לראות את הקוד לדוגמה ב-Javadoc של MediaRouter.addCallback() (I58112)

גרסה ‎1.2.0-alpha01

15 באפריל 2020

androidx.mediarouter:mediarouter:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • איך מונעים שימוש ניסיוני בשיטות לשימוש פנימי בלבד באמצעות @RestrictTo(LIBRARY)

תיקוני באגים

  • נפתרה בעיה ב-TalkBack בתיבת הדו-שיח של Cast
  • הגנה על מאזין 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 עבור הארגומנטים של הערך null שסומנו כ-@NonNull.

שינויים ב-API

  • הלוגיקה של בקשת שיחה חוזרת עבור 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 מופץ. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

תכונות חדשות

  • תמיכה ב-MediaRouteButton בתצוגה מקדימה של פריסה ב-Android Studio

שינויים ב-API

  • נוספה שיטת enableDynamicGroup() ב-MediaRouteActionProvider וב-MediaRouteButton כדי להפעיל את התכונה של קבוצות דינמיות
  • נוספה השיטה setAlwaysVisible(boolean) ב-MediaRouteActionProvider וב-MediaRouteButton כדי לאפשר ל-MediaRouteButton להיות גלוי תמיד

תיקוני באגים

  • הוספנו אפשרות ללחוץ בקלות על MediaRouteCastDialog שורות
  • הוסרו קריאות מיותרות של onRouteChanged callback

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2018

תכונות חדשות

  • נוספה תמיכה בנתיבים של קבוצות דינמיות
    • הוספנו ממשקי API לתמיכה בנתיבים של קבוצות דינמיות על ידי MediaRouteProviders
    • נוסף ממשק משתמש חדש לבחירת מסלול ולתיבות דו-שיח של בקרי מסלולים עבור מסלולי קבוצות דינמיים