メディア

メディアのコンテンツとコントロールを他のアプリと共有します。media3 が優先されます。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 8 月 13 日 1.7.1 - - -

依存関係の宣言

Media への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

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

Kotlin

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

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.7

バージョン 1.7.1

2025 年 8 月 13 日

androidx.media:media:1.7.1 がリリースされました。バージョン 1.7.1 にはこれらの commit が含まれています。

バグの修正

  • 中間割り当ての数を減らし、ビットマップの不要なパーセリング/アンパーセリングを削除することで、MediaSession.setMetadata() のパフォーマンスを改善します。

バージョン 1.7.0

2023 年 11 月 29 日

androidx.media:media:1.7.0 がリリースされました。バージョン 1.7.0 に含まれる commit については、こちらをご覧ください。

1.6.0 以降の重要な変更

  • ForegroundServiceStartNotAllowedException を MediaButtonReceiver でキャッチして 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 に含まれる commit については、こちらをご覧ください。

バージョン 1.7.0-beta01

2023 年 11 月 1 日

androidx.media:media:1.7.0-beta01 がリリースされました。バージョン 1.7.0-beta01 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 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 に含まれる commit については、こちらをご覧ください。

新機能

  • ForegroundServiceStartNotAllowedException を MediaButtonReceiver でキャッチして 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 に含まれる commit については、こちらをご覧ください。

1.5.0 以降の重要な変更

  • Android Auto のメディアアプリで CarAppLibrary を使用してログイン / 設定ページをセットアップするために必要なエクストラを追加しました。

バージョン 1.6.0-rc01

2022 年 4 月 6 日

androidx.media:media:1.6.0-rc01 がリリースされました。バージョン 1.6.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.6.0-beta01

2022 年 3 月 23 日

androidx.media:media:1.6.0-beta01 がリリースされました。バージョン 1.6.0-beta01 に含まれる commit については、こちらをご覧ください。

  • 前回のアルファ版リリースからの変更はありません。

バージョン 1.6.0-alpha01

2022 年 2 月 23 日

androidx.media:media:1.6.0-alpha01 がリリースされました。バージョン 1.6.0-alpha01 に含まれる commit については、こちらをご覧ください。

API の変更

  • Android Auto のメディアアプリで CarAppLibrary を使用してログイン / 設定ページをセットアップするために必要なエクストラを追加しました。（Ifb3ca）

バージョン 1.5

バージョン 1.5.0

2022 年 2 月 9 日

androidx.media:media:1.5.0 がリリースされました。バージョン 1.5.0 に含まれる commit については、こちらをご覧ください。

1.4.0 以降の重要な変更

  • isVolumeFixed を AudioManagerCompat に追加
  • 単一アイテムのスタイル設定と完了率をサポートするために 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 に含まれる commit については、こちらをご覧ください。

バージョン 1.5.0-beta01

2021 年 12 月 1 日

androidx.media:media:1.5.0-beta01 がリリースされました。1.5.0-alpha01 からの変更はありません。バージョン 1.5.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.5.0-alpha01

2021 年 11 月 3 日

androidx.media:media:1.5.0-alpha01 がリリースされました。バージョン 1.5.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • Media における Core への依存関係を 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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • ライブラリは、MediaBrowserCompat のパッケージの公開設定のフィルタを挿入しなくなりました。API レベル 30 以上をターゲットとする場合は、アプリ マニフェストで <queries> 要素を指定してください。（I0a964、b/185314633）

バージョン 1.4.2

2021 年 9 月 15 日

androidx.media:media:1.4.2 がリリースされました。バージョン 1.4.2 に含まれる commit については、こちらをご覧ください。

バグの修正

  • API 21 での getMediaDescription() の副作用を修正しました（I5c05f）

バージョン 1.4.1

2021 年 8 月 4 日

androidx.media:media:1.4.1 がリリースされました。バージョン 1.4.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • Android S をターゲットとする場合にクラッシュしないように、PendingIntent の作成に使用される可変性フラグを修正しました。
  • NotificationCompat.MediaStyle の ClassVerificationFailure を修正しました。

バージョン 1.4.0

2021 年 7 月 21 日

androidx.media:media:1.4.0 がリリースされました。バージョン 1.4.0 に含まれる commit については、こちらをご覧ください。

1.3.0 以降の重要な変更

  • テレビシリーズのメディア コンテンツ ID に使用する新しいバンドルキー METADATA_KEY_SERIES_CONTENT_ID を MediaMetadataCompat に追加しました
  • テレビ番組のエピソードの次のエピソード コンテンツ ID に使用する新しいバンドルキー METADATA_KEY_NEXT_EPISODE_CONTENT_ID を MediaMetadataCompat に追加しました
  • MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE を非推奨にし、代わりに MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE を追加しました
  • playFromUri のメディアをシャッフルするためのキーを追加しました
  • @Nullable アノテーションを Result クラスに追加しました
  • 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 に含まれる commit については、こちらをご覧ください。

バージョン 1.4.0-beta01

2021 年 6 月 17 日

androidx.media:media:1.4.0-beta01 がリリースされました。バージョン 1.4.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

  • テレビシリーズのメディア コンテンツ ID に使用する新しいバンドルキー METADATA_KEY_SERIES_CONTENT_ID を MediaMetadataCompat に追加しました

  • テレビ番組のエピソードの次のエピソード コンテンツ 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 に含まれる commit については、こちらをご覧ください。

API の変更

  • MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE を非推奨にし、代わりに MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE を追加しました。（I62f17）
  • playFromUri のメディアをシャッフルするためのキーを追加しました。（Ibc63c）
  • @Nullable アノテーションを Result クラスに追加しました。（I2d617）

バグの修正

  • MediaButtonReceiver のインテントの EXTRA_KEY_EVENT が欠落する問題を修正しました（If7557）

バージョン 1.3.1

バージョン 1.3.1

2021 年 5 月 5 日

androidx.media:media:1.3.1 がリリースされました。バージョン 1.3.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • MediaButtonReceiver のインテントの EXTRA_KEY_EVENT が欠落する問題を修正しました（If7557）

バージョン 1.3.0

バージョン 1.3.0

2021 年 4 月 7 日

androidx.media:media:1.3.0 がリリースされました。バージョン 1.3.0 に含まれる commit については、こちらをご覧ください。

1.2.0 以降の主な変更

  • Android Auto エクストラを MediaConstants に移行しました。

バージョン 1.3.0-rc02

2021 年 3 月 24 日

androidx.media:media:1.3.0-rc02 がリリースされました。バージョン 1.3.0-rc02 に含まれる commit については、こちらをご覧ください。

バグの修正

  • Android 12 をターゲットとするアプリに必要な MediaButtonReceiver の PendingIntent に FLAG_IMMUTABLE を設定しました。
  • API 27 で setCallback(null) を呼び出した後の MediaSessionCompat の NullPointerException を修正しました。

バージョン 1.3.0-rc01

2021 年 3 月 10 日

androidx.media:media:1.3.0-rc01 がリリースされました。バージョン 1.3.0-rc01 に含まれる commit については、こちらをご覧ください。

1.3.0-beta01 からの変更はありません。

バージョン 1.3.0-beta01

2021 年 2 月 10 日

androidx.media:media:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • API 27 で MediaSessionCompat#setCallback(null) を呼び出した後の NPE を修正しました

バージョン 1.2.0

バージョン 1.2.0

2020 年 9 月 16 日

androidx.media:media:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.1.0 以降の主な変更

  • 21 より前の SDK に 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 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-beta01

2020 年 8 月 19 日

androidx.media:media:1.2.0-beta01 がリリースされました。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

新機能

  • 21 以前の API レベルで 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 に含まれる commit については、こちらをご覧ください。

新機能

  • mediarouter ライブラリの音量調整をサポートする方法を提供しました

API の変更

  • AudioManagerCompat#getStreamMaxVolume を追加しました
  • AudioManagerCompat#getStreamMinVolume を追加しました

バグの修正

  • SDK 21 より前の Media と Media2 の相互運用性の問題を修正しました。

バージョン 1.2.0-alpha03

2020 年 6 月 10 日

androidx.media:media:1.2.0-alpha03 がリリースされました。バージョン 1.2.0-alpha03 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • VersionedParcelable クラスの変更を禁止するようにしました。

バージョン 1.2.0-alpha01

2019 年 10 月 23 日

androidx.media:media:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

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 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

  • AudioAttributesCompat を導入しました

バージョン 1.1.0-rc01

2019 年 6 月 13 日

androidx.media:media:1.1.0-rc01 がリリースされました。1.1.0-beta02 からの変更はありません。このバージョンに含まれる commit については、こちらをご覧ください。

バージョン 1.1.0-beta02

2019 年 6 月 5 日

androidx.media:media:1.1.0-beta02 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

バグの修正

  • media2-session で使用される非表示メソッドの制限範囲が LIBRARY_GROUP_PREFIX に緩和されました。

バージョン 1.1.0-beta01

2019 年 5 月 7 日

androidx.media:media:1.1.0-beta01 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

  • @NonNull としてマークされた null 引数の IllegalPointerException を NullPointerException に変更しました。

バージョン 1.1.0-alpha04

2019 年 4 月 3 日

androidx.media:media:1.1.0-alpha04 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

バグの修正

  • バージョン互換テスト定数を微調整しました（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