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

Media3

メディアのユースケースのサポートライブラリ。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2024 年 10 月 30 日	1.4.1	-	1.5.0-beta01	1.5.0-alpha01

依存関係の宣言

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

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

Groovy

dependencies {
    def media3_version = "1.4.1"

    // For media playback using ExoPlayer
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // For DASH playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // For HLS playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // For SmoothStreaming playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version"
    // For RTSP playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version"
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation "androidx.media3:media3-exoplayer-midi:$media3_version"
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    // For loading data using the Cronet network stack
    implementation "androidx.media3:media3-datasource-cronet:$media3_version"
    // For loading data using the OkHttp network stack
    implementation "androidx.media3:media3-datasource-okhttp:$media3_version"
    // For loading data using librtmp
    implementation "androidx.media3:media3-datasource-rtmp:$media3_version"

    // For building media playback UIs
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

    // For exposing and controlling media sessions
    implementation "androidx.media3:media3-session:$media3_version"

    // For extracting data from media containers
    implementation "androidx.media3:media3-extractor:$media3_version"

    // For integrating with Cast
    implementation "androidx.media3:media3-cast:$media3_version"

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version"

    // For transforming media files
    implementation "androidx.media3:media3-transformer:$media3_version"

    // For applying effects on video frames
    implementation "androidx.media3:media3-effect:$media3_version"

    // For muxing media files
    implementation "androidx.media3:media3-muxer:$media3_version"

    // Utilities for testing media components (including ExoPlayer components)
    implementation "androidx.media3:media3-test-utils:$media3_version"
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation "androidx.media3:media3-test-utils-robolectric:$media3_version"

    // Common functionality for reading and writing media containers
    implementation "androidx.media3:media3-container:$media3_version"
    // Common functionality for media database components
    implementation "androidx.media3:media3-database:$media3_version"
    // Common functionality for media decoders
    implementation "androidx.media3:media3-decoder:$media3_version"
    // Common functionality for loading data
    implementation "androidx.media3:media3-datasource:$media3_version"
    // Common functionality used across multiple media libraries
    implementation "androidx.media3:media3-common:$media3_version"
    // Common Kotlin-specific functionality
    implementation "androidx.media3:media3-common-ktx:$media3_version"
}

Kotlin

dependencies {
    val media3_version = "1.4.1"

    // For media playback using ExoPlayer
    implementation("androidx.media3:media3-exoplayer:$media3_version")

    // For DASH playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-dash:$media3_version")
    // For HLS playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-hls:$media3_version")
    // For SmoothStreaming playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version")
    // For RTSP playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version")
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation("androidx.media3:media3-exoplayer-midi:$media3_version")
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-ima:$media3_version")

    // For loading data using the Cronet network stack
    implementation("androidx.media3:media3-datasource-cronet:$media3_version")
    // For loading data using the OkHttp network stack
    implementation("androidx.media3:media3-datasource-okhttp:$media3_version")
    // For loading data using librtmp
    implementation("androidx.media3:media3-datasource-rtmp:$media3_version")

    // For building media playback UIs
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation("androidx.media3:media3-ui-leanback:$media3_version")

    // For exposing and controlling media sessions
    implementation("androidx.media3:media3-session:$media3_version")

    // For extracting data from media containers
    implementation("androidx.media3:media3-extractor:$media3_version")

    // For integrating with Cast
    implementation("androidx.media3:media3-cast:$media3_version")

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version")

    // For transforming media files
    implementation("androidx.media3:media3-transformer:$media3_version")

    // For applying effects on video frames
    implementation("androidx.media3:media3-effect:$media3_version")

    // For muxing media files
    implementation("androidx.media3:media3-muxer:$media3_version")

    // Utilities for testing media components (including ExoPlayer components)
    implementation("androidx.media3:media3-test-utils:$media3_version")
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation("androidx.media3:media3-test-utils-robolectric:$media3_version")

    // Common functionality for reading and writing media containers
    implementation("androidx.media3:media3-container:$media3_version")
    // Common functionality for media database components
    implementation("androidx.media3:media3-database:$media3_version")
    // Common functionality for media decoders
    implementation("androidx.media3:media3-decoder:$media3_version")
    // Common functionality for loading data
    implementation("androidx.media3:media3-datasource:$media3_version")
    // Common functionality used across multiple media libraries
    implementation("androidx.media3:media3-common:$media3_version")
    // Common Kotlin-specific functionality
    implementation("androidx.media3:media3-common-ktx:$media3_version")
}

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

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。Media3 Issue Tracker を使用すると、質問への回答、既知の問題、機能リクエストを見つけたり、新しい問題を報告したりできます。

バージョン 1.5

バージョン 1.5.0-beta01

2024 年 10 月 30 日

androidx.media3:media3-*:1.5.0-beta01 がリリースされました。バージョン 1.5.0-beta01 には、これらの commit が含まれています。

共通ライブラリ:
- ランタイムクラス検証の失敗を回避するために、手動でアウトオブライン化された内部クラスから @DoNotInline アノテーションを削除しました。最新バージョンの R8 では、このような呼び出しを自動的にオフラインにすることで、実行時エラーを回避します（そのため、手動でのオフライン化は不要です）。ライブラリのすべての Gradle ユーザーが、すでに Android Gradle プラグインのバージョンを使用している必要があります。このバージョンは R8 バージョンを使用している必要があります。これは compileSdk = 35 により、これを行います。Gradle 以外のビルドシステムを使用するライブラリのユーザーは、ランタイムクラス検証の失敗を回避するために、R8 と同等の圧縮/難読化ステップで同様の自動的なアウトオブラインプロセスが行われるようにする必要があります。この変更は、他の AndroidX ライブラリですでに行われています。
ExoPlayer:
- MediaCodec が非同期モードで動作しているときに、MediaCodec.CryptoException が「予期しないランタイムエラー」として報告されることがある問題を修正しました（API 31 以降のデフォルトの動作）。
- PreloadMediaSource.PreloadControl.onContinueLoadingRequested() で bufferedPositionUs ではなく bufferedDurationUs を渡します。また、DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS を DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS に変更します。アプリは、デフォルトの開始位置からの特定の時間を示す値を渡す必要があります。この値は、対応するメディアソースをこの IntDef でプリロードする位置ではなく、
- すべてのメソッド呼び出しを別のレンダラに転送する ForwardingRenderer 実装を追加しました（1703）。
- 再生リスト内の次のアイテムの再生リストのプリロードを追加します。アプリは、必要に応じて ExoPlayer.setPreloadConfiguration(PreloadConfiguration) を呼び出してプリロードを有効にできます。デフォルトでは、プリロードは無効になっています。オプトインした場合、再生を妨げないように、DefaultLoadControl は、プレーヤーが再生用に読み込んでいない場合にのみ、プリロードの開始と続行を制限します。アプリは、LoadControl.shouldContinuePreloading() を適切に実装することでこの動作を変更できます（DefaultLoadControl でこのメソッドをオーバーライドする場合など）。LoadControl のデフォルトの実装では、アプリが LoadControl のカスタム実装を使用している場合、プリロードが無効になります。
- サブクラスリスナーのイベントを呼び出せるように、メソッド MediaSourceEventListener.EventDispatcher.dispatchEvent() を追加しました。（1736）
- DefaultPreloadManager インスタンスと ExoPlayer インスタンスを一貫した共有構成でビルドする DefaultPreloadManager.Builder を追加します。
- DefaultLoadControl 実装で ExoTrackSelection[] からストリームタイプを取得できるため、LoadControl.onTracksSelected() から Renderer[] パラメータを削除しました。
- DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) のサポートを終了し、オーバーライドを防ぐためにメソッドを final としてマークしました。代わりに新しい DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) を使用してください。
- MergingMediaSource で、セカンダリソースからの MediaSourceEventListener イベントを報告します。これにより、サイドローディングされた字幕（MediaItem.LocalConfiguration.subtitleConfigurations で追加されたもの）の読み込み開始/エラー/キャンセル/完了イベントが報告されます。これは、AnalyticsListener から出力された重複する読み込みイベントとして表示される場合があります。
- 字幕やメタデータのエラーによって再生が完全に停止しないようにします。代わりに、問題のあるトラックが無効になり、残りのトラックの再生が続行されます（#1722）。
  - 新しい字幕処理（抽出中）では、関連する解析エラー（無効な字幕データなど）と読み込みエラー（HTTP 404 など）が onLoadError コールバックを介して出力されます。
  - 以前の字幕処理（レンダリング中）では、関連する読み込みエラーのみが onLoadError コールバックを介して出力され、解析エラーは無視されます（これは既存の動作です）。
Transformer:
- イメージのエクスポートには、MediaItem.Builder.setImageDurationMs を使用したイメージの表示時間の設定が必須になります。
- オーディオ EditedMediaItems のシーケンスのギャップに対するエクスポートのサポートを追加しました。
トラック選択:
- DefaultTrackSelector: 他の要因が等しい場合は、チャンネルベースのオーディオよりもオブジェクトベースのオーディオを優先します。
エクストラクタ:
- MP4 ファイルの編集リストを処理する際、キーフレーム以外のメディア開始位置のプリロールサンプル処理を修正しました（#1659）。
- Mp4Extractor と FragmentedMp4Extractor の mdhd ボックスのメディア時間を使用してフレームレートの計算を改善しました（#1531）。
- MP4 編集リストでの media_time の誤ったスケーリングを修正。segment_duration はすでに映画のタイムスケールを使用して適切にスケーリングされていましたが、media_time は、MP4 形式の標準（#1792）で指定されているように、トラックのタイムスケールを使用して適切にスケーリングされるようになりました。
- 編集リストを含む MP4 の endIndices 計算で並べ替え順序が異なるフレームを処理しました（#1797）。
オーディオ:
- シーク中に発生する可能性のあるパチパチという音声を修正しました。
- Sonic のタイムストレッチ/ピッチシフトアルゴリズムの切り捨てエラーの蓄積を修正。
- 出力フレームのドロップを引き起こす SpeedChangingAudioProcessor のバグを修正しました。
動画:
- Galaxy Tab S7 FE で、60 fps のセキュア H264 ストリームがサポート対象外とマークされる原因となる、デバイスの問題の回避策を追加しました（#1619）。
- 最後のサンプルの後にストリーミング終了シグナルを返さずに停止するコーデックに対する回避策を追加しました。
テキスト:
- 非常に大きな字幕タイムスタンプ（マイクロ秒で表して 90,000 MPEG タイムベースで乗算すると 64 ビットの long がオーバーフローする）を持つ HLS の WebVTT が表示されるようにしました（#1763）。
メタデータ:
- icy または vnd.dvb.ait コンテンツを含むトラックに C.TRACK_TYPE_METADATA タイプを割り当てます。
DRM:
- DRM セッションの開きに失敗した後の DefaultDrmSession.requiresSecureDecoder の IllegalStateException を修正。この問題は 1.5.0-alpha01 で発生しました。
マルチプレクサー:
IMA 拡張機能:
- サーバーサイドで挿入される DAI ストリームでプレロールなしで挿入する場合、最後のミッドロールを超えて再生すると ArrayIndexOutOfBoundsException が発生するバグを修正しました（#1741）。
セッション:
- 従来のサービスに接続したときに、MediaBrowser から送信されたカスタムコマンドが、メソッドの MediaBrowserServiceCompat バリアントではなく MediaSessionCompat.Callback にディスパッチされるバグを修正しました。これにより、以前のサービスから返された実際の戻り値を MediaBrowser が受信できませんでした（#1474）。
- メディアボタンインテントのブロードキャストレシーバーを設定するときに、特定のメーカーのデバイスによってスローされる IllegalArgumentException を処理（#1730）。
- メディアアイテムのコマンドボタンを追加します。これにより、Custom browse actions として知られている Media3 API が、MediaBrowserCompat のレガシーライブラリに追加されます。Media3 のコマンドボタンでは、MediaBrowser と MediaController の両方でメディアアイテムに使用できます。AAOS のカスタムブラウズアクションをご覧ください。
- play() をリクエストした後に、Media3 コントローラがセッションアプリでフォアグラウンドサービスを開始できないことがあるバグを修正。
- CommandButton.Builder.setIconUri をコンテンツ URI のみを受け付けるように制限。
- 以前の MediaBrowserCompat に接続する場合は、Media3 ブラウザの接続ヒントを最初の MediaBrowserCompat に渡します。サービスは、onGetRoot() の最初の呼び出しで、ルートヒントとして渡された接続ヒントを受け取ることができます。
- 以前のブラウザサービスに接続した MediaBrowser が、ブラウザが parentid をサブスクライブした後にサービスから送信されたエラーを受信しないバグを修正しました。
- 相互運用性を改善し、以前の MediaBrowserService に接続されている Media3 ブラウザが親にサブスクライブするときに parentId の子を 2 回リクエストしないようにしました。
UI:
- XML ベースの共有遷移に関する問題のため、PlayerView-in-Compose-AndroidView の回避策で、引き伸ばし/切り抜きされた動画をオプトインにしました。AndroidView 内で PlayerView を使用するアプリは、オプトインするために PlayerView.setEnableComposeSurfaceSyncWorkaround を呼び出す必要があります（#1237、#1594）。
- setFullscreenButtonState を PlayerView に追加して、全画面表示ボタンのアイコンをオンデマンドで、つまり帯域外で、クリック操作に反応しないように更新できるようにします（#1590、#184）。
- アプリ定義のテキストトラック選択設定がある場合に、テキスト選択の [なし] が機能しないバグを修正しました。
Smooth Streaming 拡張機能:
- テキストトラックを含む SmoothStreaming ストリームを再生する際の Bad magic number for Bundle エラーを修正しました。（#1779）
RTSP 拡張機能:
- エンコードされた @ 文字を含む URL のユーザー情報の削除を修正しました（#1138）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- Android 15 でのデコーダ拡張機能に対する 16 KB ページのサポートを追加しました（#1685）。
Cast 拡張機能:
- CastSession の切断後にタイムラインのクリーンアップを停止します。これにより、送信元アプリは切断後にローカルで再生を再開できます。
- Context が指定されている場合は、CastPlayer の DeviceInfo に入力します。これにより、MediaSession を RoutingSession にリンクできるようになりました。これは、出力スイッチャーの統合に必要です（#1056）。
サポートが終了したシンボルを削除しました。
- 非推奨の DefaultEncoderFactory コンストラクタを削除しました。代わりに DefaultEncoderFactory.Builder を使用してください。

バージョン 1.5.0-alpha01

2024 年 9 月 10 日

このリリースには、1.4.1 リリース以降の次の変更が含まれています。

共通ライブラリ:
- 完全な整合性とリスナー処理を確保しながら、わずかな調整で別のプレーヤーに転送できる ForwardingSimpleBasePlayer を追加しました（#1183）。
- SimpleBasePlayer.State.playlist を getPlaylist() メソッドに置き換えます。
- SimpleBasePlayer.State.Builder.setPlaylist() のオーバーライドを追加して、プレイリスト構造を構築する代わりに、Timeline と現在の Tracks と Metadata を直接指定できるようにしました。
- minSdk を 21（Android Lollipop）に引き上げました。これは、他のすべての AndroidX ライブラリと整合しています。
- 共通ライブラリ上に構築された Kotlin 固有の機能を提供する androidx.media3:media3-common-ktx アーティファクトを追加
- media3-common-ktx ライブラリに、Player.Events をリッスンするコルーチンをスピンする Player.listen サスペンド拡張関数を追加します。
ExoPlayer:
- すべてのメディアアイテムで MediaCodecRenderer.onProcessedStreamChange() を呼び出せるようになりました。以前は、最初の呼び出しでは呼び出されませんでした。これを有効にするには、MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() を使用します。
- PreloadMediaSource.PreloadControl.onPreloadError を追加して、PreloadMediaSource.PreloadControl 実装がエラーが発生したときにアクションを実行できるようにしました。
- BasePreloadManager.Listener を追加して、プリロードイベントをアプリに伝播します。
- SNTP クライアントのタイムアウトを変更し、タイムアウト時に代替アドレスを再試行できるようにしました（#1540）。
- フィールドは常にゼロだったため、MediaCodecAdapter.Configuration.flags を削除します。
- Wear OS API 35 以降で、再生用の内蔵スピーカーをユーザーが選択できるようにします（デバイスがこのサポートをアドバタイズしている場合）。
- 音声フォーカス処理が有効になるまで、Context.getSystemService(Context.AUDIO_SERVICE) へのブロッキング呼び出しを延期します。これにより、音声フォーカス処理が有効になっていない場合、ブロッキング呼び出しが行われなくなります（#1616）。
- 読み込みに失敗した場合、バッファに保存されている時間に関係なく再生を許可します（#1571）。
- 個々のレンダラで再生の準備が整ったときに通知するために、AnalyticsListener.onRendererReadyChanged() を追加しました。
Transformer:
- SurfaceAssetLoader を追加します。これにより、Surface を介して Transformer への動画データのキューイングをサポートします。
- ImageAssetLoader は、IllegalStateException をスローするのではなく、AssetLoader.onError を介してサポートされていない入力を報告します。
エクストラクタ:
- 後続のサンプルで参照として使用されない H264 サンプルを Mp4Extractor と FragmentedMp4Extractor で識別できるようになりました。
- AmrExtractor でインデックスベースのシークを有効にするオプションを追加。
- 有効なフレーム間の MP3 ファイルが 128 KB を超える場合は、無効ではなく切り捨てられたものとして扱います。つまり、MP3 以外のデータが最後にあり、MP3 バイトの長さを示す他のメタデータがないファイルは、ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} で失敗するのではなく、MP3 データの終わりで再生が停止します（#1563）。
DataSource:
- HttpEngineDataSource を更新し、API レベル 34 ではなくバージョン S 拡張機能 7 以降での使用を許可しました（#1262）。
オーディオ:
- メディアに CTA-2075 のラウドネスメタデータが自動的に設定される（コーデック上のラウドネスメタデータ）。
- シーク時に音量がスムーズに下がるようにしました。
動画:
- MediaCodecVideoRenderer は、レンダリングされず、他のサンプルで参照として使用されていないサンプルのデコードを回避します。
- API 35 以降では、MediaCodecAdapter が configure で null Surface を受け取り、コーデックがこれ（MediaCodecInfo.detachedSurfaceSupported）をサポートしている場合、新しいメソッド detachOutputSurface を呼び出して以前に設定された Surface を削除できるようになりました。
- onOutputFormatChanged の処理時に指定されている場合、MediaCodecAdapter で指定されたピクセルアスペクト比の値を使用（#1371）。
テキスト:
- カスタム VoiceSpan を追加して、WebVTT 音声スパン用に設定します（#1632）。
画像:
- ExternallyLoadedImageDecoder を追加して、Glide や Coil などの外部画像読み込みライブラリとの統合を簡素化します。
DataSource:
- FileDescriptor からの読み取りに使用できる新しい DataSource である FileDescriptorDataSource を追加しました（#3757）。
効果:
- 軽微な SurfaceTexture スケーリングの回避策として DefaultVideoFrameProcessor を追加。SurfaceTexture には、切り抜かれたバッファの端の周囲にある 1 テクセルの境界を切り取る小さなスケーリングが含まれる場合があります。出力が想定どおりに近づくように処理が変更されました。
- DefaultVideoFrameProcessor.queueInputBitmap() を高速化します。その結果、Transformer を使用すると、画像を動画にエクスポートする方が速くなります。
IMA 拡張機能:
- プレイリストを消去すると ImaServerSideAdInsertionMediaSource に ArrayIndexOutOfBoundsException が挿入されるバグを修正しました。
セッション:
- MediaButtonReceiver.shouldStartForegroundService(Intent) を追加して、このメソッドをオーバーライドすることで、アプリが再生の再開のために受信した再生コマンドを抑制できるようにします。デフォルトでは、サービスは常に開始され、ForegroundServiceDidNotStartInTimeException でシステムがサービスをクラッシュさせない限り、再生を抑制できません（#1528）。
DASH 拡張機能:
- セグメントの途中から始まる期間のサポートを追加しました（#1440）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- IAMF デコーダモジュールを追加します。このモジュールは、libiamf ネイティブライブラリを使用して IAMF トラックを含む MP4 ファイルの再生をサポートし、音声を合成します。
  - 再生は、ステレオレイアウトと 5.1 で空間化とオプションのヘッドトラッキングが有効な場合に有効になりますが、バイノーラル再生のサポートは現在利用できません。
Cast 拡張機能:
- CastSession の切断後にタイムラインの消去を停止しました。これにより、送信元アプリは切断後にローカルで再生を再開できるようになります。
- Context が指定されている場合は、CastPlayer の DeviceInfo に入力します。これにより、MediaSession を RoutingSession にリンクできるようになりました。これは、出力スイッチャーの統合に必要です（#1056）。
テストユーティリティ:
- DataSourceContractTest に、次の検証を行うテストが追加されました。
  - 入力ストリーム read position が更新されます。
  - 出力バッファ offset が正しく適用されます。
サポートが終了したシンボルを削除しました。
- 非推奨の Player.hasPrevious、Player.hasPreviousWindow() を削除。代わりに Player.hasPreviousMediaItem() を使用してください。
- 非推奨の Player.previous() メソッドを削除しました。代わりに Player.seekToPreviousMediaItem() を使用してください。
- 非推奨の DrmSessionEventListener.onDrmSessionAcquired メソッドを削除しました。

バージョン 1.4.0

バージョン 1.4.1

2024 年 8 月 27 日

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

ExoPlayer:
- PreloadMediaSource でプリロードコールバックを非同期で処理しました（#1568）。
- 読み込みが失敗した場合、バッファリングされている時間に関係なく再生できるようにします（#1571）。
エクストラクタ:
- MP3: Info フレームの長さフィールドに基づいて、末尾の MP3 以外のデータを正しく無視することで、Searched too many bytes エラーを修正しました（#1480）。
テキスト:
- TTML: パーセンテージ tts:fontSize 値の処理を修正し、パーセンテージ tts:fontSize 値を持つ親ノードから正しく継承されるようにしました。
- リクエストされた出力の開始時間が Subtitle の最終イベント時間以上である場合の処理が正しく行われていなかったため、LegacySubtitleUtil の IndexOutOfBoundsException を修正しました（#1516）。
DRM:
- L1 Widevine コンテンツを再生する API 31 以降のデバイスでの android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE エラーを修正。このエラーは、フレームワークの MediaDrm.requiresSecureDecoder メソッドが不完全に実装されていることが原因で発生します（#1603）。
効果:
- release() メソッドを GlObjectsProvider に追加しました。
セッション:
- ドキュメントに記載されているように、KEYCODE_HEADSETHOOK のダブルタップを「次の項目に移動」アクションに変換しました（#1493）。
- ForegroundServiceDidNotStartInTimeException を回避するために無視するかどうかを判断するときに、MediaButtonReceiver で KEYCODE_HEADSETHOOK を「再生」コマンドとして処理（#1581）。
RTSP 拡張機能:
- SDP 解析で無効なメディアの説明をスキップする（#1087）。

バージョン 1.4.0

2024 年 7 月 25 日

androidx.media3:media3-*:1.4.0 がリリースされました。バージョン 1.4.0 に含まれるcommit

共通ライブラリ:
- 無効なシーク呼び出しを無視するのではなく、保護された BasePlayer.seekTo() メソッドと SimpleBasePlayer.handleSeek() メソッドに転送します。これらのメソッドをカスタムプレーヤーに実装する場合は、これらの追加呼び出しを mediaItemIndex == C.INDEX_UNSET で処理する必要があります。
- 拡張された Java 8 デシュガーリングのビルド依存関係を削除しました（#1312）。
- MediaItem.Builder.setImageDurationMs() に渡された時間は、イメージ以外の MediaItem では無視されるようにします（ドキュメントに記載されているように）。
- Format.customData を追加して、Format インスタンスに関するアプリ提供のカスタム情報を保存します。
ExoPlayer:
- rankingData で定義された優先度に基づいて、複数のソースのプリロードを調整する BasePreloadManager を追加します。このクラスを拡張することでカスタマイズできます。DefaultPreloadManager を追加します。これは、PreloadMediaSource を使用してソースのメディアサンプルをメモリにプリロードし、UI 上のアイテムのインデックスを示す整数 rankingData を使用します。
- LoadControl の実装で複数のプレーヤーをサポートできるように、LoadControl のほとんどのメソッドに PlayerId を追加しました。
- Buffer.isDecodeOnly() と C.BUFFER_FLAG_DECODE_ONLY を削除しました。レンダラとデコーダはタイムスタンプに基づいてバッファをスキップするため、このフラグを設定する必要はありません。カスタム Renderer 実装では、バッファ時間が BaseRenderer.getLastResetPositionUs() 秒以上かどうかを確認し、サンプルを表示するかどうかを判断する必要があります。カスタム SimpleDecoder 実装では、必要に応じて isAtLeastOutputStartTimeUs() をチェックしたり、他のバッファに DecoderOutputBuffer.shouldBeSkipped を付けてスキップしたりできます。
- 指定された rankingData で MediaSource をプリロードしないことを示すために、TargetPreloadStatusControl.getTargetPreloadStatus(T) が null 値を返すことを許可します。
- remove(MediaSource) を BasePreloadManager に追加します。
- reset() を BasePreloadManager に追加して、プリロードマネージャーインスタンスを維持しながら、すべての保持ソースを解放します。
- ExoPlayer.setPriority()（および Builder.setPriority()）を追加して、PriorityTaskManager で使用される優先度値と、API 35 以降の MediaCodec の重要度を定義しました。
- 最後の再バッファ時間を更新すると、CMCD の bs（バッファ不足）キーが不正確になる問題を修正しました（#1124）。
- ソースが最後まで読み込まれたことを示すために PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) を追加します。これにより、DefaultPreloadManager とカスタム PreloadMediaSource.PreloadControl の実装で、次のソースをプリロードしたり、その他のアクションを実行したりできます。
- アイテムの末尾で無音をスキップすると再生例外が発生するバグを修正しました。
- プリロード期間を破棄するには、PreloadMediaSource に clear を追加します。
- 優先度の高いタスクでコーデックリソースが再利用されるときに使用される新しいエラーコード PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED を追加しました。
- 最初のコンテンツメディアの準備が完了する前に AdsMediaSource でプレロール広告が読み込まれるようにしました（#1358）。
- 元の期間がマニフェストからすでに削除された後にマルチ期間の DASH ライブストリームを再準備するときに、再生が STATE_ENDED に移動されるバグを修正しました。
- PreloadMediaSource.PreloadControl で onTimelineRefreshed() の名前を onSourcePrepared() に、onPrepared() の名前を onTracksSelected() に変更しました。また、必要に応じて DefaultPreloadManager.Stage の IntDef の名前を変更します。
- 動的スケジューリングの試験運用版のサポートを追加し、CPU のウェイクサイクルに合わせて作業を調整し、レンダラが進行できるまでウェイクアップを遅らせます。これは、ExoPlayer インスタンスを設定するときに experimentalSetDynamicSchedulingEnabled() を使用して有効にできます。
- Renderer.getDurationToProgressUs() を追加しました。Renderer は、このメソッドを実装して、レンダラが進行するために再生を進める必要のある時間を ExoPlayer に返すことができます。ExoPlayer が experimentalSetDynamicSchedulingEnabled() で設定されている場合、ExoPlayer はワークタスクのスケジュール設定時間を計算するときにこのメソッドを呼び出します。
- MediaCodecAdapter#OnBufferAvailableListener を追加して、入力バッファと出力バッファが MediaCodecRenderer で使用できる場合にアラートを発します。MediaCodecRenderer は、これらのコールバックを受信すると ExoPlayer にシグナルを送信します。ExoPlayer が experimentalSetDynamicSchedulingEnabled() で設定されている場合、レンダラが進行できるため、ExoPlayer はワークループをスケジュールします。
- 個々のパラメータではなく、LoadControl メソッドにデータクラスを使用します。
- ExoPlayer.isReleased() を追加して、Exoplayer.release() が呼び出されたかどうかを確認します。
- ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() を追加して、seekToPrevious() が前のアイテムにシークする最大位置を構成しました（#1425）。
- プレーヤーが一時停止しているときに、完全なフォーカスの喪失や一時的なフォーカスの喪失が報告されないなどの、音声フォーカスの不整合を修正しました（#1436）。
- 最初の準備ステップの後にエクストラクタが追加トラックを報告することによる IndexOutOfBoundsException の可能性を修正しました（#1476）。
- ExoPlayer.setVideoEffect() の Effects は、レンダラオフセットを削除したタイムスタンプを受け取ります（#1098）。
- 別の再生リストアイテムを読み上げる際に発生したプレーヤーエラーを処理する際に IllegalArgumentException が発生する可能性を修正しました（#1483）。
Transformer:
- 出力ファイル内の各トラックの作成方法を示す audioConversionProcess と videoConversionProcess を ExportResult に追加します。
- トリム最適化の H.264 レベルのチェックを緩和。
- SDR 入力メディアと HDR 入力メディアを連続して切り替えるサポートを追加しました。
- コンポジションレベルのオーディオ効果のサポートを追加しました。
- ウルトラ HDR 画像を HDR 動画にトランスコードするサポートを追加しました。
- リセットして再利用した後に DefaultAudioMixer が正しい量のバイトを出力しない問題を修正しました。
- PCM 入力を処理するときに音声チャンネル数がステレオで上限が設定されるデコーダのバグを回避。
- ExoPlayerAssetLoader でトラックを選択する場合は、音声チャンネル数の制約は無視してください。これは再生にのみ適用されます。
- androidx.media3.transformer.Muxer インターフェースを androidx.media3.muxer.Muxer に置き換え、androidx.media3.transformer.Muxer を削除します。
- コンテンツ URI スキームからの HEIC 画像の読み込みを修正。（#1373）。
- AudioGraphInput で音声トラックの長さを調整し、AV 同期を改善。
- ExportResult.processedInputs フィールドを削除します。このフィールドをコーデックの詳細に使用する場合は、代わりに DefaultDecoderFactory.listener を使用してください。コーデック例外の場合、コーデックの詳細は ExportException.codecInfo で確認できます。
エクストラクタ:
- MPEG-TS: 変更をロールフォワードし、ストリームの最後のアクセスユニットをサンプルキューに渡すことで、最後のフレームがレンダリングされるようにします（#7909）。I フレームのみ HLS ストリーム（#1150）と H.262 HLS ストリーム（#1126）で発生した問題を解決するための修正を組み込みました。
- MP3: 基盤となるストリームによってレポートされるサイズ（ファイルサイズ、HTTP Content-Length ヘッダーなど）よりも、Info フレームのデータサイズを優先します。これにより、再生できない予告編データ（アルバムアートワークなど）が固定ビットレートのシークの計算から除外され、シークの精度が向上します（#1376）。
- MP3: Info フレーム（存在する場合）のフレーム数とその他のデータを使用して、一定のビットレートのシークのための平均ビットレートを計算します。Info フレームの後のフレームのビットレートを外挿するのではなく、PCUT フレームなど、人為的に小さいビットレートを外挿しないでください（#1376）。
- AVI コンテナでの PCM 音声形式の抽出を修正
オーディオ:
- パススルー再生の DTS:X プロファイル 2 エンコード属性を修正しました（#1299）。
- オフロード再生の場合、AudioTrack.stop() を呼び出す前に DefaultAudioSink でストリーム完了のトラッキングフィールドをリセットし、保留中のすべてのデータが再生されたことを AudioTrack.StreamEventCallback#onPresentationEnded が正しく識別できるようにします。
- 異なる音声形式の切り替え（ステレオからモノラルなど）により、プロセッサが例外をスローする可能性がある SilenceSkippingAudioProcessor のバグを修正しました（#1352）。
- MediaCodecAudioRenderer.getDurationToProgressUs() を実装して、ExoPlayer が MediaCodecAudioRenderer が進行できるときにメインのワークループを動的にスケジュールするようにします。
動画:
- 再生中にサーフェスを切り替えたときに Listener.onRenderedFirstFrame() が早すぎる問題を修正しました。
- 必要に応じて互換性のある AV1 デコーダを使用するように、ドルビービジョンのデコーダフォールバックロジックを修正しました（#1389）。
- 再生中に動画レンダラを有効にすることで発生する可能性のあるコーデック例外を修正しました。
テキスト:
- シーク位置の前に開始される字幕がスキップされる問題を修正しました。この問題は Media3 1.4.0-alpha01 でのみ発生します。
- デフォルトの字幕解析動作を変更し、レンダリング中ではなく抽出中に行われるようにしました（抽出とレンダリングの違いについては、ExoPlayer のアーキテクチャ図をご覧ください）。
  - この変更は、MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) と TextRenderer.experimentalSetLegacyDecodingEnabled(true) の両方を呼び出すことでオーバーライドできます。これらのコンポーネントを ExoPlayer インスタンスに組み込む方法については、カスタマイズに関するドキュメントをご覧ください。これらのメソッド（および以前の字幕デコードのすべてのサポート）は今後のリリースで削除される予定です。
  - カスタムの SubtitleDecoder 実装を使用しているアプリは、代わりに SubtitleParser を実装するように更新する必要があります（SubtitleDecoderFactory の代わりに SubtitleParser.Factory）。
- PGS: リニアランデコードを修正し、0 をリテラル色値ではなく色インデックスとして解決（#1367）。
- CEA-708: rowLock 値を無視します。CEA-708-E S-2023 仕様では、ストリームに存在する値に関係なく、rowLock と columnLock の両方を true とみなす必要があります（columnLock のサポートは実装されていないため、事実上常に false とみなされます）。
  - これは元々 1.3.0-alpha01 リリースノートに記載されていましたが、1.3.0-rc01 リリースの前に誤って変更が元に戻されました。現在は修正されているため、変更が再度加えられています。
- CEA-708: ExoPlayer が「set pen location」コマンドを単純に処理して、重複する改行が追加されないようにしました（#1315）。
- DASH ストリームの一部など、WebVTT 字幕サンプルにキューが含まれていない場合に、LegacySubtitleUtil の IllegalArgumentException を修正しました（#1516）。
メタデータ:
- MP4 と ID3 の並べ替えタグのマッピングを修正。以前は、[アルバムの並べ替え]（soal）、[アーティストの並べ替え]（soar）、[アルバムアーティストの並べ替え]（soaa）の MP4 タグが、TSO2、TSOA、TSOP の ID3 タグに誤ってマッピングされていました（#1302）。
- 値が 1 バイトを超える場合の MP4（/iTunes）数値 gnre（ジャンル）タグと tmpo（テンポ）タグの読み取りを修正。
- ID3 TCON フレームを MediaMetadata.genre に伝播しました（#1305）。
画像:
- 正方形以外の DASH サムネイルグリッドのサポートを追加しました（#1300）。
- API 34 以降での AVIF のサポートを追加しました。
- ExoPlayer.setImageOutput() のパラメータとして null を許可し、以前に設定された ImageOutput をクリアできるようにしました。
DataSource:
- android.resource://package/id 未加工リソース URI のサポートを実装します。ここで、package は現在のアプリのパッケージとは異なります。これは以前は動作するとはドキュメントされていませんでしたが、名前でアクセスするよりも別のパッケージ内のリソースにアクセスする効率的な方法です。
- DataSpec コンストラクタで url が null でないことを確認します。このパラメータには、null 以外であることを示すアノテーションがすでに付けられています。
- ByteArrayDataSource が、作成時にハードコードされるのではなく、open() 中に URI をバイト配列に解決できるようにしました（#1405）。
DRM:
- DefaultDrmSessionManagerProvider での LoadErrorHandlingPolicy の設定を許可する（#1271）。
効果:
- SpeedChangeEffect 内の同じ EditedMediaItem または Composition 内で複数の速度変更をサポート。
- 超 HDR ビットマップ入力からの HLG と PQ の出力のサポート。
- EGL_GL_COLORSPACE_BT2020_HLG_EXT のサポートを追加しました。これにより、ExoPlayer.setVideoEffect と Transformer の Debug SurfaceView の HLG サーフェス出力が改善されます。
- setOverlayFrameAnchor() で適用される x 値と y 値を反転して、オーバーレイ行列の実装を更新し、ドキュメントと整合させます。OverlaySettings.Builder.setOverlayFrameAnchor() を使用する場合は、x 値と y 値に -1 を乗算して反転します。
- ExoPlayer#setVideoEffects で使用すると TimestampWrapper がクラッシュするバグを修正しました。（#821）
- デフォルトの SDR カラー作業空間をリニアカラーから電気 BT 709 SDR 動画に変更。元のカラースペースを保持する 3 つ目のオプションも提供します。
- EditedMediaItemSequences の未確定の z 順序を定義できるようにしました（#1055）。
- さまざまな HDR コンテンツで明るさ範囲を一定に保つ（HLG 範囲を使用）。
- HDR コンテンツでのウルトラ HDR（ビットマップ）オーバーレイのサポートを追加しました。
- API 26 より前に SeparableConvolution エフェクトを使用できるようにしました。
- オーバーレイとフレームのダイナミックレンジが一致する必要があるため、未使用の OverlaySettings.useHdr を削除しました。
- TextOverlay の HDR サポートを追加しました。テキストオーバーレイの明るさは OverlaySettings.Builder.setHdrLuminanceMultiplier() で調整できます。
IMA 拡張機能:
- アプリが DAI 広告ストリームを再生するために必要な API を安定版に昇格しました。
- ImaServerSideAdInsertionMediaSource.AdLoader に replaceAdTagParameters(Map <String, String>) を追加し、実行時に広告タグパラメータを置き換えられるようにしました。
- 広告の再生中にプレーヤーエラーが発生したときに VideoAdPlayer.VideoAdPlayerCallback.onError() が呼び出されないバグを修正しました（#1334）。
- IMA SDK のバージョンを 3.33.0 に引き上げ、data:// 広告タグ URI の使用時に発生する NullPointerException を修正しました（#700）。
セッション:
- CommandButton.enabled のデフォルトを true に変更し、関連するコマンドが使用可能な場合でも、コントローラで値が false のままになるようにします。
- カスタムアイコンリソースの代わりに使用する CommandButton のアイコン定数を追加します。
- MediaSessionService.isPlaybackOngoing() を追加して、アプリが onTaskRemoved() でサービスを停止する必要があるかどうかをクエリできるようにしました（#1219）。
- MediaSessionService.pauseAllPlayersAndStopSelf() を追加して、すべてのセッションの再生を一時停止し、stopSelf() を呼び出して MediaSessionService のライフサイクルを終了できるようにします。
- MediaSessionService.onTaskRemoved(Intent) をオーバーライドして、再生が進行中の場合はサービスをフォアグラウンドで実行し続け、そうでない場合はサービスを停止する安全なデフォルト実装を提供します。
- プラットフォームセッションメタデータに継続時間を設定しないことで、ライブ配信のメディア通知でシークバーを非表示にしました（#1256）。
- MediaMetadata の変換を MediaDescriptionCompat に合わせ、media1 と同じ優先順序とロジックを使用してメタデータプロパティを選択できるようにします。
- Media3 コントローラへの非致命的エラーの送信を許可する MediaSession.sendError() を追加しました。通知コントローラを使用する場合（MediaSession.getMediaNotificationControllerInfo() を参照）、カスタムエラーを使用して、プラットフォームセッションの PlaybackState を、指定されたエラー情報を含むエラー状態に更新します（#543）。
- MediaSession.Callback.onPlayerInteractionFinished() を追加して、特定のコントローラからの一連のプレーヤー操作が終了したことをセッションに通知します。
- SessionError を追加し、エラーコードの代わりに SessionResult と LibraryResult で使用して、エラーの詳細と、可能であればエラーの解決方法を提供します。
- メディアセッションを公開するアプリとのインタラクションをテストするために使用できる、media3 コントローラテストアプリのコードが公開されました。
- media3 の MediaSession[Builder].setSessionExtras() に渡されたエクストラを media1 コントローラの PlaybackStateCompat.getExtras() に伝播する。
- 致命的なエラーと致命的でないエラーをプラットフォームセッションとの間でマッピングします。PlaybackException は、PlaybackStateCompat の致命的なエラー状態にマッピングされます。MediaSession.sendError(ControllerInfo, SessionError) でメディア通知コントローラに送信された SessionError は、PlaybackStateCompat の致命的でないエラーにマッピングされます。つまり、エラーコードとメッセージは設定されますが、プラットフォームセッションの状態が STATE_ERROR のままになります。
- グローバルセッションアクティビティをオーバーライドするように、セッションアクティビティをコントローラごとに設定できるようにします。セッションアクティビティは、AcceptedResultBuilder.setSessionActivivty(PendingIntent) を指定して ConnectionResult を作成することで、接続時にコントローラに定義できます。接続されると、セッションアクティビティは MediaSession.setSessionActivity(ControllerInfo, PendingIntent) で更新できます。
- MediaLibrarySession.Callback への呼び出しのエラーの複製を改善。エラーレプリケーションは、MediaLibrarySession.Builder.setLibraryErrorReplicationMode() を使用してエラータイプを選択するか、デフォルトで有効になっているエラーレプリケーションをオプトアウトすることで構成できるようになりました。
UI:
- ExoPlayer に接続したときの PlayerView に画像表示のサポートを追加しました（#1144）。
- xml 属性を使用して PlayerControlView のさまざまなアイコンのカスタマイズを追加し、グローバルオーバーライドではなく、PlayerView インスタンスごとに異なるドロワブルを許可しました。（#1200）
- API 34 で Compose AndroidView 内で SurfaceView を使用すると、動画が引き伸ばされたり切り抜かれたりすることになる、プラットフォームのバグを回避しました（#1237）。
ダウンロード:
- DownloadHelper が未公開の Renderer インスタンスをリークしないようにしました。このリークは、最終的に IllegalStateException: Too many receivers, total of 1000, registered for pid でアプリがクラッシュする可能性があります（#1224）。
Cronet 拡張機能:
- CronetDataSource の SocketTimeoutException を修正しました。Cronet の一部のバージョンでは、コールバックによって提供されるリクエストが常に同じとは限りません。これにより、コールバックが完了せず、リクエストがタイムアウトします（https://issuetracker.google.com/328442628）。
HLS 拡張機能:
- 不連続を待機している保留中の EMSG サンプルが、誤ったオフセットで HlsSampleStreamWrapper に委任され、IndexOutOfBoundsException または IllegalArgumentException が発生するバグを修正しました（#1002）。
- LL-HLS ストリームでメイン以外の再生リストが再読み込みされるバグを修正しました（#1240）。
- 初期化セグメントを使用して HLS の CMCD を有効にすると Source Error と IllegalArgumentException になるバグを修正。
- ライブ再生中に、再生中のプライマリ以外の再生リストが更新されないバグを修正しました（#1240）。
- HLS ライブストリームで CMCD を有効にすると ArrayIndexOutOfBoundsException が発生するバグを修正しました（#1395）。
DASH 拡張機能:
- マルチ期間ライブ配信を再準備すると IndexOutOfBoundsException がスローされるバグを修正しました（#1329）。
- dashif:Laurl ライセンス URL のサポートを追加しました（#1345）。
Cast 拡張機能:
- MediaQueueItem のアルバムタイトルが Media3 メディアアイテムのアーティストに変換されるバグを修正しました（#1255）。
テストユーティリティ:
- FakeRenderer に onInit() と onRelease() を実装します。
- 致命的でないエラー（AnalyticsListener.onVideoCodecError() に報告されたエラーなど）で失敗するように TestPlayerRunHelper.runUntil()/playUntil() メソッドを変更します。この動作を無効にするには、新しい TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() メソッドチェーンを使用します。
デモアプリ:
- 短い形式のデモアプリで DefaultPreloadManager を使用します。
- コマンドラインから Intent 引数を使用して繰り返しモードを設定できるようにしました（#1266）。
- デバイスでサポートされている場合は、HttpEngineDataSource を HttpDataSource として使用します。
サポートが終了したシンボルを削除しました。
- CronetDataSourceFactory を削除しました。代わりに CronetDataSource.Factory を使用してください。
- いくつかの DataSpec コンストラクタを削除しました。代わりに DataSpec.Builder を使用してください
- DefaultHttpDataSource、OkHttpDataSource、CronetDataSource から setContentTypePredicate(Predicate) メソッドを削除しました。代わりに、各 XXXDataSource.Factory で同等のメソッドを使用してください。
- OkHttpDataSource コンストラクタと OkHttpDataSourceFactory を削除しました。代わりに OkHttpDataSource.Factory を使用してください。
- PlayerMessage.setHandler(Handler) を削除しました。代わりに setLooper(Looper) を使用してください。
- Timeline.Window.isLive フィールドを削除します。代わりに isLive() メソッドを使用してください。
- DefaultHttpDataSource コンストラクタを削除しました。代わりに DefaultHttpDataSource.Factory を使用してください。
- DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS を削除しました。代わりに DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS を使用してください。
- MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) を削除しました。代わりに MediaCodecInfo.canReuseCodec(Format, Format) を使用してください
- DrmSessionManager.DUMMY メソッドと getDummyDrmSessionManager() メソッドを削除しました。代わりに DrmSessionManager.DRM_UNSUPPORTED を使用してください。
- AnalyticsListener.onAudioInputFormatChanged(EventTime, Format)、AnalyticsListener.onVideoInputFormatChanged(EventTime, Format)、AudioRendererEventListener.onAudioInputFormatChanged(Format)、VideoRendererEventListener.onVideoInputFormatChanged(Format) を削除。代わりに、DecoderReuseEvaluation を受け取るオーバーロードを使用してください。
- RendererSupport.FormatSupport IntDef と FORMAT_HANDLED、FORMAT_EXCEEDS_CAPABILITIES、FORMAT_UNSUPPORTED_DRM、FORMAT_UNSUPPORTED_SUBTYPE、FORMAT_UNSUPPORTED_TYPE の定数を削除しました。代わりに、androidx.media3.common.C で同等の IntDef と定数（C.FORMAT_HANDLED など）を使用してください。
- Bundleable インターフェースを削除します。これには、すべての Bundleable.Creator<Foo> CREATOR 定数フィールドの削除が含まれます。呼び出し元は、代わりに各型で Bundle toBundle() メソッドと static Foo fromBundle(Bundle) メソッドを使用する必要があります。

バージョン 1.4.0-rc01

2024 年 7 月 10 日

1.4.0 の安定版を使用します。

バージョン 1.4.0-beta01

2024 年 6 月 26 日

1.4.0 の安定版を使用します。

バージョン 1.4.0-alpha02

2024 年 6 月 7 日

1.4.0 の安定版を使用します。

バージョン 1.4.0-alpha01

2024 年 4 月 17 日

1.4.0 の安定版を使用します。

バージョン 1.3.0

バージョン 1.3.1

2024 年 4 月 11 日

androidx.media3:media3-*:1.3.1 がリリースされました。バージョン 1.3.1 に含まれる commit は次のとおりです。

共通ライブラリ:
- ローカライズされたラベルやその他の代替ラベルを許可するには、Format.labels を追加します。
ExoPlayer:
- PreloadMediaPeriod が再度プリロードされたときにストリームを保持できない問題を修正しました。
- トラックの再選択で、再生期間に正しい対応する TrackSelectionResult を適用します。
- メディアアイテム間を移動するときに、再生期間を進めた後にのみ、早期有効化レンダラを開始します（#1017）。
- DefaultVideoFrameProcessor.Factory.Builder.build() の proguard -keepclasseswithmembers ルールに不足している戻り型を追加しました（#1187）。
Transformer:
- API 30 より前の MediaMuxer が負の表示タイムスタンプをサポートしていないためにスローされる例外の回避策を追加。
トラック選択:
- DefaultTrackSelector: フレームレートが低すぎる、または設定されていない動画トラックよりも、適切なフレームレート（10 fps 以上）の動画トラックを優先します。これにより、プレーヤーは、モーションフォトから抽出された MP4 形式の「本物」の動画トラックを選択します。2 つの HEVC トラック（1 つは高解像度でフレーム数が非常に少ない）が含まれます（#1051）。
エクストラクタ:
- WAV ファイルから奇数のサイズのチャンクを読み取るときにパディングがスキップされない問題を修正しました（#1117）。
- MP3: XING や VBRI などのメタデータフレームから Format.averageBitrate に入力します。
- MPEG-TS: ストリームの最後のアクセスユニットをサンプルキューに渡すことで、最後のフレームがレンダリングされるようにする変更を元に戻しました（#7909）。これは、この変更により、I フレームのみの HLS ストリーム（#1150）と H.262 HLS ストリーム（#1126）で新たな問題が発生するためです。
オーディオ:
- オフロードモードでオーディオトラックの初期化に失敗した場合に、オフロードを無効にしてレンダラ復元を許可。
動画:
- Galaxy Tab S7 FE、Chromecast with Google TV、Lenovo M10 FHD Plus で、60 fps H265 ストリームがサポート対象外としてマークされる原因となるデバイスの問題に対する回避策を追加
- デバイスが API で要求されているように自動的にレンダリングしない場合でも、トンネリング中に最初のフレームが常にレンダリングされるようにする回避策を追加しました（#1169）。（#966）。
- HDR カラー情報の処理によりコーデックの動作が不正になり、SDR 動画トラックの適応型フォーマット切り替えが妨げられる問題を修正しました（#1158）。
テキスト:
- WebVTT: 連続するキューによって WebvttParser.parse から不要な CuesWithTiming インスタンスが追加作成されないようにしました（#1177）。
DRM:
- 一部の Android 14 デバイスで、ResourceBusyException または NotProvisionedException ではなく MediaDrm フレームワークによってスローされる NoSuchMethodError を回避（#1145）。
効果:
- 色空間を変換することで、PQ から SDR へのトーンマッピングを改善しました。
セッション:
- コントローラが現在のアイテムを置き換えたときに現在の位置が後方にジャンプする問題を修正しました（#951）。
- null 以外の extras のみを含む MediaMetadata がメディアコントローラとセッション間で送信されない問題を修正しました（#1176）。
UI:
- Locale が表示名を識別できない場合に、音声トラックの言語名を含めるようにフォールバックします（#988）。
DASH 拡張機能:
- マニフェストからすべての Label 要素を Format.labels に入力しました（#1054）。
RTSP 拡張機能:
- SDP 解析で空のセッション情報値（i-tag）をスキップしました（#1087）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- MIDI 拡張機能は、追加の Maven リポジトリを構成する必要があるため、デフォルトでローカル依存関係として無効になっています。ローカル依存関係からこのモジュールが必要なユーザーは、モジュールを再度有効にできます。

バージョン 1.3.0

2024 年 3 月 6 日

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

共通ライブラリ:
- package が現在のアプリのパッケージと異なる場合の android.resource://package/[type/]name 未加工リソース URI のサポートを実装します。これは動作すると常にドキュメント化されていましたが、これまでは正しく実装されていませんでした。
- アプリコードで設定された MIME タイプやメディアから読み取った MIME タイプを完全に小文字に正規化します。
- AdPlaybackState で 1 つの Uri ではなく、完全な MediaItem を使用して広告を定義します。
- minSdk を 19（Android KitKat）に増やしました。これは、他のすべての AndroidX ライブラリと整合しており、AndroidX 依存関係の最新バージョンにアップグレードするために必要です。
- artworkUri と artworkData の少なくとも 1 つが null でない場合、MediaMetadata.Builder.populate(MediaMetadata) に artworkUri と artworkData の両方を入力します（#964）。
ExoPlayer:
- PreloadMediaSource と PreloadMediaPeriod を追加し、アプリが再生前に特定の開始位置でコンテンツメディアソースをプリロードできるようにしました。PreloadMediaSource は、Timeline を受信するためのコンテンツメディアソースの準備、指定された開始位置での期間の準備とキャッシュへの保存、トラックの選択、期間のメディアデータの読み込みを行います。アプリは、PreloadMediaSource.PreloadControl を実装してプリロードの進行状況を制御し、プリロードされたソースを再生用のプレーヤーに設定します。
- アプリが ImageRenderer.ImageOutput を設定できるようにする ExoPlayer.setImageOutput を追加しました。
- DefaultRenderersFactory が、デフォルトで null の ImageOutput と ImageDecoder.Factory.DEFAULT を使用してプレーヤーに ImageRenderer を提供するようにしました。
- 無音がスキップされたときに Player.Listener.onPositionDiscontinuity イベントを出力（#765）。
- 抽出中の字幕の解析の試験運用版サポートを追加しました。これは、MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() を使用して有効にできます。
- PreloadMediaSource でアダプティブメディアソースをサポート。
- HttpEngine API を使用して HttpEngineDataSource を実装します。HttpDataSource
- CompositeSequenceableLoader のサブクラス化を防止。このコンポーネントは以前拡張可能にされていましたが、ライブラリ内でサブクラス化されたことはありませんでした。カスタマイズは、デコレーターパターンを使用してインスタンスをラップし、カスタム CompositeSequenceableLoaderFactory を実装することで行えます。
- 同じ時刻を繰り返すと、そのアイテムのメタデータが消去される問題を修正しました（#1007）。
- BundledChunkExtractor.Factory と DefaultHlsExtractorFactory の experimentalSetSubtitleParserFactory メソッドの名前を setSubtitleParserFactory に変更し、null の受け渡しを禁止します。新しい experimentalParseSubtitlesDuringExtraction(boolean) メソッドを使用して、解析動作を制御します。
- 抽出時に使用される SubtitleParser.Factory のカスタマイズをサポートしました。これは MediaSource.Factory.setSubtitleParserFactory() で実現できます。
- MergingMediaSource から生成されたすべての Format.id フィールドにソースプレフィックスを追加します。これにより、Format を生成するソースを特定できます（#883）。
- カスタム Common Media Client Data（CMCD）キー名の検証に使用される正規表現を、ハイフンのみをチェックするよう修正（#1028）しました。
- CMCD クエリパラメータの二重エンコードを停止しました（#1075）。
Transformer:
- H.265/HEVC SEF スローモーション動画のフラット化のサポートを追加しました。
- トランスコード速度を向上させました（特に「動画を削除」の編集の場合）。
- 出力ファイルが動画フレームで開始されるように API を追加します。これにより、トリミングオペレーションの出力を、プレゼンテーションタイムスタンプまで最初の動画フレームを表示しないプレーヤー実装との互換性を高めることができます（#829）。
- 単一アセットの MP4 トリムオペレーションの最適化のサポートを追加しました。
- 動画フレームが出力ファイルの最初のタイムスタンプを持つようにサポートを追加します。iOS ベースのプレーヤーで黒いフレームで始まる出力ファイルを修正しました（#829）。
トラック選択:
- DefaultTrackSelector.selectImageTrack を追加して、画像トラックの選択を有効化。
- TrackSelectionParameters.isPrioritizeImageOverVideoEnabled を追加して、画像トラックと動画トラックの両方が使用可能な場合に画像トラックを選択するかどうかを決定します。デフォルト値は false で、動画トラックの選択が優先されます。
エクストラクタ:
- MP4 エクストラクタに AV1C 解析を追加して、ColorInfo.colorSpace、ColorInfo.colorTransfer、ColorInfo.colorRange の値を取得します（#692）。
- MP3: Info ヘッダー（Xing ヘッダーの CBR 相当）を含むファイルに対して、固定ビットレート（CBR）シークを使用します。以前は Info ヘッダーのシークトテーブルを使用していましたが、この方法では、ファイルを CBR であると想定して無視した場合よりも正確なシークができません。
- MPEG2-TS: DTS、DTS-LBR、DTS:X Profile2 のサポートを追加しました（#275）。
- TS 記述子からオーディオタイプを抽出してロールフラグにマッピングすることで、ユーザーが適切な情報に基づきオーディオトラックを選択できるようになりました（#973）。
オーディオ:
- 音量をスムーズに増加させるサイレンススキップアルゴリズムを改善し、最小限のサイレンスとより自然なサイレンスの長さを維持しました（#7423）。
- スキップされた無音をより確定的に報告します（#1035）。
動画:
- VideoFrameProcessor.Factory 引数を受け取る MediaCodecVideoRenderer コンストラクタを変更し、VideoSinkProvider 引数を受け取るコンストラクタに置き換えます。カスタム VideoFrameProcessor.Factory を挿入するアプリは、カスタム VideoFrameProcessor.Factory を使用する CompositingVideoSinkProvider をインスタンス化し、動画シンクプロバイダを MediaCodecVideoRenderer に渡すことができます。
テキスト:
- ビットマップキューのシリアル化を修正し、DefaultExtractorsFactory.setTextTrackTranscodingEnabled の使用時に発生する Tried to marshall a Parcel that contained Binder objects エラーを解決しました（#836）。
- CEA-708: rowLock 値を無視。CEA-708-E S-2023 仕様では、ストリームに存在する値に関係なく、rowLock と columnLock の両方を true とみなす必要があります（columnLock のサポートは実装されていないため、事実上常に false とみなされます）。
画像:
- DASH サムネイルのサポートを追加しました。グリッド画像は切り抜かれ、個々のサムネイルが ImageOutput に提供され、表示時間に近づきます。
DRM:
- 後続の暗号化されたサンプルのキーがまだ準備できていない場合でも、デフォルトでは DRM コンテンツの「クリアリード」の暗号化されていないサンプルをすぐに再生します。再生位置が暗号化されたサンプルに達したときにキーの準備がまだできていない場合、再生中に停止する可能性があります（ただし、以前は、この時点で再生はまったく開始されていませんでした）。この動作は、MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey または DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys で無効にできます。
IMA 拡張機能:
- 適切なファイル拡張子のない DASH 広告と HLS 広告を再生できない問題を修正しました。
セッション:
- テレビアプリのダブルクリック検出を無効にしました（#962）。
- null 以外のエクストラのみを含む MediaItem.RequestMetadata がメディアコントローラとセッション間で送信されない問題を修正しました。
- MediaLibraryService ではなく Context のみを受け取るコンストラクタを MediaLibrarySession.Builder に追加しました。
HLS 拡張機能:
- HlsMediaPeriod の公開設定をパッケージプライベートに変更しました。この型は、HLS パッケージの外部から直接依存すべきではありません。
- セグメントの先頭へのシークをより効率的に解決しました（#1031）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- MIDI デコーダ: SysEx イベントメッセージを無視（#710）。
テストユーティリティ:
- TestPlayerRunHelper.playUntilPosition で再生を一時停止しないでください。テストは再生を再生状態に保ちますが、テストでアサーションとその他のアクションを追加できるようになるまで進行を停止します。
デモアプリ:
- ショートフォームのデモモジュールを追加して、ショートフォームコンテンツのユースケースで PreloadMediaSource の使用方法をデモします。

バージョン 1.3.0-rc01

2024 年 2 月 22 日

1.3.0 安定版を使用します。

バージョン 1.3.0-beta01

2024 年 2 月 7 日

1.3.0 安定版を使用します。

バージョン 1.3.0-alpha01

2024 年 1 月 15 日

1.3.0 安定版を使用します。

バージョン 1.2.0

バージョン 1.2.1

2024 年 1 月 9 日

ExoPlayer:
- LiveConfiguration.min/maxOffset の範囲外への手動シークによってオフセットが min/maxOffset に調整され続ける問題を修正しました。
- OPUS と VORBIS のチャンネルレイアウトが 3、5、6、7、8 チャンネルで正しくない問題を修正しました（#8396）。
- ライブ配信でゼロにシークした後のトラック選択で、ストリームがデフォルトの位置から誤って開始される問題を修正しました（#9347）。
- CmcdData.Factory の新しいインスタンスがチャンクソースから bufferedDurationUs の負の値を受信し、IllegalArgumentException が発生する問題を修正しました（#888）。
Transformer:
- 動作レートを高く設定したことでエンコーダが設定時にスローする問題を回避。
エクストラクタ:
- JPEG モーション写真のセカンダリ（再生不可）HEVC トラックを ROLE_FLAG_ALTERNATE としてマークし、解像度が高いために再生用に自動的に選択されないようにします。
- TS H264 ストリームの誤ったキーフレーム検出を修正しました（#864）。
- 47,721 秒を超える TS ストリームの長さの推定を修正しました（#855）。
オーディオ:
- 複数回呼び出された場合に SilenceSkippingAudioProcessor の EOS の処理を修正しました（#712）。
動画:
- Galaxy Tab S7 FE、Chromecast with Google TV、Lenovo M10 FHD Plus のデバイスの問題（60 fps AVC ストリームがサポート対象外としてマークされる）の回避策を追加しました（#693）。
メタデータ:
- MediaMetadata が大文字のキーを持つ Vorbis コメントからのみ入力されるバグを修正しました（#876）。
- 非常に大きな ID3 フレームを解析するときに OutOfMemoryError をキャッチ。つまり、再生が完全に失敗するのではなく、タグ情報なしで再生を続行できます。
DRM:
- 不正な ClearKey https://default.url ライセンス URL の回避策を API 33 以上に拡張しました（以前は、回避策は API 33 にのみ適用されていました）（#837）。
- プレーヤーにサーフェスが接続されていない状態で、暗号化されたコンテンツからクリアコンテンツに切り替えるときの ERROR_DRM_SESSION_NOT_OPENED を修正しました。このエラーは、クリアコンテンツの再生にセキュアデコーダを誤って使用したことが原因で発生しました。
セッション:
- MediaMetadataCompat のカスタムキーと値を MediaMetadata.extras に、MediaMetadata.extras を MediaMetadataCompat にそれぞれ配置します（#756、#802）。
- 以前のコントローラでの notifyChildrenChanged ブロードキャストを修正しました（#644）。
- 通知の無効な setWhen タイマーに負の時間を設定したときに、一部のデバイスでクラッシュが発生するバグを修正しました（#903）。
- 最初の通知の更新がリクエストされたときに、メディア通知コントローラが接続を完了していない場合の IllegalStateException を修正しました（#917）。
UI:
- BottomSheetDialogFragment でマテリアルデザインを使用しているときに、早送りボタンと早戻しボタンが表示されない問題を修正しました（#511）。
- PlayerControlView の早送りボタンの数字がずれていた問題を修正しました（#547）。
DASH 拡張機能:
- DASH マニフェストで、ドルビーのチャンネル数 5 として「f800」を解析します（#688）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- MIDI: 前方にシークすると Program Change イベントがスキップされる問題を修正しました（#704）。
- FFmpeg 6.0 に移行し、サポートされている NDK を r26b に更新しました（#707、#867）。
Cast 拡張機能:
- キャストデバイスでメディアの読み込みに失敗したときにアプリがクラッシュしないように、Timeline の作成をサニタイズしました（#708）。

バージョン 1.2.0

2023 年 11 月 15 日

共通ライブラリ:
- Log.Logger インターフェースのメソッドに @Nullable Throwable パラメータを追加します。これらのメソッドの message パラメータには、Log.{d,i,w,e}() メソッドに渡された Throwable に関する情報が含まれなくなりました。そのため、必要に応じて、実装でこの情報を手動で追加する必要があります（Logger.appendThrowableString(String, Throwable) を使用する場合もあります）。
- null 値許容の汎用型パラメータと null 値許容の配列要素型が null 値許容として検出されない Kotlin の互換性の問題を修正しました。例: TrackSelectorResult メソッドパラメータと SimpleDecoder メソッドパラメータ（#6792）。
- Util.shouldShowPlayButton でデフォルトの UI と通知の動作を変更し、再生が一時的に抑制されている間（一時的な音声フォーカスの喪失など）に [再生] ボタンを表示するようにしました。以前の動作は、PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) または MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) を使用して維持できます（#11213）。
- androidx.annotation:annotation-experimental を 1.3.1 にアップグレードして、https://issuetracker.google.com/251172715 を修正します。
- ExoPlayer.setAudioAttributes を Player インターフェースに移動します。
ExoPlayer:
- デコード専用のサンプルが正しく識別されず、AC4 ストリームでシークの問題が発生する問題を修正しました（#11000）。
- ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput でこの機能が有効になっている場合に、不適切なオーディオ出力デバイス（Wear OS デバイスの内蔵スピーカーなど）での再生を抑制する機能を追加しました。適切なオーディオ出力が利用できないときに再生が試行された場合、または再生中に適切な出力がすべて切断された場合、再生抑制理由は Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT として更新されます。適切な出力が接続されると、抑制の理由は削除されます。
- MediaSource.canUpdateMediaItem と MediaSource.updateMediaItem を追加して、Player.replaceMediaItem(s) を介して作成後に MediaItem の更新を受け入れます。
- Player.replaceMediaItem(s) を介してライブラリから提供されるすべての MediaSource クラスの MediaItem 更新を許可しました（#33、#9978）。
- MimeTypes.TEXT_EXOPLAYER_CUES を MimeTypes.APPLICATION_MEDIA3_CUES に名前変更します。
- 1 つのサンプルとして、PNG ファイル全体を送信して読み取る PngExtractor を TrackOutput に追加します。
- SequenceableLoader インターフェースの SequenceableLoader.continueLoading(long) メソッドを SequenceableLoader.continueLoading(LoadingInfo loadingInfo) に拡張しました。LoadingInfo には、既存の playbackPositionUs に加えて、playbackSpeed や lastRebufferRealtimeMs などの追加のパラメータが含まれます。
- ChunkSource インターフェースの ChunkSource.getNextChunk(long, long, List, ChunkHolder) メソッドを ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) に拡張しました。
- 共通メディアクライアントデータ（CMCD）ロギングに、バッファの飢餓（bs）、期限（dl）、再生レート（pr）、起動（su）のフィールドを追加しました（#8699）。
- ColorInfo に輝度と色差のビット深度を追加しました（#491）。
- 共通メディアクライアントデータ（CMCD）ロギングに、次のオブジェクトリクエスト（nor）と次の範囲リクエスト（nrr）のフィールドを追加しました（#8699）。
- クエリパラメータを使用して Common Media Client Data（CMCD）データを送信する機能を追加しました（#553）。
- ExperimentalBandwidthMeter の ConcurrentModificationException を修正しました（#612）。
- MediaPeriodId パラメータを CompositeMediaSource.getMediaTimeForChildMediaTime に追加しました。
- ConcatenatingMediaSource2 で ClippingMediaSource（および期間/ウィンドウ時間のオフセットがある他のソース）をサポートしました（#11226）。
- MediaPeriodId 引数も受け取るように BaseRenderer.onStreamChanged() を変更します。
Transformer:
- 画像入力の EXIF 回転データを解析する。
- TransformationRequest.HdrMode アノテーションタイプとそれに関連する定数を削除しました。代わりに Composition.HdrMode とそれに関連する定数を使用してください。
- OverlaySettings を簡素化して、回転の問題を修正。
- SampleConsumer.queueInputBitmap の frameRate パラメータと durationUs パラメータを TimestampIterator に変更しました。
トラック選択:
- DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness を追加して、シームレス以外の適応を明示的に許可または禁止します。デフォルトは、true の現在の動作のままです。
エクストラクタ:
- MPEG-TS: ストリームの最後のアクセスユニットをサンプルキューに渡すことで、最後のフレームがレンダリングされるようにします（#7909）。
- rotationDegrees の判定時のタイプミスを修正しました。projectionPosePitch を projectionPoseRoll に変更しました（#461）。
- Extractor インスタンスを instanceof を使用して直接検査できるという前提を排除します。実行時に Extractor の実装の詳細にアクセスする場合は、まず Extractor.getUnderlyingInstance を呼び出す必要があります。
- BmpExtractor を追加します。
- WebpExtractor を追加します。
- HeifExtractor を追加します。
- Mp4Extractor に QuickTime クラシックのサポートを追加。
オーディオ:
- MP4 と Matroska で 24 ビット/32 ビットのビッグエンディアン PCM のサポートを追加し、MP4 の lpcm の PCM エンコードを解析しました。
- MP4 での Vorbis オーディオの抽出のサポートを追加。
- DefaultAudioOffloadSupportProvider を介してシンクがフォーマットに提供できるオフロードサポートのレベルを取得する AudioSink.getFormatOffloadSupport(Format) を追加しました。isFormatSupported、isGaplessSupported、isSpeedChangeSupported を含む新しい AudioOffloadSupport を返します。
- オーディオシンクのオフロードの構成を構成する AudioSink.setOffloadMode() を追加します。デフォルトは AudioSink.OFFLOAD_MODE_DISABLED です。
- オフロードは、TrackSelectionParameters の setAudioOffloadPreference を使用して有効にできます。設定された設定が有効で、デバイスがその形式のオフロードをサポートし、トラック選択が単一のオーディオトラックである場合、オーディオオフロードが有効になります。
- audioOffloadModePreference が AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED に設定されている場合、DefaultTrackSelector は音声トラックのみを選択し、そのトラックの形式がオフロードでサポートされている場合に限ります。オフロードでサポートされている音声トラックがない場合、トラックは選択されません。
- トラック移行後の再生位置の問題により、API レベル 33 より前の時点でのオフロードのギャップレスサポートを無効にしました。
- DefaultRenderersFactory.buildAudioSink メソッドシグネチャからパラメータ enableOffload を削除しました。
- メソッド DefaultAudioSink.Builder.setOffloadMode を削除します。
- intdef 値 DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED を削除。
- オフロード再生中の Opus のギャップレスメタデータのサポートを追加しました。
- 最初の書き込みで失敗した場合にオフロードを無効にしてレンダラ復旧を許可（#627）。
- 音声のみのオフロード再生に対してオフロードスケジューリングをデフォルトで有効に。
- ExoPlayer.experimentalSetOffloadSchedulingEnabled と AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged を削除します。
- onExperimentalSleepingForOffloadChanged の名前を onSleepingForOffloadChanged に、onExperimentalOffloadedPlayback の名前を onOffloadedPlayback に変更しました。
- 音声オフロードモードに関連する TrackSelectionParameters インターフェースと定義を内部 AudioOffloadPreferences クラスに移動しました。
- onAudioTrackInitialized コールバックと onAudioTrackReleased コールバックを AnalyticsListener、AudioRendererEventListener、AudioSink.Listener に追加します。
- DTS Express 音声バッファの下り（欠落）の問題を修正しました（#650）。
- E-AC3-JOC の機能チェックで IllegalArgumentException がスローされるバグを修正しました（#677）。
動画:
- MediaCodecVideoRenderer がカスタム VideoFrameProcessor.Factory を使用できるようにします。
- 音声ストリームが負のタイムスタンプで開始された場合に最初のフレームをレンダリングできないバグを修正しました（#291）。
テキスト:
- ExoplayerCuesDecoder を削除しました。sampleMimeType = application/x-media3-cues を含むテキストトラックは、SubtitleDecoder インスタンスの必要なしに TextRenderer によって直接処理されるようになりました。
メタデータ:
- 実装ではいずれにしても null を返す必要があるため、「デコード専用」のサンプルで MetadataDecoder.decode が呼び出されなくなります。
効果:
- タイムスタンプによるビットマップ入力のキューイング VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) を追加。
- VideoFrameProcessor.registerInputStream() を非ブロッキングに変更。アプリで VideoFrameProcessor.Listener#onInputStreamRegistered() を実装する必要があります。
- VideoFrameProcessor.queueInputBitmap の frameRate パラメータと durationUs パラメータを TimestampIterator に変更しました。
IMA 拡張機能:
- 再生リストの最初のアイテムではない複数期間の DASH ライブストリームが例外をスローするバグを修正しました（#571）。
- AdsLoader.destroy() を呼び出す前に StreamManager を解放
- IMA SDK のバージョンを 3.31.0 に引き上げました。
セッション:
- 通知のフォアグラウンドサービスの動作を DefaultMediaNotificationProvider で FOREGROUND_SERVICE_IMMEDIATE に設定しました（#167）。
- Samsung デバイスで非推奨の API に関する問題が発生しないように、API 31 以降の android.media.session.MediaSession.setMediaButtonBroadcastReceiver() のみを使用してください（#167）。
- メディア通知コントローラをプロキシとして使用して、通知とプラットフォームセッションに入力するために使用される利用可能なコマンドとカスタムレイアウトを設定します。
- プラットフォームセッションに転送してから Media3 に戻すのではなく、Media3 内の MediaSessionService.onStartCommand() によって受信されたメディアボタンイベントを変換します。これにより、呼び出し元のコントローラは常にメディア通知コントローラになり、アプリはサポートされているすべての API レベルで、通知から受信した呼び出しを同じように簡単に認識できるようになります。
- 以前の MediaSessionCompat に接続したときに MediaController.getCurrentPosition() が進まないバグを修正しました。
- 利便性を高めるため、MediaLibrarySession.getSubscribedControllers(mediaId) を追加します。
- MediaLibrarySession.Callback.onSubscribe() をオーバーライドして、コントローラがサブスクライブする親 ID の可用性をアサートします。成功すると、購読が承認され、直ちに notifyChildrenChanged() が呼び出され、ブラウザに通知されます（#561）。
- Automotive OS のセッションデモモジュールを追加し、Android Auto のセッションデモを有効にしました。
- メディア通知コントローラで COMMAND_GET_TIMELINE を使用できない場合、フレームワークセッションのキューを設定しないでください。Android Auto がフレームワークセッションから読み取るクライアントコントローラの場合、Android Auto の UI に queue ボタンが表示されなくなります（#339）。
- デフォルトで SimpleBitmapLoader ではなく DataSourceBitmapLoader を使用（#271、#327）。
- アプリがデフォルトのメディアボタンイベント処理をオーバーライドできるようにする MediaSession.Callback.onMediaButtonEvent(Intent) を追加しました。
UI:
- Wear OS デバイスに Player.Listener の実装を追加し、Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT による再生の抑制を処理します。システムダイアログを起動して、ユーザーが適切なオーディオ出力（Bluetooth ヘッドフォンなど）を接続できるようにします。設定可能なタイムアウト（デフォルトは 5 分）内に適切なデバイスが接続されると、リスナーは再生を自動的に再開します。
ダウンロード:
- Android 14 との互換性を確保するために、DownloadService の「データ同期」フォアグラウンドサービスタイプを宣言しました。このサービスを使用する場合、アプリはマニフェストに dataSync を foregroundServiceType として追加し、FOREGROUND_SERVICE_DATA_SYNC 権限を追加する必要があります（#11239）。
HLS 拡張機能:
- 最後に読み込みが完了した時刻ではなく、最後に読み込みが開始された時刻から計算された間隔で HLS ライブプレイリストを更新（#663）。
DASH 拡張機能:
- セグメントテンプレートの URL で同じ DASH 識別子を複数使用できるようにします。
- 抽出中の字幕の解析の試験運用版サポートを追加しました。これにより、字幕セグメント間の切り替え時のちらつきの解消など、重複する字幕の統合がより適切にサポートされるようになりました。これは DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() を使用して有効にできます（#288）。
RTSP 拡張機能:
- TCP にフォールバックする場合や、一部の状況で再生がハングする場合に、IndexOutOfBoundsException を引き起こす可能性のある競合状態を修正。
- RtspMediaPeriod の読み込み状態を返す際の RTSP セットアップの状態を確認（#577）。
- Options レスポンスの公開ヘッダーでカスタム Rtsp リクエストメソッドを無視するようになりました（#613）。
- キープアライブ RTSP オプションリクエストを送信する時間間隔で、RTSP セットアップレスポンスタイムアウト値を使用します（#662）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- MIDI デコーダモジュールをリリースしました。このモジュールは、Jsyn ライブラリを使用してオーディオを合成することで、標準 MIDI ファイルの再生をサポートします。
- DecoderOutputBuffer.shouldBeSkipped を追加して、表示する必要のない出力バッファを直接マークします。これは、非推奨になる C.BUFFER_FLAG_DECODE_ONLY よりも優先されます。
- Decoder.setOutputStartTimeUs と SimpleDecoder.isAtLeastOutputStartTimeUs を追加して、デコーダが開始時間の前にデコードのみのサンプルを削除できるようにします。非推奨となる Buffer.isDecodeOnly よりも優先されます。
- MIDI デコーダアーティファクトを Maven リポジトリに公開するバグを修正。アーティファクトの名前を media3-exoplayer-midi に変更しました。（#734）
Leanback 拡張機能:
- サーフェスを無効にすると、Leanback コードで ArithmeticException が発生するバグを修正しました（#617）。
テストユーティリティ:
- TestExoPlayerBuilder と FakeClock を Espresso UI テストと Compose UI テストと互換性を持たせました。これにより、Espresso または Compose のビューインタラクション中に再生が非決定的に進行するバグが修正されました。
サポートが終了したシンボルを削除しました。
- TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) と TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) を削除します。代わりに Composition.Builder.setHdrMode(int) を使用して、Composition を Transformer.start(Composition, String) に渡します。
- 非推奨の DownloadNotificationHelper.buildProgressNotification メソッドを削除し、代わりに notMetRequirements パラメータを取る非推奨ではないメソッドを使用します。

バージョン 1.2.0-rc01

2023 年 11 月 1 日

1.2.0 の安定版を使用します。

バージョン 1.2.0-beta01

2023 年 10 月 19 日

1.2.0 の安定版を使用します。

バージョン 1.2.0-alpha02

2023 年 9 月 29 日

1.2.0 の安定版を使用します。

バージョン 1.2.0-alpha01

2023 年 8 月 17 日

1.2.0 の安定版を使用します。

バージョン 1.1.0

バージョン 1.1.1

2023 年 8 月 16 日

共通ライブラリ:
- 誤って追加された multidex 依存関係をすべてのモジュールから削除しました（#499）。
ExoPlayer:
- プレイリストの消去後に不要な PlaybackStats が作成される PlaybackStatsListener の問題を修正しました。
- 共通メディアクライアントデータ（CMCD）ロギングに、ストリーミング形式（sf）、ストリームタイプ（st）、バージョン（v）、上限ビットレート（tb）、オブジェクトの長さ（d）、測定スループット（mtp）、オブジェクトタイプ（ot）の追加フィールドを追加しました（#8699）。
オーディオ:
- 非常に短いファイルを再生するときに Player.getState() が STATE_ENDED に遷移しないバグを修正しました（#538）。
オーディオオフロード:
- RFC 7845 に従って、オフロードされた Opus 再生用に Ogg ID ヘッダーとコメントヘッダーページをビットストリームに追加します。
動画:
- H.265/HEVC: SPS の短期および長期の参照画像情報の解析を修正。
テキスト:
- CEA-608: 表示テキストのみを考慮するようにキューの切り捨てロジックを変更。以前は、キューの長さを 32 文字に制限する際に、インデントやタブのオフロットが含まれていました（これは仕様上正しいことでした）（#11019）。
IMA 拡張機能:
- IMA SDK のバージョンを 3.30.3 に引き上げました。
セッション:
- コントローラの状態にカスタムレイアウトを追加し、それにアクセスするためのゲッターを指定します。カスタムレイアウトが変更されると、MediaController.Listener.onCustomLayoutChanged が呼び出されます。異なる Media3 コントローラに異なるカスタムレイアウトを送信するアプリは、MediaSession.Callback.onConnect で AcceptedResultBuilder を使用して、接続が完了したときにコントローラでカスタムレイアウトを使用できるようにします。
- MediaLibraryServiceLegacyStub がこれをサポートしない Result にエラーを送信し、それが UnsupportedOperationException を生成するケースを修正しました（#78）。
- 以前のコマンド（COMMAND_ADJUST_DEVICE_VOLUME と COMMAND_SET_DEVICE_VOLUME）と新しいコマンド（COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS と COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS）の両方で volumeControlType を決定することで、PlayerWrapper が VolumeProviderCompat を作成する方法を修正しました（#554）。

バージョン 1.1.0

2023 年 7 月 5 日

共通ライブラリ:
- 不適切な音声ルートの抑制理由を追加し、準備ができたら再生する理由を長すぎる抑制理由に変更。（#15）。
- Player にコマンドを追加します。
  - COMMAND_GET_METADATA
  - COMMAND_SET_PLAYLIST_METADATA
  - COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
  - COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
- ユーザーが音量フラグを指定できるように、オーバーロードされたメソッドを Player に追加しました。
  - void setDeviceVolume(int, int)
  - void increaseDeviceVolume(int)
  - void decreaseDeviceVolume(int)
  - void setDeviceMuted(boolean, int)
- DeviceInfo に Builder を追加し、既存のコンストラクタを非推奨にしました。
- DeviceInfo.routingControllerId を追加して、リモート再生用のルーティングコントローラ ID を指定します。
- 同じ位置にアイテムを追加または削除するためのショートカットとして Player.replaceMediaItem(s) を追加しました（#8046）。
ExoPlayer:
- 明示的にオプトインした場合にのみ、ExoPlayer がデバイスの音量メソッドを制御できるようにします。ExoPlayer.Builder.setDeviceVolumeControlEnabled を使用すると、次の機能にアクセスできます。
  - getDeviceVolume()
  - isDeviceMuted()
  - setDeviceVolume(int)、setDeviceVolume(int, int)
  - increaseDeviceVolume(int)、increaseDeviceVolume(int, int)
  - decreaseDeviceVolume(int)、decreaseDeviceVolume(int, int)
- MediaSource から使用可能なトラックタイプをフィルタできる FilteringMediaSource を追加しました。
- アダプティブストリーミング形式の DASH、HLS、SmoothStreaming の送信リクエストに Common Media Client Data（CMCD）を含めるサポートを追加しました。次のフィールド（br、bl、cid、rtp、sid）が組み込まれました（#8699）。API 構造と API メソッド:
  - CMCD ロギングはデフォルトで無効になっています。有効にするには、MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) を使用します。
  - デフォルトではすべてのキーが有効になっています。CmcdConfiguration.RequestConfig.isKeyAllowed(String key) をオーバーライドして、ログに記録されるキーをフィルタします。
  - CmcdConfiguration.RequestConfig.getCustomData() をオーバーライドして、カスタムキーのロギングを有効にします。
- カスタム *.exolist.json ファイルでデモアプリを簡単に起動できるように、メインのデモのマニフェストに追加のアクションを追加しました（#439）。
- 動画再生中に Effect を使用するように ExoPlayer.setVideoEffects() を追加しました。
- sourceId を int ではなく long として保存するように SampleQueue を更新します。これにより、パブリックメソッド SampleQueue.sourceId と SampleQueue.peekSourceId のシグネチャが変更されます。
- LoadControl メソッドの shouldStartPlayback と onTracksSelected にパラメータを追加し、これらのメソッドを適切な MediaPeriod と関連付けるようにします。
- マップ内のキーとして使用される UID を含む期間を含むタイムラインパラメータを追加して、ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) の署名を変更しました。これは、マルチ期間ライブ配信の同時実行の問題を回避するために必要です。
- EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) と BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs) を非推奨にしました。代わりに、mediaTimeOffsetUs のないメソッドのバリエーションを呼び出すことができます。非推奨のバリアントの場合でも、ディスパッチャによってディスパッチされる MediaLoadData オブジェクトの startTimeUs と endTimeUs には、オフセットは追加されません。
- ExoTrackSelection.blacklist の名前を excludeTrack に、isBlacklisted の名前を isTrackExcluded に変更しました。
- 空のプレイリストで呼び出されたときの ExoPlayer.setMediaItem(s) と addMediaItem(s) の動作の不整合を修正しました。
Transformer:
- Transformer.Builder.setMediaSourceFactory(MediaSource.Factory) を削除します。代わりに ExoPlayerAssetLoader.Factory(MediaSource.Factory) と Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory) を使用してください。
- Transformer.startTransformation(MediaItem, ParcelFileDescriptor) を削除しています。
- 入力フレームの処理が保留中だったときに動画ストリームの終了が通知された場合、変換が停止する（muxer のタイムアウトにつながる）バグを修正しました。
- findDecoder/EncoderForFormat ユーティリティを使用する代わりに MediaCodecList を介してコーデックをクエリし、サポートを拡大します。
- 一部のデバイスで機能しないため、DefaultEncoderFactory の B フレーム設定を削除しました。
トラック選択:
- デフォルトで無効になっている DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange を追加しました。有効にすると、レンダラ機能が変更されたときに DefaultTrackSelector が新しいトラック選択をトリガーします。
エクストラクタ:
- Ogg: 長い時間のファイルでシークする際のバグを修正しました（#391）。
- FMP4: TimestampAdjuster が emsg アトムのメタデータサンプル時間で間違ったタイムスタンプオフセットを初期化する問題を修正しました（#356）。
オーディオ:
- トンネルが有効で AudioProcessors がアクティブな場合に、一部の再生が失敗するバグを修正しました（ギャップレストリミングなど）（#10847）。
- 直接再生（オフロード）で Opus フレームを Ogg パケットにカプセル化します。
- オフロードスケジューリングを使用して、スリープ中の現在の位置を推定します。
- プレーヤーのライフサイクルの終了時にリソースを解放するために、Renderer.release() と AudioSink.release() を追加します。
- DefaultAudioSink でオーディオ機能の変更をリッスンします。DefaultAudioSink のコンストラクタに必須パラメータ context を追加します。これにより、DefaultAudioSink は AudioCapabilitiesReceiver のリスナーとして登録され、機能の変更が通知されると audioCapabilities プロパティを更新します。
- AudioSink.Listener インターフェースの新しいイベント onAudioCapabilitiesChanged と、onRendererCapabilitiesChanged イベントをトリガーする新しいインターフェース RendererCapabilities.Listener を介して、音声機能の変更を伝播します。
- 音声チャネルにスケーリング/ミキシングを適用するための ChannelMixingAudioProcessor を追加しました。
- DecoderDiscardReasons に新しい int 値 DISCARD_REASON_AUDIO_BYPASS_POSSIBLE を追加し、オーディオ機能の変更後にバイパスモードが可能な場合にオーディオデコーダを破棄できるようにしました。
- DTS Express と DTS:X の直接再生のサポートを追加しました（#335）。
動画:
- レンダラが無効になっているときに、MediaCodecVideoRenderer が幅と高さが 0 の VideoSize を報告するようにしました。Player.getVideoSize() が変更されると、Player.Listener.onVideoSizeChanged が呼び出されます。この変更により、Player.getCurrentTracks が動画をサポートしていない場合、またはサポートされている動画トラックのサイズがまだ確定していない場合、MediaCodecVideoRenderer の ExoPlayer の動画サイズは幅と高さが 0 になります。
DRM:
- DRM パッケージの外部から呼び出されることのない DefaultDrmSession の内部専用メソッドの可視性を下げます。
  - void onMediaDrmEvent(int)
  - void provision()
  - void onProvisionCompleted()
  - onProvisionError(Exception, boolean)
マルチプレクサー:
- MP4 コンテナファイルの作成に使用できる新しいマルチプレクサライブラリを追加します。
IMA 拡張機能:
- DAI 用に複数期間のライブ DASH ストリームを有効にします。なお、現在の実装ではライブ配信でのシークをまだサポートしていません（#10912）。
- 連続するタイムラインで計算されるコンテンツの位置が若干異なるため、ライブ配信に新しい広告グループが挿入されるバグを修正します。
セッション:
- ヘルパーメソッド MediaSession.getControllerForCurrentRequest を追加して、現在 Player メソッドを呼び出しているコントローラに関する情報を取得します。
- androidx.media3.session.MediaButtonReceiver を追加して、Bluetooth ヘッドセットなどから送信されるメディアボタンイベントで再生再開を実装できるようにしました（#167）。
- MediaSession.Callback.onAddMediaItems にデフォルトの実装を追加し、LocalConfiguration（URI など）がある場合に、リクエストされた MediaItems を Player に渡せるようにしました（#282）。
- Android 12 以前では、デフォルトでコンパクトなメディア通知ビューに「前の項目に移動」ボタンと「次の項目に移動」ボタンを追加（#410）。
- MediaSession.Callback.onAddMediaItems にデフォルトの実装を追加し、LocalConfiguration（URI など）がある場合に、リクエストされた MediaItems を Player に渡せるようにしました（#282）。
- Android 12 以前では、デフォルトでコンパクトなメディア通知ビューに「前の項目に移動」ボタンと「次の項目に移動」ボタンを追加（#410）。
UI:
- Util メソッドの shouldShowPlayButton と handlePlayPauseButtonAction を追加して、再生/一時停止ボタンのあるカスタム UI 要素を記述します。
RTSP 拡張機能:
- MPEG4-LATM の場合、describe Response SDP メッセージに存在しない場合はデフォルトの profile-level-id 値を使用します（#302）。
- DESCRIBE レスポンスヘッダーに存在する場合は、RTSP セッションからの相対パス解決にベース URI を使用（#11160）。
DASH 拡張機能:
- マルチ期間の DASH ストリームの MediaLoadData.startTimeMs と MediaLoadData.endTimeMs からメディア時間オフセットを削除。
- マルチ期間のライブ Dash メディアソースを再準備すると IndexOutOfBoundsException が生成されるバグを修正しました（#10838）。
HLS 拡張機能:
- HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) を追加して、TimestampAdjuster の初期化を待機する読み込みスレッドのタイムアウトを設定します。タイムアウト前に初期化が完了しなかった場合、PlaybackException がスローされ、再生が永続的に停止しないようにします。タイムアウトはデフォルトで 0 に設定されています（#323）。
テストユーティリティ:
- DataSourceContractTest で URI スキームの大文字と小文字の区別を確認します。
サポートが終了したシンボルを削除しました。
- DefaultAudioSink コンストラクタを削除し、代わりに DefaultAudioSink.Builder を使用しました。
- HlsMasterPlaylist を削除し、代わりに HlsMultivariantPlaylist を使用してください。
- Player.stop(boolean) を削除しました。代わりに Player.stop() と Player.clearMediaItems()（reset が true の場合）を使用してください。
- 非推奨の 2 つの SimpleCache コンストラクタを削除し、代わりに DatabaseProvider を受け取る非推奨ではないコンストラクタを使用して、パフォーマンスを向上させます。
- DefaultBandwidthMeter コンストラクタを削除し、代わりに DefaultBandwidthMeter.Builder を使用します。
- DefaultDrmSessionManager コンストラクタを削除し、代わりに DefaultDrmSessionManager.Builder を使用してください。
- 非推奨の 2 つの HttpDataSource.InvalidResponseCodeException コンストラクタを削除し、追加のフィールド（cause、responseBody）を受け入れる非推奨ではないコンストラクタを使用して、エラーロギングを強化します。
- DownloadHelper.forProgressive、DownloadHelper.forHls、DownloadHelper.forDash、DownloadHelper.forSmoothStreaming を削除し、代わりに DownloadHelper.forMediaItem を使用します。
- 非推奨の DownloadService コンストラクタを削除し、channelDescriptionResourceId パラメータを指定するオプションを含む非推奨のコンストラクタを使用します。
- Charsets の非推奨の文字列定数（ASCII_NAME、UTF8_NAME、ISO88591_NAME、UTF16_NAME、UTF16LE_NAME）を削除し、代わりに kotlin.text パッケージの Kotlin Charsets、java.nio.charset.StandardCharsets、または com.google.common.base.Charsets を使用します。
- 非推奨の WorkManagerScheduler コンストラクタを削除し、代わりに Context パラメータを指定するオプションを含む非推奨のコンストラクタを使用します。
- Format クラスのインスタンス化に使用されていたサポートが終了したメソッド createVideoSampleFormat、createAudioSampleFormat、createContainerFormat、createSampleFormat を削除しました。代わりに、Format のインスタンスを作成するには Format.Builder を使用します。
- 非推奨のメソッド copyWithMaxInputSize、copyWithSubsampleOffsetUs、copyWithLabel、copyWithManifestFormatInfo、copyWithGaplessInfo、copyWithFrameRate、copyWithDrmInitData、copyWithMetadata、copyWithBitrate、copyWithVideoSize を削除し、代わりに Format.buildUpon() と setter メソッドを使用します。
- 非推奨の ExoPlayer.retry() を削除しました。代わりに prepare() を使用してください。
- 非推奨のゼロ引数の DefaultTrackSelector コンストラクタを削除し、代わりに DefaultTrackSelector(Context) を使用してください。
- 非推奨の OfflineLicenseHelper コンストラクタを削除しました。代わりに OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) を使用してください。
- 非推奨の DownloadManager コンストラクタを削除し、代わりに Executor を受け取るコンストラクタを使用します。
- 非推奨の Cue コンストラクタを削除しました。代わりに Cue.Builder を使用してください。
- 非推奨の OfflineLicenseHelper コンストラクタを削除しました。代わりに OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) を使用してください。
- サポートが終了した 4 つの AnalyticsListener メソッドを削除しました。
  - onDecoderEnabled、代わりに onAudioEnabled または onVideoEnabled を使用してください。
  - onDecoderInitialized、代わりに onAudioDecoderInitialized または onVideoDecoderInitialized を使用してください。
  - onDecoderInputFormatChanged、代わりに onAudioInputFormatChanged または onVideoInputFormatChanged を使用してください。
  - onDecoderDisabled、代わりに onAudioDisabled または onVideoDisabled を使用してください。
- 非推奨の Player.Listener.onSeekProcessed と AnalyticsListener.onSeekProcessed を削除し、代わりに onPositionDiscontinuity と DISCONTINUITY_REASON_SEEK を使用。
- ExoPlayer.setHandleWakeLock(boolean) を削除し、代わりに setWakeMode(int) を使用してください。
- 非推奨の DefaultLoadControl.Builder.createDefaultLoadControl() を削除し、代わりに build() を使用してください。
- 非推奨の MediaItem.PlaybackProperties を削除しました。代わりに MediaItem.LocalConfiguration を使用してください。非推奨のフィールド MediaItem.playbackProperties の型を MediaItem.LocalConfiguration に変更しました。

バージョン 1.1.0-rc01

2023 年 6 月 21 日

1.1.0 の安定版を使用します。

バージョン 1.1.0-beta01

2023 年 6 月 7 日

1.1.0 の安定版を使用します。

バージョン 1.1.0-alpha01

2023 年 5 月 10 日

1.1.0 の安定版を使用します。

バージョン 1.0.0

バージョン 1.0.2

2023 年 5 月 18 日

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

このリリースは ExoPlayer 2.18.7 リリースに対応しています。

このリリースには、1.0.1 リリース以降の次の変更が含まれています。

コアライブラリ:
- Buffer にフラグ C.BUFFER_FLAG_LAST_SAMPLE が含まれているかどうかを示す Buffer.isLastSample() を追加。
- フレームを含む最後のサンプルが「ストリームの終了」サンプルを読み取らずにキューから削除された場合に、最後のフレームがレンダリングされない問題を修正しました。（#11079）。
エクストラクタ:
- RTSP エクストラクタと MP4 エクストラクタですでに使用されている解析ロジックを再利用して、MPEG-TS ファイル内の H.265 SPS の解析を修正しました（#303）。
テキスト:
- SSA: バイトオーダーマークで始まる UTF-16 ファイルのサポートを追加しました（#319）。
セッション:
- アクションを更新する以前の MediaSessionCompat に接続したときに、MediaController が使用可能なコマンドを更新しない問題を修正しました。
- API 30 で params.isRecent == true を使用して System UI から Callback.onGetLibraryRoot への呼び出しで MediaLibraryService が null を返さないバグを修正しました。（#355）
- MediaSessionService または MediaLibraryService のメモリリークを修正しました（#346）。
- MediaSession で Timeline と位置情報の更新を組み合わせると、MediaController が IllegalStateException をスローする可能性があるバグを修正しました。

バージョン 1.0.1

2023 年 4 月 18 日

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

このリリースは ExoPlayer 2.18.6 リリースに対応しています。

コアライブラリ:
- デフォルトの位置にシークするときにターゲットライブストリームのオーバーライドをリセットしました（#11051）。
- メディア内の空のサンプルストリームが原因で再生が停止するバグを修正しました。
セッション:
- 以前の MediaSessionCompat によってパブリッシュされた複数の同一キューアイテムが MediaController で例外を引き起こすバグを修正しました（#290）。
- 以前の MediaControllerCompat.Callback.onSessionEvent に不足している MediaSession.broadcastCustomCommand の転送を追加しました（#293）。
- MediaSession.setPlayer を呼び出しても使用可能なコマンドが更新されないバグを修正しました。
- MediaController から送信された TrackSelectionOverride インスタンスが Format.metadata でグループを参照している場合に無視される問題を修正しました（#296）。
- 以前の MediaSessionCompat を介してメタデータにアクセスするために Player.COMMAND_GET_CURRENT_MEDIA_ITEM を使用できる必要がある問題を修正しました。
- バックグラウンドスレッドの MediaSession インスタンスが MediaSessionService で使用されたときにクラッシュする問題を修正しました（#318）。
- メディアボタンレシーバがライブラリによって宣言されるのに、アプリが想定していない問題を修正しました（#314）。
DASH:
- 空のセグメントタイムラインの処理を修正しました（#11014）。
RTSP:
- UDP を使用した RTSP 設定が RTSP エラー 461 UnsupportedTransport で失敗した場合は、TCP で再試行します（#11069）。

バージョン 1.0.0

2023 年 3 月 22 日

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

このリリースは ExoPlayer 2.18.5 リリースに対応しています。

1.0.0-rc02 からの変更はありません。

バージョン 1.0.0-rc02

2023 年 3 月 2 日

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

このリリースは ExoPlayer 2.18.4 リリースに対応しています。

コアライブラリ:
- API 33 でのネットワークタイプの検出を修正しました（#10970）。
- ExoPlayer.isTunnelingEnabled を呼び出すときの NullPointerException を修正（#10977）。
ダウンロード:
- マージする 2 つのセグメントの開始時間の最大差を SegmentDownloader とサブクラスで構成できるようにしました（#248）。
オーディオ:
- Samsung デバイスで途切れのない MP3 再生が機能しない問題を修正しました（#8594）。
- 音声を無効にした直後に設定した再生速度が、以前の速度変更によってオーバーライドされるバグを修正しました。（#10882）
動画:
- HEVC HDR10 形式を HEVCProfileMain10 ではなく HEVCProfileMain10HDR10 にマッピング。
- Chromecast with Google TV と Lenovo M10 FHD Plus で 60 fps AVC ストリームがサポート対象外とマークされる原因となるデバイスの問題に対する回避策を追加しました（#10898）。
- 画面リフレッシュレートよりはるかに高いフレームレートでメディアを再生する際のフレームリリースパフォーマンスの問題を修正。
Cast:
- メディアアイテムを切り替えるときの過渡的な STATE_IDLE を修正しました（#245）。
RTSP:
- 無効な RTSP describe レスポンスメッセージの解析でスローされる IllegalArgumentException をキャッチしました（#10971）。
セッション:
- 通知の再生/一時停止ボタンがプレーヤーの状態に合わせて更新されないバグを修正しました（#192）。
IMA 拡張機能:
- 最初の LOADED イベント（広告がない場合は唯一のイベント）が受信されなかったために、広告なしの DAI ストリームが開始されないバグを修正しました。

バージョン 1.0.0-rc01

2023 年 2 月 16 日

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

このリリースは ExoPlayer 2.18.3 リリースに対応しています。

コアライブラリ:
- メディアの再生パフォーマンスが低い可能性があるとデコーダが報告する場合でも、レンダラのデコーダの順序付けロジックを調整して MediaCodecSelector の設定を維持します。たとえば、デフォルトのセレクタは、その形式を完全にサポートするソフトウェアデコーダよりも、機能サポートのみ組み込まれたハードウェアデコーダを優先します（#10604）。
- 新しい ExoPlayer インスタンス用に既存の再生スレッドを設定する ExoPlayer.Builder.setPlaybackLooper を追加しました。
- ダウンロードマネージャーヘルパーを消去できるようにしました（#10776）。
- シークに使用するコマンドも指定するパラメータを BasePlayer.seekTo に追加しました。
- API 21 以上でドローアブルを読み込む際、テーマを使用します（#220）。
- 複数のメディアアイテムを 1 つのウィンドウに結合できる ConcatenatingMediaSource2 を追加しました（#247）。
エクストラクタ:
- トラックアトムの解析時にサンプルテーブル（stbl）に必要なサンプルの説明（stsd）が欠落している場合は、NullPointerException ではなく ParserException をスローします。
- fMP4 で同期フレームを直接シークする際、サンプルを正しくスキップします（#10941）。
オーディオ:
- 直接再生（パススルー）における AudioTrack の最小バッファサイズを計算する際、圧縮音声形式のビットレートを使用します。
テキスト:
- 字幕ファイルにキューが含まれていない場合に無効な（負の）インデックスを Subtitle.getEventTime に渡す TextRenderer を修正しました。
- SubRip: バイトオーダーマークで始まる UTF-16 ファイルのサポートを追加しました。
メタデータ:
- ID3 v2.4 で許されているように、ID3 フレームから複数の null 区切り値を解析します。
- コンテンツのタイプまたはメタデータで記述されたフォルダのタイプを示す MediaMetadata.mediaType を追加しました。
- MediaMetadata.isBrowsable を追加して MediaMetadata.folderType の代わりとしました。このフォルダタイプは次のリリースで非推奨になります。
DASH:
- タイル数など、画像適合セットに対する完全な解析を追加しました（#3752）。
UI:
- 非推奨の PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) を修正しました。これにより、公開設定の変更が登録済みのリスナーに渡されます（#229）。
- 右から左（RTL）レイアウトを使用する場合の、PlayerView での中央プレーヤーコントロールの順序を修正しました（#227）。
セッション:
- カスタムプレーヤーの Player インターフェースの実装用に、抽象クラス SimpleBasePlayer を追加しました。
- プラットフォームセッショントークンを Media3 SessionToken に変換するヘルパーメソッドを追加しました（#171）。
- onMediaMetadataChanged を使用して、プラットフォームメディアセッションの更新をトリガーします（#219）。
- DefaultMediaNotificationProvider の getMediaButtons() の引数としてメディアセッションを追加し、わかりやすくするために不変リストを使用するようにします（#216）。
- onSetMediaItems コールバックリスナーを追加して、Player に設定する前に、セッションごとに MediaItem リスト、開始インデックス、位置を変更、設定する手段を提供しました（#156）。
- Bluetooth 以外のメディアボタンイベントに対するダブルタップの検出を回避しました（#233）。
- 不正なレガシーセッション状態に備えて、QueueTimeline の堅牢性を高めました（#241）。
メタデータ:
- ID3 v2.4 で許されているように、ID3 フレームから複数の null 区切り値を解析します。
- コンテンツのタイプまたはメタデータで記述されたフォルダのタイプを示す MediaMetadata.mediaType を追加しました。
- MediaMetadata.isBrowsable を追加して MediaMetadata.folderType の代わりとしました。このフォルダタイプは次のリリースで非推奨になります。
Cast 拡張機能:
- Cast SDK のバージョンを 21.2.0 に引き上げました。
IMA 拡張機能:
- スレッドに関する問題を回避するために、アプリスレッド上の ImaServerSideAdInsertionMediaSource のプレーヤーリスナーを削除しました。
- プロパティ focusSkipButtonWhenAvailable を ImaServerSideAdInsertionMediaSource.AdsLoader.Builder に追加して、TV デバイスでスキップボタンのフォーカスをリクエストし、デフォルトで true に設定するようにしました。
- focusSkipButton() メソッドを ImaServerSideAdInsertionMediaSource.AdsLoader に追加して、スキップボタンのフォーカスをプログラムでリクエストできるようにしました。
- IMA SDK のバージョンを 3.29.0 に引き上げました。
デモアプリ:
- ランタイムのダウンロード通知用に、通知権限をリクエストします（#10884）。

バージョン 1.0.0-beta03

2022 年 11 月 22 日

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

このリリースは ExoPlayer 2.18.2 リリースに対応しています。

コアライブラリ:
- 現在選択されているトラックでトンネリングが有効になっているかどうかを確認する ExoPlayer.isTunnelingEnabled を追加しました（#2518）。
- 単一の MediaSource のラップを簡素化するための WrappingMediaSource を追加しました（#7279）。
- 使用可能なメモリの不足が原因で再生が止まる前にバックバッファを破棄します。
- オフロードが有効な場合に「doSomeWork」ブロックのトレースを閉じます。
- PlaybackStatsListener での高速シークに関するセッショントラッキングの問題を修正しました（#180）。
- 単一のアイテムのプレイリストで seekToNext または seekToPrevious を呼び出す場合、欠落していた onMediaItemTransition コールバックを送信します（#10667）。
- 動画がレンダリングされるサーフェスのサイズを返す Player.getSurfaceSize を追加しました。
- プレーヤーの解放中にリスナーを削除すると IllegalStateException が発生する可能性があるバグを修正しました（#10758）。
ビルド:
- コンパイルエラーを回避するため、最小 compileSdkVersion を適用しました（#10684）。
- 別の Gradle ビルドに含まれている場合はブロックを公開しません。
トラック選択:
- ディスプレイがドルビービジョンをサポートしていない場合は、他のトラックを優先します（#8944）。
ダウンロード:
- 同じ PriorityTaskManager でダウンロードと再生を同時に行うことで発生する ProgressiveDownloader の無限ループを修正しました（#10570）。
- ダウンロードの通知を即座に表示します（#183）。
- スレッドが過度に作成されるのを避けるため、並列ダウンロードの削除を 1 に制限しました（#10458）。
動画:
- ディスプレイがドルビービジョンをサポートしていない場合は、別のデコーダを試します（#9794）。
オーディオ:
- 複数のプレーヤーを同時に解放するときに OutOfMemory エラーを回避するため、AudioTrack インスタンスを解放するのに SingleThreadExecutor を使用します（#10057）。
- AudioTrack のオフロード状態の AudioOffloadListener.onExperimentalOffloadedPlayback を追加しました（#134）。
- AudioTrackBufferSizeProvider を公開インターフェースにしました。
- 優先するオーディオ出力デバイスを設定するために ExoPlayer.setPreferredAudioDevice を追加しました（#135）。
- androidx.media3.exoplayer.audio.AudioProcessor から androidx.media3.common.audio.AudioProcessor に名前を変更しました。
- すべての Android バージョンで、8 チャンネルと 12 チャンネルのオーディオをそれぞれ 7.1 と 7.1.4 のチャンネルマスクにマッピングしました（#10701）。
メタデータ:
- メタデータが利用可能になり次第すぐにレンダリングするように MetadataRenderer を設定できるようになりました。MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) でインスタンスを作成して、レンダラがメタデータをすぐに出力するか、プレーヤーの位置と同期して出力するかを指定します。
DRM:
- 空ではないが無効なライセンスの URL を返す、Android 13 の ClearKey 実装のバグを回避します。
- プレイリストで DRM スキームを切り替えるときの setMediaDrmSession failed: session not opened エラー（例: Widevine から ClearKey）を修正しました。
テキスト:
- CEA-608: フィールド 2 でサービスの切り替えコマンドが正しく処理されるようにしました（#10666）。
DASH:
- マニフェストから EventStream.presentationTimeOffset を解析しました（#10460）。
UI:
- プレーヤーの現在のオーバーライドを TrackSelectionDialogBuilder のプリセットとして使用しました（#10429）。
セッション:
- 非同期解決が必要なコマンドであっても、常に正しい順序で実行されるようにしました（#85）。
- DefaultMediaNotificationProvider インスタンスを作成するための DefaultMediaNotificationProvider.Builder を追加しましたビルダーは、プロバイダが使用する通知 ID、通知チャンネル ID、通知チャンネル名を設定できます。また、メソッド DefaultMediaNotificationProvider.setSmallIcon(int) を追加して、通知の小さなアイコンを設定できます（#104）。
- MediaController.release() より前に送信されたコマンドがドロップされないようにしました（#99）。
- SimpleBitmapLoader は、file:// URI からビットマップを読み込めます（#108）。
- ある期間に MediaController が広告をシークできないようにするアサーションを修正しました（#122）。
- 再生が終了するとMediaSessionService がフォアグラウンドから停止され、最後に再生されたメディアアイテムを再生するための通知が表示されます（#112）。
- 一時停止のペンディングインテントではフォアグラウンドサービスは開始されません（#167）。
- API 26 と API 27 で DefaultNotificationProvider が作成した、通知に関連付けられた「バッジ」は手動で非表示にします（API 28 以降ではバッジは自動的に非表示になります）（131）。
- 従来の MediaSession から Media3 MediaController への 2 番目のバインダーの接続で IllegalStateExceptions が発生するバグを修正しました（#49）。
RTSP:
- H263 の断片化されたパケットの処理を追加しました（#119）。
- MP4A-LATM のサポートを追加しました（#162）。
IMA:
- IMA SDK の広告の読み込みが進まない場合に、広告情報を読み込むためのタイムアウトを追加しました（#10510）。
- コンテンツの最後に移動するときにミッドロール広告をスキップできないようにしました（#10685）。
- IMA DAI などのサーバーサイドで挿入される広告を含むライブ配信のウィンドウ表示時間が正確に計算されます（#10764）。
FFmpeg 拡張機能:
- FFmpeg ライブラリを NDK 23.1.7779620 以降にリンクするのに必要な新たなフラグを追加しました（#9933）。
AV1 拡張機能:
- 最新の Android Studio リリースとの非互換性の問題を避けるために CMake バージョンを更新しました（#9933）。
Cast 拡張機能:
- MediaController を使用して再生を制御するときに CastPlayer を識別できるように getDeviceInfo() を実装しました（#142）。
Transformer:
- 出力サンプルの生成が遅すぎる場合に検出できるよう、マルチプレクサのウォッチドッグタイマーを追加しました。
サポートが終了したシンボルを削除しました。
- Transformer.Builder.setOutputMimeType(String) を削除しました。この機能は削除されました。デフォルトのマルチプレクサが使用されている場合、MIME タイプは常に MP4 になります。

バージョン 1.0.0-beta02

2022 年 7 月 21 日

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

このリリースは ExoPlayer 2.18.1 リリースに対応しています。

コアライブラリ:
- ExoPlayer.setShuffleOrder で ShuffleOrder を変更すると、reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED で Player.Listener#onTimelineChanged が呼び出されるようにしました（#9889）。
- プログレッシブメディアの場合、選択したトラックのみがバッファリングされた位置に含まれるようになりました（#10361）。
- すべての ExoPlayer ログ出力に対してカスタムの logger を許可しました（#9752）。
- 特定のケースで機能していなかった、DefaultMediaSourceFactory の setDataSourceFactory の実装を修正しました（#116）。
エクストラクタ:
- H265 短期参照画像セットの解析を修正しました（#10316）。
- esds ボックスからのビットレートの解析を修正しました（#10381）。
DASH:
- マニフェストからの ClearKey ライセンス URL を解析しました（#10246）。
UI:
- TalkBack が再生コントロールメニューの現在アクティブな速度オプションを通知するようにしました（#10298）。
RTSP:
- VP8 の断片化されたパケットの処理を追加しました（#110）。
Leanback 拡張機能:
- LeanbackAdapter の playWhenReady の変更をリッスンするようになりました（10420）。
Cast:
- CastTimeline で Window.mediaItem としてプレイリストメソッドに渡された MediaItem を使用するようになりました（#25、#8212）。
- CastPlayer で Player.getMetadata() と Listener.onMediaMetadataChanged() がサポートされるようになりました（#25）。

バージョン 1.0.0-beta01

2022 年 6 月 16 日

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

これは ExoPlayer 2.18.0 リリースに対応しています。

コアライブラリ:
- MediaMetricsManager による Android プラットフォーム診断のサポートを有効にしました。ExoPlayer では再生イベントとパフォーマンスデータがプラットフォームに転送されるため、デバイスのシステムパフォーマンスとデバッグ情報の提供に役立てることができます。このデータは、デバイスのユーザーが使用状況と診断情報の共有を有効にしている場合に、Google によって収集されることもあります。アプリは、ExoPlayer.Builder.setUsePlatformDiagnostics(false) で ExoPlayer のプラットフォーム診断への貢献を無効にできます。
- 字幕をサイドローディングしたり、再生中に選択した字幕を変更したりする場合など、MergingMediaSource の使用時にトラックが頻繁にリセットされるバグを修正しました（#10248）。
- API 29 と 30 で 5G-NSA ネットワークタイプの検出を停止しました。これらの再生は 4G ネットワークを前提としています。
- null を MediaSource.Factory.setDrmSessionManagerProvider、MediaSource.Factory.setLoadErrorHandlingPolicy に渡すことを禁止しました。DefaultDrmSessionManagerProvider と DefaultLoadErrorHandlingPolicy のインスタンスは、必要に応じて明示的に渡すことができます。
- 正確な LocalConfiguration が不明の場合に、メディアの再生に必要なメタデータを表す MediaItem.RequestMetadata を追加しました。また、MediaMetadata.mediaUrl は RequestMetadata に含まれるようになったため削除しました。
- プレーヤーが 1 つの項目を設定できるように Player.Command.COMMAND_SET_MEDIA_ITEM を追加しました。
トラック選択:
- TrackSelectionOverrides クラスを TrackSelectionParameters にフラット化し、TrackSelectionOverride をトップレベルクラスに昇格しました。
- TracksInfo の名前を Tracks に、TracksInfo.TrackGroupInfo の名前を Tracks.Group に変更しました。Player.getCurrentTracksInfo と Player.Listener.onTracksInfoChanged の名前も Player.getCurrentTracks と Player.Listener.onTracksChanged に変更されました。これには、Player.Listener.onTracksChanged メソッド名の「サポート終了解除」も含まれますが、パラメータのタイプが異なります。
- サポートが終了した DefaultTrackSelector.ParametersBuilder ではなく DefaultTrackSelector.Parameters.Builder を返すように、DefaultTrackSelector.buildUponParameters と DefaultTrackSelector.Parameters.buildUpon を変更しました。
- デフォルトで有効化される DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities を追加しました。有効にすると、DefaultTrackSelector は、チャンネル数がデバイスの出力機能を超えないオーディオトラックを優先します。ハンドヘルドデバイスでは、マルチチャンネルフォーマットを空間化できる（Android 12L 以降）場合か、ドルビーサラウンド音声形式である場合を除き、DefaultTrackSelector はマルチチャンネルオーディオフォーマットよりもステレオ / モノラルを優先します。さらに、オーディオ空間化をサポートしているデバイスでは、DefaultTrackSelector が Spatializer プロパティの変更を監視し、これに応じて新しいトラック選択をトリガーします。television UI モードのデバイスは、これらの制約から除外され、チャンネル数が最も多い形式が優先されます。この機能を有効にするには、DefaultTrackSelector インスタンスを Context で作成する必要があります。
動画:
- DummySurface から PlaceholderSurface に名前を変更しました。
- MediaCodecVideoRenderer.getCodecMaxInputSize に AV1 サポートを追加しました。
オーディオ:
- 非標準の MIME タイプをアドバタイズする LG AC3 オーディオデコーダーを使用しました。
- API 21 未満の ART 検証の遅延を防ぐため、AudioAttributes.getAudioAttributesV21() の戻り値の型を android.media.AudioAttributes から新しい AudioAttributesV21 ラッパークラスに変更しました。
- プラットフォーム（API 29 以上）にクエリするか、フォーマットオーディオチャンネル数が設定されていない場合に、オーディオパススルーの音声エンコードチャンネル数を想定しました。これは、HLS チャンクレス準備で発生します（10204）。
- デコーダが 12 チャンネルの PCM オーディオを出力する場合に、AudioTrack にチャンネルマスク AudioFormat.CHANNEL_OUT_7POINT1POINT4 を設定しました（#10322）。
DRM
- 形式変更の直後にシークする場合に、常に DRM セッションが正しく更新されるようにしました（10274）。
テキスト:
- List<Cue> ではなく CueGroup を返すように Player.getCurrentCues() を変更しました。
- SSA: BorderStyle == 3（OutlineColour がキューの背景を設定する）の場合の OutlineColour スタイル設定がサポートされるようになりました（#8435）。
- CEA-708: データを複数のサービスブロックに解析し、現在選択されているサービス番号に関連付けられないブロックを無視しました。
- Google 内部の字幕形式の処理にのみ使用されていた RawCcExtractor を削除しました。
エクストラクタ:
- AVI のサポートを追加しました（#2092）。
- Matroska: Opus トラックの DiscardPadding を解析しました。
- MP4: esds ボックスのビットレートを解析しました。
- Ogg: Opus ID とコメントヘッダーの重複を許可しました（#10038）。
UI:
- useController=false の場合に、PlayerView に設定された OnClickListener へのイベントの配信を修正しました（#9605）。また、すべてのビュー構成でイベントの OnLongClickListener への配信を修正しました。
- ACTION_UP の前の PlayerView の境界を越えるタッチイベントシーケンスをクリックとして誤って扱う問題を修正しました（#9861）。
- タップ操作でコントロールが非表示にならずに、再生が切り替えられる PlayerView のアクセシビリティの問題を修正しました（#8627）。
- ExoPlayer ではなく Player インターフェースと連携するように TrackSelectionView と TrackSelectionDialogBuilder を書き換えました。これにより、ビューを他の Player 実装で使用できるようになり、UI モジュールから ExoPlayer モジュールへの依存関係が削除されます。これは互換性を破る変更です。
- PlayerView トラックセレクタに強制テキストトラックを表示せずに、「なし」が選択されている場合は、適切な強制テキストトラックが選択されるようにしました（#9432）。
DASH:
- DTS AudioChannelConfiguration 要素からチャンネル数を解析しました。これにより、DTS ストリームの音声パススルーが再度有効になります（#10159）。
- null を DashMediaSource.Factory.setCompositeSequenceableLoaderFactory に渡すことを禁止しました。DefaultCompositeSequenceableLoaderFactory のインスタンスは、必要に応じて明示的に渡すことができます。
HLS:
- プレイリストの CODECS 属性にオーディオコーデックが含まれていない場合、チャンクフルの準備にフォールバックしました（#10065）。
- null を HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory、HlsMediaSource.Factory.setPlaylistParserFactory、HlsMediaSource.Factory.setPlaylistTrackerFactory に渡すことを禁止しました。DefaultCompositeSequenceableLoaderFactory や DefaultHlsPlaylistParserFactory のインスタンス、または DefaultHlsPlaylistTracker.FACTORY への参照は、必要に応じて明示的に渡すことができます。
スムーズなストリーミング:
- null を SsMediaSource.Factory.setCompositeSequenceableLoaderFactory に渡すことを禁止しました。DefaultCompositeSequenceableLoaderFactory のインスタンスは、必要に応じて明示的に渡すことができます。
RTSP:
- H263 用の RTP リーダーを追加しました（#63）。
- MPEG4 用の RTP リーダーを追加しました（#35）。
- HEVC 用の RTP リーダーを追加しました（#36）。
- AMR 用の RTP リーダーを追加しました。現在、モノチャンネルの非インターリーブ AMR ストリームのみがサポートされます。複合 AMR RTP ペイロードはサポートされません（#46）。
- VP8 用の RTP リーダーを追加しました（#47）。
- WAV 用の RTP リーダーを追加しました（#56）。
- RTSP 基本認証ヘッダーを修正しました（#9544）。
- 必須の SDP フィールドの確認は、ExoPlayer では不要なため停止しました（#10049）。
- RTSP タイミングを解析するときにチェック済み例外をスローしました（#10165）。
- VP9 用の RTP リーダーを追加しました（#47）。
- OPUS 用の RTP リーダーを追加しました（#53）。
データソース:
- DummyDataSource から PlaceholderDataSource に名前を変更しました。
- OkHttp 割り込み処理の回避策
セッション:
- リクエストを非同期で解決できるように MediaSession.MediaItemFiller を MediaSession.Callback.onAddMediaItems に置き換えました。
- MediaController が従来のメディアセッションに接続する場合の setMediaItems(s) メソッドをサポートしました。
- MediaController.setMediaUri と MediaSession.Callback.onSetMediaUri を削除しました。MediaController.setMediaItem と MediaSession.Callback.onAddMediaItems を使用して同じ機能を実現できます。
- メディアを再生するための従来の MediaController 呼び出しを onSetMediaUri ではなく MediaSession.Callback.onAddMediaItems に転送しました。
- 通知のカスタマイズを行うための MediaNotification.Provider と DefaultMediaNotificationProvider を追加しました。
- アートワークの画像をダウンロードするための BitmapLoader と SimpleBitmapLoader を追加しました。
- 以前のセッションとの下位互換性を維持するための MediaSession.setCustomLayout() を追加しました。
- 以前のセッションと同等の機能を提供するための MediaSession.setSessionExtras() を追加しました。
- MediaSession.MediaSessionCallback の名前を MediaSession.Callback に、MediaLibrarySession.MediaLibrarySessionCallback の名前を MediaLibrarySession.Callback に、MediaSession.Builder.setSessionCallback の名前を setCallback に変更しました。
- MediaControllerImplLegacy の NPE を修正しました（#59）。
- タイムラインの変更に関するセッション位置情報を更新しました（#51）。
- コントローラをリリースした後の MediaControllerImplBase の NPE を修正しました（#74）。
広告の再生 / IMA:
- Media Rating Council（MRC）の推奨事項に合わせて、広告ポーリングレートを 100 ミリ秒ごとから 200 ミリ秒ごとに引き下げました。
FFmpeg 拡張機能:
- CMake バージョンを 3.21.0+ に更新し、CMake のバグにより AndroidStudio の Gradle 同期が失敗するのを回避しました（#9933）。
サポートが終了したシンボルを削除しました。
- Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) を削除しました。代わりに Player.Listener.onTracksChanged(Tracks) を使用してください。
- Player.getCurrentTrackGroups と Player.getCurrentTrackSelections を削除しました。代わりに Player.getCurrentTracks を使用してください。ExoPlayer.getCurrentTrackGroups と ExoPlayer.getCurrentTrackSelections を引き続き使用することもできますが、これらのメソッドは非推奨のままです。
- DownloadHelper、DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT、DEFAULT_TRACK_SELECTOR_PARAMETERS の定数を削除しました。可能であれば getDefaultTrackSelectorParameters(Context) を使用し、それ以外の場合は DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT を使用します。
- コンストラクタ DefaultTrackSelector(ExoTrackSelection.Factory) を削除しました。代わりに DefaultTrackSelector(Context, ExoTrackSelection.Factory) を使用してください。
- Transformer.Builder.setContext を削除しました。代わりに、Context を Transformer.Builder コンストラクタに渡す必要があります。

バージョン 1.0.0-alpha03

2022 年 3 月 14 日

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

これは ExoPlayer 2.17.1 リリースに対応しています。

オーディオ:
- HLS でのドルビーアトモス（E-AC3-JOC）の音声機能に関するエラーを修正しました。
エクストラクタ:
- FMP4: v0 と v1 の両方の emsg アトムスを含むストリームに対して、emsg サンプルメタデータが誤った順序で出力される問題を修正しました（#9996）。
テキスト:
- SubtitleConfiguration フィールドの優先順位を設定し、Factory 値が設定されていない場合はその値に戻すために、SingleSampleMediaSource.Factory.setTrackId と MediaItem.SubtitleConfiguration.Builder.setId のインタラクションを修正しました（#10016）。
広告再生:
- ライブ HLS SSAI ストリームの広告期間における音声アンダーランを修正しました。

バージョン 1.0.0-alpha02

2022 年 3 月 2 日

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

これは ExoPlayer 2.17.0 リリースに対応しています。

コアライブラリ:
- 保護されたメソッド DefaultRenderersFactory.getCodecAdapterFactory() を追加し、buildVideoRenderers() または buildAudioRenderers() をオーバーライドする DefaultRenderersFactory のサブクラスが、コーデックアダプターファクトリにアクセスして MediaCodecRenderer インスタンスに渡せるようにしました。
- ICY ヘッダーフィールド name と genre をそれぞれ MediaMetadata.station と MediaMetadata.genre に反映し、Player.Listener.onMediaMetadataChanged() を介してアプリに到達できるようにしました（#9677）。
- DefaultHttpDataSource#getResponseHeaders から null のキーを削除しました。
- MediaCodec インスタンスの作成に失敗した場合、スリープと再試行を行います。これにより、サーフェスを安全なコーデックから別のコーデックに切り替えたときに一部のデバイスで発生する問題を回避できます（#8696）。
- MediaCodecAdapter.getMetrics() を追加して、ユーザーが MediaCodec から指標データを取得できるようにしました（#9766）。
- Maven の依存関係の解決を修正しました（#8353）。
- 低レイテンシ機能がないライブストリームや、速度設定のユーザーリクエストがないライブストリームについて、自動速度調整を無効にしました（#9329）。
- DecoderCounters#inputBufferCount から queuedInputBufferCount に名前を変更しました。
- SimpleExoPlayer.renderers を非公開にしました。レンダラには ExoPlayer.getRenderer を介してアクセスできます。
- Player.EventFlags の値と一致するように、一部の AnalyticsListener.EventFlags 定数値を更新しました。
- AnalyticsCollector をインターフェースとデフォルトの実装に分割し、アプリで必要ない場合は R8 によって削除されるようにしました。
トラック選択:
- トラック選択での優先動画ロールフラグをサポートしました（#9402）。
- 複数の動画トラックを選択する際に優先する MIME タイプとロールフラグが考慮されるように、動画トラック選択ロジックを更新しました（#9519）。
- デコーダとハードウェアのサポートレベルが同じである自動選択形式のみを選択するように、動画と音声のトラック選択ロジックを更新しました（#9565）。
- プライマリのハードウェアアクセラレーテッドデコーダで複数のコーデックがサポートされている場合は、より効率的なコーデックを優先するように、動画トラック選択ロジックを更新しました（#4835）。
- 技術的なトラック選択の制約（優先 MIME タイプ、最大チャンネル数など）よりも、音声コンテンツの設定（「デフォルト」の音声トラック、システムロケール言語に一致するトラックなど）を優先します。
- あるトラックグループをオーバーライドしても同じタイプの他のトラックグループが無効にならないという、トラック選択の問題を修正しました（#9675）。
- 空でないトラックと空のトラックのオーバーライドが混在していると正しく適用されないという、トラック選択の問題を修正しました（#9649）。
- TrackGroupArray 内の TrackGroup の重複を禁止しました。TrackGroup コンストラクタで id を設定することで、TrackGroup が常に区別できるようになります。これにより、アクティブなトラックのオーバーライドでアプリをバックグラウンド化した後に再生を再開するとクラッシュする問題が修正されます（#9718）。
- 再生がライブエッジに非常に近い場合でも、十分なネットワーク帯域幅があれば品質を向上させられるように、AdaptiveTrackSelection のロジックを修正しました（#9784）。
動画:
- 必要に応じて互換性のある H264/H265 デコーダを使用するように、ドルビービジョンのデコーダフォールバックロジックを修正しました。
オーディオ:
- 必要に応じて互換性のある E-AC3 デコーダを使用するように、ドルビーアトモス（E-AC3-JOC）のデコーダフォールバックロジックを修正しました。
- null ではなく AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES を明示的に渡すことが必須になるように、AudioCapabilities API を変更しました。
- AudioTrackBufferSizeProvider を DefaultAudioSink に挿入することで、AudioTrack バッファサイズの計算をカスタマイズできるようにしました（#8891）。
- リクエストされたバッファサイズが 1 MB を超える場合は、AudioTrack の作成を再試行します（#9712）。
エクストラクタ:
- WAV: RF64 ストリームのサポートを追加しました（#9543）。
- H.265 SPS NAL ユニットの不適切な解析を修正しました（#9719）。
- Ogg Opus ファイルと Ogg Vorbis ファイルの Vorbis コメント（METADATA_BLOCK_PICTURE を含む）を解析します。
テキスト:
- 構成から作成された字幕トラックの Format.id フィールドに反映される MediaItem.SubtitleConfiguration.id フィールドを追加しました（#9673）。
- Matroska コンテナでの WebVTT 字幕の基本的なサポートを追加しました（#9886）。
- 宣言されたサイズを超えるサービスブロックを Cea708Decoder が読み取らないようにしました。
DRM:
- DrmSessionManager.(pre)acquireSession から playbackLooper を削除しました。カスタムの MediaSource でアプリが DrmSessionManager を使用している場合は、代わりに playbackLooper を DrmSessionManager.setPlayer に渡す必要があります。
広告の再生 / IMA:
- IMA ダイナミック広告挿入（DAI）のサポートを追加しました（#8213）。
- 広告グループをリセットしてもう一度再生できるように、AdPlaybackState にメソッドを追加しました（#9615）。
- 広告の再生時、再生速度 1.0 を強制適用します（#9018）。
- 広告グループの読み込みに失敗するとすぐに再生がリセットされる問題を修正しました（#9929）。
UI:
- 特定のテーマを使用している場合の、StyledPlayerView の巻き戻しボタンと早送りボタンの数字の色を修正しました（#9765）。
- 再生速度の文字列を正しく解釈するようになりました（#9811）。
DASH:
- 解析した必須プロパティと補足プロパティを Representation に追加しました（#9579）。
- forced-subtitle トラックロールをサポートしました（#9727）。
- main トラックロールを C.SELECTION_FLAG_DEFAULT として解釈しないようにしました。
- DVB 名前空間を宣言していないマニフェストのベース URL 除外ロジックを修正しました（#9856）。
- 相対 MPD.Location URL をサポートしました（#9939）。
HLS:
- 音声のみの HLS ストリームの Format.label を正しく入力できるようになりました（#9608）。
- 起動時間を改善するためにデフォルトでチャンクレス準備を使用します。マスタープレイリストで宣言されていないクローズドキャプショントラックが描出に含まれている場合は、マスタープレイリストに追加して再生できるようにするか、HlsMediaSource.Factory.setAllowChunklessPreparation(false) でチャンクレス準備をオフにする必要があります。
- HLS でのキーフレームの正確なシークをサポートしました（#2882）。
RTSP:
- 任意のサーバー接続に使用される SocketFactory をオーバーライドするクライアント API を提供しました（#9606）。
- DIGEST と BASIC がどちらも存在する場合、DIGEST 認証方式を優先します（#9800）。
- RTSP トラックタイミングを利用できない場合に対応しました（#9775）。
- 無効な RTP-Info ヘッダー値を無視するようになりました（#9619）。
Transformer:
- 必要な最小 API バージョンを 21 に増やしました。
- TransformationException は、変換中に発生するエラーの記述に使用されるようになりました。
- 変換オプションを指定するための TransformationRequest を追加しました。
- 複数のリスナーを登録できるようになりました。
- コーデック出力が部分的に読み取られたときに Transformer が停止する問題を修正しました。
- muxer スローを解放するときに Transformer.getProgress で発生する可能性がある NPE を修正しました。
- 変換を適用するためのデモアプリを追加しました。
MediaSession 拡張機能:
- デフォルトで、停止時に MediaSessionConnector がプレイリストを消去するようになりました。プレイリストを保持する必要があるアプリは、コネクタで setClearMediaItemsOnStop(false) を呼び出すことができます。
Cast 拡張機能:
- CastPlayer が onIsPlayingChanged を正しく呼び出せないバグを修正しました（#9792）。
- DefaultMediaItemConverter を使用したアートワークを含む音声メタデータをサポートしました（#9663）。
FFmpeg 拡張機能:
- build_ffmpeg.sh が GNU ではなく LLVM の bin utils に依存するようになりました（#9933）。
Android 12 の互換性:
- com.google.android.gms:play-services-cast-framework:20.1.0 に依存するように Cast 拡張機能をアップグレードしました。以前のバージョンの play-services-cast-framework は Android 12 をターゲットとするアプリに対応しておらず、PendingIntent の作成時に IllegalArgumentException でクラッシュします（#9528）。
サポートが終了したシンボルを削除しました。
- Player.EventListener を削除しました。代わりに Player.Listener を使用してください。
- MediaSourceFactory#setDrmSessionManager、MediaSourceFactory#setDrmHttpDataSourceFactory、MediaSourceFactory#setDrmUserAgent を削除しました。代わりに MediaSourceFactory#setDrmSessionManagerProvider を使用してください。
- MediaSourceFactory#setStreamKeys を削除しました。代わりに MediaItem.Builder#setStreamKeys を使用してください。
- MediaSourceFactory#createMediaSource(Uri) を削除しました。代わりに MediaSourceFactory#createMediaSource(MediaItem) を使用してください。
- DashMediaSource、HlsMediaSource、SsMediaSource から setTag を削除しました。代わりに MediaItem.Builder#setTag を使用してください。
- DashMediaSource#setLivePresentationDelayMs(long, boolean) を削除しました。MediaItem.Builder#setLiveConfiguration と MediaItem.LiveConfiguration.Builder#setTargetOffsetMs を使用してマニフェストをオーバーライドするか、DashMediaSource#setFallbackTargetLiveOffsetMs を使用してフォールバック値を提供してください。
- (Simple)ExoPlayer.setThrowsWhenUsingWrongThread を削除しました。スレッドの強制適用をオプトアウトすることはできなくなりました。
- ActionFile と ActionFileUpgradeUtil を削除しました。ExoPlayer 2.16.1 以前で ActionFileUpgradeUtil を使用して、以前のアクションファイルを DefaultDownloadIndex に統合してください。
- ProgressiveMediaSource#setExtractorsFactory を削除しました。代わりに ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) コンストラクタを使用してください。
- ProgressiveMediaSource.Factory#setTag と ProgressiveMediaSource.Factory#setCustomCacheKey を削除しました。代わりに MediaItem.Builder#setTag と MediaItem.Builder#setCustomCacheKey を使用してください。
- DefaultRenderersFactory(Context, @ExtensionRendererMode int) コンストラクタと DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) コンストラクタを削除しました。代わりに DefaultRenderersFactory(Context) コンストラクタ、DefaultRenderersFactory#setExtensionRendererMode、DefaultRenderersFactory#setAllowedVideoJoiningTimeMs を使用してください。
- すべてのパブリック CronetDataSource コンストラクタを削除しました。代わりに CronetDataSource.Factory を使用してください。
次の IntDefs を @Target(TYPE_USE) のみに変更しました。Kotlin での使用のコンパイルが失敗するおそれがありますが、アノテーションを移動して型（Int）にアノテーションを付けることで修正できます。
- @AacAudioObjectType
- @Ac3Util.SyncFrameInfo.StreamType
- @AdLoadException.Type
- @AdtsExtractor.Flags
- @AmrExtractor.Flags
- @AspectRatioFrameLayout.ResizeMode
- @AudioFocusManager.PlayerCommand
- @AudioSink.SinkFormatSupport
- @BinarySearchSeeker.TimestampSearchResult.Type
- @BufferReplacementMode
- @C.BufferFlags
- @C.ColorRange
- @C.ColorSpace
- @C.ColorTransfer
- @C.CryptoMode
- @C.Encoding
- @C.PcmEncoding
- @C.Projection
- @C.SelectionReason
- @C.StereoMode
- @C.VideoOutputMode
- @CacheDataSource.Flags
- @CaptionStyleCompat.EdgeType
- @DataSpec.Flags
- @DataSpec.HttpMethods
- @DecoderDiscardReasons
- @DecoderReuseResult
- @DefaultAudioSink.OutputMode
- @DefaultDrmSessionManager.Mode
- @DefaultTrackSelector.SelectionEligibility
- @DefaultTsPayloadReaderFactory.Flags
- @EGLSurfaceTexture.SecureMode
- @EbmlProcessor.ElementType
- @ExoMediaDrm.KeyRequest.RequestType
- @ExtensionRendererMode
- @Extractor.ReadResult
- @FileTypes.Type
- @FlacExtractor.Flags（com.google.android.exoplayer2.ext.flac パッケージ）
- @FlacExtractor.Flags（com.google.android.exoplayer2.extractor.flac パッケージ）
- @FragmentedMp4Extractor.Flags
- @HlsMediaPlaylist.PlaylistType
- @HttpDataSourceException.Type
- @IllegalClippingException.Reason
- @IllegalMergeException.Reason
- @LoadErrorHandlingPolicy.FallbackType
- @MatroskaExtractor.Flags
- @Mp3Extractor.Flags
- @Mp4Extractor.Flags
- @NotificationUtil.Importance
- @PlaybackException.FieldNumber
- @PlayerNotificationManager.Priority
- @PlayerNotificationManager.Visibility
- @PlayerView.ShowBuffering
- @Renderer.State
- @RendererCapabilities.AdaptiveSupport
- @RendererCapabilities.Capabilities
- @RendererCapabilities.DecoderSupport
- @RendererCapabilities.FormatSupport
- @RendererCapabilities.HardwareAccelerationSupport
- @RendererCapabilities.TunnelingSupport
- @SampleStream.ReadDataResult
- @SampleStream.ReadFlags
- @StyledPlayerView.ShowBuffering
- @SubtitleView.ViewType
- @TextAnnotation.Position
- @TextEmphasisSpan.MarkFill
- @TextEmphasisSpan.MarkShape
- @Track.Transformation
- @TrackOutput.SampleDataPart
- @Transformer.ProgressState
- @TsExtractor.Mode
- @TsPayloadReader.Flags
- @WebvttCssStyle.FontSizeUnit

バージョン 1.0.0-alpha01

2021 年 10 月 27 日

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

新機能

Media3 は、ExoPlayer を含むメディアサポートライブラリの新しいホームです。最初のアルファ版には、メディアのユースケースを実装するためのライブラリの機能の初期実装が含まれています。

カスタマイズと拡張が簡単な Android 用のアプリレベルのメディアプレーヤーである ExoPlayer。
再生を公開して制御するためのメディアセッション機能。この新しいセッションモジュールは、ExoPlayer と同じ Player インターフェースを使用します。
メディア再生のユーザーインターフェースを作成するための UI コンポーネント。
IMA SDK による広告の挿入など、ExoPlayer で使用する他のライブラリの機能をラップするモジュール。

詳しくは、Media3 GitHub プロジェクトをご覧ください。

ExoPlayer は、以前は別の ExoPlayer GitHub プロジェクトでホストされていました。Media3 のパッケージ名は androidx.media3.exoplayer です。しばらくの間、ExoPlayer GitHub プロジェクトの維持とリリースを続け、アプリが Media3 に移行できるようにする予定です。Media3 には、ExoPlayer のすべてのモジュールの置き換えが用意されています。ただし、以前の media2 と mediasession 拡張機能は新しい media3-session モジュールに置き換えられています。これにより、アダプターやコネクタのクラスを使用する必要なく、プレーヤーとメディアセッションを直接統合できます。