このページは Cloud Translation API によって翻訳されました。

Media

API リファレンス
androidx.media
androidx.media.app
androidx.media.session

メディアのコンテンツとコントロールを他のアプリと共有します。Media2 が優先されます。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
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 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

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

バージョン 1.7

バージョン 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

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

2021 年 5 月 5 日

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

バグの修正

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

バージョン 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

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

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

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