מדיה

שיתוף תכני מדיה ואמצעי בקרה עם אפליקציות אחרות. הוחלפה על ידי Media3.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫13 באוגוסט 2025 1.7.1 - - -

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

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

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

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

גרסה 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 extras. (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 extras. (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. אם אתם מטargetים רמת API‏ 30 ומעלה, אתם צריכים לציין אלמנט <queries> במניפסט של האפליקציה. (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)

תיקוני באגים

  • תיקון של Intent חסר 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 עבור כוונת ההמתנה של לחצן המדיה.

גרסה 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 מגרסה Pre-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 משוחרר. כאן אפשר לראות את הרשימה המלאה של הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

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

גרסה 1.1.0-alpha02

‫13 במרץ 2019

androidx.media:media:1.1.0-alpha02 משוחרר. כאן אפשר לראות את הרשימה המלאה של הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

  • תוקנה קריסה של MediaBrowserCompat בזמן החיבור
  • הבעיה IllegalStateException תוקנה ב-getCurrentBrowserInfo()/getBrowserRootHints()
  • ‫Make MediaBrowserServiceCompat.getCurrentBrowserInfo() return the same RemoteUserInfo instance for the same MediaBrowserCompat in 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