미디어

다른 앱과 미디어 콘텐츠 및 컨트롤을 공유합니다. media3로 대체되었습니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2023년 11월 29일 1.7.0 - - -

종속 항목 선언

Media의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

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

Kotlin

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

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.7

버전 1.7.0

2023년 11월 29일

androidx.media:media:1.7.0이 출시되었습니다. 버전 1.7.0에 포함된 커밋을 확인하세요.

1.6.0 이후 중요 변경사항

  • MediaButtonReceiver에서 ForegroundServiceStartNotAllowedException을 포착하고 onForegroundServiceStartNotAllowedException에 전달합니다. (I0c939)
  • MediaBrowserCompat 루트 추가 항목에 즐겨찾기 미디어 항목을 전달하기 위한 BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM을 추가했습니다. (Id3a11)
  • MediaBrowserCompat 루트 추가 항목 및 MediaItem 설명에서 맞춤 작업 둘러보기를 설정하는 추가 항목을 추가했습니다. (Iab163)
  • 이전 Android 버전에서 MediaBrowserService.onLoadChildren에서 null을 반환하여 발생하는 IllegalStateException를 수정했습니다.

버전 1.7.0-rc01

2023년 11월 15일

androidx.media:media:1.7.0-rc01은 변경사항 없이 출시되었습니다. 버전 1.7.0-rc01에 포함된 커밋을 확인하세요.

버전 1.7.0-beta01

2023년 11월 1일

androidx.media:media:1.7.0-beta01이 출시되었습니다. 버전 1.7.0-beta01에 포함된 커밋을 확인하세요.

버그 수정

  • MediaBrowserService 및 MediaBrowserServiceCompat의 잠재적인 메모리 누수를 수정했습니다. b/37137738
  • 이전 Android 버전에서 MediaBrowserService.onLoadChildren에서 null을 반환하여 발생하는 IllegalStateException를 수정했습니다.

버전 1.7.0-alpha01

2023년 2월 8일

androidx.media:media:1.7.0-alpha01이 출시되었습니다. 버전 1.7.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • MediaButtonReceiver에서 ForegroundServiceStartNotAllowedException을 포착하고 onForegroundServiceStartNotAllowedException에 전달합니다. (I0c939)
  • MediaBrowserCompat 루트 추가 항목에 즐겨찾기 미디어 항목을 전달하기 위한 BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM을 추가했습니다. (Id3a11)
  • MediaBrowserCompat 루트 추가 항목 및 MediaItem 설명에서 맞춤 작업 둘러보기를 설정하는 추가 항목을 추가했습니다. (Iab163)

버전 1.6.0

버전 1.6.0

2022년 4월 20일

androidx.media:media:1.6.0이 출시되었습니다. 버전 1.6.0에 포함된 커밋을 확인하세요.

1.5.0 이후 중요 변경사항

  • Android Auto용 미디어 앱에서 CarAppLibrary를 사용하여 로그인/설정 페이지를 설정하는 데 필요한 extras를 추가했습니다.

버전 1.6.0-rc01

2022년 4월 6일

androidx.media:media:1.6.0-rc01이 출시되었습니다. 버전 1.6.0-rc01에 포함된 커밋을 확인하세요.

버전 1.6.0-beta01

2022년 3월 23일

androidx.media:media:1.6.0-beta01이 출시되었습니다. 버전 1.6.0-beta01에 포함된 커밋을 확인하세요.

  • 마지막 알파 출시 이후 변경사항이 없습니다.

버전 1.6.0-alpha01

2022년 2월 23일

androidx.media:media:1.6.0-alpha01이 출시되었습니다. 버전 1.6.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • Android Auto용 미디어 앱에서 CarAppLibrary를 사용하여 로그인/설정 페이지를 설정하는 데 필요한 extras를 추가했습니다. (Ifb3ca)

버전 1.5

버전 1.5.0

2022년 2월 9일

androidx.media:media:1.5.0이 출시되었습니다. 버전 1.5.0에 포함된 커밋을 확인하세요.

1.4.0 이후 중요 변경사항

  • AudioManagerCompat에 isVolumeFixed를 추가했습니다.
  • 단일 항목 스타일 지정 및 완료 비율에 MediaConstants를 추가했습니다.
  • API 수준 30 이상에서는 라이브러리가 MediaBrowserCompat용 패키지 공개 상태 필터를 삽입하지 않습니다. 앱 매니페스트에 <queries> 요소를 지정해야 합니다.
  • API 21에서 getMediaDescription() 추가 요소의 예상치 못한 변경사항을 수정했습니다.
  • API 19에서 IllegalStateException을 방지합니다.
  • Android 12를 타겟팅할 때 MediaSessionCompat에서 발생하는 비정상 종료 문제를 수정했습니다.
  • KitKat의 NotificationCompat에서 발생하는 비정상 종료 문제를 수정했습니다.

버전 1.5.0-rc01

2022년 1월 26일

androidx.media:media:1.5.0-rc01이 1.5.0-beta01 이후 변경사항 없이 출시되었습니다. 버전 1.5.0-rc01에 포함된 커밋을 확인하세요.

버전 1.5.0-beta01

2021년 12월 1일

androidx.media:media:1.5.0-beta01이 1.5.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.5.0-beta01에 포함된 커밋을 확인하세요.

버전 1.5.0-alpha01

2021년 11월 3일

androidx.media:media:1.5.0-alpha01이 출시되었습니다. 버전 1.5.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 미디어용 코어 종속 항목을 1.6.0으로 업데이트합니다.

API 변경사항

  • AudioManagerCompat에 isVolumeFixed를 추가했습니다.
  • 단일 항목 스타일 지정 및 완료 비율에 MediaConstants를 추가했습니다.

버그 수정

  • API 수준 30 이상에서는 라이브러리가 MediaBrowserCompat용 패키지 공개 상태 필터를 삽입하지 않습니다. 앱 매니페스트에 <queries> 요소를 지정해야 합니다.
  • API 21에서 getMediaDescription() 추가 요소의 예상치 못한 변경사항을 수정했습니다.
  • 기본 크기를 설정하여 ArrayList의 비효율적인 사용을 수정했습니다.
  • API 19의 일부 IllegalStateException을 방지했습니다.
  • Android 12를 타겟팅할 때 MediaSessionCompat에서 발생하는 비정상 종료 문제를 수정했습니다.
  • KitKat의 NotificationCompat에서 발생하는 비정상 종료 문제를 수정했습니다.

버전 1.4

버전 1.4.3

2021년 10월 13일

androidx.media:media:1.4.3이 출시되었습니다. 버전 1.4.3에 포함된 커밋을 확인하세요.

버그 수정

  • 라이브러리는 더 이상 MediaBrowserCompat을 위한 패키지 공개 상태 필터를 삽입하지 않습니다. API 수준 30 이상을 타겟팅할 경우 앱 매니페스트에 <queries> 요소를 지정하세요. (I0a964, b/185314633)

버전 1.4.2

2021년 9월 15일

androidx.media:media:1.4.2가 출시되었습니다. 버전 1.4.2에 포함된 커밋을 확인하세요.

버그 수정

  • API 21에서 getMediaDescription()의 부작용을 수정합니다. (I5c05f)

버전 1.4.1

2021년 8월 4일

androidx.media:media:1.4.1이 출시되었습니다. 버전 1.4.1에 포함된 커밋을 확인하세요.

버그 수정

  • Android S를 타겟팅할 때 비정상 종료를 방지하기 위해 PendingIntent 생성을 위한 변경 가능 여부 플래그를 수정했었습니다.
  • NotificationCompat.MediaStyle의 ClassVerificationFailure를 수정했습니다.

버전 1.4.0

2021년 7월 21일

androidx.media:media:1.4.0이 출시되었습니다. 버전 1.4.0에 포함된 커밋을 확인하세요.

1.3.0 이후 중요 변경사항

  • TV 시리즈의 미디어 콘텐츠 ID에 사용되는 새 번들 키 METADATA_KEY_SERIES_CONTENT_ID가 MediaMetadataCompat에 추가되었습니다.
  • TV 에피소드의 다음 에피소드 콘텐츠 ID에 사용되는 새로운 번들 키 METADATA_KEY_NEXT_EPISODE_CONTENT_ID가 MediaMetadataCompat에 추가되었습니다.
  • MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE을 지원 중단하고 대신 MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE을 추가합니다.
  • playFromUri의 미디어 셔플을 위한 추가 키를 추가합니다.
  • @Nullable 주석을 결과 클래스에 추가합니다.
  • MediaButtonReceiver의 누락된 인텐트 EXTRA_KEY_EVENT를 수정합니다.

버전 1.4.0-rc01

2021년 6월 30일

androidx.media:media:1.4.0-rc01이 1.4.0-beta01 이후 변경사항 없이 출시되었습니다. 버전 1.4.0-rc01에 포함된 커밋을 확인하세요.

버전 1.4.0-beta01

2021년 6월 17일

androidx.media:media:1.4.0-beta01이 출시되었습니다. 버전 1.4.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • TV 시리즈용 미디어 콘텐츠 ID에 사용되는 새 번들 키 METADATA_KEY_SERIES_CONTENT_ID가 MediaMetadataCompat에 추가되었습니다.

  • TV 에피소드의 다음 에피소드 콘텐츠 ID에 사용되는 새로운 번들 키 METADATA_KEY_NEXT_EPISODE_CONTENT_ID가 MediaMetadataCompat에 추가되었습니다.

버전 1.4.0-alpha01

2021년 5월 5일

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)

버그 수정

  • MediaButtonReceiver의 누락된 인텐트 EXTRA_KEY_EVENT를 수정합니다. (If7557)

버전 1.3.1

버전 1.3.1

2021년 5월 5일

androidx.media:media:1.3.1이 출시되었습니다. 버전 1.3.1에 포함된 커밋을 확인하세요.

버그 수정

  • MediaButtonReceiver의 누락된 인텐트 EXTRA_KEY_EVENT를 수정합니다. (If7557)

버전 1.3.0

버전 1.3.0

2021년 4월 7일

androidx.media:media:1.3.0이 출시되었습니다. 버전 1.3.0에 포함된 커밋을 확인하세요.

1.2.0 이후 주요 변경사항

  • Android Auto extras를 MediaConstants로 이전했습니다.

버전 1.3.0-rc02

2021년 3월 24일

androidx.media:media:1.3.0-rc02가 출시되었습니다. 버전 1.3.0-rc02에 포함된 커밋을 확인하세요.

버그 수정

  • Android 12를 타겟팅하는 앱에 필요한 MediaButtonReceiver의 PendingIntent로 FLAG_IMMUTABLE을 설정합니다.
  • setCallback(null) 후 API 27을 사용하는 MediaSessionCompat의 NullPointerException 문제를 해결했습니다.

버전 1.3.0-rc01

2021년 3월 10일

androidx.media:media:1.3.0-rc01이 출시되었습니다. 버전 1.3.0-rc01에 포함된 커밋을 확인하세요.

1.3.0-beta01 이후 변경사항이 없습니다.

버전 1.3.0-beta01

2021년 2월 10일

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

Media 버전 1.2.1

2020년 12월 2일

androidx.media:media:1.2.1이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.

버그 수정

  • API 27에서 MediaSessionCompat#setCallback(null) 호출 후의 NPE를 수정했습니다.

버전 1.2.0

버전 1.2.0

2020년 9월 16일

androidx.media:media:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 주요 변경사항

  • SDK 21 미만에 관한 AudioAttributesCompat#setLegacyStreamType 지원이 추가되었습니다.
  • androidx.mediarouter 라이브러리에 볼륨 조절이 지원됩니다.
  • androidx.media 및 androidx.media2 간의 상호 운용성 지원이 향상되었습니다.

버전 1.2.0-rc01

2020년 9월 2일

androidx.media:media:1.2.0-rc01이 1.2.0-beta01 이후 변경사항 없이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

버전 1.2.0-beta01

2020년 8월 19일

androidx.media:media:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • API 수준 21 이전 버전을 위한 AudioAttributesCompat#setLegacyStreamType 지원이 추가되었습니다.

API 변경사항

  • PlaybackStateCompat 추가 항목 미디어 ID에 대해 MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID가 추가되었습니다. 이는 현재 메타데이터의 MediaMetadataCompat#METADATA_KEY_MEDIA_ID와 동일할 것으로 예상됩니다.

버그 수정

  • AudioAttributesCompat.Builder#setContentType 관련 문제를 수정했습니다.

버전 1.2.0-alpha04

2020년 6월 24일

androidx.media:media:1.2.0-alpha04가 출시되었습니다. 버전 1.2.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

  • Mediarouter 라이브러리의 볼륨 제어를 지원하는 방법을 제공합니다.

API 변경사항

  • AudioManagerCompat#getStreamMaxVolume이 추가되었습니다.
  • AudioManagerCompat#getStreamMinVolume이 추가되었습니다.

버그 수정

  • 버전 21 미만 SDK의 media와 media2 간의 상호 운용성 문제를 수정했습니다.

버전 1.2.0-alpha03

2020년 6월 10일

androidx.media:media:1.2.0-alpha03이 출시되었습니다. 버전 1.2.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

  • MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN이 삭제되었습니다.

버그 수정

  • RemoteUserInfo의 equals() 문제를 해결했습니다.

버전 1.2.0-alpha02

2020년 4월 15일

androidx.media:media:1.2.0-alpha02가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

버그 수정

  • VersionedParcelable 클래스 수정을 방지합니다.

버전 1.2.0-alpha01

2019년 10월 23일

androidx.media:media:1.2.0-alpha01이 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • 다음 메서드가 추가되었습니다.
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

버그 수정

  • IPC 호출을 통해 Bundle 객체를 전달할 때 BadParcelableException을 방지하는 조치를 시행했습니다.
  • MediaControllerCompat의 생성자에서 더 이상 RemoteException이 발생하지 않습니다.
  • MediaSessionCompat.release() 후에 콜백 메서드 호출을 방지하는 조치를 시행했습니다.

버전 1.1.0

버전 1.1.0

2019년 9월 5일

androidx.media:media:1.1.0이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

1.0.0 이후 중요 변경사항

  • AudioAttributesCompat을 도입했습니다.

버전 1.1.0-rc01

2019년 6월 13일

androidx.media:media:1.1.0-rc01 버전은 1.1.0-beta02에서 변경사항 없이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버전 1.1.0-beta02

2019년 6월 5일

androidx.media:media:1.1.0-beta02가 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버그 수정

  • media2-session에 사용되는 숨겨진 메서드의 제한 범위를 LIBRARY_GROUP_PREFIX로 완화했습니다.

버전 1.1.0-beta01

2019년 5월 7일

androidx.media:media:1.1.0-beta01이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

새로운 기능

  • @NonNull로 표시되는 null 인수의 IllegalPointerException을 NullPointerException으로 변경했습니다.

버전 1.1.0-alpha04

2019년 4월 3일

androidx.media:media:1.1.0-alpha04가 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버그 수정

  • version-compat-test 상수를 조정했습니다. (aosp/933656)

버전 1.1.0-alpha03

2019년 3월 21일

androidx.media:media:1.1.0-alpha03이 출시되었습니다. 이 버전에 포함된 커밋의 전체 목록은 여기에서 확인할 수 있습니다.

버그 수정

  • 여러 MediaBrowserCompat을 연결하려고 할 때 발생하는 MedaBrowserServiceCompat 비정상 종료 문제를 해결했습니다. (aosp/930246)

버전 1.1.0-alpha02

2019년 3월 13일

androidx.media:media:1.1.0-alpha02가 출시되었습니다. 이 버전에 포함된 커밋의 전체 목록은 여기에서 확인할 수 있습니다.

버그 수정

  • 연결 중 발생하는 MediaBrowserCompat 비정상 종료 문제를 해결했습니다.
  • getCurrentBrowserInfo()/getBrowserRootHints()에서 발생하는 IllegalStateException을 수정했습니다.
  • MediaBrowserServiceCompat.getCurrentBrowserInfo()가 onGetRoot()의 동일한 MediaBrowserCompat에 관해 동일한 RemoteUserInfo 인스턴스를 반환하게 합니다.

버전 1.0.1

버전 1.0.1

2019년 1월 30일

androidx.media:media 1.0.1이 출시되었습니다.

버그 수정

  • MediaBrowserCompat.connect()를 사용하는 동안 예기치 않은 IllegalStateException이 발생하는 버그를 수정했습니다. (aosp/858075)

버전 1.0.0

버전 1.0.0-alpha06

2018년 12월 17일

API 변경사항

media.widget 패키지 및 클래스 이름을 다음과 같이 변경했습니다.

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

버전 1.0.0-alpha01

2018년 12월 3일

API 변경사항

  • 2개의 MediaSessionCompat 플래그가 지원 중단되었습니다.
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS