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

Media3

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

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2025 年 10 月 22 日	1.8.0	-	-	1.9.0-alpha01

依存関係の宣言

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

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

Groovy

dependencies {
    def media3_version = "1.8.0"

    // 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 using Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs using Views
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs using Jetpack Compose
    implementation "androidx.media3:media3-ui-compose:$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.8.0"

    // 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 using Compose
    implementation("androidx.media3:media3-ui-compose:$media3_version")
    // For building media playback UIs using Views
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs using Jetpack Compose
    implementation("androidx.media3:media3-ui-compose:$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.9.0

バージョン 1.9.0-alpha01

2025 年 10 月 22 日

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

共通ライブラリ:
- 他の AndroidX ライブラリに合わせて minSdk を 23 に更新しました。
- PlayerTransferState を追加しました。これにより、Player インスタンス間で再生状態を簡単に転送できます。
- Player に void mute() メソッドと void unmute() メソッドを追加します。これにより、Player の音量をゼロに設定する前後に Player の音量を保持して復元します。
- 以前は ExoPlayer が内部で使用していたユーティリティクラス WakeLockManager、WifiLockManager、AudioFocusManager、AudioBecomingNoisyManager、StuckPlayerDetector を公開し、他のプレーヤーが再利用できるようにしました（#1893）。
- 基盤となるデリゲートプレーヤーがリスナーインスタンスの比較に参照の等価性を使用する場合の ForwardingPlayer リスナーの処理を修正しました（#2675）。
- media3-common-ktx ライブラリに、処理対象の特定の Player.Events を指定する Player.listenTo 拡張関数を追加します。
- 報告されたバッファリングされた位置が報告された再生時間よりも大幅に大きい場合に、整数オーバーフローが原因で BasePlayer.getBufferedPercentage でクラッシュする問題を修正（#2750）。
ExoPlayer:
- プレーヤーが動かなくなった場合に StuckPlayerException プレーヤーエラーをトリガーする、動かなくなったプレーヤーの検出を追加します。これは次のケースで発生します。各デフォルトタイムアウトは、必要に応じて ExoPlayer.Builder で構成できます。
  - 再生を試みている間、STATE_BUFFERING が 10 分間続き、バッファリングが進まない場合。
  - 再生を試みている間、STATE_READY が 10 秒間経過しても再生が進まない場合。
  - アイテムの終了に達することなく、宣言された期間を超えて 1 分間 STATE_READY が続いた場合。
  - 再生を試みているときに、再生抑制の理由が 10 分間続いた場合。
- バックグラウンド再生中のバッファリングに関する問題を修正するため、ウェイクロック処理をデフォルトで有効化。これは、ExoPlayer.Builder.setWakeMode を C.WAKE_MODE_LOCAL に設定するのと同じです。
- ExoPlayer.Builder に最初に渡された Context に変更が報告されたときに、仮想デバイス ID を自動的に更新するリスニングロジックを追加します。
- ExoPlayer.setVirtualDeviceId を追加して、ExoPlayer.Builder に渡された Context から取得した仮想デバイス ID を手動で更新します。
- レンダラが、現在のアイテムの終了 10 秒以上前に次のプレイリストアイテムのデータを消費しないようにします。
- setSeekBackIncrementMs、setSeekForwardIncrementMs、setMaxSeekToPreviousPositionMs を ExoPlayer に追加して、構築後にこれらの設定を更新します（#2736）。
- DefaultPreloadManager にプリキャッシュ機能を追加します。アプリは、TargetPreloadStatusControl.getTargetPreloadStatus(T rankingData) を介して DefaultPreloadManager.PreloadStatus.specifiedRangeCached(startPositionMs, durationMs) または DefaultPreloadManager.PreloadStatus.specifiedRangeCached(durationMs) を返すことで、メディアアイテムをプリキャッシュする必要があることを示すことができるようになりました。
- ショートフォームデモアプリで DefaultPreloadManager のプリキャッシュ機能を使用します。
- ローカル再生用の DefaultLoadControl.Builder セッターを追加し、幅広いローカルファイルで適切に動作するように DefaultLoadControl のデフォルト値を調整しました。
- 空のプレイリストを設定するとプレーヤーが STATE_READY または STATE_BUFFERING の状態になるバグを修正
- プリロードマネージャー API を強化:
  - メディアアイテムまたはメディアソースを一括で追加し、その後 invalidate() を自動的に呼び出す addMediaItems(List<MediaItem>, List<T>) と addMediaSources(List<MediaSource>, List<T>) を追加します。
  - メディアアイテムまたはメディアソースを一括で削除する removeMediaItems((List<MediaItem>) と removeMediaSources(List<MediaSource>) を追加し、削除後にプリロードマネージャーがそれらのプリロードを開始または継続しないようにします。
  - DefaultPreloadManager.setCurrentPlayingIndex(int) が自動的に無効になるようにします。現在の再生インデックスを更新した後、アプリが invalidate() を明示的に呼び出す必要はなくなりました。
- スクラブモードで、同じ写真グループ内の前方シークでキーフレームのリセットをスキップする機能を追加。
- アプリが指定された playerName を持つプレーヤーのターゲットバッファバイトの値を設定するための DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int) を追加しました。DefaultLoadControl は、割り当てられたバイト数とターゲットバッファバイト数に基づいて、各プレーヤーの決定を個別に行うことができるようになりました。
- AdPlaybackState.AdGroup に SkipInfo を追加して、広告グループ内の各広告のスキップ情報を伝えます。
- ポストロールの再生中に removeMediaItems(List) を呼び出すとクラッシュが発生するバグを修正しました（#2746）。
- フレームが常に最後のサンプルとして設定され、レンダリングされていたため、プレイリストの再生で発生していたスタッタリングを修正
- プレーヤーがオーディオセッション ID を生成できない場合に再試行パスを有効化（#2382、#2678）。
- DefaultPreloadManager のソースの合計バッファバイト数を制御するサポートを追加して、プリロードの合計バッファバイト数が任意に増加しないようにします。デフォルトの制御ロジックを使用するには、アプリは PlayerId.Preload.name（「preload」）の playerName の DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int) を介してプリロードのターゲットバッファバイトを設定し、作成された DefaultLoadControl を DefaultPreloadManager.Builder.setLoadControl(LoadControl) を介して挿入できます。
CompositionPlayer:
- CompositionPlayer を新しい @ExperimentalApi アノテーションで公開し、テストには使用できるものの、まだ開発中であることを示します。一部の API は今後のリリースで大幅に変更される可能性があり、一部のユースケース（一部はドキュメント化されていません）には既知の問題と制限事項があります。
- CompositionPlayer で COMMAND_SET_AUDIO_ATTRIBUTES と音声フォーカス処理のサポートを追加
- CompositionPlayer のセカンダリシーケンスでの速度変更のサポートを追加。
Transformer:
- デフォルトの muxer として InAppMp4Muxer を使用します。
- EditedMediaItem.Builder#setSpeed() を追加し、Effects#createExperimentalSpeedChangingEffects() を非推奨にします。
- EditedMediaItemSequence で forceAudioTrack と forceVideoTrack を trackTypes に置き換えます。
トラックの選択:
- TrackSelectionParameters.selectTextByDefault を追加して、他のより具体的な設定を指定せずに、任意のテキストトラックの選択を優先します。
- TrackSelectionParameters に preferredVideoLabels、preferredAudioLabels、preferredTextLabels を追加して、特定のラベルが付いたトラックの優先順位を指定します。たとえば、HLS NAME タグから読み取られたトラックなどです（#1666）。
エクストラクタ:
- FLAC: ヘッダー検出を厳密化し、エンコードされた FLAC データでスプリアスヘッダーが検出される可能性を減らして、デコードエラーを回避（#558）。
- MP3: MP3 ファイルの先頭にある ID3 タグの間（および前）にギャップを許可（#811、#5718）。
- MP4: エクストラクタからトラック形式を出力する前に、最初のサンプルのレイヤ値を覗き見することで、audio/mpeg（MP3）、audio/mpeg-L1、audio/mpeg-L2 の MIME タイプの区別を行います（#2683）。
- MP4: 1 MB を超える stbl ボックスはファイルがフラグメント化されていないことを意味すると仮定することで、非常に大きなファイルのスニッフィング効率を改善（#2650）。
- Matroska: DTS-HD 検出のサポートを追加しました（#6225）。
- 複数のトラックを含むファイルでシークが不正確になる可能性がある MatroskaExtractor の問題を修正しました。キューポイントがそれぞれのトラックに正しく関連付けられるようになり、より正確なシークが可能になりました。
- MP4: ©mvn（ムーブメント名）と ©mvi（ムーブメントインデックス）のメタデータのサポートを追加しました。これらは、Format.metadata の TextInformationFrame オブジェクトとして、それぞれ MVNM と MVIN の ID で出力されるようになりました（#2754）。
- MPEG-TS: タイムスタンプのない PES パケットが原因で ReorderingBufferQueue から IllegalArgumentException が発生する問題を修正しました（#2764）。
- MP4: stsd ボックスがないトラックを無視します（ファイル全体の解析に失敗する代わりに）。
- HEIC モーションフォトの抽出のサポートを追加。HeifExtractor で、埋め込みの動画トラックと音声トラックを含む HEIC ファイルを解析できるようになりました。
- MP3: FLAG_ENABLE_INDEX_SEEKING を変更して、メタデータヘッダー（Xing や VBRI など）から情報を取得することを優先し、他のシーク情報がない場合はインデックスベースのシークにフォールバックするようにしました。これにより、シークメタデータを含むファイルのパフォーマンスが向上します（#2839）。
検査官:
- メディア検査ユーティリティ専用のホームとして機能する新しい :media3-inspector モジュールが導入されました。このモジュールには、メタデータとフレーム抽出の両方に統一された API を提供する新しい androidx.media3.inspector.MetadataRetriever が含まれています。既存の androidx.media3.exoplayer.MetadataRetriever は非推奨となり、この新しいバージョンに置き換えられました。
- フレーム抽出用の新しい公開 API である androidx.media3.inspector.FrameExtractor を導入しました。この AutoCloseable クラスは、HDR 動画、動画エフェクト、カスタムデコーダ選択をサポートするフレームを抽出する方法を提供します。特定の MediaItem の Builder を介して作成する必要があります。
- FrameExtractor: 特定のタイムスタンプを必要とせずにメディアファイルから代表的なサムネイルフレームを抽出する getThumbnail() を追加
オーディオ:
- AudioProcessor インスタンスにシークを認識させます。
- カスタムオーディオ出力パスをサポートするため、新しい AudioOutputProvider インターフェースを DefaultAudioSink.Builder に挿入できるようにします。デフォルトは AudioTrackAudioOutputProvider です。
- GainProcessor でシークを処理します。
- トラック形式のサポート評価で AC-4 デコーダのプロファイルとレベルの機能を利用します（#2580）。
- 再生の開始時にルーティング変更コールバックを処理することによる遅延の可能性を回避（#2646）。
- EAC3、EAC3-JOC、AC-4 形式のコーデックの再利用を許可（#1346）。
- Sonic での浮動小数点 PCM サンプルのサポートを追加。
- ToFloatPcmAudioProcessor で 16 ビット PCM サンプルのサポートを追加。
動画:
- プロファイルが異なる Dolby-Vision コンテンツのコーデックの再利用を無効化。
テキスト:
- ドルビービジョンコンテンツの CEA-6/708 字幕の解析を修正しました（#2775）。
画像:
- DASH サムネイルトラックのスクラブ中にプレーヤーが停止する ScrubbingMode の問題を修正しました（#2815）。
DRM:
- MediaDrmCallback メソッドの戻り値の型を byte[] から新しい MediaDrmCallback.Response 型に変更し、追加のオプション情報を返せるようにしました。これはソースの互換性を破る変更ですが、以前の byte[] の戻り値を new Response でラップしてから返すことで、簡単に解決できます。
- URL やレイテンシなどのキーリクエスト情報を AnalyticsListener.onDrmKeysLoaded に追加しました（#1001）。
- プロビジョニングリクエストデータを URL パラメータから POST 本文に移動します。
Muxer:
- フレームワーク MediaMuxer のドロップイン代替として MediaMuxerCompat を追加しました。
- モーションフォトの作成を許可する MuxerUtil.createMotionPhotoFromJpegImageAndBmffVideo() を追加しました。
- WebmMuxer を追加して、OPUS、VORBIS、VP8、VP9 のメディアストリームを webm ファイル形式に多重化できるようにします。
IMA 拡張機能:
- カスタム ProGuard ルールを削除し、アプリが IMA Android アーカイブでリリースされたルールを使用できるようにしました。
- IMA SDK が Google アドマネージャーの設定で指定された広告識別子を処理するための Google アドマネージャーのネットワークコードを設定する新しい API ImaServerSideAdInsertionUriBuilder.setNetworkCode を追加しました。ネットワークコードは省略可能ですが、フルサービスストリームリクエストでは指定することをおすすめします。ネットワークコードを確認するには、こちらの記事をご覧ください。
- IMA の依存関係を 3.37.0 に引き上げました。これにはコアライブラリの逆糖衣処理を有効にする必要があります。これは、依存アプリでも有効にする必要があります。IMA の構成に関する注意事項をご覧ください。
- SSAI URI ビルダーで IMA DAI カスタム UI オプションをサポート。サーバーサイド広告挿入のカスタム UI オプションには、「スキップ可能」と「この広告について」のレンダリングサポートが含まれます。この機能は現在、許可リストに登録されている一部のパブリッシャー様のみご利用いただけます。この変更により、カスタム UI オプション API にアクセスするために、IMA SDK のバージョンも 3.38.0（リリースノート）にアップグレードされます。
セッション:
- MediaSession.Callback.onPlaybackResumption に新しいパラメータを追加して、呼び出しが情報の収集のみを目的とするのか、再生の開始を目的とするのかを示すようにしました（#1764）。
- MediaSession.ControllerInfo.isTrusted を更新して、独自のアプリのコントローラも信頼できるものとして宣言するようにしました（#2542）。
- 通知の更新を手動でトリガーする MediaSessionService.triggerNotificationUpdate を追加しました（#1833）。
- カスタムコマンドメソッドに ProgressListener を追加します。
- MediaLibrarySession.Builder.setLibraryErrorReplicationMode のデフォルト値を非致命的に変更します。
- MediaButtonReceiver.onForegroundServiceStartNotAllowedException に Context パラメータを追加（#2625）。
- バインダ経由で取得するのではなく、プラットフォーム PlaybackInfo から音量コントロール ID を読み取ります。これにより、再生タイプと音量制御 ID がアトミックに読み取られ、互いに一致します。
- ACTION_UP キーイベントがフィルタリングされ、カスタム処理のコールバックに渡されないバグを修正しました。これにより、media1 の動作とプラットフォームの動作が同等になります（#2637）。
- コマンドが使用できない場合でも PlayerWrapper によって getCurrentTimeline() が呼び出されるバグを修正しました（#2665）。
- サービス終了後にメモリリークを引き起こすメッセージがメインのルーパーのメッセージキューに残るバグを修正しました（#2692）。
- MediaBrowser を使用して以前のセッションアプリに接続している場合、カスタムコマンドは、カスタムアクションが以前のセッションの PlaybackStateCompat でカスタムアクションとしてアドバタイズされている場合にのみセッションに送信されます。他のすべてのカスタムアクションはサービスに送信されます。
- セッションによってオーディオセッション ID が設定されたときにメディアコントローラに通知する onAudioSessionIdChanged を実装しました（#244）。
- onStartCommand() にメディアキーイベント Intent が届いたときに KEYCODE_HEADSETHOOK がプレーヤーを起動しないバグを修正しました。これは、KEYCODE_MEDIA_PLAY_PAUSE（#2816）と同様に「KEYCODE_HEADSETHOOK」を処理することで修正されます。
- セッションとコントローラの間でサーフェスのサイズが伝達されず、デモセッションで動画エフェクトを適用できないバグを修正コントローラを使用している場合、プレーヤーが setVideoSurfaceHolder 呼び出しを処理できないと、互換性が損なわれる可能性があります。
- span スタイルの文字列（#2853）など、String 以外の CharSequence メタデータ値の伝播を修正しました。
UI:
- ProgressStateWithTickInterval クラスと対応する rememberProgressStateWithTickInterval コンポーザブルを media3-ui-compose モジュールに追加します。この状態ホルダーは、demo-compose で現在の位置と再生時間をテキスト形式で表示するために使用されます。
- Player 音量のミュートを処理する ui-compose に MuteButtonState を追加します。この状態ホルダーは、demo-compose でミュート/ミュート解除の切り替えボタンを表示するために使用されます。
- ProgressStateWithTickCount クラスと対応する rememberProgressStateWithTickCount コンポーザブルを media3-ui-compose モジュールに追加します。この状態ホルダーは、demo-compose で進行状況を水平方向の読み取り専用の進行状況バーとして表示するために使用されます。
- PlayerSurface の管理と、シャッターによるアスペクト比のサイズ変更とカバーを組み合わせた ContentFrame コンポーザブルを media3-ui-compose に追加します。
- Compose AndroidView 内で SurfaceView を使用すると、動画が引き伸ばされたり切り取られたりする API 34 プラットフォームの既知のバグを回避します。これにより、SURFACE_TYPE_SURFACE_VIEW を含む ContentFrame と PlayerSurface コンポーザブルに影響します（#1237、#2811）。
- 新しい media3-ui-compose-material3 モジュールを作成し、Material3 テーマのコンポーザブル（PlayPauseButton、NextButton、PreviousButton、SeekBackButton、SeekForwardButton、RepeatButton、ShuffleButton、MuteButton）を追加します。
- PlayerView にメディアルートボタンを配置するためのサポートを追加しました。
HLS 拡張機能:
- HLS インタースティシャルスキップ属性を解析します。
- HLS プレイリストとアセットリストドキュメントのスキップ制御属性を AdPlaybackState にマッピングして、一般公開します。
- プレイリストの開始時間を定義する EXT-X-PROGRAM-START-DATE タグがプレイリストから削除されたときに、プレイリストの開始時間がドロップされるバグを修正しました（#2760）。
- バイナリ検索を使用して、プレイリスト内の指定された位置のセグメントインデックスを見つけます（#2826）。
DASH 拡張機能:
- 階層構造のない data: URI マニフェストで DASH ストリームを再生する際の UnsupportedOperationException を修正しました（#2688）。
- リリース時と、ユーザーがメディアアイテムを更新したときに、LiveConfiguration を DashMediaSource の MediaItem が提供する値にリセットします（#2606）。
- プレーヤーエラーとして報告されなかった無効なマニフェスト更新によって発生するクラッシュを回避しました（#2805）。
RTSP 拡張機能:
- H264 および H265 の断片化された NAL ユニットを処理する際に、RTP パケットの欠落エラーを処理します（#2613）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- AV1 拡張機能: AV1 ソフトウェアデコーダで、以前の libgav1 実装に代わって、高性能の dav1d ライブラリが使用されるようになりました。これにより、デコード速度が向上します。
Cast 拡張機能:
- CastPlayer.Builder を追加します。これにより、CastPlayer でローカル再生とキャスト再生の両方が可能になります。以前の CastPlayer の動作（Cast 再生のみをサポート）を維持するには、RemoteCastPlayer を使用します。既存の CastPlayer コンストラクタは以前の動作を維持しますが、代わりに CastPlayer または RemoteCastPlayer ビルダーを使用することが推奨されます。
- DefaultMediaItemConverter で null 以外の MIME タイプの適用を停止します。
- 利用可能な場合は、MediaItem.mediaMetadata.mediaType を使用して、DefaultCastOptionsProvider#toMediaQueueItem で使用する Cast の MEDIA_TYPE を推測します。
- DefaultCastOptionsProvider でリモートからローカルへの転送を有効にします。
- セッションデモで Cast のサポートを追加。
- コンポーザブル UI にメディアルートボタンを表示するためのサポートを追加。
- アクションバーメニューにメディアルートボタンを表示するためのサポートを追加。
- メディアルートボタンを View UI として表示するためのサポートを追加します。
テストユーティリティ:
- FakeClock の自動進行動作の最大時間差を追加。デフォルトは 1 秒ですが、FakeClock.Builder で構成できます。
- RobolectricUtil.runMainLooperUntil（および runLooperUntil）のメッセージ間の最大時間差を追加。デフォルトは 1 秒ですが、これらのメソッドの新しいオーバーロードで構成できます。
- CapturingRenderersFactory を test-utils から test-utils-robolectric に移動しました。
サポートが終了したシンボルを削除しました。
- 非推奨の DefaultPreloadManager コンストラクタを削除しました。代わりに DefaultPreloadManager.Builder を使用してください。
- 非推奨の EditedMediaItemSequence コンストラクタを削除しました。代わりに EditedMediaItemSequence.Builder を使用してください。

バージョン 1.8.0

2025 年 7 月 30 日

バージョン 1.8.0 にはこれらの commit が含まれています。

共通ライブラリ:
- ForwardingSimpleBasePlayer でのプレーヤーの置き換えのサポートを追加しました。
ExoPlayer:
- シャッフルモードのゲッターを ExoPlayer インターフェースに追加しました（#2522）。
- 複数のスレッドから DefaultAudioSink にアクセスした場合に、例外をより明確にスローします。プレーヤーの外部で RendererCapabilities.getFormatSupport を呼び出したことが原因でこのエラーが発生した場合は、ExoPlayer の再生スレッドと同じスレッドでこのメソッドを呼び出すか、再生に使用したインスタンスとは別のインスタンスを使用してください（#1191）。
- テレビの非ステレオオーディオ形式が DefaultTrackSelector でサポート対象外としてマークされる可能性があるバグを修正しました。
- MediaCodec の DECODE_ONLY フラグ（スクラビングモードではデフォルトで有効）を使用する際に、最後のフレームが正しくレンダリングされるようにします。
- ExoPlayer.Builder に渡された Context から仮想デバイス ID を使用するためのサポートを追加しました。
- スクラブモードで動的スケジューリングをデフォルトで有効にします。
- アイテムの末尾にシークするときに、不要なソースの再読み込みを回避。
- スクラブモードでは、デフォルトで MediaCodec.BUFFER_FLAG_DECODE_ONLY を使用します。
- プリロードスレッドとは異なる再生スレッドを持つ ExoPlayer によって PreloadMediaSource が再生されるときに IllegalStateException をスローします（#2495）。
- デフォルト実装で cloneAndMove を ShuffleMode に追加しました（#2226）。
- render の呼び出しが必要ない場合に、より大きな値を返すように Renderer.getMinDurationToProgressUs のデフォルトの動作を変更。
- 一時停止中にシークバーを最後まで移動すると、内部スケジューリングによって最後のフレームが遅延するバグを修正現時点では、このバグ修正は ExoPlayer.Builder.experimentalSetDynamicSchedulingEnabled が有効になっている場合にのみ有効になります。
- ExoPlayer.setScrubbingModeEnabled(boolean) メソッドを追加します。これにより、頻繁なシーク（ユーザーがスクラバーバーをドラッグするなど）に対してプレーヤーが最適化されます。スクラブモードの動作は、ExoPlayer と ExoPlayer.Builder の setScrubbingModeParameters(..) でカスタマイズできます。
- スクラビングモードで分数シーク許容値をカスタマイズできるようにします。
- スクラビングモードでコーデックの動作レートを上げます。
- AdsMediaSource のコンテンツの準備エラーが報告されないことがあるバグを修正しました（#2337）。
- 字幕をサイドローディングする際などに使用される MergingMediaSource のメモリリークを修正しました（#2338）。
- CmcdConfiguration.Factory が null を返して、特定のメディアアイテムの CMCD ロギングを無効にできるようにします（#2386）。
- デフォルトの画像バッファサイズを 128 KB（テキストトラックからのコピー＆ペーストの誤り）から 26 MB に増やしました。これは 50 MP のウルトラ HDR 画像に十分な大きさです（#2417）。
- アプリが指定された開始位置と再生時間で単一のメディアをプリキャッシュできるようにする PreCacheHelper を追加
- DefaultPreloadManager の指定された位置からのプリロードのサポートを追加。
Transformer:
- 動画エンコード設定のチップセット固有の最適化を可能にする CodecDbLite を追加
- DefaultEncoderFactory に setEnableCodecDbLite フラグを追加して、CodecDB Lite 設定の最適化を有効化デフォルトでは、このフラグは false に設定されています。
- （addGap() で追加された）最初のギャップを無音音声で埋めるには、EditedMediaItemSequence.Builder で experimentalSetForceAudioTrack(true) を明示的に設定する必要があります。ギャップがシーケンスの中間にある場合、このフラグは必要ありません。
- Muxer インターフェースを media3-transformer から media3-muxer に移動します。
- メディアアイテムを画像としてインポートする際に MediaItem.Builder().setImageDuration(long) 設定を必須にします。
- トリミング時に MP4 編集リストを含む Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean) を追加して、トリミング開始点の前のキーフレームとトリミング開始点の間のサンプルを無視するようプレーヤーに指示します。
- Kotlin と Jetpack Compose を使用するように Composition Demo アプリを更新し、シーケンスを 2x2 または PiP レイアウトに配置するカスタム VideoCompositorSettings を追加しました。
エクストラクタ:
- 断片化された MP4 ファイルからメタデータを解析します（#2084）。
- JPEG: 先頭に Exif セグメントがないモーションフォトをサポート（#2552）。
- 複数の sidx アトムを含むフラグメント化された MP4 でのシークのサポートを追加します。この動作は、FragmentedMp4Extractor の FLAG_MERGE_FRAGMENTED_SIDX フラグを使用して有効にできます（#9373）。
- FLAC ファイル内の空のシークテーブル（プレースホルダシークポイントのみを含むものを含む）を無視し、ファイルの再生時間がわかっている場合はバイナリ検索シークにフォールバックします（#2327）。
- H.265 SEI ユニットの解析を修正し、認識されない SEI タイプを完全にスキップするようにしました（#2456）。
- WAVE_FORMAT_EXTENSIBLE タイプのファイルを解析する際に、ヘッダー拡張機能の SubFormat データを使用して音声形式を取得するように WavExtractor を更新
- MP4: 未加工の PCM オーディオトラックを定義する ipcm ボックスと fpcm ボックスのサポートを追加しました（64 ビット浮動小数点 PCM はサポートされていません）。
- MP4: 動画を回転および反転する tkhd 変換行列の回転部分を処理します。これにより、iPhone の前面カメラで撮影された反射動画が正しい向きで表示されますが、y 軸で正しく反射されません（#2012）。
- MP3: FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS)（#2194）により固定ビットレートシークにフォールバックする際に、シークできない Xing、VBRI、同様の可変ビットレートメタデータから再生時間とデータサイズを使用します。
オーディオ:
- メディアの終了間際に音声再生が開始されると AnalyticsListener.onAudioPositionAdvancing が呼び出されないバグを修正しました。
- ChannelMappingAudioProcessor と TrimmingAudioProcessor で、すべてのリニア PCM サンプル形式のサポートを追加。
- CompositionPlayer での音声ギャップのサポートを追加。
- BaseAudioProcessor#reset() から BaseAudioProcessor#flush() への不要な呼び出しを削除。
- DefaultAudioMixer で一定のパワーアップミキシング/ダウンミキシングを許可。
- ChannelMappingAudioProcessor、TrimmingAudioProcessor、ToFloatPcmAudioProcessor を公開しました（#2339）。
- AudioTrackPositionTracker の AudioTrack#getUnderrunCount() を使用して、ベストエフォート推定ではなく DefaultAudioSink のアンダーランを検出します。
- オーディオ出力デバイスからの予期しない位置のずれに対するオーディオタイムスタンプの平滑化を改善。
- Bluetooth デバイスに接続しているときに、一時停止から再開してから最初の 10 秒間、音声と映像の同期が崩れるバグを修正
- AnalyticsListener.onAudioPositionAdvancing が、音声の進行開始時刻ではなく、最初の測定時刻を報告していたバグを修正しました。
- 一部のデバイスでステレオオーディオにフォールバックした後、マルチチャンネルオーディオに復元する問題を修正しました（#2258）。
動画:
- 切り離されたサーフェスの回避策を「lenovo」デバイスと「motorola」デバイスに拡張（#2059）。
- 音声サンプルがリクエストされた位置で正確に開始されない場合に、起動時のスムーズな動画フレームのリリースを改善
- 取り外したサーフェスの回避策を「realme」デバイスに拡張（#2059）。
- デコード専用の入力バッファをキューに入れるときに MediaCodec.BUFFER_FLAG_DECODE_ONLY フラグを含めるための試験運用版 ExoPlayer API を追加しました。このフラグは、デコード専用バッファをスキップするようデコーダに指示し、シークを高速化します。DefaultRenderersFactory.experimentalSetEnableMediaCodecBufferDecodeOnlyFlag で有効にします。
- ソフトウェア動画コーデックのコーデックパフォーマンスチェックを改善。これにより、一部のトラックが EXCEEDS_CAPABILITIES としてマークされることがあります。
- 一部のデバイスで VP9 Widevine の再生エラーを修正（#2408）。
テキスト:
- MP4 ファイルの VobSub トラックのサポートを追加しました（#2510）。
- 字幕セグメントの読み込みに最初に失敗し、その後正常に読み込まれ、その後に空の字幕セグメントが続く場合に再生が停止する問題を修正しました（#2517）。
- 字幕を有効にしたときに進行中のキューを表示するよう SSA と SubRip を修正しました（#2309）。
- 字幕エラーのあるストリームから字幕トラックが空のライブストリームに切り替えると再生が停止する問題を修正しました（#2328）。
- B フレームを含む H.262 ストリームを再生する際に CEA-608 字幕が文字化けする問題を修正しました（#2372）。
- Matroska ファイルで CodecId = S_TEXT/SSA を使用した SSA 字幕のサポートを追加しました。以前は、MatroskaExtractor は SubStation Alpha 字幕の「高度な」（v4 以降）バリアントを表す CodecId = S_TEXT/ASS のみをサポートしていました（ただし、ExoPlayer の解析ロジックは両方のバリアントで同じです）（#2384）。
- SubStation Alpha（SSA）字幕ファイルで layer プロパティのサポートを追加しました。このプロパティは、複数のキューが同時に画面に表示される場合に、キューの z オーダーを定義するために使用されます（#2124）。
メタデータ:
- メディアの再生時間と Timeline の取得のサポートを MetadataRetriever に追加し、インスタンスベースの AutoCloseable API に移行しました。新しい Builder を使用して MediaItem のインスタンスを作成し、retrieveTrackGroups()、retrieveTimeline()、retrieveDurationUs() を呼び出してメタデータの ListenableFuture を取得します。以前の静的メソッドは非推奨になりました（#2462）。
画像:
- BitmapFactoryImageDecoder の表示サイズにデコードされたビットマップを制限し、非常に大きな（50 メガピクセルなど）画像を表示しようとしたときに PlayerView からの Canvas: trying to draw too large bitmap. でアプリがクラッシュしないようにします。
- Context パラメータを受け取るように DefaultRenderersFactory.getImageDecoderFactory() のシグネチャを変更します。
- CompositionPlayer で使用されるビットマップの最大出力サイズを、Transformer で使用されるサイズと一致させます（つまり、CompositionPlayer は ExoPlayer とは異なり、ビットマップをデコードする際にディスプレイサイズを考慮しません）。
DRM:
- MediaItem.DrmConfiguration を受け入れる OfflineLicenseHelper.newWidevineInstance の新しいオーバーロードを追加し、HTTP リクエストヘッダーを正しく適用できるようにしました（#2169）。
効果:
- 入力の向きに関係なく、短い辺が常に指定された値と一致するようにする Presentation を作成する Presentation.createForShortSide(int) を追加します。
Muxer:
- フラグメント化された MP4 の音声サンプルに正しいサンプルフラグが設定されないバグを修正しました。
- writeSampleData() API が MediaCodec.BufferInfo ではなく、muxer 固有の BufferInfo クラスを使用するようになりました。
- デフォルトで false になる Muxer.Factory#supportsWritingNegativeTimestampsInEditList を追加します。
IMA 拡張機能:
- 1 つの広告の読み込みエラーが原因で、別の広告グループが誤って無効になるバグを修正しました。
- VOD ウィンドウの終了後に広告グループが再生を停止するバグを修正しました。期間後に開始する広告グループは、MediaPeriodQueue にエンキューされなくなりました（#2215）。
セッション:
- 特権のないサードパーティの Media3 コントローラからの接続が無視されるバグを修正しました。
- 以前の MediaBrowserServiceCompat にカスタムコマンドを送信する際に、使用可能なコマンドのチェックを削除します。これは、レガシーアプリに接続された場合のレガシーコントローラ/ブラウザの動作と同じです。
- プレーヤーの最初の再生エラーが永続的なカスタム例外として誤って処理されるバグを修正これにより、アプリケーションが復元されなくなります。
- セッションで処理されない一部のコントローラ変更が IllegalStateExceptions を引き起こすバグを修正しました。
- セッションで処理されないコントローラアクションによってコントローラが無効な状態になる可能性があるバグを修正
- StrictMode の安全でない起動違反の警告を修正しました（#2330）。
- メインスレッドとは異なるアプリケーションスレッドからプレーヤーを実行しているときに、メインスレッドから setSessionExtras を呼び出すと IllegalStateException が発生するバグを修正しました（#2265）。
- メディアアイテムを準備または再生せずに設定した場合、通知を自動的に表示しない（#2423 https://github.com/androidx/media/issues/2423）。この動作は MediaSessionService.setShowNotificationForIdlePlayer で構成できます。
- すべてのコントローラまたは選択したコントローラにカスタム PlaybackException を追加します。
- MediaController でライブストリームをシークすると IllegalArgumentException が発生するバグを修正しました。
- ライブ配信の場合、Android Auto UI（およびプラットフォームメディアセッションからこの情報を使用する他のコントローラ）で位置のアーティファクトが発生しないように、プラットフォームメディアコントローラでの再生位置の公開と現在のアイテムでのシーク機能を停止します（#1758）。
- 従来の MediaBrowserServiceCompat に接続された MediaBrowser の getLibraryRoot に null を渡すと NullPointerException が生成されるバグを修正しました。
- カスタムアクション、検索結果、getItem リクエストを送信すると、レガシーセッションアプリが ClassNotFoundException でクラッシュするバグを修正しました。
- MediaItem.LocalConfiguration.uri がプラットフォームセッションの MediaMetadata に共有されるバグを修正。コントローラがメディアを再リクエストできるように URI を意図的に共有するには、代わりに MediaItem.RequestMetadata.mediaUri を設定します。
UI:
- LazyColumn などの再利用可能なコンポーネント内の PlayerSurface が正しく機能しないバグを修正しました（#2493）。
- 初期ボタンの状態の設定と状態の変化（アイコンの形状や有効 / 無効など）の監視の間にギャップが生じる Compose のバグを修正しました。観測期間外に Player に加えられた変更が取得されるようになりました（#2313）。
- SeekBackButtonState と SeekForwardButtonState の状態ホルダーとコンポーザブルを media3-ui-compose モジュールに追加します。
- ExoPlayer のスクラブモードのサポートを PlayerControlView に追加します。有効にすると、ユーザーがスクラバーバーのドラッグを開始したときにプレーヤーがスクラビングモードになり、すべての移動に対して player.seekTo 呼び出しが発行され、画面からタッチが離れるとスクラビングモードが終了します。この統合は、XML の time_bar_scrubbing_enabled = true または Java/Kotlin の setTimeBarScrubbingEnabled(boolean) メソッドで有効にできます。
- PlayerSurface が null 可能な Player 引数を受け入れるようにします。
ダウンロード:
- プログレッシブストリームの部分的なダウンロードのサポートを追加しました。アプリは DownloadHelper でプログレッシブストリームを準備し、ダウンロードでカバーする時間ベースのメディアの開始位置と終了位置を指定して、ヘルパーに DownloadRequest をリクエストできます。返された DownloadRequest には解決済みのバイト範囲が含まれており、それを使用して ProgressiveDownloader を作成し、対応するコンテンツをダウンロードできます。
- 静的 DownloadHelper.forMediaItem() メソッドを置き換える DownloadHelper.Factory を追加します。
- SegmentDownloader 実装に Factory を追加
- アダプティブストリームの部分的なダウンロードのサポートを追加しました。アプリは DownloadHelper でアダプティブストリームを準備し、ダウンロードでカバーする時間ベースのメディアの開始位置と終了位置を指定して、ヘルパーから DownloadRequest をリクエストできます。返された DownloadRequest には解決された時間範囲が含まれており、それを使用して具体的な SegmentDownloader を作成し、対応するコンテンツをダウンロードできます。
Cronet 拡張機能:
- Cookie の自動処理を追加しました（#5975）。
HLS 拡張機能:
- バッファにチャンクがない場合に HlsSampleStreamWrapper がバッファ内でシークしようとするバグを修正しました。#2598。
- 低遅延部分とプリロードヒントの読み込み後にトラック選択を変更すると、再生が停止またはフリーズするバグを修正しました（#2299）。
- サーバーで CAN-BLOCK-RELOAD=YES が尊重されない場合、目標期間の半分だけ待機することで、過剰な再読み込みを防ぎます（#2317）。
- ミッドロールの前にインタースティシャルストリームを開始したときに再生が停止し、アセットリストの解決が誤った広告に対して試行されるバグを修正しました（#2558）。
- 引用符付き文字列属性値で \f（フォームフィード）を受け入れるように、再生リストの解析を修正しました（#2420）。
- 同じ ID のインタースティシャルを更新できるようになりました（#2427）。
- ライブストリームで読み込むセグメントがなくなると、再生リストの読み込みエラーが伝播されないことがあるバグを修正しました（#2401 https://github.com/androidx/media/issues/2401）。
- 音声レンディションがすでにグループ化されているのと同様に、字幕レンディションを NAME タグでグループ化します（#1666）。
- X-ASSET-LIST と HlsInterstitialsAdsLoader を使用したライブストリームをサポートします。
DASH 拡張機能:
- トリック再生アダプテーションセットがメインアダプテーションセットと統合されて無効な TrackGroup が形成される問題を修正しました（#2148）。
- 新しい期間を超えるサンプルがレンダリングパイプラインによってすでに読み取られている場合に、DASH 期間の短縮で例外がスローされるバグを修正しました（#2440）。
- CMCD クエリパラメータを使用するとリダイレクトがフォローされないバグを修正しました（#2475）。
RTSP 拡張機能:
- RFC 7798#4.4.2 に準拠して H265 の RTP 集約パケットのサポートを追加しました（#2413）。
- HTTP 302 レスポンスの処理時に提供されたロケーション URI を使用するように RtspClient を修正しました（#2398）。
- 末尾に空白文字を含む行を含む SessionDescription の解析サポートを追加しました（#2357）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- DefaultTrackSelector.setAllowInvalidateSelectionsOnRendererCapabilitiesChange がオーディオデコーダ拡張機能に影響しないバグを修正しました（#2258）。
Cast 拡張機能:
- setVolume() と getVolume() のサポートを追加しました（#2279）。
- タイムラインが空のときに CastPlayer が STATE_BUFFERING に入らないようにします。
- getDeviceVolume()、setDeviceVolume()、getDeviceMuted()、setDeviceMuted() のサポートを追加しました（#2089）。
テストユーティリティ:
- 指定した位置に達するまでプレーヤーを進めるために、TestPlayerRunHelper に advance(player).untilPositionAtLeast と untilMediaItemIndex を追加します。ほとんどの場合、これらのメソッドは既存の untilPosition メソッドと untilStartOfMediaItem メソッドよりも信頼性が高くなります。
- 他のテストで再利用できるように FakeDownloader を test-utils-robolectric モジュールに移動
- transformer.TestUtil.addAudioDecoders(String...)、transformer.TestUtil.addAudioEncoders(String...)、transformer.TestUtil.addAudioEncoders(ShadowMediaCodec.CodecConfig, String...) を削除しました。代わりに ShadowMediaCodecConfig を使用してシャドーエンコーダとデコーダを構成します。
- ShadowMediaCodecConfig によって報告されるコーデック名で、「exotest」接頭辞を「media3」に置き換えました。
サポートが終了したシンボルを削除しました。
- 非推奨の SegmentDownloader コンストラクタ SegmentDownloader(MediaItem, Parser<M>, CacheDataSource.Factory, Executor) と、そのサブクラス DashDownloader、HlsDownloader、SsDownloader の対応するコンストラクタを削除しました。
- 非推奨の Player.hasNext()、Player.hasNextWindow() を削除しました。代わりに Player.hasNextMediaItem() を使用してください。
- サポートが終了した Player.next() を削除しました。代わりに Player.seekToNextMediaItem() を使用してください。
- サポートが終了した Player.seekToPreviousWindow() を削除しました。代わりに Player.seekToPreviousMediaItem() を使用してください。
- サポートが終了した Player.seekToNextWindow() を削除しました。代わりに Player.seekToNextMediaItem() を使用してください。
- exoplayer モジュールでサポートが終了した BaseAudioProcessor を削除しました。common モジュールの BaseAudioProcessor を使用します。
- 非推奨の MediaCodecVideoRenderer コンストラクタ MediaCodecVideoRenderer(Context, MediaCodecAdapter.Factor, MediaCodecSelector, long, boolean, @Nullable Handler, @Nullable VideoRendererEventListener, int, float, @Nullable VideoSinkProvider) を削除しました。

バージョン 1.8.0-rc02

2025 年 7 月 24 日

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

バージョン 1.8.0-rc01

2025 年 7 月 16 日

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

バージョン 1.8.0-beta01

2025 年 7 月 2 日

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

バージョン 1.8.0-alpha01

2025 年 5 月 19 日

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

バージョン 1.7.0

バージョン 1.7.1

2025 年 5 月 16 日

このリリースには 1.6.1 と同じコードが含まれています。これは、1.7.0 より「新しい」リリースとして表示されるようにするためにリリースされています。1.7.0 は、誤って安定版としてタグ付けされたアルファ版リリースでした（下記を参照）。

バージョン 1.7.0

2025 年 5 月 16 日

このリリースは 1.7.0-alpha01 であるべきでしたが、maven.google.com で誤って 1.7.0（安定版）としてタグ付けされました。使用しないでください。1.6.1 のままにするか、1.7.1（1.6.1 と同じコード）にアップグレードします。

バージョン 1.6.0

1.6.1

2025 年 4 月 14 日

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

共通ライブラリ:
- 新しい pitch 値で PlaybackParameters を簡単にコピーするための PlaybackParameters.withPitch(float) メソッドを追加しました（#2257）。
ExoPlayer:
- 次のメディアアイテムの初期化中に復元可能なレンダラーエラーが発生し、メディアアイテムの切り替えに失敗する問題を修正しました（#2229）。
- PreloadMediaSource が準備される前に getBufferedDurationUs() を呼び出そうとすると、ProgressiveMediaPeriod が IllegalStateException をスローする問題を修正（#2315）。
- DASH、HLS、SmoothStreaming のマニフェストリクエストで CmcdData を送信する問題を修正しました（#2253）。
- 広告グループの削除後も AdPlaybackState.withAdDurationsUs(long[][]) を使用できることを確認します。ユーザーは、削除された広告グループの期間の配列を渡す必要があります。この配列は空または null にできます（#2267）。
エクストラクタ:
- MP4: tkhd ボックスから alternate_group を解析し、各トラックの Format.metadata の Mp4AlternateGroupData エントリとして公開します（#2242）。
オーディオ:
- 短いコンテンツのプレイリストを再生するときに位置が動かなくなる可能性があるオフロードの問題を修正しました（#1920）。
セッション:
- プラットフォーム MediaSession コールバックの集計タイムアウトを 500 ミリ秒から 100 ミリ秒に短縮し、アプリがこの値を設定できるように試験運用版のセッターを追加
- ユーザーが通知を閉じた後、通知が再び表示される問題を修正（#2302）。
- ラップされたプレーヤーが実際には空の場合に、セッションが単一アイテムのタイムラインを返すバグを修正しました。これは、ラップされたプレーヤーに COMMAND_GET_TIMELINE がなく、COMMAND_GET_CURRENT_MEDIA_ITEM があり、ラップされたプレーヤーが空の場合に発生しました（#2320）。
- setForegroundServiceTimeoutMs などのサービスとの他のインタラクションの後に MediaSessionService.setMediaNotificationProvider の呼び出しが無視されるバグを修正しました（#2305）。
UI:
- PlayerSurface が ExoPlayer.setVideoEffects および CompositionPlayer と連携できるようにします。
- 新しい Player で PlayerSurface を再コンポーズできないバグを修正
HLS 拡張機能:
- HLS メディアの CmcdData でチャンクの長さが設定されず、暗号化されたメディアセグメントの処理時にアサーションエラーが発生する問題を修正しました（#2312）。
RTSP 拡張機能:
- RTSP セッションで TCP を使用するように構成する方法として、RTSPT スキームの URI のサポートを追加しました（#1484）。
Cast 拡張機能:
- プレイリストメタデータのサポートを追加しました（#2235）。

1.6.0

2025 年 3 月 26 日

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

共通ライブラリ:
- androidx.media の同等のクラスを置き換えるために、AudioManagerCompat と AudioFocusRequestCompat を追加しました。
- Kotlin を 1.9.20 から 2.0.20 にアップグレードし、Compose Compiler Gradle プラグインを使用します。KotlinX コルーチンライブラリを 1.8.1 から 1.9.0 にアップグレード。
- Format.toBundle(boolean excludeMetadata) メソッドを削除し、代わりに Format.toBundle() を使用
- SimpleBasePlayer で、null MediaMetadata を使用して setPlaylist の後に State で新しい currentMediaItemIndex を設定しても、メタデータが再評価されないバグを修正しました（#1940）。
- SimpleBasePlayer.State のアクセスを保護から公開に変更し、他のクラスでの更新を処理しやすくします（#2128）。
ExoPlayer:
- プラットフォームの MediaExtractor と同等の機能を提供する新しいクラス MediaExtractorCompat を追加します。
- MediaCodecVideoRenderer を使用した再生用に、試験運用版の「ExoPlayer」事前ウォーミングのサポートを追加しました。DefaultRenderersFactory から experimentalSetEnableMediaCodecVideoRendererPrewarming を構成して、セカンダリ MediaCodecVideoRenderer を ExoPlayer に提供できます。有効にすると、ExoPlayer は再生中に連続するメディアアイテムの動画を前処理して、メディアアイテムの切り替えのレイテンシを短縮します。
- DefaultLoadControl の bufferForPlaybackMs と bufferForPlaybackAfterRebufferMs のデフォルト値をそれぞれ 1,000 ミリ秒と 2,000 ミリ秒に減らしました。
- DeviceInfo とデバイスの音量を非同期で初期化します（setDeviceVolumeControlEnabled を使用して有効になっている場合）。これらの値は ExoPlayer.Builder.build() の直後には使用できません。Player.Listener は onDeviceInfoChanged と onDeviceVolumeChanged を介して変更を通知します。
- プレーヤーの作成後、初期オーディオセッション ID がすぐに利用できなくなりました。必要に応じて、AnalyticsListener.onAudioSessionIdChanged を使用して初期更新をリッスンできます。
- 動画トラックを選択する際は、言語を考慮してください。デフォルトでは、選択した音声トラックの言語と一致する「メイン」の動画トラックが選択されます（利用可能な場合）。動画の言語設定は TrackSelectionParameters.Builder.setPreferredVideoLanguage(s) で明示的に指定できます。
- DefaultTrackSelector.selectVideoTrack() メソッドに selectedAudioLanguage パラメータを追加します。
- retryCount パラメータを MediaSourceEventListener.onLoadStarted と対応する MediaSourceEventListener.EventDispatcher メソッドに追加します。
- 実際のコンテンツと一致しない再生リストアイテムまたは期間を含むマルチ期間 DASH ストリームで、アイテムの最後にフレームがフリーズするバグを修正しました（#1698）。
- BasePreloadManager.Listener をトップレベルの PreloadManagerListener に移動します。
- RenderersFactory.createSecondaryRenderer を実装して、事前ウォーミング用のセカンダリレンダラを提供できます。プリウォーミングにより、再生中のメディアアイテムの切り替えが速くなります。
- アダプティブストリーミング形式の DASH、HLS、SmoothStreaming でマニフェストリクエストの CmcdData を送信できるようにしました（#1951）。
- MediaCodecRenderer.onReadyToInitializeCodec で初期化されるコーデックの MediaCodecInfo を提供します（#1963）。
- AdsMediaSource を変更して、広告グループを追加することで AdPlaybackStates を拡張できるようにします。無効な変更が検出され、例外がスローされます。
- ミッドロール広告の後にコンテンツメディアに移行する際に、デコード専用の追加フレームが連続して表示される問題を修正しました。
- DefaultRenderersFactory で 2 つの MetadataRenderer インスタンスを追加し、アプリがデフォルトで 2 つの異なるメタデータスキーマを受信できるようにします。
- 再生が一時停止されたときに、チャンクの進行中の読み込みをキャンセルするかどうかを再評価します（#1785）。
- シークできないメディアでのクリップを許可するオプションを ClippingMediaSource に追加。
- プリウォーミングによるシークで次のメディアアイテムへの切り替えがブロックされるバグを修正
- ExoPlayer.isLoading() が STATE_IDLE または STATE_ENDED に移行した後も true のままになるバグを修正しました（#2133）。
- LoadControl.Parameter に lastRebufferRealtimeMs を追加します（#2113）。
Transformer:
- 下位互換性のある代替形式へのトランスミュークシングのサポートを追加します。
- ドルビービジョン（プロファイル 8）形式のトランスコーディングとトランスミュークシングのサポートを追加。
- Format を使用するように VideoFrameProcessor.registerInputStream と VideoFrameProcessor.Listener.onInputStreamRegistered のパラメータを更新します。
- DefaultEncoderFactory を使用する際に HDR 静的メタデータを生成します。
- MediaMetricsManager を使用した Android プラットフォーム診断のサポートを有効にしました。Transformer では編集イベントとパフォーマンスデータがプラットフォームに転送されるため、デバイスのシステムパフォーマンスとデバッグ情報の提供に役立てることができます。このデータは、デバイスのユーザーが使用状況と診断情報の共有を有効にしている場合に、Google によって収集されることもあります。アプリは、Transformer.Builder.setUsePlatformDiagnostics(false) で Transformer のプラットフォーム診断への貢献を無効にできます。
- InAppMuxer を InAppMp4Muxer と InAppFragmentedMp4Muxer に分割します。InAppMp4Muxer はフラグメント化されていない MP4 ファイルを生成するために使用され、InAppFragmentedMp4Muxer はフラグメント化された MP4 ファイルを生成するために使用されます。
- Muxer インターフェースを media3-muxer から media3-transformer に移動します。
- 画面録画用の MediaProjection からメディアを提供する MediaProjectionAssetLoader を追加し、Transformer デモアプリに画面録画のサポートを追加
- Codec インターフェースに #getInputFormat() を追加します。
- 可能であれば、DefaultVideoFrameProcessor と DefaultVideoCompositor の呼び出し元に GlObjectsProvider を解放する責任を移します。
エクストラクタ:
- AVI: ストリームヘッダーにチャンク数ではなくバイト数が格納されている、一定ビットレートの圧縮音声を含むファイルの処理を修正
- 長さが 1 バイトまたは 2 バイト（4 バイトではない）で表される NAL ユニットの処理を修正。
- 編集リストが同期フレーム以外のフレームで始まり、その前に同期フレームがない場合、MP4 編集リストの ArrayIndexOutOfBoundsException を修正（#2062）。
- 一部のデバイスで TS ストリームが停止する問題を修正しました（#2069）。
- FLAC: 32 ビット FLAC ファイルのサポートを追加しました。以前は、IllegalStateException: Playback stuck buffering and not loading で再生できませんでした（#2197）。
オーディオ:
- 再生が再開されたときに onAudioPositionAdvancing が呼び出されるように修正しました（以前は再生が一時停止されたときに呼び出されていました）。
- SpeedChangingAudioProcessor がデフォルトのパラメータで構成されている場合は、SonicAudioProcessor をバイパスしないでください。
- DefaultAudioSink が停止する原因となる可能性がある Sonic#getOutputSize() のアンダーフローを修正
- シークで指定された時間が正しくリセットされるように MediaCodecAudioRenderer.getDurationToProgressUs() と DecoderAudioRenderer.getDurationToProgressUs() を修正しました。
- androidx.media3.common.audio.SonicAudioProcessor を final にします。
- ChannelMappingAudioProcessor と TrimmingAudioProcessor に浮動小数点 PCM のサポートを追加します。
動画:
- MediaCodecVideoRenderer.shouldUsePlaceholderSurface を protected に変更して、プレースホルダサーフェスの使用をブロックするためにアプリケーションがオーバーライドできるようにします（#1905）。
- シークを高速化するために、試験運用版の ExoPlayer AV1 サンプル依存関係の解析を追加しました。新しい DefaultRenderersFactory.experimentalSetParseAv1SampleDependencies API で有効にします。
- 依存関係のない遅延 MediaCodecVideoRenderer デコーダ入力バッファをドロップする試験運用版 ExoPlayer API を追加しました。DefaultRenderersFactory.experimentalSetLateThresholdToDropDecoderInputUs で有効にします。
- サーフェスがないプレーヤーがすぐに準備完了となり、保留中のフレームのデコードが非常に遅くなる問題を修正しました（#1973）。
- 画面のちらつきを避けるため、Xiaomi と OPPO のデバイスを分離型サーフェスモードから除外（#2059）。
テキスト:
- VobSub 字幕のサポートを追加しました（#8260）。
- MediaItem.Builder.setSubtitleConfigurations で構成されたすべての字幕ファイルを積極的に読み込むのを停止し、代わりにトラック選択で選択された場合のみ 1 つを読み込むようにします（#1721）。
- TTML: style を使用した tts:origin と tts:extent の参照のサポートを追加しました（#2953）。
- WebVTT と SubRip のタイムスタンプを小数点以下 3 桁に制限します。以前は、小数点以下の桁数を誤って解析し、常に値がミリ秒単位であると想定していたため、タイムスタンプが正しくありませんでした（#1997）。
- プレイリストに CEA-608 または CEA-708 の字幕を含むクリップされたアイテムが含まれている場合に再生がハングする問題を修正しました。
- SSA ファイルに継続時間ゼロのキュー（開始時間と終了時間が同じ）が含まれている場合の IllegalStateException を修正（#2052）。
- 字幕が音声や動画と同じコンテナに多重化されている場合、字幕の解析エラーを抑制（およびログ記録）します（#2052）。
- CR 行末文字を使用する WebVTT ファイルでのマルチバイト UTF-8 文字の処理を修正しました（#2167）。
DRM:
- API レベル 27 未満のデバイスで ClearKey コンテンツを再生する際の MediaCodec$CryptoException: Operation not supported in this configuration エラーを修正しました（#1732）。
効果:
- OverlaySettings の機能を StaticOverlaySettings に移動しました。OverlaySettings は、動的オーバーレイ設定を可能にするためにサブクラス化できます。
Muxer:
- 完全修飾名が長くなりすぎるのを避けるため、MuxerException を Muxer インターフェースから移動しました。
- Mp4Muxer.Builder と FragmentedMp4Muxer.Builder の両方で setSampleCopyEnabled() メソッドの名前を setSampleCopyingEnabled() に変更しました。
- Mp4Muxer.addTrack() と FragmentedMp4Muxer.addTrack() が TrackToken ではなく int トラック ID を返すようになりました。
- Mp4Muxer と FragmentedMp4Muxer は Muxer インターフェースを実装しなくなりました。
- Mp4Muxer サンプルのバッチ処理とコピーをデフォルトで無効にします。
- 音声トラックのみが書き込まれた場合に大量のフラグメントを作成する FragmentedMp4Muxer のバグを修正
セッション:
- 再生が一時停止、停止、または失敗した場合、フォアグラウンドサービスの状態をさらに 10 分間保持します。これにより、さまざまなデバイスでフォアグラウンドサービスの制限を受けることなく、このタイムアウト内で再生を再開できます。onTaskRemoved をオーバーライドするときに stopSelf() の前にフォアグラウンドサービスを停止するために player.pause() を呼び出すことはできなくなりました。代わりに MediaSessionService.pauseAllPlayersAndStopSelf() を使用してください。
- 再生がエラー状態または停止状態になったときに、通知を表示したままにします。通知は、プレイリストがクリアされるか、プレーヤーがリリースされた場合にのみ削除されます。
- 利用可能なコマンドに応じて ACTION_PLAY と ACTION_PAUSE のいずれか 1 つのみを設定し、いずれか 1 つのみが設定されている場合も受け入れるように、Android プラットフォームの MediaSession アクション ACTION_PLAY と ACTION_PAUSE の処理を改善。
- MediaButtonReceiver.shouldStartForegroundService にパラメータとして Context を追加します（#1887）。
- レガシーセッションに接続された MediaController で Player メソッドを呼び出すと、保留中の更新から変更が削除されるバグを修正しました。
- MediaSession.setSessionActivity(PendingIntent) が null を受け入れるようにしました（#2109）。
- プレイリストがクリアされたときに古い通知が引き続き表示されるバグを修正しました（#2211）。
UI:
- PlayerSurface、PresentationState、PlayPauseButtonState、NextButtonState、PreviousButtonState、RepeatButtonState、ShuffleButtonState、PlaybackSpeedState の状態ホルダーとコンポーザブルを media3-ui-compose モジュールに追加します。
ダウンロード:
- データソースが IOException 以外の Exception をスローした場合に、データソースが開いたままになり、キャッシュ領域がロックされる CacheWriter のバグを修正しました（#9760）。
HLS 拡張機能:
- HlsInterstitialsAdsLoader の最初のバージョンを追加します。広告ローダーは、HLS メディアプレイリストの HLS インタースティシャルを読み取り、AdsMediaSource に渡される AdPlaybackState にマッピングします。この初期バージョンでは、X-ASSET-URI 属性を持つ HLS VOD ストリームのみがサポートされています。
- HlsInterstitialsAdsLoader.AdsMediaSourceFactory を追加しました。アプリはこれを使用して、HlsInterstitialsAdsLoader を便利かつ安全に使用する AdsMediaSource インスタンスを作成できます。
- HLS 再生リストから SUPPLEMENTAL-CODECS タグを解析して Dolby Vision 形式を検出（#1785）。
- HLS ストリームでシークして位置を同期する条件を緩和しました（#2209）。
DASH 拡張機能:
- DASH 向けに AC-4 レベル 4 形式のサポートを追加しました（#1898）。
- マルチピリオドのライブ配信で広告挿入の更新間隔を計算する際の問題を修正しました（#1698）。
- DASH マニフェストから scte214:supplementalCodecs 属性を解析して、ドルビービジョン形式を検出します（#1785）。
- 期間に宣言された期間を超えるメディアサンプルが含まれているライブストリームでの期間の切り替えの処理を改善（#1698）。
- adaptation-set-switching でマークされているが、言語またはロールフラグが異なる適応セットが統合される問題を修正しました（#2222）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- 組み込みの MPEG-H デコーダを使用して MPEG-H 音声をデコードする MPEG-H デコーダモジュールを追加（#1826）。
MIDI 拡張機能:
- カスタムの AudioSink インスタンスと AudioRendererEventListener インスタンスを MidiRenderer に接続します。
Cast 拡張機能:
- play-services-cast-framework 依存関係を 21.5.0 に引き上げて、Google Play 開発者サービスがインストールされているが有効になっていないデバイスで API 34 以上をターゲットとするアプリの FLAG_MUTABLE クラッシュを修正しました（#2178）。
デモアプリ:
- 追加のボタンで demo-compose を拡張し、スケーリングとシャッターのサポートで PlayerSurface の統合を強化。
サポートが終了したシンボルを削除しました。
- 非推奨になった AudioMixer.create() メソッドを削除しました。代わりに DefaultAudioMixer.Factory().create() を使用してください。
- サポートが終了した次の Transformer.Builder メソッドを削除します。
  - setTransformationRequest()、代わりに setAudioMimeType()、setVideoMimeType()、setHdrMode() を使用してください。
  - setAudioProcessors() でオーディオプロセッサを EditedMediaItem.Builder.setEffects() に設定し、代わりに Transformer.start() に渡します。
  - setVideoEffects() は、EditedMediaItem.Builder.setEffects() で動画エフェクトを設定し、代わりに Transformer.start() に渡します。
  - setRemoveAudio()、代わりに EditedMediaItem.Builder.setRemoveAudio() を使用して、Transformer.start() に渡された EditedMediaItem から音声を削除してください。
  - setRemoveVideo()、代わりに EditedMediaItem.Builder.setRemoveVideo() を使用して、Transformer.start() に渡された EditedMediaItem から動画を削除します。
  - setFlattenForSlowMotion()、代わりに EditedMediaItem.Builder.setFlattenForSlowMotion() を使用して、Transformer.start() に渡される EditedMediaItem をフラット化します。
  - setListener()、代わりに addListener()、removeListener()、または removeAllListeners() を使用してください。
- サポートが終了した次の Transformer.Listener メソッドを削除します。
  - onTransformationCompleted(MediaItem)、代わりに onCompleted(Composition, ExportResult) を使用してください。
  - onTransformationCompleted(MediaItem, TransformationResult)、代わりに onCompleted(Composition, ExportResult) を使用してください。
  - onTransformationError(MediaItem, Exception)、代わりに onError(Composition, ExportResult, ExportException) を使用してください。
  - onTransformationError(MediaItem, TransformationException)、代わりに onError(Composition, ExportResult, ExportException) を使用してください。
  - onTransformationError(MediaItem, TransformationResult, TransformationException)、代わりに onError(Composition, ExportResult, ExportException) を使用してください。
  - onFallbackApplied(MediaItem, TransformationRequest, TransformationRequest)、代わりに onFallbackApplied(Composition, TransformationRequest, TransformationRequest) を使用してください。
- 非推奨の TransformationResult クラスを削除します。代わりに ExportResult を使用してください。
- 非推奨の TransformationException クラスを削除します。代わりに ExportException を使用してください。
- サポートが終了した Transformer.PROGRESS_STATE_NO_TRANSFORMATION を削除しました。代わりに Transformer.PROGRESS_STATE_NOT_STARTED を使用してください。
- サポートが終了した Transformer.setListener() を削除しました。代わりに Transformer.addListener()、Transformer.removeListener()、Transformer.removeAllListeners() を使用してください。
- サポートが終了した Transformer.startTransformation() を削除しました。代わりに Transformer.start(MediaItem, String) を使用してください。
- サポートが終了した SingleFrameGlShaderProgram を削除しました。代わりに BaseGlShaderProgram を使用してください。
- Transformer.flattenForSlowMotion を削除しました。代わりに EditedMediaItem.flattenForSlowMotion を使用してください。
- ExoPlayer.VideoComponent、ExoPlayer.AudioComponent、ExoPlayer.TextComponent、ExoPlayer.DeviceComponent を削除しました。
- androidx.media3.exoplayer.audio.SonicAudioProcessor を削除しました。
- サポートが終了した次の DownloadHelper メソッドを削除しました。
  - コンストラクタ DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilities[])。代わりに DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilitiesList) を使用してください。
  - getRendererCapabilities(RenderersFactory) の場合、RenderersFactory を使用して DefaultRendererCapabilitiesList を作成し、DefaultRendererCapabilitiesList.getRendererCapabilities() を呼び出すことで、同等の機能を実現できます。
- PlayerNotificationManager.setMediaSessionToken(MediaSessionCompat) メソッドを削除しました。代わりに PlayerNotificationManager.setMediaSessionToken(MediaSession.Token) を使用して (MediaSession.Token) compatToken.getToken() を渡してください。

1.6.0-rc02

2025 年 3 月 19 日

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

1.6.0-rc01

2025 年 3 月 12 日

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

1.6.0-beta01

2025 年 2 月 26 日

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

バージョン 1.6.0-alpha03

2025 年 2 月 6 日

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

バージョン 1.6.0-alpha02

2025 年 1 月 30 日

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

バージョン 1.6.0-alpha01

2024 年 12 月 20 日

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

バージョン 1.5

バージョン 1.5.1

2024 年 12 月 19 日

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

ExoPlayer:
- このプラットフォーム API で報告されたコーデックタイムアウトの問題を回避するため、MediaCodec での非同期復号の使用を無効化（#1641）。
エクストラクタ:
- MP3: VBRI フレームの目次がファイル内のすべての MP3 データをカバーしていない場合、再生を途中で停止しない（#1904）。
動画:
- onOutputFormatChanged の処理中に提供された MediaCodecAdapter のピクセルアスペクト比の値の使用をロールバック（#1371）。
テキスト:
- ReplacingCuesResolver.discardCuesBeforeTimeUs のバグを修正しました。このバグでは、timeUs でアクティブなキュー（開始済みだがまだ終了していない）が誤って破棄されていました（#1939）。
メタデータ:
- Vorbis コメントからディスク/トラック番号とジャンルを抽出し、MediaMetadata に格納します（#1958）。

バージョン 1.5.0

2024 年 11 月 27 日

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

共通ライブラリ:
- 完全な整合性とリスナーの処理を確保しながら、別のプレーヤーに転送できる ForwardingSimpleBasePlayer を追加しました（#1183）。
- SimpleBasePlayer.State.playlist を getPlaylist() メソッドに置き換えます。
- プレイリスト構造を構築する代わりに、Timeline と現在の Tracks および Metadata を直接指定するために、SimpleBasePlayer.State.Builder.setPlaylist() のオーバーライドを追加します。
- minSdk を 21（Android Lollipop）に引き上げました。これは他のすべての AndroidX ライブラリと一致しています。
- Common ライブラリの上に構築された Kotlin 固有の機能を提供する androidx.media3:media3-common-ktx アーティファクトを追加
- media3-common-ktx ライブラリに、Player.Events をリッスンするコルーチンをスピンする Player.listen suspend 拡張関数を追加。
- ランタイムクラス検証の失敗を回避するために設計された、手動でアウトライン化された内部クラスから @DoNotInline アノテーションを削除します。最近のバージョンの R8 では、このようなインライン呼び出しが自動的にアウトライン化されるため、実行時のエラーを回避できます（手動でのアウトライン化は不要になりました）。ライブラリのすべての Gradle ユーザーは、compileSdk = 35 により、この処理を行う R8 のバージョンを使用する Android Gradle プラグインのバージョンをすでに使用している必要があります。Gradle 以外のビルドシステムを使用するライブラリのユーザーは、ランタイムクラス検証の失敗を回避するために、R8 相当のシュリンク/難読化ステップで同様の自動アウトライン化プロセスが行われるようにする必要があります。この変更は、他の AndroidX ライブラリですでに実施されています。
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() を追加します。
- MediaCodec が非同期モードで動作している場合（API 31 以降のデフォルトの動作）、MediaCodec.CryptoException が「予期しないランタイムエラー」として報告されることがある問題を修正。
- 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 コールバックを介して出力され、解析エラーは無視されます（これは既存の動作です）。
- 実際のコンテンツと一致しない再生リストアイテムまたは期間を含むマルチ期間 DASH ストリームで、アイテムの最後にフレームがフリーズするバグを修正しました（#1698）。
- SntpClient にセッターを追加して、クライアントが再初期化されるまでの最後の更新からの最大経過時間を設定できるようにしました（#1794）。
Transformer:
- Surface を介して Transformer に動画データをキューに登録することをサポートする SurfaceAssetLoader を追加します。
- ImageAssetLoader は、IllegalStateException をスローする代わりに AssetLoader.onError 経由でサポートされていない入力を報告します。
- イメージのエクスポートで MediaItem.Builder.setImageDurationMs を使用したイメージの再生時間を必須にします。
- オーディオの EditedMediaItem のシーケンスのギャップのエクスポートのサポートを追加。
トラックの選択:
- DefaultTrackSelector: 他の要素が同じ場合は、チャンネルベースの音声よりもオブジェクトベースの音声を優先します。
エクストラクタ:
- Mp4Extractor と FragmentedMp4Extractor を使用して、後続のサンプルで参照として使用されない H264 サンプルを特定できるようにします。
- AmrExtractor でインデックスベースのシークを有効にするオプションを追加。
- 有効なフレーム間のサイズが 128 KB を超える MP3 ファイルは、無効ではなく切り捨てられたものとして扱います。つまり、MP3 バイトの長さを示すメタデータがなく、末尾に MP3 以外のデータがあるファイルは、ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1}（#1563）で失敗するのではなく、MP3 データの末尾で再生を停止するようになりました。
- MP4 ファイルの編集リストを処理する際に、キーフレーム以外のメディア開始位置のプリロールサンプルの処理を修正しました（#1659）。
- Mp4Extractor と FragmentedMp4Extractor の mdhd ボックスのメディアの再生時間を使用して、フレームレートの計算を改善（#1531）。
- MP4 編集リストでの media_time の誤ったスケーリングを修正。segment_duration はムービーのタイムスケールを使用してすでに正しくスケーリングされていましたが、MP4 形式の標準で指定されているとおり、media_time はトラックのタイムスケールを使用して適切にスケーリングされるようになりました（#1792）。
- 編集リストを含む MP4 の endIndices 計算で順序が異なるフレームを処理（#1797）。
- MP4 ファイルの mdhd ボックスでのメディア再生時間の解析を修正し、-1 値を処理するようにしました（#1819）。
- H.263 動画の MP4 ファイルで h263 ボックスを識別するサポートを追加しました（#1821）。
- AC-4 Level-4 ISO ベースメディアファイル形式のサポートを追加（#1265）。
DataSource:
- HttpEngineDataSource を更新し、API レベル 34 ではなくバージョン S 拡張機能 7 から使用できるようにします（#1262）。
- DataSourceContractTest: DataSource.getUri() が（ドキュメントに記載されているとおり）解決済みの URI を返すことをアサートします。リクエストされた URI と異なる場合、テストは新しい DataSourceContractTest.TestResource.Builder.setResolvedUri() メソッドを使用してこれを示すことができます。
- DataSourceContractTest: open() の呼び出しが失敗した後（リソースが見つからないため）、後続の close() 呼び出しの前に、DataSource.getUri() と getResponseHeaders() が「open」値を返すことをアサートします。
  - DataSourceContractTest.getNotFoundResources() をオーバーライドすると、テストサブクラスで複数の「見つからない」リソースを指定したり、任意のヘッダーを指定したりできます。これにより、HTTP 404（ヘッダーあり）と「サーバーが見つかりません」（ヘッダーなし）を区別できます。
オーディオ:
- メディアに存在する場合、コーデックで CTA-2075 ラウドネスメタデータを自動的に構成します。
- シーク時に音量がスムーズに下がるようにします。
- シーク中に発生する可能性のあるポップ音を修正しました。
- Sonic のタイムストレッチ/ピッチシフトアルゴリズムの切り捨てエラーの蓄積を修正。
- 出力フレームがドロップされる原因となっていた SpeedChangingAudioProcessor のバグを修正しました。
動画:
- MediaCodecVideoRenderer は、レンダリングも他のサンプルの参照としても使用されないサンプルをデコードしません。
- API 35 以降では、MediaCodecAdapter は configure で null Surface を受け取ることができ、コーデックがこれをサポートしている場合（MediaCodecInfo.detachedSurfaceSupported）、新しいメソッド detachOutputSurface を呼び出して、以前に設定された Surface を削除できます。
- onOutputFormatChanged の処理時に指定された場合は、MediaCodecAdapter で指定されたピクセルアスペクト比の値を使用します（#1371）。
- 60fps の安全な H264 ストリームがサポート対象外としてマークされる Galaxy Tab S7 FE のデバイスの問題に対する回避策を追加（#1619）。
- 最後のサンプル後にストリーム終了シグナルを返さずにスタックするコーデックの回避策を追加。
テキスト:
- カスタム VoiceSpan を追加し、WebVTT 音声スパン（#1632）用に値を設定します。
- 非常に大きな字幕タイムスタンプ（マイクロ秒で表され、90,000 MPEG タイムベースを乗算すると 64 ビットの long をオーバーフローする）を含む HLS の WebVTT が表示されることを確認します（#1763）。
- ドルビービジョンコンテンツで CEA-608 字幕をサポートします（#1820）。
- CEA-608 字幕が有効になっている場合に、DASH マルチピリオドストリームで再生がハングする問題を修正しました（#1863）。
メタデータ:
- icy または vnd.dvb.ait コンテンツを含むトラックに C.TRACK_TYPE_METADATA タイプを割り当てます。
画像:
- Glide や Coil などの外部画像読み込みライブラリとの統合を簡素化するために、ExternallyLoadedImageDecoder を追加します。
DataSource:
- FileDescriptor から読み取るために使用できる新しい DataSource である FileDescriptorDataSource を追加しました（#3757）。
効果:
- 軽微な SurfaceTexture スケーリングの DefaultVideoFrameProcessor 回避策を追加しました。SurfaceTexture には、切り抜かれたバッファの端の 1 テクセル境界を切り取る小さなスケーリングが含まれる場合があります。これにより、出力が想定どおりに近づくように処理されるようになりました。
- DefaultVideoFrameProcessor.queueInputBitmap() を高速化します。その結果、Transformer を使用して画像を動画にエクスポートする速度が向上します。
IMA 拡張機能:
- プレイリストをクリアすると ImaServerSideAdInsertionMediaSource の ArrayIndexOutOfBoundsException が発生するバグを修正
- プリロールのないサーバーサイド挿入 DAI ストリームで、最後のミッドロールを過ぎて再生すると ArrayIndexOutOfBoundsException が発生するバグを修正しました（#1741）。
セッション:
- MediaButtonReceiver.shouldStartForegroundService(Intent) を追加して、アプリがこのメソッドをオーバーライドすることで、再生再開のために受信した再生コマンドを抑制できるようにしました。デフォルトでは、サービスは常に開始され、システムが ForegroundServiceDidNotStartInTimeException でサービスをクラッシュさせない限り、再生を抑制することはできません（#1528）。
- 従来のサービスに接続したときに、MediaBrowser から送信されたカスタムコマンドがメソッドの MediaBrowserServiceCompat バリアントではなく MediaSessionCompat.Callback にディスパッチされるバグを修正しました。これにより、MediaBrowser がレガシーサービスから返送された実際の戻り値を受け取ることができませんでした（#1474）。
- メディアボタンインテントのブロードキャストレシーバを設定する際に、特定のメーカーのデバイスからスローされる IllegalArgumentException を処理します（#1730）。
- メディアアイテムのコマンドボタンを追加します。これにより、MediaBrowserCompat を含むレガシーライブラリで Custom browse actions として知られていた Media3 API が追加されます。Media3 コマンドボタンは、MediaBrowser と MediaController の両方で利用できます。カスタムブラウズアクションを実装するをご覧ください。
- 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）。
- PlayerView に setFullscreenButtonState を追加し、クリック操作に反応するのではなく、帯域外でオンデマンドで全画面ボタンのアイコンを更新できるようにしました（#1590、#184）。
- アプリ定義のテキストトラック選択設定がある場合に、テキスト選択の [なし] が機能しないバグを修正
DASH 拡張機能:
- セグメントの途中から始まる期間のサポートを追加しました（#1440）。
スムーズなストリーミング拡張機能:
- テキストトラックを含む SmoothStreaming ストリームを再生する際の Bad magic number for Bundle エラーを修正しました（#1779）。
RTSP 拡張機能:
- エンコードされた @ 文字を含む URL のユーザー情報の削除を修正しました（#1138）。
- ヘッダー拡張機能を含む RTP パケットの解析時にクラッシュする問題を修正しました（#1225）。
デコーダ拡張機能（FFmpeg、VP9、AV1 など）:
- IAMF デコーダモジュールを追加しました。このモジュールは、libiamf ネイティブライブラリを使用して音声を合成し、IAMF トラックを含む MP4 ファイルの再生をサポートします。
  - ステレオレイアウトと、空間化された 5.1 の両方で再生が有効になっており、オプションのヘッドトラッキングも有効になっていますが、バイノーラル再生のサポートは現在利用できません。
- Android 15 でデコーダ拡張機能の 16 KB ページサポートを追加（#1685）。
Cast 拡張機能:
- CastSession が切断されたらタイムラインのクリーンアップを停止します。これにより、送信側アプリは切断後にローカルで再生を再開できます。
- Context が指定されたときに CastPlayer の DeviceInfo を入力します。これにより、MediaSession を RoutingSession にリンクできるようになります。これは、出力スイッチャーを統合するために必要です（#1056）。
テストユーティリティ:
- DataSourceContractTest に、次のことを検証するテストが含まれるようになりました。
  - 入力ストリーム read position が更新されます。
  - 出力バッファ offset が正しく適用されます。
デモアプリ
- デモのショートフォームアプリのメモリリークを解決しました（#1839）。
サポートが終了したシンボルを削除しました。
- 非推奨の Player.hasPrevious、Player.hasPreviousWindow() を削除します。代わりに Player.hasPreviousMediaItem() を使用してください。
- 非推奨になった Player.previous() メソッドを削除しました。代わりに Player.seekToPreviousMediaItem() を使用してください。
- 非推奨になった DrmSessionEventListener.onDrmSessionAcquired メソッドを削除しました。
- 非推奨の DefaultEncoderFactory コンストラクタを削除しました。代わりに DefaultEncoderFactory.Builder を使用してください。

バージョン 1.5.0-rc02

2024 年 11 月 19 日

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

バージョン 1.5.0-rc01

2024 年 11 月 13 日

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

バージョン 1.5.0-beta01

2024 年 10 月 30 日

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

バージョン 1.5.0-alpha01

2024 年 9 月 10 日

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

バージョン 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（#1581）を回避するために無視するかどうかを判断する際に、MediaButtonReceiver で KEYCODE_HEADSETHOOK を「再生」コマンドとして処理します。
RTSP 拡張機能:
- SDP 解析で無効なメディアの説明をスキップします（#1087）。

バージョン 1.4.0

2024 年 7 月 25 日

androidx.media3:media3-*:1.4.0 がリリースされました。バージョン 1.4.0 にはこれらのコミットが含まれています。

共通ライブラリ:
- no-op と推定されるシーク呼び出しを無視するのではなく、保護された BasePlayer.seekTo() メソッドと SimpleBasePlayer.handleSeek() メソッドに転送します。カスタムプレーヤーでこれらのメソッドを実装する場合は、mediaItemIndex == C.INDEX_UNSET でこれらの追加の呼び出しを処理する必要がある場合があります。
- 拡張された Java 8 の脱糖化のコンパイル依存関係を削除しました（#1312）。
- イメージ以外の MediaItem では、MediaItem.Builder.setImageDurationMs() に渡された期間が無視されることを確認します（ドキュメントに記載されています）。
- Format.customData を追加して、Format インスタンスに関するアプリ提供のカスタム情報を保存します。
ExoPlayer:
- 複数のソースのプリロードを、それぞれの rankingData で定義された優先度に基づいて調整する BasePreloadManager を追加します。このクラスを拡張することでカスタマイズできます。PreloadMediaSource を使用してソースのメディアサンプルをメモリにプリロードし、UI 上のアイテムのインデックスを示す整数 rankingData を使用する DefaultPreloadManager を追加します。
- LoadControl のほとんどのメソッドに PlayerId を追加して、LoadControl の実装で複数のプレーヤーをサポートできるようにしました。
- Buffer.isDecodeOnly() と C.BUFFER_FLAG_DECODE_ONLY を削除しました。レンダラとデコーダがタイムスタンプに基づいてバッファをスキップするかどうかを判断するため、このフラグを設定する必要はありません。カスタム Renderer 実装では、バッファ時間が BaseRenderer.getLastResetPositionUs() 以上かどうかを確認して、サンプルを表示するかどうかを決定する必要があります。カスタム SimpleDecoder 実装では、必要に応じて isAtLeastOutputStartTimeUs() をチェックしたり、他のバッファに DecoderOutputBuffer.shouldBeSkipped をマークしてスキップしたりできます。
- TargetPreloadStatusControl.getTargetPreloadStatus(T) が null 値を返すことを許可し、指定された rankingData で MediaSource をプリロードしないことを示します。
- remove(MediaSource) を BasePreloadManager に追加します。
- BasePreloadManager に reset() を追加して、プリロードマネージャーインスタンスを保持しながら、すべての保持ソースを解放します。
- API 35 以降で PriorityTaskManager と MediaCodec の重要度で使用される優先度値を定義するために、ExoPlayer.setPriority()（および Builder.setPriority()）を追加しました。
- 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 は、作業タスクのスケジュール時間を計算するときにこのメソッドを呼び出します。
- MediaCodecRenderer で使用できる入力バッファと出力バッファがある場合にアラートを出すため、MediaCodecAdapter#OnBufferAvailableListener を追加します。MediaCodecRenderer は、これらのコールバックを受信すると ExoPlayer にシグナルを送信します。ExoPlayer が experimentalSetDynamicSchedulingEnabled() で設定されている場合、ExoPlayer はレンダラが進行できるようにワークループをスケジュールします。
- 個々のパラメータではなく、LoadControl メソッドにデータクラスを使用します。
- Exoplayer.release() が呼び出されたかどうかを確認する ExoPlayer.isReleased() を追加します。
- ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() を追加して、seekToPrevious() が前のアイテムをシークする最大位置を設定します（#1425）。
- 音声フォーカスの不整合（プレーヤーが一時停止中にフルフォーカスまたは一時フォーカスの喪失をレポートしないなど）を修正（#1436）。
- 抽出ツールが最初の準備ステップの後にトラックを追加で報告することによって発生する可能性のある IndexOutOfBoundsException を修正しました（#1476）。
- ExoPlayer.setVideoEffect() の Effects は、レンダラオフセットが削除されたタイムスタンプを受け取ります（#1098）。
- 別のプレイリストアイテムを先読みしている間に発生したプレーヤーエラーを処理する際の潜在的な IllegalArgumentException を修正（#1483）。
Transformer:
- ExportResult に audioConversionProcess と videoConversionProcess を追加して、出力ファイルの各トラックがどのように作成されたかを示します。
- トリム最適化の 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 Profile 2 エンコード属性を修正しました（#1299）。
- オフロード再生の場合、保留中のすべてのデータが再生されたタイミングを AudioTrack.StreamEventCallback#onPresentationEnded が正しく識別できるように、AudioTrack.stop() を呼び出す前に DefaultAudioSink でストリーム完了のトラッキングフィールドをリセットします。
- SilenceSkippingAudioProcessor で、異なる音声形式（ステレオからモノラルなど）間の切り替えでプロセッサが例外をスローする可能性があるバグを修正しました（#1352）。
- MediaCodecAudioRenderer.getDurationToProgressUs() を実装して、MediaCodecAudioRenderer が進行できるときに ExoPlayer がメインのワークループを動的にスケジュールできるようにします。
動画:
- 再生中にサーフェスを切り替えると 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 の「ペンの位置を設定」コマンドの単純な処理によって重複した改行が追加されるのを回避（#1315）。
- WebVTT 字幕サンプルにキューが含まれていない場合（DASH ストリームの一部など）に 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:
- package が現在のアプリのパッケージと異なる android.resource://package/id 生リソース URI のサポートを実装します。これは、以前は動作が文書化されていませんでしたが、名前でアクセスするよりも効率的に別のパッケージのリソースにアクセスする方法です。
- 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 で乗算して反転させます。
- TimestampWrapper を ExoPlayer#setVideoEffects とともに使用するとクラッシュするバグを修正しました（#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）。
- data:// 広告タグ URI（#700）を使用する際の NullPointerException を修正するため、IMA SDK のバージョンを 3.33.0 に引き上げました。
セッション:
- CommandButton.enabled のデフォルトを true に変更し、関連するコマンドが利用可能な場合でも、コントローラの値を false のままにできることを確認します。
- カスタムアイコンリソースの代わりに使用する CommandButton のアイコン定数を追加
- MediaSessionService.isPlaybackOngoing() を追加して、アプリが onTaskRemoved() でサービスを停止する必要があるかどうかをクエリできるようにしました（#1219）。
- すべてのセッションの再生を一時停止し、stopSelf() を呼び出して MediaSessionService のライフサイクルを終了できる MediaSessionService.pauseAllPlayersAndStopSelf() を追加します。
- MediaSessionService.onTaskRemoved(Intent) をオーバーライドして、再生が進行中の場合はサービスをフォアグラウンドで実行し、それ以外の場合はサービスを停止する安全なデフォルト実装を提供します。
- プラットフォームセッションメタデータに再生時間を設定しないことで、ライブ配信のメディア通知でシークバーを非表示にしました（#1256）。
- メタデータプロパティを選択する際に、media1 と同じ優先順位とロジックを使用するように、MediaMetadata から MediaDescriptionCompat への変換を調整します。
- 致命的でないエラーを Media3 コントローラに送信できるようにする MediaSession.sendError() を追加します。通知コントローラ（MediaSession.getMediaNotificationControllerInfo() を参照）を使用する場合、カスタムエラーは、指定されたエラー情報（#543）でプラットフォームセッションの PlaybackState をエラー状態に更新するために使用されます。
- 特定のコントローラからのプレーヤー操作の一連の処理が終了したときにセッションに通知するために、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）。
- PlayerControlView のさまざまなアイコンのカスタマイズを xml 属性で追加し、グローバルなオーバーライドではなく、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() を実装します。
- TestPlayerRunHelper.runUntil()/playUntil() メソッドを変更して、致命的でないエラー（AnalyticsListener.onVideoCodecError() に報告されたエラーなど）で失敗するようにします。新しい TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() メソッドチェーンを使用して、この動作を無効にします。
デモアプリ:
- 短編動画デモアプリで DefaultPreloadManager を使用します。
- コマンドラインから Intent 引数でリピートモードを設定できるようにしました（#1266）。
- デバイスでサポートされている場合は、HttpDataSource として HttpEngineDataSource を使用します。
サポートが終了したシンボルを削除しました。
- 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 で、60fps の 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 で、単一の Uri ではなく、完全な MediaItem を使用して広告を定義します。
- minSdk を 19（Android KitKat）に増やします。これは他のすべての AndroidX ライブラリと整合しており、AndroidX 依存関係の最新バージョンにアップグレードするために必要です。
- artworkUri と artworkData の少なくとも一方が null 以外の場合、MediaMetadata.Builder.populate(MediaMetadata) の両方を入力します（#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 を使用して HttpDataSource を使用する HttpEngineDataSource を実装します。
- CompositeSequenceableLoader のサブクラス化を防止します。このコンポーネントは以前に拡張可能にされましたが、ライブラリ内でサブクラス化されたことはありません。カスタマイズは、デコレータパターンを使用してインスタンスをラップし、カスタム CompositeSequenceableLoaderFactory を実装することで行えます。
- 同じ時間を繰り返すと、このアイテムのメタデータがクリアされる問題を修正しました（#1007）。
- BundledChunkExtractor.Factory と DefaultHlsExtractorFactory の experimentalSetSubtitleParserFactory メソッドの名前を setSubtitleParserFactory に変更し、null の受け渡しを禁止します。新しい experimentalParseSubtitlesDuringExtraction(boolean) メソッドを使用して、解析の動作を制御します。
- 抽出時に使用される SubtitleParser.Factory のカスタマイズのサポートを追加しました。これは MediaSource.Factory.setSubtitleParserFactory() で実現できます。
- MergingMediaSource から生成されたすべての Format.id フィールドにソース接頭辞を追加します。これにより、どのソースが Format を生成したかを特定できます（#883）。
- ハイフンのみをチェックするように変更することで、カスタムの共通メディアクライアントデータ（CMCD）キー名の検証に使用される正規表現を修正しました（#1028）。
- CMCD クエリパラメータの二重エンコードを停止しました（#1075）。
Transformer:
- H.265/HEVC SEF スローモーション動画のフラット化のサポートを追加。
- 特に「動画を削除」する編集で、トランスミュークシングの速度を向上させました。
- 出力ファイルが動画フレームで始まるようにする API を追加しました。これにより、プレゼンテーションタイムスタンプ（#829）まで最初の動画フレームを表示しないプレーヤー実装との互換性が高まります。
- 単一アセットの MP4 トリミング処理の最適化のサポートを追加しました。
- 動画フレームの最初のタイムスタンプが出力ファイルに含まれるようにサポートを追加。iOS ベースのプレーヤーで出力ファイルが黒いフレームで始まる問題を修正（#829）。
トラックの選択:
- DefaultTrackSelector.selectImageTrack を追加して、画像トラックの選択を有効にします。
- 画像トラックと動画トラックの両方が利用可能な場合に画像トラックを選択するかどうかを決定するために、TrackSelectionParameters.isPrioritizeImageOverVideoEnabled を追加します。デフォルト値は false で、動画トラックの選択が優先されることを意味します。
エクストラクタ:
- ColorInfo.colorSpace、ColorInfo.colorTransfer、ColorInfo.colorRange の値を取得するために、MP4 エクストラクタに AV1C の解析を追加しました（#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 に戻り続ける問題を修正
- 3、5、6、7、8 チャンネルで OPUS と VORBIS のチャンネルレイアウトが間違っている問題を修正しました（#8396）。
- ライブ配信でシークを 0 に行った後のトラック選択で、ストリームがデフォルトの位置から開始される問題を修正しました（#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 で、60fps 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 マニフェストで Dolby のチャンネル数として「f800」を 5 として解析（#688）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- MIDI: 早送りするとプログラム変更イベントがスキップされる問題を修正しました（#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）。
- https://issuetracker.google.com/251172715 を修正するため、androidx.annotation:annotation-experimental を 1.3.1 にアップグレードします。
- 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 に名前変更します。
- PNG ファイル全体を TrackOutput に送信して読み取る PngExtractor を 1 つのサンプルとして追加します。
- 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）。
- クエリパラメータを使用して共通メディアクライアントデータ（CMCD）データを送信する機能を追加しました（#553）。
- ExperimentalBandwidthMeter の ConcurrentModificationException を修正しました（#612）。
- CompositeMediaSource.getMediaTimeForChildMediaTime に MediaPeriodId パラメータを追加します。
- 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 classic のサポートを追加します。
オーディオ:
- 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 内の MediaSessionService.onStartCommand() で受信したメディアボタンイベントを、プラットフォームセッションにルーティングして Media3 に戻すのではなく、変換します。これにより、呼び出し元コントローラは常にメディア通知コントローラとなり、アプリはサポートされているすべての 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:
- Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT による再生抑制を処理する Wear OS デバイス用の Player.Listener 実装を追加します。この実装では、システムダイアログを起動して、ユーザーが適切な音声出力（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 Options リクエストを送信する時間間隔で RTSP Setup Response タイムアウト値を使用します（#662）。
デコーダ拡張機能（FFmpeg、VP9、AV1、MIDI など）:
- Jsyn ライブラリを使用してオーディオを合成し、標準 MIDI ファイルの再生をサポートする 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 の問題を修正
- Common Media Client Data（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）。
- PlayerWrapper が VolumeProviderCompat を作成する方法を修正します。レガシーコマンド（COMMAND_ADJUST_DEVICE_VOLUME と COMMAND_SET_DEVICE_VOLUME）と新しいコマンド（COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS と COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS）の両方で volumeControlType を決定します（#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 を追加し、既存のコンストラクタを非推奨にしました。
- リモート再生のルーティングコントローラ ID を指定するために DeviceInfo.routingControllerId を追加しました。
- 同じ位置でアイテムを追加および削除するためのショートカットとして 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() を追加。
- int ではなく long として sourceId を保存するように 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) を削除しています。
- 入力フレームの処理が保留されているときに動画ストリームの終了が通知されると、変換が停止し（多重化ツールのタイムアウトにつながる）、変換が停止するバグを修正しました。
- 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 を追加しました。
- オーディオ機能の変更後にバイパスモードが可能な場合にオーディオデコーダを破棄するため、新しい int 値 DISCARD_REASON_AUDIO_BYPASS_POSSIBLE を DecoderDiscardReasons に追加しました。
- DTS Express と DTS:X のダイレクト再生のサポートを追加しました（#335）。
動画:
- レンダラが無効になっている場合、MediaCodecVideoRenderer が幅と高さが 0 の VideoSize を報告するようにします。Player.getVideoSize() が変更されると、それに応じて Player.Listener.onVideoSizeChanged が呼び出されます。この変更により、MediaCodecVideoRenderer を使用する ExoPlayer の動画サイズは、Player.getCurrentTracks が動画をサポートしていない場合、またはサポートされている動画トラックのサイズがまだ決定されていない場合、幅と高さが 0 になります。
DRM:
- DRM パッケージの外部から呼び出されることが想定されていない DefaultDrmSession の内部専用メソッドの可視性を低減します。
  - void onMediaDrmEvent(int)
  - void provision()
  - void onProvisionCompleted()
  - onProvisionError(Exception, boolean)
Muxer:
- MP4 コンテナファイルの作成に使用できる新しい muxer ライブラリを追加。
IMA 拡張機能:
- DAI で複数期間のライブ DASH ストリームを有効にします。現在の実装では、ライブストリームでのシークはまだサポートされていません（#10912）。
- 連続するタイムラインで計算されたコンテンツの位置がわずかに異なるため、ライブストリームに新しい広告グループが挿入されるバグを修正しました。
セッション:
- 現在 Player メソッドを呼び出しているコントローラの情報を取得するヘルパーメソッド MediaSession.getControllerForCurrentRequest を追加します。
- androidx.media3.session.MediaButtonReceiver を追加して、アプリが Bluetooth ヘッドセットなどから送信されたメディアボタンイベントで再生再開を実装できるようにしました（#167）。
- リクエストされた MediaItems が LocalConfiguration（URI など）を持っている場合、Player に渡せるように、MediaSession.Callback.onAddMediaItems にデフォルトの実装を追加（#282）。
- Android 12 以前では、コンパクトメディア通知ビューに「前の位置にシーク」と「次の位置にシーク」のコマンドボタンをデフォルトで追加（#410）。
- リクエストされた MediaItems が LocalConfiguration（URI など）を持っている場合、Player に渡せるように、MediaSession.Callback.onAddMediaItems にデフォルトの実装を追加（#282）。
- Android 12 以前では、コンパクトメディア通知ビューに「前の位置にシーク」と「次の位置にシーク」のコマンドボタンをデフォルトで追加（#410）。
UI:
- 再生/一時停止ボタン付きのカスタム UI 要素を作成する Util メソッド shouldShowPlayButton と handlePlayPauseButtonAction を追加します。
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 パラメータを指定するオプションを含む非推奨のコンストラクタを使用します。
- 非推奨の Charset の String 定数（ASCII_NAME、UTF8_NAME、ISO88591_NAME、UTF16_NAME、UTF16LE_NAME）を削除し、代わりに kotlin.text パッケージ、java.nio.charset.StandardCharsets、または com.google.common.base.Charsets の Kotlin Charset を使用します。
- 非推奨の WorkManagerScheduler コンストラクタを削除し、代わりに Context パラメータを指定するオプションを含む非推奨のコンストラクタを使用します。
- Format クラスのインスタンス化に使用されていた、サポートが終了したメソッド createVideoSampleFormat、createAudioSampleFormat、createContainerFormat、createSampleFormat を削除しました。代わりに、Format のインスタンスを作成するには Format.Builder を使用します。
- 非推奨のメソッド copyWithMaxInputSize、copyWithSubsampleOffsetUs、copyWithLabel、copyWithManifestFormatInfo、copyWithGaplessInfo、copyWithFrameRate、copyWithDrmInitData、copyWithMetadata、copyWithBitrate、copyWithVideoSize を削除し、代わりに Format.buildUpon() とセッターメソッドを使用します。
- サポートが終了した 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 を削除し、代わりに DISCONTINUITY_REASON_SEEK と onPositionDiscontinuity を使用します。
- 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）。
- MediaSession.broadcastCustomCommand のレガシー MediaControllerCompat.Callback.onSessionEvent への転送の欠落を追加（#293）。
- MediaSession.setPlayer を呼び出しても使用可能なコマンドが更新されないバグを修正しました。
- Format.metadata を含むグループを参照している場合、MediaController から送信された TrackSelectionOverride インスタンスが無視される問題を修正しました（#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 で、60fps の AVC ストリームがサポート対象外とマークされるデバイスの問題の回避策を追加（#10898）。
- 画面のリフレッシュレートよりもはるかに高いフレームレートでメディアを再生する際のフレームリリースパフォーマンスの問題を修正しました。
Cast:
- メディアアイテム間の切り替え時に STATE_IDLE が一時的に発生する問題を修正（#245）。
RTSP:
- 無効な RTSP Describe レスポンスメッセージの解析でスローされる IllegalArgumentException をキャッチしました（#10971）。
セッション:
- 通知の再生/一時停止ボタンがプレーヤーの状態に合わせて更新されないバグを修正しました（#192）。
IMA 拡張機能:
- 広告のない DAI ストリームが開始されないバグを修正しました。これは、最初の（広告のない場合は唯一の）LOADED イベントが受信されなかったことが原因です。

バージョン 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 モジュールに置き換えられています。これにより、アダプターやコネクタのクラスを使用する必要なく、プレーヤーとメディアセッションを直接統合できます。