מדיה

לשתף תוכן מדיה ואמצעי בקרה עם אפליקציות אחרות. הוחלפה על ידי media3.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
29 בנובמבר 2023 1.7.0 - - -

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

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

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

מגניב

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

Kotlin

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

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.7

גרסה 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 ובתיאורים MediaItem. (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 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תיקון של דליפת זיכרון פוטנציאלית ב-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)
  • מוסיפים פריטים נוספים כדי להגדיר פעולות גלישה בהתאמה אישית בפריטים הנוספים ברמה הבסיסית (root) ובתיאורים MediaItem.MediaBrowserCompat (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 כוללת את ההצהרות האלה.

תכונות חדשות

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

שינויים ב-API

  • הוספת isVolumeFixed ל-AudioManagerCompat
  • הוספת MediaConstants לסגנון של פריט יחיד ולאחוז השלמה.

תיקוני באגים

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

תיקוני באגים

  • תיקון הדגל של היכולת לשינוי ליצירת 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 שמשמש ל-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 לכיתה Result (I2d617)

תיקוני באגים

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

שינויים ב-API

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

תיקוני באגים

  • מוסיפים את FLAG_RECEIVER_FOREGROUND לכוונה בהמתנה של לחצן המדיה.

גרסה 1.2.1

גרסה 1.2.1 של Media

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 extras, והוא אמור להיות זהה ל-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 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

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

  • הוספנו את AudioAttributesCompat

גרסה 1.1.0-rc01

13 ביוני 2019

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

גרסה 1.1.0-beta02

5 ביוני 2019

androidx.media:media:1.1.0-beta02 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תיקוני באגים

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

גרסה 1.1.0-beta01

7 במאי 2019

androidx.media:media:1.1.0-beta01 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות חדשות

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

גרסה 1.1.0-alpha04

3 באפריל 2019

androidx.media:media:1.1.0-alpha04 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תיקוני באגים

  • שינוי קבוע של version-compat-test (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()
  • איך לגרום ל-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