Multimedia

udostępnianie treści multimedialnych i elementów sterujących innym aplikacjom; Zastąpiona przez bibliotekę Media3.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja Beta Wersja alfa
13 sierpnia 2025 r. 1.7.1 - - -

Deklarowanie zależności

Aby dodać zależność od biblioteki Media, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Groovy

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

Kotlin

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.7

Wersja 1.7.1

13 sierpnia 2025 r.

Zostanie wycofaneandroidx.media:media:1.7.1 Wersja 1.7.1 zawiera te zmiany.

Poprawki błędów

  • Poprawia wydajność MediaSession.setMetadata() przez zmniejszenie liczby alokacji pośrednich i usunięcie niepotrzebnego dzielenia i scalania map bitowych.

Wersja 1.7.0

29 listopada 2023 r.

Zostanie wycofaneandroidx.media:media:1.7.0 Wersja 1.7.0 zawiera te zmiany.

Ważne zmiany od wersji 1.6.0

  • Przechwyć ForegroundServiceStartNotAllowedException w MediaButtonReceiver i przekaż go do onForegroundServiceStartNotAllowedException. (I0c939)
  • Dodaj BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM, aby przekazać element multimedialny Ulubione w dodatkach głównych MediaBrowserCompat. (Id3a11)
  • Dodaj dodatki, aby ustawić niestandardowe działania przeglądania w MediaBrowserCompatdodatkach głównychMediaItem i opisach. (Iab163)
  • Naprawiono błąd IllegalStateException spowodowany zwracaniem wartości null przez MediaBrowserService.onLoadChildren na starszych wersjach Androida.

Wersja 1.7.0-rc01

15 listopada 2023 r.

androidx.media:media:1.7.0-rc01 zostaje opublikowany bez zmian. Wersja 1.7.0-rc01 zawiera te zmiany.

Wersja 1.7.0-beta01

1 listopada 2023 roku

Zostanie wycofaneandroidx.media:media:1.7.0-beta01 Wersja 1.7.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Naprawiono potencjalny wyciek pamięci w przypadku MediaBrowserService i MediaBrowserServiceCompat. b/37137738.
  • Naprawiono błąd IllegalStateException spowodowany zwracaniem wartości null przez MediaBrowserService.onLoadChildren na starszych wersjach Androida.

Wersja 1.7.0-alpha01

8 lutego 2023 r.

Zostanie wycofaneandroidx.media:media:1.7.0-alpha01 Wersja 1.7.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Przechwyć ForegroundServiceStartNotAllowedException w MediaButtonReceiver i przekaż go do onForegroundServiceStartNotAllowedException. (I0c939)
  • Dodaj BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM, aby przekazać element multimedialny Ulubione w dodatkach głównych MediaBrowserCompat. (Id3a11)
  • Dodaj dodatki, aby ustawić niestandardowe działania przeglądania w MediaBrowserCompatdodatkach głównychMediaItem i opisach. (Iab163)

Wersja 1.6.0

Wersja 1.6.0

20 kwietnia 2022 r.

Zostanie wycofaneandroidx.media:media:1.6.0 Wersja 1.6.0 zawiera te zmiany.

Ważne zmiany od wersji 1.5.0

  • Dodaj dodatki niezbędne do skonfigurowania strony logowania lub ustawień za pomocą CarAppLibrary w aplikacji multimedialnej na Androida Auto.

Wersja 1.6.0-rc01

6 kwietnia 2022 roku

Zostanie wycofaneandroidx.media:media:1.6.0-rc01 Wersja 1.6.0-rc01 zawiera te zmiany.

Wersja 1.6.0-beta01

23 marca 2022 r.

Zostanie wycofaneandroidx.media:media:1.6.0-beta01 Wersja 1.6.0-beta01 zawiera te zmiany.

  • Brak zmian od ostatniej wersji alfa.

Wersja 1.6.0-alpha01

23 lutego 2022 r.

Zostanie wycofaneandroidx.media:media:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj dodatki niezbędne do skonfigurowania strony logowania lub ustawień za pomocą CarAppLibrary w aplikacji multimedialnej na Androida Auto. (Ifb3ca)

Wersja 1.5

Wersja 1.5.0

9 lutego 2022 r.

Zostanie wycofaneandroidx.media:media:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0

  • Dodaj isVolumeFixed do AudioManagerCompat
  • Dodaj MediaConstants, aby określić styl pojedynczego elementu i procent ukończenia.
  • W przypadku interfejsu API na poziomie 30 lub nowszym biblioteka nie wstrzykuje filtra widoczności pakietu dla MediaBrowserCompat. W pliku manifestu aplikacji musisz określić element <queries>.
  • Naprawianie nieoczekiwanej zmiany dodatków w przypadku interfejsu API 21getMediaDescription()
  • Zapobiegaj niektórym IllegalStateException w przypadku interfejsu API 19.
  • Rozwiązywanie problemów z awarią w MediaSessionCompat podczas kierowania reklam na Androida 12
  • Rozwiązywanie problemów z awarią w NotificationCompat na KitKacie

Wersja 1.5.0-rc01

26 stycznia 2022 r.

androidx.media:media:1.5.0-rc01 zostaje opublikowany bez zmian od 1.5.0-beta01. Wersja 1.5.0-rc01 zawiera te zmiany.

Wersja 1.5.0-beta01

1 grudnia 2021 r.

androidx.media:media:1.5.0-beta01 zostaje opublikowany bez zmian od 1.5.0-alpha01. Wersja 1.5.0-beta01 zawiera te zmiany.

Wersja 1.5.0-alpha01

3 listopada 2021 r.

Zostanie wycofaneandroidx.media:media:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Zaktualizuj zależność od podstawowych funkcji multimediów do wersji 1.6.0

Zmiany w interfejsie API

  • Dodawanie parametru isVolumeFixed do klasy AudioManagerCompat
  • Dodaj MediaConstants do stylizacji pojedynczego elementu i procentu ukończenia.

Poprawki błędów

  • W przypadku interfejsu API na poziomie 30 lub nowszym biblioteka nie wstrzykuje filtra widoczności pakietu dla MediaBrowserCompat. W pliku manifestu aplikacji musisz określić element <queries>.
  • Naprawianie nieoczekiwanej zmiany dodatków funkcji getMediaDescription() w interfejsie API 21
  • Poprawienie nieefektywnego użycia klasy ArrayList przez ustawienie domyślnego rozmiaru.
  • Zapobieganie występowaniu niektórych błędów IllegalStateException w przypadku interfejsu API w wersji 19.
  • Rozwiązywanie problemu z awarią w MediaSessionCompat w przypadku kierowania na Androida 12
  • Rozwiązywanie problemu z awarią w klasie NotificationCompat na urządzeniach z Androidem 4.4

Wersja 1.4

Wersja 1.4.3

13 października 2021 r.

Zostanie wycofaneandroidx.media:media:1.4.3 Wersja 1.4.3 zawiera te zmiany.

Poprawki błędów

  • Biblioteka nie będzie już wstrzykiwać filtra widoczności pakietu.MediaBrowserCompat Jeśli kierujesz aplikację na interfejs API na poziomie 30 lub wyższym, w pliku manifestu aplikacji musisz określić element <queries>. (I0a964, b/185314633)

Wersja 1.4.2

15 września 2021 r.

Zostanie wycofaneandroidx.media:media:1.4.2 Wersja 1.4.2 zawiera te zmiany.

Poprawki błędów

  • Naprawienie efektu ubocznego getMediaDescription() w interfejsie API 21 (I5c05f)

Wersja 1.4.1

4 sierpnia 2021 r.

Zostanie wycofaneandroidx.media:media:1.4.1 Wersja 1.4.1 zawiera te zmiany.

Poprawki błędów

  • Naprawienie flagi zmienności podczas tworzenia PendingIntent, aby zapobiec awarii podczas kierowania na Androida S.
  • Napraw błąd ClassVerificationFailure w przypadku NotificationCompat.MediaStyle.

Wersja 1.4.0

21 lipca 2021 r.

Zostanie wycofaneandroidx.media:media:1.4.0 Wersja 1.4.0 zawiera te zmiany.

Ważne zmiany od wersji 1.3.0

  • Dodano nowy klucz pakietu METADATA_KEY_SERIES_CONTENT_ID używany w przypadku identyfikatora treści multimedialnych serialu w klasie MediaMetadataCompat.
  • Dodano nowy klucz pakietu METADATA_KEY_NEXT_EPISODE_CONTENT_ID używany w przypadku identyfikatora treści następnego odcinka programu telewizyjnego w klasie MediaMetadataCompat.
  • Wycofanie MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE i dodanie MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE
  • Dodawanie dodatkowego klucza do losowego odtwarzania multimediów w przypadku playFromUri
  • Dodawanie adnotacji @Nullable do klasy Result
  • Rozwiązywanie problemu z brakującym EXTRA_KEY_EVENT intencji w przypadku MediaButtonReceiver

Wersja 1.4.0-rc01

30 czerwca 2021 r.

androidx.media:media:1.4.0-rc01 zostaje opublikowany bez zmian od 1.4.0-beta01. Wersja 1.4.0-rc01 zawiera te zmiany.

Wersja 1.4.0-beta01

17 czerwca 2021 r.

Zostanie wycofaneandroidx.media:media:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy nowy klucz pakietu METADATA_KEY_SERIES_CONTENT_ID używany w przypadku identyfikatora treści multimedialnych serialu w MediaMetadataCompat.

  • Dodano nowy klucz pakietu METADATA_KEY_NEXT_EPISODE_CONTENT_ID używany w przypadku identyfikatora treści następnego odcinka serialu w MediaMetadataCompat

Wersja 1.4.0-alpha01

5 maja 2021 roku

Zostanie wycofaneandroidx.media:media:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Wycofaj MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE i dodaj zamiast niego MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE (I62f17)
  • Dodaj dodatkowy klucz do tasowania multimediów w przypadku playFromUri (Ibc63c)
  • Dodanie adnotacji @Nullable do klasy Result (I2d617)

Poprawki błędów

  • Naprawianie braku EXTRA_KEY_EVENT intencji w przypadku MediaButtonReceiver (If7557)

Wersja 1.3.1

Wersja 1.3.1

5 maja 2021 roku

Zostanie wycofaneandroidx.media:media:1.3.1 Wersja 1.3.1 zawiera te zmiany.

Poprawki błędów

  • Naprawianie braku EXTRA_KEY_EVENT w intencji MediaButtonReceiver (If7557)

Wersja 1.3.0

Wersja 1.3.0

7 kwietnia 2021 r.

Zostanie wycofaneandroidx.media:media:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Główne zmiany od wersji 1.2.0

  • Przeniesiono dodatki Androida Auto do MediaConstants.

Wersja 1.3.0-rc02

24 marca 2021 r.

Zostanie wycofaneandroidx.media:media:1.3.0-rc02 Wersja 1.3.0-rc02 zawiera te zmiany.

Poprawki błędów

  • Ustaw wartość FLAG_IMMUTABLE na PendingIntent obiektu MediaButtonReceiver, który jest wymagany w przypadku aplikacji kierowanych na Androida 12.
  • Naprawiono NullPointerException w MediaSessionCompat z interfejsem API 27 po setCallback(null).

Wersja 1.3.0-rc01

10 marca 2021 r.

Zostanie wycofaneandroidx.media:media:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zmiany.

Brak zmian od 1.3.0-beta01.

Wersja 1.3.0-beta01

10 lutego 2021 r.

Zostanie wycofaneandroidx.media:media:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano nową stałą PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076)
  • Przeniesienie dodatków Androida Auto do MediaConstants. (I290ab)
  • Dodaj stałe do ograniczania elementów podrzędnych głównego elementu MediaBrowserService. (Ifcebd)

Poprawki błędów

  • Dodaj FLAG_RECEIVER_FOREGROUND dla oczekującego zamiaru przycisku multimediów.

Wersja 1.2.1

Media Version 1.2.1

2 grudnia 2020 r.

Zostanie wycofaneandroidx.media:media:1.2.1 Wersja 1.2.1 zawiera te zmiany.

Poprawki błędów

  • Naprawianie błędu NPE po wywołaniu funkcji MediaSessionCompat#setCallback(null) w interfejsie API 27

Wersja 1.2.0

Wersja 1.2.0

16 września 2020 roku

Zostanie wycofaneandroidx.media:media:1.2.0 Wersja 1.2.0 zawiera te zmiany.

Główne zmiany od wersji 1.1.0

  • Dodaliśmy obsługę AudioAttributesCompat#setLegacyStreamType w przypadku pakietu SDK w wersji < 21
  • Obsługa sterowania głośnością w bibliotece androidx.mediarouter
  • Lepsza obsługa interoperacyjności między androidx.media a androidx.media2

Wersja 1.2.0-rc01

2 września 2020 r.

androidx.media:media:1.2.0-rc01 zostaje opublikowany bez zmian od 1.2.0-beta01. Wersja 1.2.0-rc01 zawiera te zmiany.

Wersja 1.2.0-beta01

19 sierpnia 2020 r.

Zostanie wycofaneandroidx.media:media:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Dodano obsługę AudioAttributesCompat#setLegacyStreamType w przypadku interfejsów API na poziomach starszych niż 21.

Zmiany w interfejsie API

  • Dodano MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID dla identyfikatora multimediów w PlaybackStateCompat extras, który powinien być taki sam jak MediaMetadataCompat#METADATA_KEY_MEDIA_ID w bieżących metadanych.

Poprawki błędów

  • Rozwiązaliśmy problem z usługą AudioAttributesCompat.Builder#setContentType

Wersja 1.2.0-alpha04

24 czerwca 2020 r.

Zostanie wycofaneandroidx.media:media:1.2.0-alpha04 Wersja 1.2.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • Udostępniono sposób obsługi sterowania głośnością w bibliotece mediarouter

Zmiany w interfejsie API

  • Dodano AudioManagerCompat#getStreamMaxVolume
  • Dodano AudioManagerCompat#getStreamMinVolume

Poprawki błędów

  • Rozwiązanie problemu z współdziałaniem między interfejsami media i media2 w przypadku SDK < 21

Wersja 1.2.0-alpha03

10 czerwca 2020 r.

Zostanie wycofaneandroidx.media:media:1.2.0-alpha03 Wersja 1.2.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

  • Sieć MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN została usunięta

Poprawki błędów

  • Rozwiązaliśmy problem z equals() w RemoteUserInfo

Wersja 1.2.0-alpha02

15 kwietnia 2020 roku

Zostanie wycofaneandroidx.media:media:1.2.0-alpha02 Wersja 1.2.0-alpha02 zawiera te zmiany.

Poprawki błędów

  • Zapobieganie modyfikacjom klas VersionedParcelable

Wersja 1.2.0-alpha01

23 października 2019 r.

Zostanie wycofaneandroidx.media:media:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy te metody:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

Poprawki błędów

  • Wprowadzono zabezpieczenie przed BadParcelableException podczas przekazywania obiektu Bundle za pomocą wywołania IPC.
  • Konstruktor MediaControllerCompat nie zgłasza już wyjątku RemoteException
  • Wdrożono zapobieganie wywoływaniu metod wywołania zwrotnego po MediaSessionCompat.release()

Wersja 1.1.0

Wersja 1.1.0

5 września 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0 Listę zmian w tej wersji znajdziesz tutaj.

Importowanie zmian od wersji 1.0.0

  • Wprowadzono AudioAttributesCompat

Wersja 1.1.0-rc01

13 czerwca 2019 r.

androidx.media:media:1.1.0-rc01 zostaje opublikowany bez zmian w stosunku do 1.1.0-beta02. Listę zmian w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta02

5 czerwca 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0-beta02 Listę zmian w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Zakres ograniczeń ukrytych metod używanych przez media2-session został złagodzony do LIBRARY_GROUP_PREFIX.

Wersja 1.1.0-beta01

7 maja 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0-beta01 Listę zmian w tej wersji znajdziesz tutaj.

Nowe funkcje

  • W przypadku argumentów o wartości null, które zostały oznaczone jako @NonNull, zmieniono wartość IllegalPointerException na NullPointerException.

Wersja 1.1.0-alpha04

3 kwietnia 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0-alpha04 Listę zmian w tej wersji znajdziesz tutaj.

Poprawki błędów

Wersja 1.1.0-alpha03

21 marca 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0-alpha03 Pełną listę zmian w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Naprawiono awarię urządzenia MedaBrowserServiceCompat, gdy wiele urządzeń MediaBrowserCompat próbowało się z nim połączyć. (aosp/930246)

Wersja 1.1.0-alpha02

13 marca 2019 r.

Zostanie wycofaneandroidx.media:media:1.1.0-alpha02 Pełną listę zmian w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Usunięto awarię MediaBrowserCompat podczas łączenia.
  • Naprawiono IllegalStateException w getCurrentBrowserInfo()/getBrowserRootHints()
  • Spraw, aby funkcja MediaBrowserServiceCompat.getCurrentBrowserInfo() zwracała tę samą instancję RemoteUserInfo dla tego samego parametru MediaBrowserCompat w onGetRoot().

Wersja 1.0.1

Wersja 1.0.1

30 stycznia 2019 r.

Zostanie wycofaneandroidx.media:media 1.0.1

Poprawki błędów

  • Usunęliśmy błąd nieoczekiwanego wyjątku IllegalStateException podczas korzystania z MediaBrowserCompat.connect() (aosp/858075).

Wersja 1.0.0

Wersja 1.0.0-alpha06

17 grudnia 2018 r.

Zmiany w interfejsie API

Zmieniliśmy nazwy pakietów i klas media.widget w ten sposób:

  • androidx.media.widget.VideoView2 → androidx.media2.widget.VideoView
  • androidx.media.widget.MediaControlView2 → androidx.media2.widget.MediaControlView

Wersja 1.0.0-alpha01

3 grudnia 2018 r.

Zmiany w interfejsie API

  • Wycofano 2 flagi MediaSessionCompat:
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS