מדיה

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

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

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

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

מגניב

dependencies {
    implementation "androidx.media:media:1.7.1"
}

Kotlin

dependencies {
    implementation("androidx.media:media:1.7.1")
}

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

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.8

גרסה ‎1.8.0-alpha01

‫8 באפריל 2026

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

שינויים ב-API

  • הוצאה משימוש של androidx.media. במקום זאת, צריך להשתמש ב-androidx.media3.

גרסה 1.7

גרסה 1.7.1

‫13 באוגוסט 2025

‫androidx.media:media:1.7.1 מופץ. גרסה 1.7.1 מכילה את השמירות האלה.

תיקוני באגים

  • שיפור הביצועים של MediaSession.setMetadata() על ידי צמצום מספר ההקצאות הביניים והסרת פעולות מיותרות של חלוקה לחבילות וביטול החלוקה לחבילות של מפות סיביות.

גרסה 1.7.0

‫29 בנובמבר 2023

‫androidx.media:media:1.7.0 מופץ. גרסה 1.7.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.6.0

  • תפוס את ForegroundServiceStartNotAllowedException ב-MediaButtonReceiver והעבר אותו ל-onForegroundServiceStartNotAllowedException. (I0c939)
  • מוסיפים BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM כדי להעביר פריט מדיה למועדפים בתוספים של MediaBrowserCompat root. (Id3a11)
  • מוסיפים תוספים כדי להגדיר פעולות מותאמות אישית לגלישה בMediaBrowserCompat root extras ובMediaItem descriptions. (Iab163)
  • תיקון IllegalStateException שנגרם כתוצאה מהחזרת null מ-MediaBrowserService.onLoadChildren בגרסאות ישנות יותר של Android.

גרסה ‎1.7.0-rc01

‫15 בנובמבר 2023

הגרסה androidx.media:media:1.7.0-rc01 יוצאת ללא שינויים. גרסה ‎1.7.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.7.0-beta01

‫1 בנובמבר 2023

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

תיקוני באגים

  • תיקון דליפת זיכרון פוטנציאלית של MediaBrowserService ו-MediaBrowserServiceCompat. b/37137738.
  • תיקון IllegalStateException שנגרם כתוצאה מהחזרת null מ-MediaBrowserService.onLoadChildren בגרסאות ישנות יותר של Android.

גרסה ‎1.7.0-alpha01

‫8 בפברואר 2023

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

תכונות חדשות

  • תפוס את ForegroundServiceStartNotAllowedException ב-MediaButtonReceiver והעבר אותו ל-onForegroundServiceStartNotAllowedException. (I0c939)
  • מוסיפים BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM כדי להעביר פריט מדיה למועדפים בתוספים של MediaBrowserCompat root. (Id3a11)
  • מוסיפים תוספים כדי להגדיר פעולות מותאמות אישית לגלישה בMediaBrowserCompat root extras ובMediaItem descriptions. (Iab163)

גרסה 1.6.0

גרסה 1.6.0

‫20 באפריל 2022

‫androidx.media:media:1.6.0 מופץ. גרסה 1.6.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.5.0

  • מוסיפים תוספים שנדרשים להגדרת דף הכניסה או דף ההגדרות באמצעות CarAppLibrary באפליקציית מדיה ל-Android Auto.

גרסה ‎1.6.0-rc01

‫6 באפריל 2022

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

גרסה ‎1.6.0-beta01

‫23 במרץ 2022

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

  • לא בוצעו שינויים מאז שחרור גרסת האלפא האחרונה.

גרסה ‎1.6.0-alpha01

23 בפברואר 2022

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

שינויים ב-API

  • מוסיפים תוספים שנדרשים להגדרת דף הכניסה או דף ההגדרות באמצעות CarAppLibrary באפליקציית מדיה ל-Android Auto. (Ifb3ca)

גירסה 1.5

גרסה 1.5.0

‫9 בפברואר 2022

‫androidx.media:media:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.4.0

  • הוספת isVolumeFixed אל AudioManagerCompat
  • מוסיפים MediaConstants כדי להגדיר סגנון לפריט יחיד ואת אחוז ההשלמה.
  • ברמת API 30 ומעלה, הספרייה לא תזריק את מסנן חשיפת החבילה עבור MediaBrowserCompat. צריך לציין רכיב <queries> במניפסט של האפליקציה.
  • תיקון שינוי לא צפוי של תוספים של getMediaDescription() ב-API 21
  • מניעת חלק מהפעולות IllegalStateException ב-API 19.
  • תיקון קריסה ב-MediaSessionCompat כשמטרגטים Android 12
  • תיקון קריסה ב-NotificationCompat ב-KitKat

גרסה ‎1.5.0-rc01

‫26 בינואר 2022

הגרסה androidx.media:media:1.5.0-rc01 פורסמה ללא שינויים מאז 1.5.0-beta01. גרסה ‎1.5.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.5.0-beta01

1 בדצמבר 2021

הגרסה androidx.media:media:1.5.0-beta01 פורסמה ללא שינויים מאז 1.5.0-alpha01. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.5.0-alpha01

‫3 בנובמבר 2021

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

תכונות חדשות

  • עדכון התלות בליבה של מדיה לגרסה 1.6.0

שינויים ב-API

  • הוספה של isVolumeFixed ל-AudioManagerCompat
  • הוספת MediaConstants לעיצוב פריט בודד ולאחוז ההשלמה.

תיקוני באגים

  • ברמת API 30 ומעלה, הספרייה לא תזריק את מסנן חשיפת החבילה עבור MediaBrowserCompat. צריך לציין רכיב <queries> במניפסט של האפליקציה.
  • תיקון השינוי הלא צפוי של התוספים של getMediaDescription()‎ ב-API 21
  • כדי לפתור את הבעיה של שימוש לא יעיל ב-ArrayList, צריך להגדיר את גודל ברירת המחדל.
  • מניעת חלק מהמקרים של IllegalStateException ב-API 19.
  • תיקון קריסה ב-MediaSessionCompat כשמטרגטים את Android 12
  • תיקון קריסה ב-NotificationCompat ב-KitKat

גרסה 1.4

גרסה 1.4.3

‫13 באוקטובר 2021

‫androidx.media:media:1.4.3 מופץ. גרסה 1.4.3 מכילה את השמירות האלה.

תיקוני באגים

  • הספרייה לא תוסיף יותר את מסנן חבילות הגלויות עבור MediaBrowserCompat. צריך לציין רכיב <queries> במניפסט של האפליקציה כשמטרגטים רמת API‏ 30 ומעלה. (I0a964, b/185314633)

גרסה 1.4.2

‫15 בספטמבר 2021

‫androidx.media:media:1.4.2 מופץ. גרסה 1.4.2 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון תופעת לוואי של getMediaDescription() ב-API 21 (I5c05f)

גרסה 1.4.1

4 באוגוסט 2021

‫androidx.media:media:1.4.1 מופץ. גרסה 1.4.1 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון דגל השינוי ליצירת PendingIntent כדי למנוע קריסה כשמטרגטים את Android S.
  • פתרון הבעיה ClassVerificationFailure עבור NotificationCompat.MediaStyle.

גרסה 1.4.0

21 ביולי 2021

‫androidx.media:media:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.3.0

  • נוסף מפתח חדש של חבילה, METADATA_KEY_SERIES_CONTENT_ID, שמשמש למזהה תוכן המדיה של סדרת הטלוויזיה ב-MediaMetadataCompat
  • נוסף מפתח חדש של חבילה METADATA_KEY_NEXT_EPISODE_CONTENT_ID שמשמש למזהה התוכן של הפרק הבא של פרק בתוכנית טלוויזיה ב-MediaMetadataCompat
  • הוצאה משימוש של MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE והוספה של MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE במקום זאת
  • הוספת מפתח נוסף להפעלה אקראית של מדיה ב-playFromUri
  • הוספת אנוטציית ‎ @Nullable למחלקה Result
  • תיקון של EXTRA_KEY_EVENT חסר של Intent עבור MediaButtonReceiver

גרסה ‎1.4.0-rc01

‫30 ביוני 2021

הגרסה androidx.media:media:1.4.0-rc01 פורסמה ללא שינויים מאז 1.4.0-beta01. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta01

‫17 ביוני 2021

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

שינויים ב-API

  • נוסף מפתח חדש של חבילה METADATA_KEY_SERIES_CONTENT_ID שמשמש למזהה תוכן המדיה של סדרת הטלוויזיה ב-MediaMetadataCompat

  • נוסף מפתח חדש של חבילה METADATA_KEY_NEXT_EPISODE_CONTENT_ID שמשמש למזהה התוכן של הפרק הבא של פרק בתוכנית טלוויזיה ב-MediaMetadataCompat

גרסה ‎1.4.0-alpha01

‫5 במאי 2021

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

שינויים ב-API

  • הוצאה משימוש של MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE והוספה של MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE במקום זאת (I62f17)
  • הוספת מפתח נוסף להפעלה אקראית של מדיה באמצעות playFromUri ‏ (Ibc63c)
  • הוספת אנוטציית ‎ @Nullable למחלקת התוצאות (I2d617)

תיקוני באגים

  • תיקון של כוונת חסרה EXTRA_KEY_EVENT עבור MediaButtonReceiver (If7557)

גרסה 1.3.1

גרסה 1.3.1

‫5 במאי 2021

‫androidx.media:media:1.3.1 מופץ. גרסה 1.3.1 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון של EXTRA_KEY_EVENT חסר של intent עבור MediaButtonReceiver ‏ (If7557)

גרסה 1.3.0

גרסה 1.3.0

‫7 באפריל 2021

‫androidx.media:media:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.2.0

  • העברנו תוספים של Android Auto אל MediaConstants.

גרסה ‎1.3.0-rc02

‫24 במרץ 2021

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

תיקוני באגים

  • מגדירים את FLAG_IMMUTABLE ל-PendingIntent של MediaButtonReceiver, שנדרש באפליקציות שמטרגטות ל-Android מגרסה 12 ואילך.
  • תוקנה NullPointerException ב-MediaSessionCompat עם API 27 אחרי setCallback(null).

גרסה ‎1.3.0-rc01

‫10 במרץ 2021

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

לא בוצעו שינויים מאז 1.3.0-beta01.

גרסה ‎1.3.0-beta01

10 בפברואר 2021

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

שינויים ב-API

  • נוסף קבוע חדש PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076)
  • העברה של תוספים של Android Auto אל MediaConstants. (I290ab)
  • הוספת קבועים להגבלת צאצאים ברמת הבסיס של MediaBrowserService. (Ifcebd)

תיקוני באגים

  • הוספת FLAG_RECEIVER_FOREGROUND ל-pending intent של כפתור המדיה.

גרסה 1.2.1

גרסת המדיה 1.2.1

2 בדצמבר 2020

‫androidx.media:media:1.2.1 מופץ. גרסה 1.2.1 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון NPE אחרי קריאה ל-MediaSessionCompat#setCallback(null) ב-API 27

גרסה 1.2.0

גרסה 1.2.0

‫16 בספטמבר 2020

‫androidx.media:media:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.1.0

  • הוספנו תמיכה ב-AudioAttributesCompat#setLegacyStreamType לגרסאות SDK נמוכות מ-21
  • תמיכה בשליטה בעוצמת הקול בספרייה androidx.mediarouter
  • תמיכה משופרת ביכולת פעולה הדדית בין androidx.media לבין androidx.media2

גרסה ‎1.2.0-rc01

‫2 בספטמבר 2020

הגרסה androidx.media:media:1.2.0-rc01 פורסמה ללא שינויים מאז 1.2.0-beta01. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.2.0-beta01

‫19 באוגוסט 2020

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

תכונות חדשות

  • הוספנו תמיכה ב-AudioAttributesCompat#setLegacyStreamType לרמות API מגרסה 21 ומטה

שינויים ב-API

  • נוסף MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID למזהה המדיה בתוספים של PlaybackStateCompat, שאמור להיות זהה ל-MediaMetadataCompat#METADATA_KEY_MEDIA_ID של המטא-נתונים הנוכחיים.

תיקוני באגים

  • פתרנו בעיה שקשורה ל-AudioAttributesCompat.Builder#setContentType

גרסה ‎1.2.0-alpha04

‫24 ביוני 2020

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

תכונות חדשות

  • נוספה דרך לתמוך בשליטה בעוצמת הקול בספריית mediarouter

שינויים ב-API

  • תאריך ההוספה: AudioManagerCompat#getStreamMaxVolume
  • תאריך ההוספה: AudioManagerCompat#getStreamMinVolume

תיקוני באגים

  • תוקנה בעיית תאימות בין media ל-media2 ב-SDK < 21

גרסה ‎1.2.0-alpha03

‫10 ביוני 2020

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

שינויים ב-API

  • הרשת MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN הוסרה

תיקוני באגים

  • תוקנה בעיה שקשורה ל-equals() של RemoteUserInfo

גרסה ‎1.2.0-alpha02

15 באפריל 2020

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

תיקוני באגים

  • מניעת שינויים במחלקות VersionedParcelable

גרסה ‎1.2.0-alpha01

‫23 באוקטובר 2019

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

שינויים ב-API

  • הוספנו את השיטות הבאות:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

תיקוני באגים

  • הטמענו מניעה מפני BadParcelableException כשמעבירים אובייקט Bundle באמצעות קריאת IPC
  • ה-constructor של MediaControllerCompat לא זורק יותר RemoteException
  • הוטמעה מניעה של קריאה לשיטות קריאה חוזרת אחרי MediaSessionCompat.release()

גרסה 1.1.0

גרסה 1.1.0

‫5 בספטמבר 2019

‫androidx.media:media:1.1.0 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

ייבוא שינויים מאז גרסה 1.0.0

  • הוספנו AudioAttributesCompat

גרסה ‎1.1.0-rc01

13 ביוני 2019

‫androidx.media:media:1.1.0-rc01 יוצא ללא שינויים מ-1.1.0-beta02. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

גרסה ‎1.1.0-beta02

‫5 ביוני 2019

‫androidx.media:media:1.1.0-beta02 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • היקף ההגבלה של שיטות מוסתרות שמשמשות את media2-session הוקל ל-LIBRARY_GROUP_PREFIX.

גרסה ‎1.1.0-beta01

‫7 במאי 2019

‫androidx.media:media:1.1.0-beta01 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

  • הערך IllegalPointerException השתנה ל-NullPointerException עבור הארגומנטים של הערך null שסומנו כ-@NonNull.

גרסה ‎1.1.0-alpha04

‫3 באפריל 2019

‫androidx.media:media:1.1.0-alpha04 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • שינוי קבוע בבדיקת תאימות לגרסה (aosp/933656)

גרסה ‎1.1.0-alpha03

‫21 במרץ 2019

‫androidx.media:media:1.1.0-alpha03 מופץ. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

תיקוני באגים

  • תוקנה קריסה של MedaBrowserServiceCompat כשכמה MediaBrowserCompat מנסים להתחבר אליו. (aosp/930246)

גרסה ‎1.1.0-alpha02

‫13 במרץ 2019

‫androidx.media:media:1.1.0-alpha02 מופץ. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

תיקוני באגים

  • תוקנה קריסה של MediaBrowserCompat בזמן החיבור
  • הבעיה IllegalStateException תוקנה ב-getCurrentBrowserInfo()/getBrowserRootHints()
  • ‫Make MediaBrowserServiceCompat.getCurrentBrowserInfo() מחזיר את אותו מופע של RemoteUserInfo עבור אותו MediaBrowserCompat ב-onGetRoot()

גרסה 1.0.1

גרסה 1.0.1

‫30 בינואר 2019

‫androidx.media:media 1.0.1 מופץ.

תיקוני באגים

  • תוקן באג של IllegalStateException לא צפוי במהלך שימוש ב-MediaBrowserCompat.connect() (aosp/858075)

גרסה 1.0.0

גרסה ‎1.0.0-alpha06

‫17 בדצמבר 2018

שינויים ב-API

שונה השם של החבילה media.widget ושם הכיתה באופן הבא:

  • androidx.media.widget.VideoView2‏ ← androidx.media2.widget.VideoView
  • androidx.media.widget.MediaControlView2‏ ← androidx.media2.widget.MediaControlView

גרסה 1.0.0-alpha01

‫3 בדצמבר 2018

שינויים ב-API

  • הוצאנו משימוש שני דגלים MediaSessionCompat:
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS