Media3

Media3

  代码示例

API 参考文档
androidx.media3.common

适用于媒体用例的支持库。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2026 年 10 月 21 日	1.11.1	-	-	1.12.0-alpha01

声明依赖项

如需添加 Media3 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    def media3_version = "1.11.1"

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

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

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

    // For building media playback UIs using Jetpack Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs using Jetpack Compose with Material Design 3
    implementation "androidx.media3:media3-ui-compose-material3:$media3_version"
    // For building media playback UIs using Views
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

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

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

    // For inspecting media files
    implementation "androidx.media3:media3-inspector:$media3_version"
    // For extracting and processing video frames
    implementation "androidx.media3:media3-inspector-frame:$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 applying Lottie effects on video frames
    implementation "androidx.media3:media3-effect-lottie:$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.11.1"

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

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

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

    // For building media playback UIs 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 inspecting media files
    implementation("androidx.media3:media3-inspector:$media3_version")
    // For extracting and processing video frames
    implementation("androidx.media3:media3-inspector-frame:$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 applying Lottie effects on video frames
    implementation("androidx.media3:media3-effect-lottie:$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")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。您可以使用 Media3 问题跟踪器来查找问题的答案、已知问题和功能请求，以及提交新问题。

1.12.0 版

版本 1.12.0-alpha01

2026 年 10 月 21 日

版本 1.12.0-alpha01 包含以下提交内容。

• 通用库：
  • 添加了 C.COLOR_SPACE_DISPLAY_P3，并在 MediaFormatUtil 和 ColorInfo ISO 颜色映射中支持 Display P3 色彩空间。
  • 添加了中央 Flags 注册表，用于管理实验性功能标志和分阶段发布 (Flags.setCanaryModeEnabled)。迁移了许多现有 @ExperimentalApi 方法，以使用新的标志 API。
  • 添加 MediaMetadata.playlistId、MediaMetadata.Builder.setPlaylistId(String)、MediaMetadata.categories 和 MediaMetadata.Builder.setCategories(List<String>)。
  • 将 androidx.media3.common.util.NonNullApi 替换为 JSpecify org.jspecify.annotations.NullMarked。
• ExoPlayer：
  • 修复了以下问题：当下一个时段的第一个分块加载失败时，DASH 多时段播放会卡住 (#3396)。
  • 在加载重试次数用尽时，在 AnalyticsListener.onLoadError 和 MediaSourceEventListener.onLoadError 中报告 wasCanceled = true。
  • 支持使用 ExoPlayer.addVideoFrameMetadataListener 和 ExoPlayer.removeVideoFrameMetadataListener 注册多个 VideoFrameMetadataListener 实例，弃用 ExoPlayer.setVideoFrameMetadataListener 和 ExoPlayer.clearVideoFrameMetadataListener。
  • 通过拆分和偏移每个时段的 AdPlaybackState，添加对多时段内容（例如 DASH）中广告的支持。
  • 修复了 PreCacheHelper 中的竞态条件，即取消正在进行的准备请求仍可能启动后台下载。
  • ProgressiveMediaSource 和 DefaultMediaSourceFactory 上的 setLoadOnlySelectedTracks(true) 限制为仅滤除未选择的视频和图片轨道。音频和文本轨道始终处于加载状态，以便在不重新缓冲的情况下无缝切换轨道。
  • 默认在 ProgressiveMediaSource 和 DefaultMediaSourceFactory 上启用 setLoadOnlySelectedTracks(true)。这样可以节省内存，并让 DefaultLoadControl 缓冲区分配计算在未选择所有轨道时更准确地运行。请注意，如果在播放过程中新启用了未选择的视频或图片轨道，这可能会导致额外的缓冲。
  • 修复了启用动态调度时 Player.getCurrentPosition() 可能会返回过时值（每秒仅更新几次）的问题 (#3286)。
  • 修复了以下问题：AudioTrack 播放头位置意外减少或重置可能会被错误地视为整数溢出，从而导致播放因缓冲而停止 (#3407)。
  • 移除实验性 DefaultMediaCodecAdapterFactory.setAsyncCryptoSynchronizationEnabled(boolean)。
  • 避免在从插页式广告或广告返回到末尾被剪辑的内容时，不必要地重新启用渲染器和出现故障 (#3371)。
  • 修复了以下问题：启用 Flags.FLAG_PER_STREAM_MEDIA_PROGRESSION 时，即将播放的播放列表项上的渲染器错误可能会过早中断当前播放。
  • 修复了在启用 Flags.FLAG_PER_STREAM_MEDIA_PROGRESSION 时，如果 ExoPlayer 将渲染程序转换为未准备好的媒体时段，可能会发生的 NullPointerException。
  • 修复了在启用 Flags.FLAG_VIDEO_RENDERER_DURATION_TO_PROGRESS 的情况下，动态调度期间视频帧可能会意外跳过或丢弃的问题。
  • 修复了在直播期间播放广告时停止播放会导致分析监听器中出现 ArrayIndexOutOfBoundsException 的问题 (#3423)。
  • 修复了以下问题：在从未调用 preload() 的情况下，PreloadMediaSource 可能会意外发布预加载事件 (#3408)。
  • 修复了以下问题：元数据轨道会忽略 Format.subsampleOffsetUs，导致解码后的 SCTE-35 拼接命令中的播放时间戳不正确 (#3413)。
  • 修复了在同一来源上多次调用 preload() 时 PreloadMediaSource 和 DefaultPreloadManager 中发生内存泄漏的问题 (#3445)。
  • 修复了在内容时间轴刷新处于待处理状态时释放 AdsMediaSource 导致的 NullPointerException (#3442)。
  • 修复了以下问题：在跳转后（或在非零位置开始播放时）加载失败并重试时，渐进式媒体的播放可能会跳转到错误的位置 (#3440)。
  • 添加了针对小米电视棒 4K (MiTV-AYFR0) H.264 解码器在无缝分辨率更改时冻结的问题的权宜解决方法 (#3457)。
  • 修复了在执行已发布的加载完成或错误回调之前停止跟踪器时，SteeringManifestTracker 中出现 NullPointerException 的问题 (#3443)。
  • 支持从 MP4 文件中的 mebx 盒式元数据轨道播放 HAGC (ST 2094-50) 定时元数据。
  • 修复了播放列表中准备缓慢的媒体时段可能会被跳过的问题。
• CompositionPlayer：
  • 支持使用 Composition.Builder.setVideoFrameAggregationParameters 为播放工作流配置视频帧聚合的帧速率。
  • 修复了多序列合成中因时间戳量化或舍入不匹配而导致的丢帧问题，方法是在帧聚合期间选择时间戳最接近的帧。此功能仅从 API 29 开始启用，因为它需要在每个视频序列中额外保留一个正在处理的帧。
• 转换器：
  • 支持使用 Composition.Builder.setVideoFrameAggregationParameters 为导出工作流配置视频帧聚合的帧速率。
  • 修复了多序列合成中因时间戳量化或舍入不匹配而导致的丢帧问题，方法是在帧聚合期间选择时间戳最接近的帧。此功能仅从 API 29 开始启用，因为它需要在每个视频序列中额外保留一个正在处理的帧。
  • 使用 AudioProcessors 时，遵循 Transformer#setAudioMimeType(AUDIO_RAW)。在此修复之前，请求 MimeTypes.AUDIO_RAW 并应用 AudioProcessor 会导致输出被压缩。
• 轨道选择：
  • 修复了以下问题：在某些设备上，SDR 轨道被错误地优先于受支持的 Dolby Vision 轨道 (#3135)。
• 提取器：
  • Mp4Extractor：修复了 MP4 中 Opus 的 dOps 框解析问题，其中 PreSkip、InputSampleRate 和 OutputGain 未从大端序转换为小端序，导致在没有修改列表时前 ~299 毫秒的音频被丢弃 (#3431)。
  • 移除 Mp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES、Mp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES_H265、FragmentedMp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES 和 FragmentedMp4Extractor.FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES_H265，因为默认情况下会为 H.264 和 H.265 启用 GOP 内样本依赖项解析。
  • Mp4Extractor：修复了从包含海拔坐标的 xyz 框中解析位置元数据以填充 Mp4LocationData 的问题。
  • 添加了 ExtractorUtil.getFramesPerEncodedSample，用于计算编码音频格式的每个样本的音频帧数 (#3367)。
  • 向 Mp4Extractor 添加了 FLAG_READ_XMP_METADATA，以便从顶级 UUID 框中提取 XMP 元数据。
  • 通过在将载荷传递到音频读取器之前，从 PsExtractor 中每个 PES 数据包中剥离 private_stream_1 子流标头，修复播放 DVD 样式 MPEG-PS 内容时损坏的 AC-3、DTS 和 LPCM 音频 (#3327)。
  • 修复了当版本 1 tfdt 框对负 baseMediaDecodeTime 进行编码时 FragmentedMp4Extractor 失败的问题 (#3412)。
  • MPEG-TS：支持解析 H.264 和 H.265 帧打包排列 SEI 消息，以填充 Format.stereoMode (#3419)。
  • 解析杜比视界配置文件 20 配置数据，并拒绝不受支持的杜比视界配置文件，而不是以颜色不正确的标准 HEVC 格式播放 (#3427)。
  • MP3：还原 LAME/Xing 编码器延迟和填充元数据调整，因为它与许多 MediaCodec MP3 解码器不兼容 (#3425)。
  • Matroska：修复了解析嵌套 ChapterAtom 元素时的 NullPointerException 问题 (#3438)。
  • Ogg：修复了以下 bug：大小为 255 字节的倍数且在页面边界处结束的数据包会与后续数据包合并。
  • MP4：解析了 Mp4Extractor 和 FragmentedMp4Extractor 中的 mebx 盒装定时元数据轨道。带有 it35 键的轨道会公开为 MimeTypes.APPLICATION_ITUT_T35（启用 HAGC 播放）。除非设置了 FLAG_EMIT_RAW_MEBX_DATA，否则系统会忽略其他 mebx 轨道，在这种情况下，所有 mebx 轨道都会作为原始 MimeTypes.APPLICATION_MEBX 发出。
  • Ogg：支持提取 Opus 结尾填充以实现无缝播放 (#2576)，并修复了在跳转到以连续数据包开头的页面后出现的样本时间戳问题。
  • Ogg：通过忽略流中 Opus ID 和注释标头数据包，修复了链式 Ogg Opus 流中的解码错误和约 1 秒的时间戳跳跃问题。
• 检查器：
  • 支持使用 MetadataRetriever 从 MP4 文件中检索 XMP 元数据。
  • 支持将 MediaExtractorCompat 中 mebx 封装的定时元数据轨道提取为 MimeTypes.APPLICATION_MEBX。
• 检查器框架：
  • 修复了使用 FrameExtractor 提取 Ultra HDR 帧时 SDR 基础图片中广色域 BT.2020 颜色被剪裁的问题。现在，色域外的颜色会柔和地压缩到 sRGB 色域中，而不是被限制。
• 音频：
  • 针对在错误线程上调用 android.media.AudioDeviceCallback 的设备添加了权宜解决方法 (#3386)。
  • 修复了在通过压缩分流进行曲目转换后可能出现的播放卡顿问题。
  • 解决了 Amazon Fire TV Stick 上 AC-3 音频在时段转换期间可能会卡住的问题 (#3448)。
  • 支持针对 Ogg 和 WebM/Matroska Opus 无缝播放剪裁流末尾编码器填充 (#2576)。
  • 修复了轨道转换期间动态分流无缝延迟和内边距更新问题，以便它们应用于传入轨道，而不是播放轨道。
  • 除了播放列表中的无缝过渡之外，还可剪裁单个串流和播放列表中最终串流的编码器末尾内边距 (#2576)。
  • 在数据流开头编码器延迟修剪完成后，如果不需要修剪数据流结尾填充，请避免在 TrimmingAudioProcessor 中进行不必要的音频缓冲区复制。
• 视频：
  • 修复了具有相同释放时间戳的延迟视频帧的报告，以便将其报告为丢弃而不是跳过。
• 文本：
  • 添加 MediaItem.SubtitleConfiguration.timeOffsetUs，以相对于媒体移动旁加载字幕的时间戳。在播放期间，可以使用 Player.replaceMediaItem(int, MediaItem) 更改偏移量，而不会中断播放 (#1976)。
  • SubRip：添加了对将 CharsetDetector 注入 DefaultSubtitleParserFactory 的支持，以检测没有字节顺序标记的独立 SubRip 字幕的字符编码 (#2247)。
• 效果：
  • 使用 StudioSound GMSCore 模块实现 SoundSeparationAudioProcessor，以进行音频源分离。
• 多路复用器：
  • 修复了 Mp4Muxer 和 FragmentedMp4Muxer 中 Opus 的 dOps 框写入问题，其中 PreSkip、InputSampleRate 和 OutputGain 是以小端序而非大端序写入的 (#3431)。
  • 支持使用 Mp4Muxer 在 Mp4LocationData 中写入 GPS 海拔高度。
  • 添加了 Muxer.Factory.create(ParcelFileDescriptor)，以允许直接多路复用到 ParcelFileDescriptor。
  • 默认情况下，在分段 MP4 文件的 traf 框中写入 tfdt（轨道片段基本媒体解码时间）框，以提供媒体解码时间戳。
  • 支持在 Mp4Muxer 中写入 E-AC-3 和 E-AC-3 JOC（杜比全景声）dec3 容器框。
  • 为 MediaMuxerCompat 添加了 WebM 格式支持。
  • 在分段 MP4 文件的末尾写入 mfra（影片片段随机访问）框，以便在 FragmentedMp4Extractor 中使用 FLAG_READ_MFRA_FOR_SEEK_MAP 进行跳转。
  • 修复了在写入任何其他样本之前写入 EOS 样本时 Mp4Writer 和 FragmentedMp4Writer 中发生的崩溃问题。
  • 通过在容器标头中通告 dby1 兼容品牌，修复将杜比内容多路复用到 MP4 或分段 MP4 文件时的容器合规性问题 (#3369)。
  • 在 Mp4Muxer 和 FragmentedMp4Muxer 中支持 32 位浮点 PCM 音轨 (#3389)。
  • 添加轨道时，拒绝 Mp4Muxer 和 FragmentedMp4Muxer 中不受支持的杜比视界配置文件。
  • 支持 Mp4Muxer 和 FragmentedMp4Muxer 中的 24 位和 32 位整数 PCM 音轨。
• IMA 扩展程序：
  • 在 ImaServerSideAdInsertionMediaSource 中将播放器暂停和恢复事件转发到 IMA SDK。
• 会话：
  • 添加 MediaConstants.EXTRAS_KEY_PLAYLIST_ID、MediaConstants.EXTRAS_KEY_PLAYLIST_TITLE、MediaConstants.EXTRAS_KEY_PLAYLIST_ARTWORK_URI 和 MediaConstants.EXTRAS_KEY_CATEGORIES，以便根据旧版元数据和说明填充播放列表和内容项元数据，并添加 MediaConstants.EXTRAS_KEY_SUGGESTED_TYPE 和 MediaConstants.EXTRAS_KEY_TTL_SECONDS，以便提供建议 LibraryParams.extras。
  • 修复了在强制执行严格 PendingIntent 限制的设备上创建或释放 MediaSession 时发生的 SecurityException 崩溃问题。
  • 修复了以下问题：在 Android 12（API 31 和 32）上，当 MediaSessionService 尚未在前台运行时，MediaSession.getControllerForCurrentRequest() 会在播放请求期间返回 null。
  • 修复了当 MediaController 连接到报告负最大音量的旧版会话时 IllegalArgumentException 崩溃的问题。
  • 修复了以下问题：在暂停的旧版 MediaSessionCompat 上调用 MediaController.setMediaItem 或 setMediaItems，然后调用 play()，可能会分派不受支持的 onPrepareFrom* 回调（而不是 onPlayFrom*），或者分派 onPlay() 而不重新初始化请求的媒体文件。
  • 修复了在收到自定义命令响应时旧版 MediaBrowser 中的 NullPointerException 问题 (#3432)。
  • 修复了在底层 Bundle 中接收具有重复键的旧版元数据时 IllegalArgumentException 崩溃的问题。
  • 控制旧版 MediaSessionCompat 时，合并在同一 Looper 迭代中发出的传出 MediaControllerCompat.TransportControls 调用（例如，现在同时调用 setMediaItem、prepare 和 play 会调度单个 onPlayFrom* 回调）。
• 界面：
  • 修复了启用双向文本换行时 RTL 字幕标点符号定位和 span 范围保留问题 (#3454、#3455)。
  • 将 TrackSelectionState 和 TrackSelectionParametersState 类及其对应的可组合状态 remember 函数添加到 media3-ui-compose 模块。
  • 引入 PresentationState.videoAspectRatio，并使 Modifier.resizeWithContentScale 采用 aspectRatio: Float? 而非 sourceSizeDp: Size?。
  • 将 CuesState 类和 rememberCuesState 可组合项添加到 media3-ui-compose 模块，以便监听播放器的当前提示。
  • 如果 ProgressSlider 基于 ExoPlayer 或 CompositionPlayer，请为其添加拖动模式支持。
  • 向 PresentationState 添加 showArtwork 支持，并使用它来对 ContentFrame 和 Player 中提供的可选 artwork 可组合项进行渲染计时。添加 Artwork 可组合项，用作 artwork 槽位的默认值。
  • 向 PlayPauseButtonState 添加新字段（showBuffering、showRetry、showReplay），并在 PlayPauseButton 中使用这些字段来呈现更多图标和缓冲指示器。
  • 添加了 PlaybackState 类，以允许自定义播放状态观察，并引入了 BufferingIndicator 作为独立于按钮的组件。
  • 修复了以下问题：在多时段直播中，PlayerView 和 PlayerControlView 会在时段边界处显示直播后贴片广告占位符的广告标记。
  • Player、ContentFrame、PlayerDefaults 和 MiniController 的可组合槽不再接收播放器或控件可见性作为参数。改为从调用范围捕获它们（例如，topControls 现在为 @Composable BoxScope.() -> Unit）。这是对不稳定 API 的一项破坏性更改。
  • 向 ContentFrame、Player 和 Modifier.resizeWithContentScale 添加 alignment 参数，以便将经过缩放的内容放置在其容器中，并将 ContentFrame 的内容剪辑到其边界，这样使用 ContentScale.Crop 缩放的视频就不会再在其外部绘制。
  • 通过公开 isLive 和 liveOffsetMs，为 ProgressSlider、ProgressStateWithTickCount 和 ProgressStateWithTickInterval 添加了直播界面支持。向 media3-ui-compose-material3 添加了 LiveButton 可组合项 (#2213)。
• Ktor 扩展程序：
  • 修复了 KtorDataSource 可能会将流中连接失败视为输入结束，而不是抛出 HttpDataSourceException 的问题 (#3460)。
• HLS 扩展程序：
  • 将 EXT-X-STREAM-INF 和 EXT-X-I-FRAME-STREAM-INF 上的 VIDEO-RANGE（PQ 和 HLG）解析为 Format.colorInfo (#3441)。
  • 修复了解析包含 PES 媒体样本的 MPEG-TS EXT-X-MAP 初始化片段时出现的 NullPointerException 问题 (#3456)。
  • 修复了以下回归问题：对于公开的 HLS 轨道，Format.id 和 Format.metadata 为 null (#3402)。
  • 将素材资源列表广告剪辑为 X-PLAYOUT-LIMIT，并跳过完全超出限制的广告；当插页式广告省略 X-RESUME-OFFSET 且其时长未知时，即使设置了 X-PLAYOUT-LIMIT，也将内容恢复偏移量默认设置为 0。
  • 修复了以下问题：解析 X-ASSET-LIST 插页式广告会覆盖同一广告组中其他插页式广告的内容恢复偏移量贡献。
• DASH 扩展程序：
  • 支持在 DashManifestParser 中解析 Alternative MPD Insertion (urn:mpeg:dash:event:alternativeMPD:insert:2025) 和 Replacement (urn:mpeg:dash:event:alternativeMPD:replace:2025) 事件，并在 Period.alternativeMpdEvents 中将其公开为 AlternativeMpdEvent 实例。对于子类化 DashManifestParser 的应用，这是一项破坏性更改：DashManifestParser.buildPeriod 现在会采用额外的 List<AlternativeMpdEvent> 参数，并且之前的重载已被移除。替换 DashManifestParser.parseEventStream(XmlPullParser) 的应用必须改为替换 DashManifestParser.parseEventStream(XmlPullParser, String)，因为前者已废弃，并将在未来的版本中设为 private。
  • 将 CICP 颜色信息（ColourPrimaries、TransferCharacteristics、MatrixCoefficients 和 VideoFullRangeFlag）从 EssentialProperty 和 SupplementalProperty 描述符解析为 Format.colorInfo (#3426)。
  • 支持在特技模式 (http://dashif.org/guidelines/trickmode) 描述符 @value 属性中使用以空格分隔的 @id 值列表 (#3315)。
  • 支持在 DashManifestParser 中解析 <ProducerReferenceTime>，在 AdaptationSet.producerReferenceTimes 中公开它，并使用它来填充 VOD 视频流的 Timeline.Window.presentationStartTimeMs 和 Timeline.Window.windowStartTimeMs。
  • 添加了对 DASH 内容控制的支持 (#1689)。
  • 修复了在解析 <UTCTiming> 元素中缺少属性的 DASH 清单时可能发生的 NullPointerException (#3436)。
• RTSP 扩展程序：
  • 修复了在 RTSP 客户端关闭后处理延迟的网络响应时发生的 IllegalStateException 崩溃问题。
  • 修复了快速拖动进度条可能会错误地触发 TCP 协议回退机制的问题。
  • 修复了在 RTSP 客户端在曲目重新选择、会话拆解或 URI 重定向期间重置状态后，处理延迟的网络响应时可能发生的 IllegalStateException 崩溃问题。
  • 修复了在播放重启之前再次跳转可能会导致 IllegalStateException 崩溃的问题。
  • 修复了以下问题：在跳转操作已处于待处理状态时向后跳转可能会导致音频中断和视频播放卡顿。
  • 修复了以下问题：以聚合或非 IDR 数据包结尾的 H.264 和 H.265 关键帧访问单元未被标记为关键帧，导致播放一直卡在缓冲状态 (#3434)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • Opus 扩展程序：修复了解码无效 Opus 数据时发生的 JNI 崩溃问题。
  • Opus 扩展程序：修复了当预跳过和舍弃填充位于同一数据包时，舍弃填充被忽略的问题 (#2576)。
• Cast 扩展程序：
  • 引入 SessionAvailabilityListener.SessionUnavailableReason 来表示会话不可用的原因，并为 SessionAvailabilityListener.onCastSessionUnavailable 提供重载方法来公开该原因。
  • 修复了停止投放会话后，播放会在本地意外恢复的问题。
  • 当 RemoteMediaClient 操作（例如播放、暂停、速度更改、循环模式、音量、静音或曲目选择）在 RemoteCastPlayer 中失败时，记录错误 (#3373)。
  • 修复了在跳转操作处于待处理状态时，如果 Cast 接收器队列发生更改或缩减，RemoteCastPlayer 中会出现 ArrayIndexOutOfBoundsException 的问题 (#3372)。
  • 修复了默认 Cast 接收器的一个问题：时间轴仅填充紧邻活动媒体文件周围的媒体文件，而不是整个播放列表 (#3129)。
  • 在修改播放列表（setMediaItems、addMediaItems、moveMediaItems、removeMediaItems）或在 RemoteCastPlayer 中跳转时，立即更新时间轴和播放位置，并将连续的播放列表操作加入队列，以便它们按顺序可靠地执行（#2639、#3272）。
  • 修复了以下问题：在 RemoteCastPlayer 中的空队列上调用 addMediaItems 无法在 Cast 接收器上加载媒体文件 (#2402)。
  • 修复了 RemoteCastPlayer 中的一个问题：到达 Cast 接收器队列末尾时，会清除时间轴，而不是保留播放列表。
  • 修复了以下问题：在加载媒体内容之前（例如，在 CastPlayer 中从本地播放切换到远程播放期间），在 RemoteCastPlayer 上设置的 playWhenReady、repeatMode 和 playbackParameters 未传输或应用 (#889)。
• 演示版应用：
  • 为会话演示应用目录添加了对受 DRM 保护的媒体文件和额外 HLS 示例串流的支持。
  • 在会话演示应用中使用 CastTrackSelector 配置 RemoteCastPlayer，以便在投射时选择字幕和音轨。
• 移除了已废弃的符号：
  • 移除了 DashUtil.buildDataSpec(Representation, RangedUri, int) 和 DashUtil.buildDataSpec(Representation, String, RangedUri, int)。请改用 DashUtil.buildDataSpec(Representation, BaseUrl, RangedUri, int, Map<String, String>)。
• build：
  • 将 Gradle minSdk 提高到 24。

版本 1.11.0

1.11.1

2026 年 9 月 10 日

• ExoPlayer：
  • 将用于为渐进式媒体启用/停用 HAGC 元数据的标志从 MediaSource.Factory 移至 ExtractorsFactory。之前的 setExperimentalEnableHagcPlayback 方法已被移除，取而代之的是 ExtractorsFactory.setParseHagcMetadata。此版本还解决了停用功能不适用于 Matroska/WebM 容器的问题。
  • 修复了在预热非过渡辅助渲染程序时导致播放停滞的问题。
  • 修复了以下预热问题：当跳转重置并停用两个渲染器时，Surface 应返回到主渲染器。
  • 修复了以下问题：当直播时间轴刷新将默认位置移过当前正在播放的服务器端插入广告时，ArrayIndexOutOfBoundsException 会发生崩溃 (#3348)。
  • 修复了拖动模式问题：在启用 ScrubbingModeParameters.allowSkippingMediaCodecFlush 的情况下拖动进度条时，可能会短暂显示过时的视频帧。
• 提取器：
  • Matroska：修复了以下问题：在集群后放置的轨道不会导致可跳转的时间轴 (#3377)。
• 音频：
  • 修复了 SilenceSkippingAudioProcessor 中的缓冲区大小计算，以便最短静音时长不会因帧大小而错误地缩减 (#3271)。
  • 修复了 PcmAudioUtil 中的 8 位 PCM 处理，以将样本视为 Android 定义的无符号样本 (#3271)。
  • 修复了以下分流问题：由于硬件缓冲区空间大小有限，播放可能会在播放前贴片广告或无缝过渡期间停滞。
  • 修复了 DefaultAudioSink 中的一个 bug：当播放线程不再处于活动状态时，释放计数不会减少 (#3338)。
• 会话：
  • 修复了从 Player.Listener 回调中释放进程内 MediaController 时出现的 NullPointerException 问题 (#3375)。
  • 修复了以下问题：当旧版 MediaBrowser 连接到从 onGetLibraryRoot() 或 onConnectAsync() 返回异步结果的服务时，主线程上会出现死锁 (#3393)。
• HLS 扩展程序：
  • 修复了当要贴靠的目标片段尚未在播放列表中时内容恢复偏移量的计算问题 (#3322)。
  • 修复了以下问题：完全消耗的 HlsMediaChunk 在收到来自提取器的 EOFException 时会重试加载 (#3350)。
• DASH 扩展程序：
  • 修复了具有 presentationTimeOffset 的图片轨道的错误样本时间戳计算问题 (#3334)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • Opus：修复了同时初始化多个 OpusDecoder 实例时出现的内存损坏问题。
  • MPEG-H：修复了向 MpeghUiManager 发送命令时，在内存不足的情况下发生的内存泄漏、非 ASCII 字符截断和潜在的原生代码崩溃问题 (#3365)。

版本 1.11.0

2026 年 8 月 5 日

• 通用库：
  • 添加 Format.channelMask 以明确表示音频声道掩码，并添加新的 Util.getAudioTrackChannelConfig(Format) 重载以安全地解析它。
  • 将 Kotlin 从 2.0.20 升级到 2.2.0。
• ExoPlayer：
  • 修复了可能导致 ExoPlayer 中出现 IllegalStateException 或 IndexOutOfBoundsException 的时间相关并发 bug。
  • 放宽 AdsMediaSource 中的广告组数量检查，以便在广告组完全处理完毕（hasUnplayedAds() 为 false）时允许广告组数量减少，从而在重置工作流期间适应动态广告组大小调整。
  • 将 getFlags() 和 FLAG_STRICT_DURATION 添加到 SampleStream，以允许数据流报告标记，并更新渲染程序以动态检查这些标记。
  • 当数据流格式未提供有效值时，回退到 MediaCodecVideoRenderer 中的帧速率估算器和 MediaCodecAudioRenderer 中的编解码器输出格式，以计算编解码器运行速率，并避免不必要的编解码器重置。
  • 移除了核心播放器中客户端植入广告的内容剪辑。而是由 AdsMediaSource 负责剪裁逻辑。 需要更新自定义客户端植入广告来源，以便在内部实现内容剪辑。
  • 将具有格式正确但无法识别的编解码器配置文件或级别的轨道标记为 supported=NO_EXCEEDS_CAPABILITIES，而不是 supported=YES（这是缺少配置文件或级别信息或配置文件或级别信息格式不正确的轨道的标记方式）。这样可以确保在有支持效果更好的替代轨道时，不会选择这些轨道（设备不太可能支持这些轨道）。
  • 添加 DefaultPreloadManager.SimpleRankingDataComparator，这是一个 RankingDataComparator，用于根据媒体文件与当前播放媒体文件的索引之间的距离来比较媒体文件的排名。如果需要更精细的比较逻辑，应用可以替换其 compare(Integer, Integer) 方法。可以通过 DefaultPreloadManager.Builder 的新构造函数注入自定义 SimpleRankingDataComparator。
  • 如果可用堆内存似乎不足，则回退到缓冲区字节大小限制，从而降低 DefaultLoadControl.prioritizeTimeOverSizeThresholds 的 OOM 风险。
  • 统一了未设置 MediaItem.imageDurationUs 时静态图片的处理方式：JPEG 和 HEIC 静态图片现在会以非常短的默认时长“播放”（与 PNG 和其他图片之前的行为相同）。
  • 添加 MediaSource.prepareSource(MediaSourceCaller, PlayerId, BandwidthMeter) 以将 BandwidthMeter 传递到 MediaSource。不过，默认情况下，系统仍会调用具有自定义实现的已废弃方法，因此建议您实现新方法并使用 BandwidthMeter.getTransferListener() 来实现与旧方法等效的功能。
  • 在 DefaultBandwidthMeter 中，添加了对自定义 InitialBitrateSupplier 的支持。这样，应用就可以提供自己的逻辑来确定初始比特率估算值，该估算值将在创建 DefaultBandwidthMeter 以及网络类型发生变化时使用。可通过 DefaultBandwidthMeter.Builder.setInitialBitrateSupplier() 设置供应商。
  • 默认启用动态调度。ExoPlayer 播放工作循环将动态运行，而不是按静态间隔运行。
  • 移除了在将带有预卷样本的轨道加入到活跃播放时可能发生的不必要重置。
  • 在 DefaultBandwidthMeter 中，优化 getInitialBitrateCountryGroupAssignment 以返回打包到 32 位整数（而不是数组）中的国家/地区组分配，从而缩减代码大小并避免分配。
  • 通过确保在其他重试（将缓冲区大小减半）不成功时，重试逻辑始终尝试至少 1 秒的缓冲区空间，修复了某些设备上的 AudioTrack 初始化失败问题 (#3207)。
  • 修复了某些设备上的编解码器问题：如果之前在收到输入缓冲区之前已刷新，编解码器会吞噬所有样本。
  • 添加了实验性 ExoPlayer.Builder.enablePerStreamMediaProgression()，以便按数据流推进媒体处理。这可以减少播放列表项之间的启动延迟，并避免播放内容非常短时出现“卡顿”的情况 (#3122)。
  • 修复了与音频会话 ID 使用相关的竞态条件，其中会使用由 ExoPlayer 自动生成的初始音频会话 ID，而不是由 setAudioSessionId 设置的值 (#3241)。
  • 为渐进式媒体（例如 MP4、Matroska）添加了实验性 HAGC (ST 2094-50) 定时元数据播放支持。播放器会自动将 HAGC 元数据轨道与关联的视频轨道合并，并在搭载 API 37+ 的设备上将元数据带外传递给解码器。此行为可通过 DefaultMediaSourceFactory.setExperimentalEnableHagcPlayback(false) 停用。
  • 添加了 Format.selectionPriority，用于表示 Format 在轨道选择中的相对偏好 (#3236)。
  • 修复了潜在的拖动模式问题：在拖动到“流末尾”时，拖动可能会停滞。
• CompositionPlayer：
  • 修复了 TrackSelector 实例未释放的问题。
• 转换器：
  • 修复了 ExportResult.fileSizeBytes 可能会被过度报告的问题。
• 轨道选择：
  • 公开 BaseTrackSelection.DEFAULT_FORMAT_COMPARATOR 并添加 AdaptiveTrackSelection.Factory.setTrackFormatComparator，以允许自定义格式排序和 ABR 选择优先级，而不仅仅是按比特率排序。
  • 修复了与时间相关的并发问题，即快速连续更新轨道选择参数可能会导致某些更新丢失或被覆盖。
• 提取器：
  • MP4、MP3 和 FLAC：添加了 FLAG_DISABLE_ARTWORK_METADATA，以便在容器解析期间舍弃附加图片和封面图片元数据，从而减少运行时内存消耗 (#2077)。您也可以通过 DefaultExtractorsFactory.setDisableArtworkMetadata 集中启用此功能。
  • MP4：添加了对提取 ITU-T T.35 (it35) 定时元数据轨道的支持。
  • MP4：添加了对提取章节元数据（Nero 和 QuickTime 格式）的支持。如果两者都存在，则首选 QuickTime 章节。提取的章节信息会作为 Chapter 条目在轨道的 Metadata 中公开，从而允许在 MP4、M4A 和 M4B 文件（例如有声读物和播客）中进行原生章节导航 (#2803)。
  • WAV、Matroska 和 MP4：添加了对 64 位浮点 PCM 音频的支持 (#3090)。
  • Matroska：使用编解码器比特流元数据填充准确的 ColorInfo。
  • MP4：添加了对在没有 sidx 框时使用 mfra 框在分段 MP4 文件中进行跳转的支持。如需启用此功能，请向 FragmentedMp4Extractor 提供 FLAG_READ_MFRA_FOR_SEEK_MAP，现在默认在 DefaultExtractorsFactory 中完成此操作 (#3088)。
  • 忽略版本不受支持的 av1C 数据。
  • MP4：在 fpcm 框中添加了对大端序浮点 PCM 的支持。
  • Matroska：将章节信息解析为曲目 Metadata 中的 Chapter 条目。
  • MPEG-TS：通过将核心和扩展子流合并到单个样本中，改进了 DTS-HD 和 DTS Express 流的提取，修复了之前将两者作为单独样本输出时的播放问题 (#3147)。
  • MP4：防止在解析空 ilst 元数据标记项时出现无限循环和越界读取 (#3191)。
  • MPEG-TS：确保为最后一个 PES 数据包长度已知的串流渲染最后一帧 (#3206)。
  • MP3：修复了包含 Xing 和 VBRI 标头的文件比特率报告问题。
  • Matroska：处理了在最后一个集群中定义的轨道 (#3250)。
  • Matroska：添加了对 ALAC 的支持 (#3268)。
  • MP4：允许在分段 MP4 文件中使用可变长度 sgpd 框 (#3243)。
  • AVI：修复了播放音轨上没有关键帧标志的文件会导致音频丢失和 OutOfMemoryError 的问题。
  • MP3：使用 Xing/Info 标头中支持无缝播放的时长 (#3183)。
  • MP3：调整 LAME/Xing 编码器延迟和填充元数据，以匹配解码后的 PCM 剪裁 (#3200)。
• 音频：
  • 在 ExoPlayer 的音频渲染器中，从就绪状态过渡到未就绪状态时，添加了 100 毫秒的宽限期，以消除瞬时欠载并避免在主动播放期间出现意外缓冲状态 (#3210)。
  • 更改了 DefaultAudioTrackBufferSizeProvider 中的默认 PCM 缓冲区大小逻辑，以使用固定的 500 毫秒缓冲区，从而减少对设备的依赖。
  • 更新 MediaCodecAudioRenderer，以从平台解码器中提取空间 channelMask，从而允许 DefaultAudioSink 使用此显式掩码，而不是根据声道数推断掩码。
  • 将 AudioSink.configure 的参数转换为数据类。ForwardingAudioSink.configure 的自定义替换项需要迁移到新的方法签名。
  • 添加了对使用 EditedMediaItem.Builder#setSpeed(SpeedParameters) 对音频串流进行时间拉伸时保持音高的支持。
  • 增强了 ToFloatPcmAudioProcessor，以支持将 8 位 PCM、16 位大端序 PCM 和 64 位浮点 PCM 转换为 32 位浮点 PCM (#3090)。
  • 将 DecoderAudioRenderer.getChannelMapping 的返回值更改为 ImmutableIntArray。
  • 修复了在压缩分流模式下播放无缝音频播放列表时播放卡住的 bug。
  • 将 Timeline 和时间段 UID 转发到 AudioSink.configure 和 AudioProcessor.StreamMetadata，以便向音频处理器提供播放列表上下文 (#418)。
  • 设置正确的 AudioProcessor.StreamMetadata.positionOffsetUs 以允许基于时间的音频处理 (#418)。
  • 添加了对大端序 32 位和 64 位浮点 PCM 的支持。
  • 移除了 EAC3-JOC 到 EAC3 的回退路径，以便在 Google Pixel 设备上播放，因为其标准 EAC3 解码器无法解码 EAC3-JOC 流 (#3257)。
• 视频：
  • 修复了视频联接逻辑，以便将联接期间丢弃的缓冲区计为跳过，而不是丢弃。
  • 修复了设置新 Surface 时的即时渲染决策，以避免在不支持占位 Surface 的设备上出现丢帧。
  • 通过考虑丢弃或跳过的帧，修正 MediaCodecVideoRenderer 中的帧速率估算，使其更加准确。
  • 允许配置用于提前调度帧的阈值。默认值为 50 毫秒，但您可以通过 MediaCodecVideoRenderer.Builder.setMaxEarlyUsThreshold() 自定义该值。
  • 修复了 VideoFrameReleaseHelper 中的一个 bug，该 bug 导致显示更改可能会在主线程上触发冗余 Choreographer 回调和过多的 CPU 唤醒。
• 文本：
  • TTML：对于区域，从 style 回退到 displayAlign (#2559)。
  • TTML：从 <p> 元素的父级继承提示开始时间 (#3246)。
• 元数据：
  • 添加 MediaMetadata.discSubtitle 字段，并从 ID3v2.4 TSST 和 Vorbis DISCSUBTITLE 数据中解析该字段。
  • 从 ID3 TPOS 帧中解析光盘编号和数量。
• 效果：
  • 在刷新时清除 FinalShaderProgramWrapper 中的重绘状态，以防止播放器在跳转时卡住。
• 多路复用器：
  • 通过新的 addTrackReference API，在 Mp4Muxer 中添加了对轨道引用（tref 框）的支持。这样就可以在轨道之间建立关系，例如将元数据轨道与其描述的视频轨道相关联。
  • 添加 OggMuxer，以允许将 OPUS 或 VORBIS 媒体流多路复用到 ogg 文件格式中。
  • 添加了 WavMuxer 以生成 WAV 文件（支持整数和浮点 PCM）。
  • 将 setAttemptStreamableOutputEnabled 添加到 InAppMp4Muxer.Factory，以便在没有预留空间的情况下写入较小的不可流式传输文件。
  • 在 Mp4Muxer 和 FragmentedMp4Muxer 中添加了对 IAMF 音频的支持。
• IMA 扩展程序：
  • 添加 ImaServerSideAdInsertionMediaSource.AdsLoader.Builder.setPauseAdSlot，以允许提供用于暂停时广告的广告位。
  • 修复了以下 bug：连续播放的可跳过 VAST 广告会在第二个广告上立即显示“跳过”按钮 (#3165)。
• 会话：
  • 修复了在将会话与后台线程播放器 Looper 搭配使用时，MediaNotificationManager 内部可能发生的死锁和 IllegalStateException 崩溃问题。
  • 对 MediaSession 方法强制执行更严格的线程要求。Void 方法现在会自动将执行发布到应用 Looper 线程，如果从应用 Looper 以外的线程调用状态访问器（getter），则会明确抛出 IllegalStateException。
  • 通过在会话端跟踪每个控制器的状态一致性，修复了越界时间轴合并崩溃问题（MediaUtils.mergePlayerInfo 中的 IllegalStateException）。
  • 添加了 androidx.media3.session.MediaSessionManager，以支持查询活跃媒体会话并返回 Media3 SessionToken 实例。
  • 如果未替换该方法，则更改 MediaSession.Callback.onConnect 的默认行为，以便仅向不受信任的控制器提供读取权限。
  • 添加了对在通过新 API MediaSession.Builder#setPackageNameOverride 创建 MediaSession 时替换软件包名称的支持。调用方必须具有 android.permission.OVERRIDE_MEDIA_SESSION_OWNER 权限才能替换会话的软件包名称。
  • 添加了 MediaSession.Callback.onConnectAsync()。新方法允许异步处理控制器的连接尝试。应用可以返回一个带有 Futures.immediateFuture(ConnectionResult) 的即时 Future，以实现之前的行为。建议您改用新方法，因为 Callback.onConnect 可能会被弃用。
  • 修复了蓝牙 AVRCP 浏览无法在 API 36 和 37 上识别 MediaLibraryService 的问题。
  • 修复了当图片大小接近平台限制时，MediaSession 中图片两次缩减的问题，从而解决了通知中的模糊问题 (#3134)。
  • 修复了以下问题：当应用在后台运行时，异步封面图片位图加载回调尝试启动前台服务，导致 MediaNotificationManager 中发生 ForegroundServiceStartNotAllowedException 崩溃 (#3270)。
  • 修复了 MediaController 接收的 PositionInfo 对象缺少其原始 Timeline UID 的问题。现在，会话可在状态更新期间可靠地转换和传播这些 UID。
  • 通过在 MediaSessionService.stopSelfSafely() 中捕获 ForegroundServiceStartNotAllowedException 来修复崩溃问题 (#3310)。
  • 修复了在同一媒体文件内跳转时，MediaController 上出现意外 onMediaItemTransition() 回调的问题 (#3248)。
• 界面：
  • 修复了在播放过程中重组 ContentFrame 时第一帧以错误大小呈现的问题 (#3238)。
  • 将 CurrentMediaItemState 类和相应的 rememberCurrentMediaItemState 可组合项添加到 media3-ui-compose 模块。此状态容器在 demo-compose 中用于显示有关当前播放的 MediaItem 的各种元数据信息。
  • 将 PlaylistState 类和对应的 rememberPlaylistState 可组合项添加到 media3-ui-compose 模块。此状态容器在 demo-compose 中用于显示有关在播放器上设置的 MediaItems 的各种元数据信息。
  • 向 PlaybackSpeedState 添加了快进/慢动作 API。在 demo-compose 中使用此功能，以展示长按快进。
  • 将 MiniController 可组合项添加到 media3-ui-compose-material3 模块。 它提供了一个紧凑的控件来控制 Player，同时显示当前媒体文件的标题、音乐人、封面和进度。
  • 将 ErrorState 类和对应的 rememberErrorState 可组合项添加到 media3-ui-compose 模块。将 ErrorText 可组合项添加到 media3-ui-compose-material3，并将其设为 Player 上的默认叠加层。
  • 发布 PlayerDefaults 对象，其中包含 TopControls、CenterControls、BottomControls 和 ErrorOverlay 的可组合项。
  • 向 Player 可组合项及其内容槽添加 FocusRequester。
  • 发布 PlayerPool (common-ktx) 和 rememberPooledPlayer (ui-compose)，以支持在滑动窗口界面环境中预加载 MediaItems。使用新的 ShortFormPlayerScreen 在 demo-compose 中展示此功能。
  • 修复了 PlayerView 和 Compose PresentationState 中的快门抑制 bug，该 bug 会导致在不支持时间段 UID 查找的时间轴上发生崩溃 (#3264)。
• 下载内容：
  • 在提取媒体播放列表以供下载时，解析其中的 HLS 变量 (#3258)。
• Ktor 扩展程序：
  • 添加了一个新的 media3-datasource-ktor 扩展模块，该模块提供由 Ktor HTTP 堆栈支持的 KtorDataSource。
  • 修复了 KtorDataSource 在打开连接时将整个 HTTP 响应正文加载到内存中的问题 (#3305)。
• HLS 扩展程序：
  • 添加了对 HLS 内容控制和路径克隆的支持 (#1689)。
  • 向 HlsInterstitialsAdsLoader 添加了 setWithAssetListReset，以便应用将已完全处理的素材资源列表插页式广告重置回不可用状态，以便按需重新解析。
  • 解析 EXT-X-STREAM-INF 和 EXT-X-I-FRAME-STREAM-INF 的 SCORE 属性，并将其填充到 Format.selectionPriority (#3236)。
  • 修复了以下 bug：即使 HLS 播放列表不再是主要播放列表或活跃播放列表，系统仍会继续按计划刷新该播放列表 (#3254)。
  • 修复了解析插页式广告素材资源列表时内容恢复偏移量的计算问题 (#3322)。
  • 修复了在播放列表请求失败后恢复低延迟直播播放时，音频轨道时间戳意外不连续的问题 (#3311)。
  • 修复了 HlsMediaPeriod.getStreamKeys() 中的 bug，该 bug 会导致音频呈现中的 ID3 轨道被视为字幕 (#3333)。
• DASH 扩展程序：
  • 根据语言将 CEA 隐藏式字幕分隔到不同的 TrackGroup 中 (#3113)。
  • 添加了对以下操作的支持：从清单 (MPD) 中解析多个 Location 元素，并在清单加载失败时在 DashMediaSource 中执行位置回退。
  • 修复了打开包含空 <SegmentTimeline/> 元素的清单时发生的崩溃 (IndexOutOfBoundsException) 问题 (#3326)。
• RTSP 扩展程序：
  • 修复了在 RTSP 播放准备期间因 UDP 端口绑定错误而导致的暂时性播放卡顿或失败问题。
• Cast 扩展程序：
  • 添加了新的 CastParams 类，以便通过调用 Cast.initialize(CastParams) 来配置 Cast。
  • 添加了新的 CastParams.getShowSystemOutputSwitcherOnCastIconClick() 选项，该选项会在可用时触发使用 SystemUI 输出切换器，而不是应用内投放设备选择器。
  • 添加了 MediaRouteButtonState 和 rememberMediaRouteButtonState，以支持观察媒体路线选择器的可见性状态，并向 MediaRouteButton 添加了 state 参数 (#3172)。
  • 修复了以下 bug：RemoteCastPlayer 在选择轨道后可能会永久卡在轨道遮盖状态，导致其忽略来自 Cast 接收器的后续轨道更新 (#3237)。
  • 修复了以下 bug：当尝试加入从非 Media3 发送器启动的投射会话时，DefaultMediaItemConverter 会抛出 NullPointerException。
  • 防止 CastPlayer 在更改活跃播放器时传输无法播放的 MediaItems (#3199)。
  • 修复了未配置的直播 (liveConfiguration == UNSET) 会作为 STREAM_TYPE_BUFFERED 排队的 bug (#3318)。
• 测试实用程序：
  • 扩展 DataSourceContractTest，以支持带有标头和正文的 POST 请求，向 HttpDataSourceTestEnv 添加一些 POST 资源，并在 WebServerDispatcher 中为预期的 HTTP 方法、标头和正文添加断言。
  • 在 DataSourceContractTest 中收紧针对 DataSource.open() 返回的长度的断言。可能导致 C.LENGTH_UNSET 的资源应使用 TestResource.Builder.setMayResolveToUnknownLength(boolean) 指示这一点。
  • 将 setPlaybackLooper 添加到 TestExoPlayerBuilder 中。
• 移除了已废弃的符号：
  • 移除了 androidx.media3.exoplayer.MetadataRetriever。改用 androidx.media3.inspector.MetadataRetriever。
  • 移除了 androidx.media3.exoplayer.MediaExtractorCompat。改用 androidx.media3.inspector.MediaExtractorCompat。
  • 移除了 Mp4Extractor.FLAG_READ_MOTION_PHOTO_METADATA。请改用 HeifExtractor 从 HEIC 文件中提取动态照片元数据。
  • 移除了 androidx.media3.extractor.metadata.mp4.MotionPhotoMetadata。改用 androidx.media3.extractor.metadata.MotionPhotoMetadata。
  • 移除了 androidx.media3.extractor.DummyTrackOutput。改用 androidx.media3.extractor.DiscardingTrackOutput。
  • 移除了 androidx.media3.extractor.DummyExtractorOutput。改用 androidx.media3.extractor.NoOpExtractorOutput。
  • 移除了 androidx.media3.common.C.generateAudioSessionIdV21。改用 androidx.media3.common.util.Util.generateAudioSessionId。
• build
  • 更新了 README.md 说明，以便在本地依赖 Media3 时使用 Gradle 复合 build (includeBuild)。core_settings.gradle 脚本已被移除，androidxMediaModulePrefix 和 androidxMediaEnableMidiModule 属性不再使用。

1.11.0-rc01

使用 1.11.0 稳定版。

1.11.0-beta01

2026 年 7 月 7 日

使用 1.11.0 稳定版。

1.11.0-alpha01

2026 年 6 月 24 日

使用 1.11.0 稳定版。

版本 1.10.0

1.10.1

2026 年 5 月 12 日

• 通用库：
  • 修复了 SimpleBasePlayer 和 ForwardingSimpleBasePlayer 中 onAudioSessionIdChanged 的处理方式。
• ExoPlayer：
  • 修复了与音频会话 ID 生成相关的竞态条件，该条件可能会导致 IllegalStateException 处于隧道模式。 (#3099)。
  • 修复了在通过渲染器预热从解码器错误中恢复时可能发生的应用崩溃问题。
  • 修复了以下问题：在使用基于 AV1 的 Dolby Vision 编解码器时，提供初始化数据会导致视频伪影 (#3153)。
• 轨道选择：
  • 调整 VideoTrackInfo 中的轨道选择逻辑，以解析后备 MIME 类型，并将 HDR 和编解码器评分偏好设置移至画质偏好设置 (#3135)。
• 提取器：
  • MP3：如果 Xing 数据长度大于已知数据流长度，则忽略 Xing 数据长度 (#3117)。
  • 修复了以下问题：在设置了 FLAG_OMIT_TRACK_SAMPLE_TABLE 且轨道缺少同步样本 (stss) 框时，Mp4Extractor 中出现 ArrayIndexOutOfBoundsException。
• 音频：
  • 修复了以下 bug：如果向播放器添加了多个音频渲染器，音频事件可能会被错误地路由。
• 视频：
  • 调整了在 API 级别低于 30 的设备上帧速率发生变化时编解码器重用的逻辑，以避免在没有益处的情况下重置编解码器 (#3120)。
  • 针对 API 31+ 停用了 queueSecureInputBuffer 中的强制同步解决方法。该解决方法是一个人为瓶颈，会强制解密串行运行，从而防止因 API 31 之前存在的框架问题而导致视频乱码。
• 图片：
  • 修复了在拖动模式下，图片更新仅在用户“停止拖动”时才会生效的问题 (#2815)。
• 会话：
  • 修复了以下 bug：如果应用线程不是主线程，ForegroundServiceStartNotAllowedException 不会跨线程边界传播 (#2499)。
  • 修复了以下 bug：在连接到仅支持跳转到其他内容但不支持修改播放列表的平台专用会话时，COMMAND_SEEK_TO_MEDIA_ITEM 在 MediaController 中不可用。
  • 修复了以下问题：MediaController 无法在不允许 PREPARE_FROM 操作的平台媒体会话中设置媒体文件。
  • 修复了以下 bug：在 API 27 或更低版本上，通过平台控制器连接时，自己的进程未标记为 Controller.isTrusted()。
• HLS 扩展程序：
  • 修复了以下 bug：如果所选轨道是可用轨道的子集，则在流回退期间会抛出 ArrayIndexOutOfBoundsException (#3161)。
  • 修复了以下问题：如果后续更新中未重复 #EXT-X-MAP 标记，则初始化片段不会在媒体播放列表更新中沿用 (#3105)。
• DASH 扩展程序：
  • 修复了在跳转到当前正在取消的块时 SampleQueue 中发生崩溃的问题。

1.10.0

2026 年 3 月 26 日

• 通用库：
  • 将 Player.mute() 和 Player.unmute() 从 UnstableApi 升级为稳定版。
  • 将 Format.pcmEncoding 和 C.PcmEncoding 从 UnstableApi 升级为稳定版。
  • 添加 Format.primaryTrackGroupId 以标识嵌入式 Format 实例的主组 (#294)。
• ExoPlayer：
  • 为 AdsMediaSource 添加了剪辑功能。
  • 在 MediaCodecVideoRenderer 中添加了对动态调度的支持，以便更好地使调度工作和 CPU 唤醒周期与视频帧的处理时间保持一致。您可以使用 DefaultRenderersFactory 中的 experimentalSetEnableMediaCodecVideoRendererDurationToProgressUs() 启用此功能。
  • 允许在 DefaultPreloadManager.Builder 中设置自定义 DataSource.Factory。
  • 通过将一些默认常量移至 ExoPlayer.Builder，允许在不使用 Robolectric 的情况下模拟 ExoPlayer。通常不建议模拟此复杂接口，除非其使用场景极少、简单或偶然 (#2985)。
    • 这需要将 DEFAULT_STUCK_PLAYING_DETECTION_TIMEOUT_MS 从 ExoPlayer 移至 ExoPlayer.Builder（不弃用）。
  • 修复了以下 bug：ProgressiveMediaSource 将过时的时间轴信息传播到播放器，导致已加入队列的时段意外被移除 (#3016)。
  • 修复了以下问题：在通话期间请求播放时，ExoPlayer 不会请求延迟的音频焦点。
  • 修复了从点播内容过渡到直播内容可能会导致在点播内容结束时重新缓冲的 bug (#3052)。
  • 添加了对 Dolby Vision Profile 10 的支持 (#2830)。
  • 修复了未初始化的前贴片广告会产生 ArrayIndexOutOfBoundsException 的 bug (#3125)。
• CompositionPlayer：
  • 添加了对 EditedMediaItem.removeVideo 的支持。
• 转换器：
  • EditedMediaItem.Builder.setFrameRate() 现在可以为视频设置最大输出帧速率，这在使用 setSpeed() 提高媒体速度时特别有用。
• 轨道选择：
  • 更改 DefaultTrackSelector.selectAllTracks 的签名，以将输出数组作为形参包含在内，并预先填充轨道替换。
  • 修复了以下问题：无论是否选择了相应的主轨道，都会选择嵌入式元数据轨道 (#294)。
  • 稳定 preferredVideoLanguages、preferredVideoLabels、preferredAudioLabels、preferredTextLabels 和 selectTextByDefault 的 TrackSelectionParameters 选项。
• 提取器：
  • MP4：支持在其他框（如 moov）之前具有大型 uuid 框的文件 (#3046)。
  • MP4：添加了对 MP4 容器中多功能视频编码 (VVC) 轨道的支持。
• 检查器：
  • 破坏性更改：移除了 FrameExtractor。用户现在应依赖于新的 :media3-inspector-frame 模块，并将导入更新为 androidx.media3.inspector.frame.FrameExtractor。
  • 引入了一个新模块，用于提取和处理解码后的视频帧。
• 音频：
  • 将 IAMF 解码器扩展程序的底层解码库从 libiamf 更改为 iamf_tools。
  • IAMF 解码支持通过解码器（使用 IAMF 解码器扩展程序时）或通过 Android Spatializer 实现双耳输出。
  • 在汽车场景中评估 AC-4 解码器支持时，正确移除对 AC4Profile22 和其他旧版配置文件的支持 (#2609)。
  • 改进了 DefaultAudioSink 中 AudioOutput 初始化的重试逻辑 (#2905)。
  • 在解码 IAMF 时，尝试匹配扬声器（或空间化器，如果适用）的输出布局，同时使用 IAMF 扩展程序和媒体编解码器解码器，并由 AudioCapabilities 和 AudioCapabilitiesReceiver 中的新字段和逻辑提供支持。
  • 修复了在压缩分流模式下播放无缝音频播放列表时播放卡住的 bug。
• 文本：
  • VobSub：使用 START 和 STOP SPU 控制命令来推导提示时长，而不是始终默认为 5 秒 (#2935)。
• 元数据：
  • 将元数据渲染程序的默认数量增加到 4 个，以涵盖 HLS 变体和演绎版本发布的所有潜在元数据轨道 (#3043)。
• 效果：
  • 将 LottieOverlay 移至新的 :media3-effect-lottie 模块（其中还涉及将其从 androidx.media3.effect.LottieOverlay 重命名为 androidx.media3.effect.lottie.LottieOverlay）。
• 效果 Lottie：
  • 引入了新的 :media3-effect-lottie 模块，该模块提供了将 Lottie 效果应用于视频帧的功能。
• IMA 扩展程序：
  • 将 IMA SDK 版本更新至 3.39.0，以便使用最新的广告媒体信息 API。
  • 修复了广告 MIME 类型与 IMA LOADED 事件中提供的 MIME 类型不匹配的 bug。现在，此修复会使用 IMA 提供的广告媒体信息来映射广告 MIME 类型。
  • 向 ImaAdsLoader 和 ImaServerSideAdInsertionMediaSource 添加了 setEnableCustomTabs，让用户可以控制是否使用自定义标签页启动广告点击后到达网址。
  • 添加 ImaAdTagUriBuilder，该类提供了另一种构造 adTagUri 的方法。它包含 setPreferredLinearOrientation API。这是一个处于 Alpha 版测试阶段的 API，可让您设置线性广告的首选屏幕方向。如果您想加入 Alpha 版测试群组，请与您的客户合作伙伴联系。
• 会话：
  • 修复了 MediaMetadata.artworkData 中的大型数组可能导致应用崩溃的 bug。
  • 在 ActionFactory 接口中对 @Player.Command 参数使用 int 类型 (#2933)。
  • 将 MediaSessionService 和 MediaLibraryService 设为 LifecycleService，以便将生命周期感知型操作附加到服务的生命周期 (#187)。
  • 停止支持通过 MediaController 和 MediaBrowser 发出的设备音量更改命令，以进行本地播放。应用不应更改本地设备音量，如果需要，可以使用 AudioManager API 来实现此目的。
  • 检测将服务作为前台服务启动的过时 Intent 实例。这样可以防止系统抛出 ForegroundServiceDidNotStartInTimeException。对于实现自定义 MediaNotification.Provider 的应用，这是一项针对不稳定 API 的破坏性更改，因为其中包含一个必需的新方法。
  • 添加了用于主屏幕 widget 的 PendingIntent 实例的构建器 (#2933)。
  • 添加了用于为基于 Compose 的主屏幕微件创建 Intent 实例的静态方法 (#2933)。
  • 修复了以下 bug：当播放从给定媒体文件索引过渡到具有相同媒体文件的另一个索引时，由于不连续性原因“AUTO”和“SEEK”，媒体文件过渡未报告给控制器 (#2997)。
  • 修复了以下问题：系统界面按钮放置权宜解决方法会对其他界面（例如 Android Auto 或不需要该权宜解决方法的制造商）产生负面影响 (#3041)。
  • 修复了订阅访问权限未同步的问题 (#3056)。
  • 针对 API 29 上的 SysUI bug 提供了权宜解决方法，该 bug 会导致特定大小的媒体会话封面图片使 SysUI 崩溃并强制设备重启 (#3118)。
  • 修复了 Android Q 上的通知封面图标缩放问题 (#3084)。
• 界面：
  • 将 PlaybackSpeedControl 可组合项添加到 media3-ui-compose，以显示和修改播放速度。
  • 向 media3-ui-compose-material3 添加 PlaybackSpeedToggleButton 可组合项，以控制播放速度。
  • 向 media3-ui-compose-material3 添加了 ProgressSlider 可组合项，用于显示播放器进度以及通过拖动和点按执行跳转 (#2288)。
  • 避免在为 PlayerControlView 添加动画效果时使用大型屏幕外缓冲区。
  • 向 media3-ui-compose-material3 添加了 Player 可组合项，该可组合项将 ContentFrame 与可自定义的控件相结合，这些控件可与顶部、中心和底部对齐。
  • 向无障碍服务隐藏播放位置，以防止在 PlayerControlView 可见时持续更新通知。
• HLS 扩展程序：
  • 支持 X-PLAYOUT-LIMIT 与 HLS 穿插广告 (#2484)。
  • 支持 #EXT-X-DEFINE 的 QUERYPARAM 属性 (#1854)。
  • 通过缓存正则表达式匹配器来优化 HLS 播放列表解析 (#3008)。
  • 在音频呈现中公开 ID3 (EMSG) 元数据轨道 (#3043)。
  • 允许在遇到加载错误时回退到其他位置，前提是来自不同位置的冗余串流可用 (#1988)。
  • 修复了 HLS 插播广告的 X-SNAP 行为，以正确计算开始和恢复位置 (#3013)。
• DASH 扩展程序：
  • 修复了以下问题：片段开始时间未对齐的轨道会导致播放开始时出现延迟或样本丢失 (#3057)。
  • 修复了带内 EMSG v0 元数据的时间戳未正确设置的 bug (#3024)。
• RTSP 扩展程序：
  • 修复了 H.264 和 H.265 流式传输中的回归问题，该问题会导致错误地解析跨多个 RTP 数据包的同一访问单元的样本。 这会导致视频中出现视觉伪影和损坏 (#3121)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • 为 MPEG-H 解码器扩展程序添加了 MPEG-H 界面管理器支持 (#3066)。
• Cast 扩展程序：
  • 添加了 RemoteCastPlayer.Builder#setTrackSelector 方法，用于实现 Cast 播放的轨道选择。
• 移除了已废弃的符号：
  • 移除了 ExperimentalFrameExtractor。改用 androidx.media3.inspector.frame.FrameExtractor。
  • 移除了 ChannelMixingMatrix.create()。改用 ChannelMixingMatrix.createForConstantGain()。
  • 移除了 androidx.media3.extractor.metadata.flac.VorbisComment。改用 androidx.media3.extractor.metadata.vorbis.VorbisComment。
  • 移除 MediaSource.prepareSource(MediaSourceCaller, TransferListener)。 请改用 MediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId)。

1.10.0-rc03

2026 年 3 月 25 日

使用 1.10.0 稳定版。

1.10.0-rc02

2026 年 3 月 16 日

使用 1.10.0 稳定版。

1.10.0-rc01

2026 年 3 月 10 日

使用 1.10.0 稳定版。

1.10.0-beta01

2026 年 2 月 25 日

使用 1.10.0 稳定版。

1.10.0-alpha01

2026 年 2 月 6 日

使用 1.10.0 稳定版。

版本 1.9.0

1.9.4

2026 年 5 月 16 日

版本 1.9.4 包含以下提交内容。

• 效果：
  • 从无 surface 上下文转换时，明确设置 GL_DRAW_BUFFER 和 GL_READ_BUFFER。

1.9.3

2026 年 3 月 16 日

版本 1.9.3 包含以下提交内容。

• 音频：
  • 修复了在压缩分流模式下播放无缝音频播放列表时播放卡住的 bug。

1.9.2

2026 年 2 月 6 日

版本 1.9.2 包含以下提交内容。

• ExoPlayer：
  • 修复了以下 bug：ProgressiveMediaSource 将过时的时间轴信息传播到播放器，导致已加入队列的时段意外被移除 (#3016)。
• 会话：
  • 修复了以下问题：系统界面按钮放置权宜解决方法会对其他界面（例如 Android Auto 或不需要该权宜解决方法的制造商）产生负面影响 (#3041)。
• Cast 扩展程序：
  • 修复了从投屏切换到本地播放时出现故障的 bug。

1.9.1

2026 年 1 月 26 日

版本 1.9.1 包含这些提交内容。

• 通用库：
  • 支持时区偏移量中仅包含小时的日期时间字符串 (#2929)。
• ExoPlayer：
  • 仅在音频开始后，才允许动态调度减慢 doSomeWork 间隔，以便在播放开始时支持更流畅的 A/V 同步。
  • 修复了 DefaultLoadErrorHandlingPolicy 中的 bug，该 bug 会导致 FileNotFoundException 和类似异常类型被重试多次。
  • 修复了动态调度中的一个 bug，该 bug 会导致下一次 doSomeWork 的计算时间被错误地缩短了当前 doSomeWork 迭代的经过时间。解决此问题有望延长 CPU 空闲时间并节省电量。
  • 修复了在尝试使用后备 AVC 或 HEVC 编解码器时，杜比视界文件无法播放的问题。
  • 修复了以下问题：从播放列表中移除当前播放的内容时，播放结束后仍会继续加载 (#2873)。
  • 避免在同一项上重复使用 ExoPlayer.replaceMediaItem 时泄露 MediaItem 实例 (#2993)。
  • 防止因紧急唤醒锁定释放而导致潜在 ANR (#2979)。
• 提取器：
  • MP3：解析 LAME ReplayGain 数据 (#2840)。
• 音频：
  • 在汽车场景中评估 AC-4 解码器支持时，正确移除对 AC4Profile22 和其他旧版配置文件的支持 (#2609)。
• 视频：
  • 在 API 级别低于 30 的设备上，当内容帧速率发生变化时，丢弃视频编解码器，以避免播放卡顿 (#2941)。
• 文本：
  • VobSub：通过正确处理仅包含单个控制序列或关键信息分散在多个控制序列中的 SPU，修复了一些字幕缺失的问题 (#2935)。
• IMA 扩展程序：
  • 问题修复：修正了广告 MIME 类型与 IMA LOADED 事件中提供的 MIME 类型不匹配的问题。现在，该修复程序会使用广告连播索引和广告排名来映射广告 MIME 类型。
  • 在访问 getAdsManager() 和 AdEvent.getAd() 的结果之前添加了 null 检查。
• 会话：
  • 修复了以下 bug：如果停止操作发生在广告播放期间，则停止连接到平台会话的 MediaController 会导致应用崩溃 (#2948)。
  • 在各种类中对 extras Bundle 实例添加了额外的验证，以防范从其他进程发送的格式错误的 Bundle 实例。
  • 修复了以下问题：缺少 COMMAND_SEEK_NEXT 或 COMMAND_SEEK_BACK 的命令可能会导致系统媒体通知中出现间隙 (#2976)。
  • 将通知图标的位图缩放移出主线程 (#2829)。
  • 修复了从旧版 MediaMetadataCompat 和 MediaDescriptionCompat 转换时，作者、撰稿人和作曲家未用作后备的 bug (#3018)。
• 下载内容：
  • 修复了 SegmentDownloader 处理 PriorityTooLowException 时可能出现的无限循环问题（对于 DASH、HLS 和 SmoothStreaming）。使用受保护的 execute 方法对 SegmentDownloader 进行自定义替换时，需要提供封装在 Supplier 中的任务，以便重新创建该任务 (#2931)。
• HLS 扩展程序：
  • 将原始资产列表 JSON 文档传递给 Listener.onAssetListLoadCompleted 回调。这是不稳定 API 中的一项破坏性更改，需要实现此回调的应用添加 JSONObject 类型的额外参数 (#2950)。
• RTSP 扩展程序：
  • 正确处理具有回绕时间戳的 RTP 数据包 (#2930)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • 修复了在处理第一帧视频之前进行跳转时可能发生的潜在 NullPointerException (#2965)。
• Cast 扩展程序：
  • 修复了在替换播放列表时导致 RemoteCastPlayer 时间轴无法正确更新的 bug。

1.9.0

2025 年 12 月 17 日

• 通用库：
  • 将 minSdk 更新为 23，以便与其他 AndroidX 库保持一致。
  • 添加了 PlayerTransferState，以便在 Player 实例之间传输播放状态。
  • 向 Player 添加 void mute() 和 void unmute() 方法，以便在将 Player 的音量设置为零之前和之后保留并恢复其音量。
  • 发布之前由 ExoPlayer 在内部使用的实用程序类 WakeLockManager、WifiLockManager、AudioFocusManager、AudioBecomingNoisyManager 和 StuckPlayerDetector，以便其他播放器重复使用 (#1893)。
  • 修复了底层委托播放器使用引用相等性比较监听器实例时的 ForwardingPlayer 监听器处理问题 (#2675)。
  • 在 media3-common-ktx 库中添加一个 Player.listenTo 挂起扩展函数，用于指定应执行操作的特定 Player.Events。
  • 修复了 BasePlayer.getBufferedPercentage 中因整数溢出而导致的崩溃问题，该问题会在报告的缓冲位置远大于报告的时长时发生 (#2750)。
  • 修复了 TrackGroup 轨道类型的自动检测问题，方法是不忽略自定义样本 MIME 类型，并回退到使用容器 MIME 类型中可能错误的轨道类型 (#2860)。
• ExoPlayer：
  • 添加卡顿播放器检测功能，如果播放器似乎卡顿，则会触发 StuckPlayerException 播放器错误。在以下情况下会发生这种情况，如有需要，可在 ExoPlayer.Builder 中配置每个默认超时：
    • 尝试播放 10 分钟后出现 STATE_BUFFERING，且没有缓冲进度。
    • 尝试播放 10 秒后，STATE_READY 仍未开始播放。
    • STATE_READY超出声明时长 1 分钟后，仍未到达内容结尾。
    • 在尝试播放时，播放抑制原因持续了 10 分钟。
  • 默认启用唤醒锁定处理，以解决后台播放期间的缓冲问题。这相当于将 ExoPlayer.Builder.setWakeMode 设置为 C.WAKE_MODE_LOCAL。
  • 添加监听逻辑，以便在向最初传递给 ExoPlayer.Builder 的 Context 报告更改时自动更新虚拟设备 ID。
  • 添加 ExoPlayer.setVirtualDeviceId，以手动更新从传递给 ExoPlayer.Builder 的 Context 获取的虚拟设备 ID。
  • 确保渲染程序在当前内容结束前 10 秒内不会使用下一个播放列表内容的数据。
  • 向 ExoPlayer 添加了 setSeekBackIncrementMs、setSeekForwardIncrementMs 和 setMaxSeekToPreviousPositionMs，以便在构建后更新这些设置 (#2736)。
  • 在 DefaultPreloadManager 中添加预缓存功能。应用现在可以通过 TargetPreloadStatusControl.getTargetPreloadStatus(T rankingData) 返回 DefaultPreloadManager.PreloadStatus.specifiedRangeCached(startPositionMs, durationMs) 或 DefaultPreloadManager.PreloadStatus.specifiedRangeCached(durationMs)，以指示需要预缓存媒体文件。
  • 在短视频演示应用中使用 DefaultPreloadManager 的预缓存功能。
  • 为本地播放添加 DefaultLoadControl.Builder setter，并调整 DefaultLoadControl 的默认值，以便与各种本地文件完美配合。
  • 修复了以下 bug：设置空播放列表可能会使播放器处于 STATE_READY 或 STATE_BUFFERING 状态。
  • 增强了预加载管理器 API：
    • 添加 addMediaItems(List<MediaItem>, List<T>) 和 addMediaSources(List<MediaSource>, List<T>)，以便批量添加媒体内容或媒体来源，并在之后自动调用 invalidate()。
    • 添加 removeMediaItems((List<MediaItem>) 和 removeMediaSources(List<MediaSource>)，以批量移除媒体文件或媒体源，并确保预加载管理器在移除后不会开始预加载或继续预加载其中任何一项。
    • 允许 DefaultPreloadManager.setCurrentPlayingIndex(int) 自动失效。在更新当前播放索引后，应用不再需要显式调用 invalidate()。
  • 添加了在拖动模式下跳过同一组图片中向前跳转的关键帧重置的功能。
  • 添加了 DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int)，以便应用为具有指定 playerName 的播放器设置目标缓冲区字节值。现在，DefaultLoadControl 可以根据自身分配的字节数和目标缓冲区字节数，分别为每个播放器做出决策。
  • 将 SkipInfo 添加到 AdPlaybackState.AdGroup，以传递广告组中每个广告的跳过信息。
  • 修复了在播放后贴片广告期间调用 removeMediaItems(List) 会导致崩溃的 bug (#2746)。
  • 修复了播放列表播放中的一些卡顿问题，这些问题是由于帧被错误地始终设置为最后一个样本并进行渲染而导致的。
  • 如果播放器无法生成音频会话 ID，则启用重试路径 (#2382、#2678)。
  • 添加了对控制 DefaultPreloadManager 中来源的总缓冲区字节数的支持，以避免预加载的总缓冲区字节数任意增长。如需使用默认控制逻辑，应用可以通过 DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int) 为 PlayerId.Preload.name（“预加载”）的 playerName 设置预加载的目标缓冲区字节数，并通过 DefaultPreloadManager.Builder.setLoadControl(LoadControl) 注入创建的 DefaultLoadControl。
  • 向 ShuffleOrder 添加了具有默认实现的 cloneAndSet(int, int) (#2834)。
  • 在跳转调整或自动转换后跳过广告播放时，附加内容恢复偏移量 (#2484)。
  • 添加了用于设置和观察音频和视频轨道编解码器参数的 API。 此功能是针对基于 MediaCodec 的渲染程序实现的，需要 API 29 或更高级别。
    • 使用 ExoPlayer.setAudioCodecParameters() 和 ExoPlayer.setVideoCodecParameters() 应用参数。
    • 使用 ExoPlayer.addAudioCodecParametersChangeListener() 和 ExoPlayer.addVideoCodecParametersChangeListener() 监听更改。观察供应商专用键需要 API 31+。
  • 修复了以下问题：在跳转到非零位置，然后使用非空媒体源准备播放器后，设置空媒体源会导致 IllegalStateException。
  • 修复了在拖动模式下跳转到其他媒体文件可能会导致 IllegalStateException 的 bug。
  • 修复了 DefaultPlaybackSessionManager 中潜在的 NullPointerException (#2885)。
  • 为符合条件的视频启用快进/快退性能改进。
  • 在 API 36+ 上重新启用 MediaCodec 中的异步解密功能，此平台 API 的超时问题已得到修复 (#1641)。
  • 将 MediaCodecVideoRenderer.experimentalSetLateThresholdToDropDecoderInputUs 的默认值更改为 15 毫秒，并针对符合条件的视频，在解码前更高效地丢弃视频帧。
  • 在 DefaultLoadControl 中为自动内存计算添加了内存上限。这应该只在选择了过多轨道时生效 (#2860)。
  • 修复了以下 bug：在播放列表或循环播放模式下播放时，在拖动模式下快进到接近结尾的位置可能会导致快进到下一个媒体文件。
• CompositionPlayer：
  • 在新的 @ExperimentalApi 注解下发布 CompositionPlayer，以表明它可用于实验，但仍处于开发阶段。某些 API 可能会在未来版本中发生重大变化，并且某些用例存在已知问题和限制（有些未记录）。
  • 在 CompositionPlayer 中添加了对 COMMAND_SET_AUDIO_ATTRIBUTES 和音频焦点处理的支持。
  • 在 CompositionPlayer 中添加了对次要序列中速度变化的支持。
  • 添加了对 EditedMediaItem.removeVideo 的支持。
• 转换器：
  • 使用 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）。
  • MP3：将嗅探限制提高到 128kB，以匹配同步字节的现有搜索限制 (#2713)。
  • MP3：更改了 FLAG_ENABLE_INDEX_SEEKING，以便在可用时优先从元数据标头（如 Xing 和 VBRI）中查找信息，如果没有其他查找信息，则回退到基于索引的查找。这可以提高具有跳转元数据的文件性能 (#2839)。
  • MP3：更改 Mp3Extractor，使其在未找到跳转元数据（例如 Xing、VBRI）时默认采用恒定比特率 (CBR) 假设，即使设置了 FLAG_ENABLE_INDEX_SEEKING 也是如此。这是基于 MP3 规范历史记录，其中 CBR 是标准，而 VBR 需要显式标头。这提高了没有元数据的文件立即跳转到指定位置的能力，但可能会影响缺少标头的 VBR 文件的准确性。如果 CBR 假设不可跳转（例如，对于未知长度的串流），现在会将索引跳转用作后备 (#2848)。
  • MP4：在从提取器发出轨道格式之前，通过查看第一个样本的层值，消除 audio/mpeg (MP3)、audio/mpeg-L1 和 audio/mpeg-L2 MIME 类型之间的歧义 (#2683)。
  • MP4：通过假设大于 1MB 的 stbl 框意味着文件必须是非分段的，从而提高超大文件的嗅探效率 (#2650)。
  • MP4：添加了对 ©mvn（乐章名称）和 ©mvi（乐章索引）元数据的支持，这些元数据现在会作为 TextInformationFrame 对象在 Format.metadata 中发出，其 ID 分别为 MVNM 和 MVIN (#2754)。
  • MP4：忽略缺少 stsd 框的轨道（而不是无法解析整个文件）。
  • Matroska：添加了对 DTS-HD 检测的支持 (#6225)。
  • 修复了 MatroskaExtractor 中的一个问题，该问题会导致对具有多个曲目的文件进行跳转时可能不准确。提示点现在可以正确地与其各自的曲目相关联，从而实现更精确的跳转。
  • MPEG-TS：修复了由不含时间戳的 PES 数据包导致的 ReorderingBufferQueue 中的 IllegalArgumentException (#2764)。
  • 添加了对提取 HEIC 动态照片的支持。HeifExtractor 现在可以解析包含嵌入式视频和音频轨道的 HEIC 文件。
• 检查器：
  • 引入了新的 :media3-inspector 模块，作为媒体检查实用程序的专用位置。此模块现在包含一个新的 androidx.media3.inspector.MetadataRetriever，它将为元数据和帧提取提供统一的 API。现有的 androidx.media3.exoplayer.MetadataRetriever 现已弃用，取而代之的是这个新版本。
  • 引入了 androidx.media3.inspector.FrameExtractor，这是一个用于帧提取的新公共 API。此 AutoCloseable 类提供了一种提取帧的方法，支持 HDR 视频、视频效果和自定义解码器选择。应通过其 Builder 为特定 MediaItem 创建。
  • FrameExtractor：添加了 getThumbnail()，用于从媒体文件中提取代表性的缩略图帧，而无需指定时间戳。
  • 添加了 androidx.media3.inspector.MediaExtractorCompat，它是平台 android.media.MediaExtractor 的直接替代项，提供了一种从媒体文件中提取原始编码媒体样本的方法。 现有的 androidx.media3.exoplayer.MediaExtractorCompat 现已废弃，取而代之的是这个新类。
• 音频：
  • 让 AudioProcessor 实例感知到跳转。
  • 允许将新的 AudioOutputProvider 接口注入 DefaultAudioSink.Builder，以支持自定义音频输出路径。默认值为 AudioTrackAudioOutputProvider。
  • 处理 GainProcessor 中的跳转。
  • 在轨道格式支持评估中利用 AC-4 解码器配置文件和级别功能 (#2580)。
  • 避免在播放开始时处理路由更改回调而导致潜在延迟 (#2646)。
  • 允许对 EAC3、EAC3-JOC 和 AC-4 格式重复使用编解码器 (#1346)。
  • 在 Sonic 中添加了对浮点 PCM 样本的支持。
  • 在 ToFloatPcmAudioProcessor 中添加了对 16 位 PCM 样本的支持。
• 视频：
  • 针对具有不同配置文件的杜比视界内容停用编解码器重复使用。
  • 重新启用针对安全编解码器错误报告的性能点的权宜解决方法 (#2856)。
• 文本：
  • 修复了 Dolby Vision 内容中 CEA-6/708 字幕的解析问题 (#2775)。
• 图片：
  • 修复了 ScrubbingMode 问题：播放器在拖动 DASH 缩略图轨道时卡住 (#2815)。
• DRM：
  • 将 MediaDrmCallback 方法的返回值类型从 byte[] 更改为新的 MediaDrmCallback.Response 类型，以便返回额外的可选信息。这是一项源代码破坏性更改，但只需在返回之前使用 new Response 封装之前的 byte[] 返回值，即可轻松解决破坏问题。
  • 向 AnalyticsListener.onDrmKeysLoaded 添加了网址和延迟时间等密钥请求信息 (#1001)。
  • 将配置请求数据从网址参数移至 POST 正文。
• 效果：
  • 添加了 Presentation.copyWithUnsetSideRoundedTo，以便在创建 Presentation 时，如果只指定了一个边长，则对未设置的输出边长进行四舍五入。
• 多路复用器：
  • 添加了 MediaMuxerCompat，可直接替代框架 MediaMuxer。
  • 添加了 MuxerUtil.createMotionPhotoFromJpegImageAndBmffVideo() 以允许创建动态照片。
  • 添加 WebmMuxer，以便将 OPUS、VORBIS、VP8 和 VP9 媒体流多路复用到 webm 文件格式中。
• IMA 扩展程序：
  • 移除了自定义 ProGuard 规则，以便应用可以改用 IMA Android 归档中发布的规则。
  • 添加了 ImaServerSideAdInsertionUriBuilder.setNetworkCode，这是一个新 API，用于设置 Google Ad Manager 广告资源网代码，以便 IMA SDK 按照 Google Ad Manager 设置中的指定方式处理广告标识符。对于全方位服务直播请求，网络代码是可选的，但建议提供。如需查找广告资源网代码，请参阅这篇文章。
  • 将 IMA 依赖项提升至 3.37.0，这需要启用核心库脱糖。依赖应用也必须启用此功能。请参阅 IMA 的配置说明。 * 在 SSAI URI 构建器中支持 IMA DAI 自定义界面选项。服务器端广告插播的自定义界面选项包括“可跳过”和“关于此广告”呈现支持。此功能目前仅面向列入许可名单的部分发布商提供。此更改还会将 IMA SDK 版本升级到 3.38.0（版本说明），以便访问自定义界面选项 API。
  • 修复了以下问题：广告后内容的准备错误会被错误地报告为广告播放错误 (#2656)。
• 会话：
  • 向 MediaSession.Callback.onPlaybackResumption 添加了新参数，用于指示调用是仅用于收集信息还是用于开始播放 (#1764)。
  • 更新了 MediaSession.ControllerInfo.isTrusted，以便将来自应用本身的控制器也声明为可信 (#2542)。
  • 添加了 MediaSessionService.triggerNotificationUpdate 以手动触发通知更新 (#1833)。
  • 向自定义命令方法添加 ProgressListener。
  • 将 MediaLibrarySession.Builder.setLibraryErrorReplicationMode 的默认值更改为非严重。
  • 向 MediaButtonReceiver.onForegroundServiceStartNotAllowedException 添加了 Context 参数 (#2625)。
  • 从平台 PlaybackInfo 读取音量控制 ID，而不是通过 binder 提取。这可确保播放类型和音量控制 ID 以原子方式读取，并且彼此匹配。
  • 修复了以下 bug：ACTION_UP 按键事件在传递给回调进行自定义处理之前被过滤掉。这使得该库与 media1 和平台的功能保持一致 (#2637)。
  • 修复了即使命令不可用，PlayerWrapper 也会调用 getCurrentTimeline() 的 bug (#2665)。
  • 修复了以下 bug：主 Looper 的消息队列中留有一条消息，导致服务终止后发生内存泄漏 (#2692)。
  • 连接到具有 MediaBrowser 的旧版会话应用时，只有在自定义操作在旧版会话的 PlaybackStateCompat 中作为自定义操作进行通告时，自定义命令才会发送到会话。所有其他自定义操作都会发送到服务。
  • 实现了 onAudioSessionIdChanged，以便在会话设置音频会话 ID 时通知媒体控制器 (#244)。
  • 修复了以下 bug：KEYCODE_HEADSETHOOK 未在媒体键事件 Intent 到达 onStartCommand() 时启动播放器。此问题已通过像处理 KEYCODE_MEDIA_PLAY_PAUSE 一样处理“KEYCODE_HEADSETHOOK”得到解决 (#2816)。
  • 修复了以下 bug：Surface 大小未在会话和控制器之间传递，导致无法在 demo-session 中应用视频效果。如果您使用的是控制器，并且播放器无法处理 setVideoSurfaceHolder 调用，这可能会是一项破坏性更改。
  • 修复了非 String CharSequence 元数据值（例如 span 样式的字符串）的传播问题 (#2853)。
  • 添加 CommandButton.executeAction，以便控制器可以更轻松地触发预期操作。此外，还允许为某些播放器和会话命令指定参数，以定义要触发的操作。
  • 为使用 Player.Command 或非自定义 SessionCommand 定义其操作的 CommandButton 实例添加向后兼容性。现在，这些内容会在平台媒体会话（例如系统界面或 Android Auto）中正确呈现。
  • 修复了在将 MediaController 连接到平台媒体会话时，同一 Bitmap 会被多次压缩的问题。
• 界面：
  • 将 ProgressStateWithTickInterval 类和相应的 rememberProgressStateWithTickInterval 可组合项添加到 media3-ui-compose 模块。此状态容器在 demo-compose 中用于以文本形式显示当前位置和时长。
  • 向 ui-compose 添加 MuteButtonState，用于处理 Player 音量的静音。此状态容器在 demo-compose 中用于显示静音/取消静音切换按钮。
  • 将 ProgressStateWithTickCount 类和相应的 rememberProgressStateWithTickCount 可组合项添加到 media3-ui-compose 模块。此状态容器在 demo-compose 中用于以水平只读进度条的形式显示进度。
  • 向 media3-ui-compose 添加了 ContentFrame 可组合项，该可组合项将 PlayerSurface 管理与宽高比调整和快门遮盖相结合。
  • 解决了一个已知的 API 34 平台 bug，该 bug 会导致在 Compose AndroidView 中使用 SurfaceView 时视频被拉伸/剪裁，从而影响具有 SURFACE_TYPE_SURFACE_VIEW 的 ContentFrame 和 PlayerSurface 可组合项（#1237、#2811）。
  • 创建一个新的 media3-ui-compose-material3 模块，并向其中添加 Material3 主题的可组合项（PlayPauseButton、NextButton、PreviousButton、SeekBackButton、SeekForwardButton、RepeatButton、ShuffleButton、MuteButton）。
  • 将 TimeText 可组合项添加到 media3-ui-compose-material3，以文本形式显示玩家进度。可以将其配置为显示当前位置、时长或剩余时间。
  • 添加了对在 PlayerView 中放置媒体路线按钮的支持。
  • 使用 BidiFormatter 在 RTL 文本字幕中正确显示标点符号 (#11214)。
• HLS 扩展程序：
  • 解析 HLS 插页式广告跳过属性。
  • 将 HLS 播放列表和素材资源列表文档中的跳过控制属性映射到 AdPlaybackState，以便公开访问。
  • 修复了以下 bug：从播放列表中移除定义开始时间的 EXT-X-PROGRAM-START-DATE 标记时，播放列表的开始时间会被丢弃 (#2760)。
  • 使用二分查找来查找播放列表中给定位置的片段索引 (#2826)。
  • 添加了 HlsInterstitialsAdsLoader.skipCurrentAd() 和 skipCurrentAdGroup() 以及相应的方法，以便按索引跳过广告和广告组。
  • 添加了 HlsInterstitialsAdsLoader.Listener.onAdStarted 以报告广告时段的开始 (#2859)。
  • 在 ISO 8601 日期时间字符串中接受空格作为日期/时间分隔符。
  • 正确处理为没有片段的 HlsMediaPlaylist 提取下一个分块的操作 (#2821)。
  • 为直播中的前贴片广告使用默认开始位置。
• DASH 扩展程序：
  • 修复了使用非分层 data: URI 清单播放 DASH 流时出现的 UnsupportedOperationException 问题 (#2688)。
  • 在释放时以及用户更新媒体文件时，将 LiveConfiguration 重置为 DashMediaSource 的 MediaItem 提供的值 (#2606)。
  • 避免因未报告为播放器错误的无效清单更新而导致崩溃 (#2805)。
• RTSP 扩展程序：
  • 处理 H264 和 H265 的碎片化 NAL 单元时，处理 RTP 数据包缺失错误 (#2613)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • AV1 扩展程序：AV1 软件解码器现在使用高性能 dav1d 库，取代了之前的 libgav1 实现，从而提高了 A/V 解码速度。
  • FFmpeg 扩展程序：通过确保正确解析 STREAMINFO 块并将其传递给解码器，修复了导致某些 FLAC 文件无法播放的问题 (#2887)。
• Cast 扩展程序：
  • 添加 CastPlayer.Builder，使 CastPlayer 能够同时进行本地播放和 Cast 播放。如需保留仅支持 Cast 播放的旧 CastPlayer 行为，您可以使用 RemoteCastPlayer。预先存在的 CastPlayer 构造函数会保留其旧行为，但已废弃，取而代之的是使用 CastPlayer 或 RemoteCastPlayer 构建器。
  • 停止在 DefaultMediaItemConverter 中强制执行非 null MIME 类型。
  • 使用 MediaItem.mediaMetadata.mediaType 推断要在 DefaultCastOptionsProvider#toMediaQueueItem 中使用的 Cast MEDIA_TYPE（如果可用）。
  • 在 DefaultCastOptionsProvider 中启用远程到本地传输。
  • 在 Session 演示中添加了对 Cast 的支持。
  • 添加了对在可组合界面上显示媒体路由按钮的支持。
  • 添加了对在操作栏菜单上显示媒体路由按钮的支持。
  • 添加了对将媒体路由按钮显示为 View 界面的支持。
• 测试实用程序：
  • 为 FakeClock 的自动推进功能添加了最大时间差。默认值为 1 秒，但可通过 FakeClock.Builder 进行配置。
  • 为 RobolectricUtil.runMainLooperUntil（和 runLooperUntil）添加了消息之间的最大时间差。默认值为 1 秒，但可通过这些方法的新重载进行配置。
  • 将 CapturingRenderersFactory 从 test-utils 移动到 test-utils-robolectric。
• 移除了已废弃的符号：
  • 移除了已废弃的 DefaultPreloadManager 构造函数。改用 DefaultPreloadManager.Builder。
  • 移除了已废弃的 EditedMediaItemSequence 构造函数。改用 EditedMediaItemSequence.Builder。
  • 移除了 BitmapFactoryImageDecoder.BitmapDecoder。改用 ExternallyLoadedImageDecoder。
  • 移除了已废弃的 ShadowMediaCodecConfig.forAllSupportedMimeTypes()。 请改用 ShadowMediaCodecConfig.withAllDefaultSupportedCodecs()。
  • 移除了已废弃的 ShadowMediaCodecConfig.withNoDefaultSupportedMimeTypes()。改用 ShadowMediaCodecConfig.withNoDefaultSupportedCodecs()。

1.9.0-rc01

2025 年 12 月 1 日

使用 1.9.0 稳定版。

1.9.0-beta01

2025 年 11 月 20 日

使用 1.9.0 稳定版。

1.9.0-alpha01

October 22, 2025

使用 1.9.0 稳定版。

版本 1.8.0

1.8.1

2026 年 5 月 21 日

版本 1.8.1 包含以下提交内容。

• 效果：
  • 从无 surface 上下文转换时，明确设置 GL_DRAW_BUFFER 和 GL_READ_BUFFER。

版本 1.8.0

2025 年 7 月 30 日

版本 1.8.0 包含这些提交内容。

• 通用库：
  • 添加了对在 ForwardingSimpleBasePlayer 中替换播放器的支持。
• ExoPlayer：
  • 向 ExoPlayer 接口添加了随机播放模式的 getter (#2522)。
  • 如果从多个线程访问 DefaultAudioSink，则更明确地抛出异常。如果这是由于在播放器外部调用 RendererCapabilities.getFormatSupport 导致的，请务必在与 ExoPlayer 的播放线程相同的线程上调用此方法，或使用与播放所用实例不同的实例 (#1191)。
  • 修复了以下 bug：电视上的非立体声音频格式可能会被 DefaultTrackSelector 标记为不受支持。
  • 确保在使用 MediaCodec 的 DECODE_ONLY 标志（在拖动模式下默认启用）时正确渲染最后一帧。
  • 添加了对使用从 Context 传递到 ExoPlayer.Builder 的虚拟设备 ID 的支持。
  • 在清理模式下默认启用动态调度。
  • 避免在跳转到内容末尾时对来源进行不必要的重新加载。
  • 在拖动模式下默认使用 MediaCodec.BUFFER_FLAG_DECODE_ONLY。
  • 当 PreloadMediaSource 由 ExoPlayer 播放，且播放线程与预加载线程不同时，抛出 IllegalStateException (#2495)。
  • 向 ShuffleMode 添加了 cloneAndMove，并提供了默认实现 (#2226)。
  • 更改 Renderer.getMinDurationToProgressUs 的默认行为，以便在不需要调用 render 时返回更大的值。
  • 修复了以下 bug：在暂停状态下跳转到末尾时，内部调度会延迟最后一帧。目前，只有在 ExoPlayer.Builder.experimentalSetDynamicSchedulingEnabled 处于启用状态时，此 bug 修复才会生效。
  • 添加了 ExoPlayer.setScrubbingModeEnabled(boolean) 方法。这会针对许多频繁的跳转（例如，用户拖动进度条）优化播放器。您可以使用 ExoPlayer 和 ExoPlayer.Builder 上的 setScrubbingModeParameters(..) 来自定义拖动模式的行为。
  • 允许在拖动模式下自定义分数跳转容差。
  • 提高拖动模式下的编解码器运行速率。
  • 修复了 AdsMediaSource 内容中的准备错误可能永远不会报告的 bug (#2337)。
  • 修复了 MergingMediaSource 中的内存泄漏问题，例如侧载字幕时使用的内存泄漏问题 (#2338)。
  • 允许 CmcdConfiguration.Factory 返回 null，以停用特定媒体文件的 CMCD 日志记录 (#2386)。
  • 将默认图片缓冲区空间从 128kB（文本轨道中的复制粘贴错误）增加到 26MB，这足以容纳 50MP Ultra HDR 图片 (#2417)。
  • 添加了 PreCacheHelper，允许应用预缓存具有指定起始位置和时长的单个媒体。
  • 在 DefaultPreloadManager 中添加了对从指定位置预加载的支持。
• 转换器：
  • 添加 CodecDbLite，以便对视频编码设置进行特定于芯片组的优化。
  • 向 DefaultEncoderFactory 添加 setEnableCodecDbLite 标志，以启用 CodecDB Lite 设置优化。此标志默认设置为 false。
  • 现在，如需使用静音音频填充初始间隙（通过 addGap() 添加），需要在 EditedMediaItemSequence.Builder 中明确设置 experimentalSetForceAudioTrack(true)。如果间隙位于序列中间，则不需要此标志。
  • 将 Muxer 接口从 media3-transformer 移至 media3-muxer。
  • 将设置 MediaItem.Builder().setImageDuration(long) 设为必需，以便将媒体文件作为图片导入。
  • 添加 Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean)，其中包含剪辑时的 MP4 编辑列表，以指示播放器忽略剪辑起点之前的关键帧与剪辑起点之间的样本。
  • 更新 Composition Demo 应用，以使用 Kotlin 和 Jetpack Compose，并添加自定义 VideoCompositorSettings，以便将序列排列成 2x2 或画中画布局。
• 提取器：
  • 从分段 MP4 文件中解析元数据 (#2084)。
  • JPEG：支持开头没有 Exif 段的动态照片 (#2552)。
  • 添加了对在具有多个 sidx atom 的分段 MP4 中进行跳转的支持。 您可以使用 FragmentedMp4Extractor 上的 FLAG_MERGE_FRAGMENTED_SIDX 标志启用此行为 (#9373)。
  • 忽略 FLAC 文件中的空跳转表（包括仅包含占位跳转点的跳转表），并在文件时长已知的情况下回退到二分搜索跳转 (#2327)。
  • 修复了 H.265 SEI 单元的解析问题，以完全跳过无法识别的 SEI 类型 (#2456)。
  • 更新 WavExtractor，以便在解析 WAVE_FORMAT_EXTENSIBLE 类型文件时，使用标头扩展程序的 SubFormat 数据作为音频格式。
  • MP4：添加了对定义原始 PCM 音轨的 ipcm 和 fpcm 框的支持（不支持 64 位浮点 PCM）。
  • MP4：处理 tkhd 转换矩阵中同时旋转和反射视频的旋转部分。这可确保 iPhone 前置摄像头拍摄的镜像视频能够正确显示，但会在 Y 轴上错误地镜像 (#2012)。
  • MP3：由于 FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS)，在回退到恒定比特率跳转时，使用不可跳转的 Xing、VBRI 和类似可变比特率元数据中的时长和数据大小 (#2194)。
• 音频：
  • 修复了以下 bug：当音频播放在非常接近媒体结尾的位置开始时，系统不会调用 AnalyticsListener.onAudioPositionAdvancing。
  • 在 ChannelMappingAudioProcessor 和 TrimmingAudioProcessor 中添加了对所有线性 PCM 采样格式的支持。
  • 添加了对 CompositionPlayer 中音频间隙的支持。
  • 从 BaseAudioProcessor#reset() 中移除了对 BaseAudioProcessor#flush() 的虚假调用。
  • 允许在 DefaultAudioMixer 中进行恒定功率上混/下混。
  • 将 ChannelMappingAudioProcessor、TrimmingAudioProcessor 和 ToFloatPcmAudioProcessor 设为公开 (#2339)。
  • 使用 AudioTrackPositionTracker 中的 AudioTrack#getUnderrunCount() 检测 DefaultAudioSink 中的欠载，而不是尽力估算。
  • 改进音频时间戳平滑处理，以应对音频输出设备出现意外位置偏移的情况。
  • 修复了连接到蓝牙设备时，从暂停状态恢复后前 10 秒内音视频同步中断的 bug。
  • 修复了以下 bug：AnalyticsListener.onAudioPositionAdvancing 报告的不是音频开始推进的时间，而是首次测量的时间。
  • 修复了在某些设备上回退到立体声音频后恢复到多声道音频的问题 (#2258)。
• 视频：
  • 将分离式 Surface 权宜解决方法扩展到“lenovo”和“motorola”设备 (#2059)。
  • 改进了音频样本未在请求的确切位置开始时，启动时视频帧的流畅释放。
  • 将分离表面解决方法扩展到“realme”设备 (#2059)。
  • 添加了实验性 ExoPlayer API，以便在将仅解码输入缓冲区加入队列时包含 MediaCodec.BUFFER_FLAG_DECODE_ONLY 标志。此标志会指示解码器跳过仅解码缓冲区，从而加快跳转速度。使用 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 仅支持 CodecId = S_TEXT/ASS，它代表 SubStation Alpha 字幕的“高级”(v4+) 变体（但 ExoPlayer 的解析逻辑对于这两种变体是相同的）(#2384)。
  • 在 SubStation Alpha (SSA) 字幕文件中添加对 layer 属性的支持，该属性用于在屏幕上同时显示多个 cue 文件时定义其 Z 轴顺序 (#2124)。
• 元数据：
  • 向 MetadataRetriever 添加了对检索媒体时长和 Timeline 的支持，并将其迁移到了基于实例的 AutoCloseable API。使用新的 Builder 为 MediaItem 创建实例，然后调用 retrieveTrackGroups()、retrieveTimeline() 和 retrieveDurationUs() 以获取元数据的 ListenableFuture。 之前的静态方法现已废弃 (#2462)。
• 图片：
  • 将解码后的位图限制为 BitmapFactoryImageDecoder 中的显示大小，以避免应用在尝试显示非常大（例如 50MP）的图片时因 PlayerView 抛出 Canvas: trying to draw too large bitmap. 而崩溃。
  • 更改 DefaultRenderersFactory.getImageDecoderFactory() 的签名，使其接受 Context 参数。
  • 将 CompositionPlayer 中使用的最大位图输出大小与 Transformer 中已使用的大小保持一致（这意味着，与 ExoPlayer 不同，CompositionPlayer 在解码位图时不会考虑显示大小）。
• DRM：
  • 添加了接受 MediaItem.DrmConfiguration 的 OfflineLicenseHelper.newWidevineInstance 的新重载，以便正确应用 HTTP 请求标头 (#2169)。
• 效果：
  • 添加 Presentation.createForShortSide(int)，以创建 Presentation，确保最短边始终与给定值匹配，无论输入方向如何。
• 多路复用器：
  • 修复了以下 bug：未在分段 MP4 中为音频样本设置正确的样本标志。
  • writeSampleData() API 现在使用多路复用器专用的 BufferInfo 类，而不是 MediaCodec.BufferInfo。
  • 添加 Muxer.Factory#supportsWritingNegativeTimestampsInEditList，其默认值为 false。
• IMA 扩展程序：
  • 修复了以下 bug：一个广告中的加载错误可能会意外导致另一个广告组失效。
  • 修复了 VOD 窗口结束后广告组导致播放停滞的 bug。 开始时间晚于该时间范围的广告组不会再加入 MediaPeriodQueue 的队列 (#2215)。
• 会话：
  • 修复了来自第三方非特权 Media3 控制器的连接被忽略的 bug。
  • 移除了在向旧版 MediaBrowserServiceCompat 发送自定义命令时检查可用命令的步骤。这与旧版控制器/浏览器连接到旧版应用时的行为一致。
  • 修复了导致播放器的第一个播放错误被错误地视为永久性自定义异常的 bug。这会导致应用无法恢复。
  • 修复了以下 bug：会话未处理的某些控制器更改可能会导致 IllegalStateExceptions。
  • 修复了以下 bug：未由会话处理的控制器操作可能会使控制器处于无效状态。
  • 修复了 StrictMode 不安全启动违规警告 (#2330)。
  • 修复了以下 bug：从与主线程不同的应用线程运行播放器时，从主线程调用 setSessionExtras 会导致 IllegalStateException (#2265)。
  • 如果玩家设置了媒体内容，但未准备或播放这些内容，请勿自动显示通知 (#2423https://github.com/androidx/media/issues/2423)。此行为可通过 MediaSessionService.setShowNotificationForIdlePlayer 进行配置。
  • 为所有或所选控制器添加自定义 PlaybackException。
  • 修复了在 MediaController 上跳转到直播中的某个位置可能会导致 IllegalArgumentException 的 bug。
  • 对于直播，停止发布播放位置以及在当前内容中跳转的功能，以避免 Android Auto 界面（以及使用平台媒体会话中的这些信息的其他控制器）中出现位置伪影 (#1758)。
  • 修复了以下 bug：将 null 传入连接到旧版 MediaBrowserServiceCompat 的 MediaBrowser 的 getLibraryRoot 会产生 NullPointerException。
  • 修复了以下 bug：发送自定义操作、搜索结果或 getItem 请求会导致旧版会话应用崩溃，并显示 ClassNotFoundException。
  • 修复了以下 bug：MediaItem.LocalConfiguration.uri 会共享到平台会话的 MediaMetadata。如需有意共享 URI 以允许控制器重新请求媒体，请改为设置 MediaItem.RequestMetadata.mediaUri。
• 界面：
  • 修复了可重用组件（例如 LazyColumn）内的 PlayerSurface 无法正常运行的 bug (#2493)。
  • 修复了 Compose bug，该 bug 导致在设置初始按钮状态与观察状态变化（例如图标形状或启用状态）之间存在时间差。现在，在观察期之外对 Player 所做的任何更改都会被检测到 (#2313)。
  • 向 media3-ui-compose 模块添加 SeekBackButtonState 和 SeekForwardButtonState 的状态容器和可组合项。
  • 为 PlayerControlView 添加了对 ExoPlayer 拖动模式的支持。启用后，当用户开始拖动拖动条时，播放器会进入拖动模式，每次移动都会发出 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 扩展程序：
  • 修复了以下 bug：当缓冲区中没有可用的分块时，HlsSampleStreamWrapper 尝试在缓冲区内进行跳转 #2598。
  • 修复了以下 bug：在加载低延迟部分和预加载提示后，轨道选择发生变化可能会导致播放卡住或冻结 (#2299)。
  • 当服务器不遵循 CAN-BLOCK-RELOAD=YES 时，等待目标时长的一半，以防止过度重新加载 (#2317)。
  • 修复了以下 bug：在尝试为错误的广告解析中贴片广告和素材资源列表之前，启动插页式广告流时播放会停滞 (#2558)。
  • 修复了播放列表解析问题，以接受带引号的字符串属性值中的 \f（换页符）(#2420)。
  • 支持更新具有相同 ID 的插页式广告 (#2427)。
  • 修复了以下 bug：当直播流没有可加载的片段时，播放列表加载错误有时不会传播 (#2401https://github.com/androidx/media/issues/2401)。
  • 按 NAME 标记对字幕呈现进行分组，类似于音频呈现的分组方式 (#1666)。
  • 支持 X-ASSET-LIST 和 HlsInterstitialsAdsLoader 直播。
• DASH 扩展程序：
  • 修复了以下问题：特技播放适配集与其主适配集合并，形成无效的 TrackGroup (#2148)。
  • 修复了以下 bug：当渲染流水线已读取超出新时长的样本时，缩短 DASH 周期时长可能会抛出异常 (#2440)。
  • 修复了使用 CMCD 查询参数时未遵循重定向的 bug (#2475)。
• RTSP 扩展程序：
  • 根据 RFC 7798#4.4.2，添加了对 H265 的 RTP 聚合数据包的支持 (#2413)。
  • 修复了 RtspClient，以便在处理 HTTP 302 响应时使用提供的位置 URI (#2398)。
  • 添加了对包含带有尾随空格字符的行的 SessionDescriptions 的解析支持 (#2357)。
• 解码器扩展程序（FFmpeg、VP9、AV1 等）：
  • 修复了 DefaultTrackSelector.setAllowInvalidateSelectionsOnRendererCapabilitiesChange 对音频解码器扩展没有影响的 bug (#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 是一个意外标记为稳定版的 Alpha 版（见下文）。

版本 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 包含这些提交内容。

• 通用库：
  • 添加了 PlaybackParameters.withPitch(float) 方法，以便轻松复制具有新 pitch 值的 PlaybackParameters (#2257)。
• ExoPlayer：
  • 修复了以下问题：在初始化下一个媒体文件期间，由于可恢复的渲染器错误，媒体项转换失败 (#2229)。
  • 修复了以下问题：PreloadMediaSource 尝试在 getBufferedDurationUs() 准备就绪之前调用它，导致 ProgressiveMediaPeriod 抛出 IllegalStateException (#2315)。
  • 修复了在 DASH、HLS 和 SmoothStreaming 的清单请求中发送 CmcdData 的问题 (#2253)。
  • 确保在移除广告组后仍可使用 AdPlaybackState.withAdDurationsUs(long[][])。用户仍需要为已移除的广告组传入时长数组，该数组可以为空或 null (#2267)。
• 提取器：
  • MP4：从 tkhd 框中解析 alternate_group，并将其作为 Mp4AlternateGroupData 条目在每个轨道的 Format.metadata 中公开 (#2242)。
• 音频：
  • 修复了在播放短内容播放列表时位置可能会卡住的分流问题 (#1920)。
• 会话：
  • 将平台 MediaSession 回调的聚合超时时间从 500 毫秒缩短至 100 毫秒，并添加了一个实验性 setter，以便应用配置此值。
  • 修复了通知在被用户关闭后重新出现的问题 (#2302)。
  • 修复了以下 bug：当封装的播放器实际上为空时，会话会返回单项时间轴。当封装的播放器没有可用的 COMMAND_GET_TIMELINE，但有可用的 COMMAND_GET_CURRENT_MEDIA_ITEM 且封装的播放器为空时，就会发生这种情况 (#2320)。
  • 修复了在与服务进行其他互动（例如 setForegroundServiceTimeoutMs）后，调用 MediaSessionService.setMediaNotificationProvider 会被静默忽略的 bug (#2305)。
• 界面：
  • 启用 PlayerSurface 以便与 ExoPlayer.setVideoEffects 和 CompositionPlayer 配合使用。
  • 修复了无法使用新 Player 重组 PlayerSurface 的 bug。
• HLS 扩展程序：
  • 修复了以下问题：未在 CmcdData 中为 HLS 媒体设置分块时长，导致在处理加密媒体片段时出现断言失败 (#2312)。
• RTSP 扩展程序：
  • 添加了对采用 RTSPT 架构的 URI 的支持，以便将 RTSP 会话配置为使用 TCP (#1484)。
• Cast 扩展程序：
  • 添加了对播放列表元数据的支持 (#2235)。

1.6.0

2025 年 3 月 26 日

发布了 androidx.media3:media3-*:1.6.0。版本 1.6.0 包含这些提交内容。

• 通用库：
  • 添加了 AudioManagerCompat 和 AudioFocusRequestCompat，以替换 androidx.media 中的等效类。
  • 将 Kotlin 从 1.9.20 升级到 2.0.20，并使用 Compose 编译器 Gradle 插件。将 KotlinX 协程库从 1.8.1 升级到 1.9.0。
  • 移除了 Format.toBundle(boolean excludeMetadata) 方法，请改用 Format.toBundle()。
  • 修复了 SimpleBasePlayer 中的 bug：在 setPlaylist 之后，使用 null MediaMetadata 在 State 中设置新的 currentMediaItemIndex 不会重新评估元数据 (#1940)。
  • 将 SimpleBasePlayer.State 访问权限从受保护更改为公开，以便更轻松地处理其他类中的更新 (#2128)。
• ExoPlayer：
  • 添加了 MediaExtractorCompat，这是一个提供与平台 MediaExtractor 相同功能的新类。
  • 添加了对使用 MediaCodecVideoRenderer 进行播放的实验性“ExoPlayer”预热支持。您可以配置 DefaultRenderersFactory 到 experimentalSetEnableMediaCodecVideoRendererPrewarming，以便为 ExoPlayer 提供辅助 MediaCodecVideoRenderer。如果启用，ExoPlayer 会在播放期间预处理连续媒体文件的视频，以减少媒体文件过渡延迟时间。
  • 将 DefaultLoadControl 中 bufferForPlaybackMs 和 bufferForPlaybackAfterRebufferMs 的默认值分别降低到 1000 毫秒和 2000 毫秒。
  • 异步初始化 DeviceInfo 和设备音量（如果使用 setDeviceVolumeControlEnabled 启用）。这些值在 ExoPlayer.Builder.build() 之后不会立即可用，Player.Listener 会通过 onDeviceInfoChanged 和 onDeviceVolumeChanged 通知更改。
  • 创建播放器后，初始音频会话 ID 不再立即可用。如果需要，您可以使用 AnalyticsListener.onAudioSessionIdChanged 监听初始更新。
  • 选择视频轨道时，请考虑语言。默认情况下，选择与所选音轨的语言相匹配的“主”视频轨道（如果有）。可以使用 TrackSelectionParameters.Builder.setPreferredVideoLanguage(s) 表达明确的视频语言偏好设置。
  • 向 DefaultTrackSelector.selectVideoTrack() 方法添加了 selectedAudioLanguage 参数。
  • 向 MediaSourceEventListener.onLoadStarted 和相应的 MediaSourceEventListener.EventDispatcher 方法添加了 retryCount 参数。
  • 修复了以下 bug：在多时段 DASH 流中，如果播放列表项或时段的时长与实际内容不符，可能会导致内容末尾出现画面冻结 (#1698)。
  • 将 BasePreloadManager.Listener 移至顶级 PreloadManagerListener。
  • RenderersFactory.createSecondaryRenderer 可用于提供辅助渲染程序，以便进行预热。预热功能可在播放期间更快地切换媒体文件。
  • 在自适应流式传输格式 DASH、HLS 和 SmoothStreaming 中，允许为清单请求发送 CmcdData (#1951)。
  • 提供将在 MediaCodecRenderer.onReadyToInitializeCodec 中初始化的编解码器的 MediaCodecInfo (#1963)。
  • 更改 AdsMediaSource，以允许通过附加广告组来扩大 AdPlaybackStates。检测到无效修改并抛出异常。
  • 修复了以下问题：在中贴片广告播放完毕后过渡到内容媒体时，可能会快速连续显示额外的仅解码帧。
  • 让 DefaultRenderersFactory 添加两个 MetadataRenderer 实例，以便应用默认接收两种不同架构的元数据。
  • 重新评估在播放暂停时是否应取消正在进行的分块加载 (#1785)。
  • 向 ClippingMediaSource 添加了选项，以允许在不可跳转的媒体中进行剪辑。
  • 修复了以下 bug：在预热状态下跳转可能会阻止后续媒体文件转换。
  • 修复了 ExoPlayer.isLoading() 在已转换为 STATE_IDLE 或 STATE_ENDED 时仍保持 true 的 bug (#2133)。
  • 在 LoadControl.Parameter 中添加了 lastRebufferRealtimeMs (#2113)。
• 转换器：
  • 添加了对转复用为向后兼容的替代格式的支持。
  • 添加了对杜比视界（配置文件 8）格式的转码和转复用支持。
  • 更新 VideoFrameProcessor.registerInputStream 和 VideoFrameProcessor.Listener.onInputStreamRegistered 的参数以使用 Format。
  • 使用 DefaultEncoderFactory 时生成 HDR 静态元数据。
  • 使用 MediaMetricsManager 启用了对 Android 平台诊断信息的支持。Transformer 会将编辑事件和性能数据转发到平台，这有助于在设备上提供系统性能和调试信息。如果设备用户启用了使用情况和诊断信息数据分享功能，Google 可能也会收集上述数据。应用可以选择退出不通过 Transformer.Builder.setUsePlatformDiagnostics(false) 为 Transformer 提供平台诊断信息。
  • 将 InAppMuxer 拆分为 InAppMp4Muxer 和 InAppFragmentedMp4Muxer。 您可以使用 InAppMp4Muxer 生成非分段 MP4 文件，而使用 InAppFragmentedMp4Muxer 生成分段 MP4 文件。
  • 将 Muxer 接口从 media3-muxer 移至 media3-transformer。
  • 添加了 MediaProjectionAssetLoader，用于从 MediaProjection 提供媒体内容以进行屏幕录制，并为 Transformer 演示版应用添加了屏幕录制支持。
  • 向 Codec 接口添加了 #getInputFormat()。
  • 尽可能将释放 GlObjectsProvider 的责任转移到 DefaultVideoFrameProcessor 和 DefaultVideoCompositor 中的调用方。
• 提取器：
  • AVI：修复了对具有恒定比特率压缩音频的文件的处理，其中数据流标头存储的是字节数，而不是数据块数。
  • 修复了对长度以 1 或 2 个字节（而非 4 个字节）表示的 NAL 单元的处理。
  • 修复了 MP4 修改列表中当修改列表从非同步帧开始且前面没有同步帧时出现的 ArrayIndexOutOfBoundsException 问题 (#2062)。
  • 修复了 TS 流可能会在某些设备上卡住的问题 (#2069)。
  • FLAC：添加了对 32 位 FLAC 文件的支持。之前，这些内容无法使用 IllegalStateException: Playback stuck buffering and not loading 播放 (#2197)。
• 音频：
  • 修复了在播放恢复时调用 onAudioPositionAdvancing 的问题（之前是在播放暂停时调用）。
  • 如果 SpeedChangingAudioProcessor 配置了默认参数，请勿绕过 SonicAudioProcessor。
  • 修复了 Sonic#getOutputSize() 中可能导致 DefaultAudioSink 停止运行的下溢问题。
  • 修复 MediaCodecAudioRenderer.getDurationToProgressUs() 和 DecoderAudioRenderer.getDurationToProgressUs()，以便跳转操作正确重置提供的时长。
  • 将 androidx.media3.common.audio.SonicAudioProcessor 设为最终版本。
  • 为 ChannelMappingAudioProcessor 和 TrimmingAudioProcessor 添加了对浮点 PCM 的支持。
• 视频：
  • 将 MediaCodecVideoRenderer.shouldUsePlaceholderSurface 更改为受保护，以便应用可以替换为阻止使用占位符 Surface (#1905)。
  • 添加了实验性 ExoPlayer AV1 样本依赖项解析，以加快跳转速度。使用新的 DefaultRenderersFactory.experimentalSetParseAv1SampleDependencies API 启用。
  • 添加了实验性 ExoPlayer API，用于丢弃不依赖的延迟 MediaCodecVideoRenderer 解码器输入缓冲区。使用 DefaultRenderersFactory.experimentalSetLateThresholdToDropDecoderInputUs 启用。 * 修复了以下问题：没有 Surface 的播放器会立即准备就绪，并且解码任何待处理帧的速度非常慢 (#1973)。
  • 将小米和 OPPO 设备从分离式 Surface 模式中排除，以避免屏幕闪烁 (#2059)。
• 文本：
  • 添加了对 VobSub 字幕的支持 (#8260)。
  • 停止预先加载使用 MediaItem.Builder.setSubtitleConfigurations 配置的所有字幕文件，改为仅加载通过轨道选择功能选择的一个字幕文件 (#1721)。
  • TTML：添加了对使用 style 引用 tts:origin 和 tts:extent 的支持 (#2953)。
  • 将 WebVTT 和 SubRip 时间戳限制为恰好 3 位小数。 以前，我们错误地解析了任意数量的小数位，但始终假定该值以毫秒为单位，从而导致时间戳不正确 (#1997)。
  • 修复了当播放列表包含带有 CEA-608 或 CEA-708 字幕的剪辑内容时播放挂起的问题。
  • 修复了当 SSA 文件包含时长为零（开始时间和结束时间相同）的 cue 文件时出现的 IllegalStateException 问题 (#2052)。
  • 当字幕与音频和视频多路复用到同一容器中时，抑制（并记录）字幕解析错误 (#2052)。
  • 修复了在使用 CR 行尾的 WebVTT 文件中处理多字节 UTF-8 字符的问题 (#2167)。
• DRM：
  • 修复了在 API < 27 的设备上播放 ClearKey 内容时出现的 MediaCodec$CryptoException: Operation not supported in this configuration 错误 (#1732)。
• 效果：
  • 将 OverlaySettings 的功能移至 StaticOverlaySettings。可以为 OverlaySettings 创建子类，以允许动态叠加层设置。
• 多路复用器：
  • 将 MuxerException 移出了 Muxer 接口，以避免出现非常长的完全限定名称。
  • 在 Mp4Muxer.Builder 和 FragmentedMp4Muxer.Builder 中，将 setSampleCopyEnabled() 方法重命名为 setSampleCopyingEnabled()。
  • Mp4Muxer.addTrack() 和 FragmentedMp4Muxer.addTrack() 现在会返回 int 轨道 ID，而不是 TrackToken。
  • Mp4Muxer 和 FragmentedMp4Muxer 不再实现 Muxer 接口。
  • 默认停用 Mp4Muxer 样本批处理和复制。
  • 修复了 FragmentedMp4Muxer 中的一个 bug，该 bug 会在仅写入音轨时创建大量片段。
• 会话：
  • 在播放暂停、停止或失败时，将前台服务状态再保留 10 分钟。这样，用户就可以在此超时时间内恢复播放，而不会在各种设备上受到前台服务限制。请注意，在替换 onTaskRemoved 时，仅调用 player.pause() 已无法再用于在 stopSelf() 之前停止前台服务，请改用 MediaSessionService.pauseAllPlayersAndStopSelf()。
  • 当播放进入错误或停止状态时，让通知保持可见。只有在播放列表被清除或播放器被释放时，通知才会被移除。
  • 改进了对 Android 平台 MediaSession 操作 ACTION_PLAY 和 ACTION_PAUSE 的处理，以便根据可用命令仅设置其中一个，并且在仅设置其中一个时也接受。
  • 将 Context 作为参数添加到 MediaButtonReceiver.shouldStartForegroundService (#1887)。
  • 修复了以下 bug：在连接到旧版会话的 MediaController 上调用 Player 方法会丢弃待处理更新中的更改。
  • 使 MediaSession.setSessionActivity(PendingIntent) 接受 null (#2109)。
  • 修复了以下 bug：在播放列表被清除后，过时的通知仍保持可见 (#2211)。
• 界面：
  • 向 media3-ui-compose 模块添加状态容器和可组合项，以支持 PlayerSurface、PresentationState、PlayPauseButtonState、NextButtonState、PreviousButtonState、RepeatButtonState、ShuffleButtonState 和 PlaybackSpeedState。
• 下载内容：
  • 修复了 CacheWriter 中的 bug，该 bug 会导致在数据源抛出 IOException 以外的 Exception 时，数据源保持打开状态，缓存区域保持锁定状态 (#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 Level-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 包含这些提交内容。

• ExoPlayer：
  • 停用 MediaCodec 中的异步解密功能，以避免此平台 API 出现报告的编解码器超时问题 (#1641)。
• 提取器：
  • MP3：当 VBRI 帧的目录未涵盖文件中的所有 MP3 数据时，不要提前停止播放 (#1904)。
• 视频：
  • 回滚了在处理 onOutputFormatChanged 时使用 MediaCodecAdapter 提供的像素宽高比值 (#1371)。
• 文本：
  • 修复了 ReplacingCuesResolver.discardCuesBeforeTimeUs 中的一个 bug，该 bug 会导致在 timeUs 处处于活动状态的提示（之前已开始但尚未结束）被错误地舍弃 (#1939)。
• 元数据：
  • 将 Vorbis 注释中的光盘/曲目编号和流派提取到 MediaMetadata (#1958) 中。

版本 1.5.0

2024 年 11 月 27 日

发布了 androidx.media3:media3-*:1.5.0。版本 1.5.0 包含这些提交内容。

• 通用库：
  • 添加了 ForwardingSimpleBasePlayer，以便在确保完全一致性和监听器处理的同时，允许通过细微调整转发到另一个播放器 (#1183)。
  • 将 SimpleBasePlayer.State.playlist 替换为 getPlaylist() 方法。
  • 为 SimpleBasePlayer.State.Builder.setPlaylist() 添加了替换项，以直接指定 Timeline 以及当前的 Tracks 和 Metadata，而不是构建播放列表结构。
  • 将 minSdk 提高到 21 (Android Lollipop)。这与所有其他 AndroidX 库一致。
  • 添加了 androidx.media3:media3-common-ktx 工件，该工件提供基于 Common 库构建的 Kotlin 专用功能
  • 向 media3-common-ktx 库添加了 Player.listen 挂起扩展函数，用于启动协程来监听 Player.Events。
  • 从旨在避免运行时类验证失败的手动外嵌内部类中移除 @DoNotInline 注解。 现在，最新版本的 R8 会自动对这类调用进行去内联，以避免运行时失败（因此不再需要手动去内联）。由于 compileSdk = 35，该库的所有 Gradle 用户必须已经在使用 Android Gradle 插件版本，该版本使用执行此操作的 R8 版本。使用非 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()，以在各个渲染器允许播放准备就绪时发出信号。
  • 修复了在 API 31 及更高版本中，当 MediaCodec 以异步模式（默认行为）运行时，MediaCodec.CryptoException 有时会被报告为“意外运行时错误”的问题。
  • 传递 bufferedDurationUs，而不是传递 bufferedPositionUs 和 PreloadMediaSource.PreloadControl.onContinueLoadingRequested()。此外，还将 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.Builder，用于通过一致的共享配置构建 DefaultPreloadManager 和 ExoPlayer 实例。
  • 从 LoadControl.onTracksSelected() 中移除 Renderer[] 参数，因为 DefaultLoadControl 实现可以从 ExoTrackSelection[] 中检索流类型。
  • 废弃了 DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[])，并将方法标记为 final，以防止替换。 应改用新的 DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[])。
  • 在 MergingMediaSource 中报告来自次要来源的 MediaSourceEventListener 事件。这会导致系统针对旁加载的字幕（使用 MediaItem.LocalConfiguration.subtitleConfigurations 添加的字幕）报告加载开始/错误/取消/完成事件，这些事件可能会显示为从 AnalyticsListener 发出的重复加载事件。
  • 防止字幕和元数据错误导致播放完全停止。 而是停用有问题的轨道，并继续播放其余轨道 (#1722)。
    • 在新的字幕处理（提取期间）中，相关的解析（例如无效的字幕数据）和加载错误（例如 HTTP 404）通过 onLoadError 回调发出。
    • 在旧版字幕处理（在渲染期间）中，系统只会通过 onLoadError 回调发出关联的加载错误，而解析错误会被静默忽略（这是预先存在的行为）。
  • 修复了以下 bug：在多时段 DASH 流中，如果播放列表项或时段的时长与实际内容不符，可能会导致内容末尾出现画面冻结 (#1698)。
  • 向 SntpClient 添加了一个 setter，用于设置自上次更新以来客户端重新初始化的最长经过时间 (#1794)。
• 转换器：
  • 添加 SurfaceAssetLoader，它支持通过 Surface 将视频数据排入 Transformer 的队列。
  • ImageAssetLoader 通过 AssetLoader.onError 报告不受支持的输入，而不是抛出 IllegalStateException。
  • 强制要求使用 MediaItem.Builder.setImageDurationMs 设置图片时长，以便导出图片。
  • 添加了对音频 EditedMediaItem 序列中空隙的导出支持。
• 轨道选择：
  • DefaultTrackSelector：在其他因素相同的情况下，优先选择基于对象的音频，而不是基于声道的音频。
• 提取器：
  • 允许 Mp4Extractor 和 FragmentedMp4Extractor 识别后续样本未用作参考的 H264 样本。
  • 添加了用于在 AmrExtractor 中启用基于索引的跳转的选项。
  • 将有效帧之间超过 128kB 的 MP3 文件视为已截断（而非无效）。这意味着，如果文件末尾包含非 MP3 数据，且没有其他元数据来指示 MP3 字节的长度，现在会在 MP3 数据末尾停止播放，而不是失败并显示 ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563)。
  • 修复了在 MP4 文件中处理编辑列表时，非关键帧媒体起始位置的前贴片广告样本处理问题 (#1659)。
  • 通过使用 Mp4Extractor 和 FragmentedMp4Extractor 中 mdhd 框的媒体时长，改进了帧速率计算 (#1531)。
  • 修复了 MP4 编辑列表中 media_time 的缩放比例不正确的问题。虽然 segment_duration 已经使用影片时间标度正确缩放，但现在 media_time 会使用轨道时间标度正确缩放，如 MP4 格式标准 (#1792) 所指定。
  • 在针对具有修改列表的 MP4 的 endIndices 计算中处理无序帧 (#1797)。
  • 修复了 MP4 文件 mdhd 框中的媒体时长解析问题，以处理 -1 值 (#1819)。
  • 添加了对识别 H.263 视频的 MP4 文件中的 h263 框的支持 (#1821)。
  • 添加了 AC-4 Level-4 ISO 基本媒体文件格式支持 (#1265)。
• DataSource：
  • 更新了 HttpEngineDataSource，允许从版本 S 扩展 7（而非 API 级别 34）开始使用 (#1262)。
  • DataSourceContractTest：断言 DataSource.getUri() 会返回解析后的 URI（如文档中所述）。如果此 URI 与请求的 URI 不同，测试可以使用新的 DataSourceContractTest.TestResource.Builder.setResolvedUri() 方法来指明这一点。
  • DataSourceContractTest：断言在对 open() 的调用失败（由于“未找到”资源）之后以及在后续 close() 调用之前，DataSource.getUri() 和 getResponseHeaders() 会返回其“打开”值。
    • 通过替换 DataSourceContractTest.getNotFoundResources()，测试子类可以提供多个“未找到”资源，还可以提供任何预期的标头。这样可以区分 HTTP 404（带有标头）和“未找到服务器”（无标头）。
• 音频：
  • 如果媒体中存在 CTA-2075 响度元数据，则在编解码器上自动配置该元数据。
  • 确保在跳转时音量平稳降低。
  • 修复了在跳转时可能会出现爆音的问题。
  • 修复了 Sonic 的时间拉伸/音高变换算法的截断误差累积问题。
  • 修复了 SpeedChangingAudioProcessor 中导致输出帧丢失的 bug。
• 视频：
  • MediaCodecVideoRenderer 会避免解码既不渲染也不被其他样本用作参考的样本。
  • 在 API 35 及更高级别中，MediaCodecAdapter 现在可能会在 configure 中收到 null Surface，并调用新方法 detachOutputSurface 来移除之前设置的 Surface（如果编解码器支持此操作 [MediaCodecInfo.detachedSurfaceSupported]）。
  • 在处理 onOutputFormatChanged 时，使用 MediaCodecAdapter 提供的像素宽高比值（如果提供）(#1371)。
  • 针对 Galaxy Tab S7 FE 上的设备问题添加了权宜解决方法，该问题会导致 60fps 安全 H264 流被标记为不受支持 (#1619)。
  • 针对在最后一个样本后卡住且不返回流结束信号的编解码器添加了权宜解决方法。
• 文本：
  • 添加了自定义 VoiceSpan 并为 WebVTT 语音 span 填充了该 span (#1632)。
  • 确保显示 HLS 中具有非常大的字幕时间戳（以微秒表示并乘以 90,000 MPEG 时基时会溢出 64 位 long）的 WebVTT (#1763)。
  • 支持杜比视界内容中的 CEA-608 字幕 (#1820)。
  • 修复了启用 CEA-608 字幕时 DASH 多时段直播播放卡住的问题 (#1863)。
• 元数据：
  • 将 C.TRACK_TYPE_METADATA 类型分配给包含 icy 或 vnd.dvb.ait 内容的轨道。
• 图片：
  • 添加了 ExternallyLoadedImageDecoder，以便简化与外部图片加载库（如 Glide 或 Coil）的集成。
• DataSource：
  • 添加了 FileDescriptorDataSource，这是一种可用于从 FileDescriptor 中读取数据的新 DataSource (#3757)。
• 效果：
  • 针对轻微的 SurfaceTexture 缩放问题添加了 DefaultVideoFrameProcessor 解决方法。SurfaceTexture 可能包含一个小的缩放比例，用于剪裁掉剪裁缓冲区边缘周围的 1 纹素边框。现在，此问题已得到处理，输出结果更接近预期。
  • 加快 DefaultVideoFrameProcessor.queueInputBitmap()。因此，使用 Transformer 将图片导出为视频的速度更快。
• IMA 扩展程序：
  • 修复了以下 bug：清空播放列表可能会导致 ImaServerSideAdInsertionMediaSource 中出现 ArrayIndexOutOfBoundsException。
  • 修复了以下 bug：在播放完最后一个中贴片广告后，不含前贴片广告的服务器端插入 DAI 视频流可能会导致 ArrayIndexOutOfBoundsException (#1741)。
• 会话：
  • 添加了 MediaButtonReceiver.shouldStartForegroundService(Intent)，以允许应用通过替换此方法来抑制传入的用于恢复播放的播放命令。默认情况下，该服务始终处于启动状态，并且无法在系统不因 ForegroundServiceDidNotStartInTimeException 而使该服务崩溃的情况下抑制播放 (#1528)。
  • 修复了以下 bug：在连接到旧版服务时，从 MediaBrowser 发送的自定义命令会被分派到 MediaSessionCompat.Callback，而不是该方法的 MediaBrowserServiceCompat 变体。这导致 MediaBrowser 无法接收旧版服务发回的实际返回值 (#1474)。
  • 处理在为媒体按钮 intent 设置广播接收器时由某些制造商的设备抛出的 IllegalArgumentException (#1730)。
  • 为媒体文件添加命令按钮。这会添加 Media3 API，用于实现旧版库中名为 Custom browse actions 的功能，并使用 MediaBrowserCompat。请注意，借助 Media3，MediaBrowser 和 MediaController 均可使用媒体项的命令按钮。请参阅实现自定义浏览操作。 * 修复了以下 bug：在请求 play() 后，Media3 控制器有时无法让会话应用启动前台服务。
  • 限制 CommandButton.Builder.setIconUri 仅接受内容 URI。
  • 连接到旧版 MediaBrowserCompat 时，将 Media3 浏览器的连接提示传递给初始 MediaBrowserCompat。 该服务可以在首次调用 onGetRoot() 时接收作为根提示传入的连接提示。
  • 修复了以下 bug：在浏览器订阅 parentid 后，连接到旧版浏览器服务的 MediaBrowser 未收到该服务发送的错误。
  • 改进了互操作性行为，使连接到旧版 MediaBrowserService 的 Media3 浏览器在订阅父级时不会两次请求 parentId 的子级。
• 界面：
  • 由于基于 XML 的共享过渡存在问题，因此在 Compose 中使用 PlayerView 的 AndroidView 解决方法中，拉伸/剪裁视频功能改为选择启用。在 AndroidView 中使用 PlayerView 的应用需要调用 PlayerView.setEnableComposeSurfaceSyncWorkaround 才能选择启用（#1237、#1594）。
  • 向 PlayerView 添加了 setFullscreenButtonState，以便按需（即带外，而不是对点击互动做出响应）更新全屏按钮的图标（#1590、#184）。
  • 修复了以下 bug：如果存在应用定义的文字轨道选择偏好设置，则文字选择中的“None”选项不起作用。
• DASH 扩展程序：
  • 添加了对从片段中间开始的周期的支持 (#1440)。
• 流畅的流式传输扩展程序：
  • 修复了播放带有文本轨道的 SmoothStreaming 流时出现的 Bad magic number for Bundle 错误 (#1779)。
• RTSP 扩展程序：
  • 修复了针对包含经过编码的 @ 字符的网址移除用户信息的问题 (#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 包含这些提交内容。

• ExoPlayer：
  • 在 PreloadMediaSource 中异步处理预加载回调 (#1568)。
  • 加载失败时，无论缓冲时长如何，都允许播放 (#1571)。
• 提取器：
  • MP3：根据 Info 帧中的长度字段正确忽略尾随的非 MP3 数据，从而修复 Searched too many bytes 错误 (#1480)。
• 文本：
  • TTML：修复了对百分比 tts:fontSize 值的处理，以确保它们能从具有百分比 tts:fontSize 值的父节点正确继承。
  • 修复了 LegacySubtitleUtil 中因错误处理请求的输出开始时间大于或等于 Subtitle 中的最终事件时间的情况而导致的 IndexOutOfBoundsException 问题 (#1516)。
• DRM：
  • 修复了在播放 L1 Widevine 内容时 API 31 及更高版本的设备上出现的 android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE 错误。此错误是由于框架 MediaDrm.requiresSecureDecoder 方法 (#1603) 的实现不完整所致。
• 效果：
  • 向 GlObjectsProvider 添加了 release() 方法。
• 会话：
  • 如文档中所述，将点按两次 KEYCODE_HEADSETHOOK 转换为“跳转到下一个”操作 (#1493)。
  • 在决定是否忽略 KEYCODE_HEADSETHOOK 以避免 ForegroundServiceDidNotStartInTimeException 时，将其作为 MediaButtonReceiver 中的“播放”命令进行处理 (#1581)。
• RTSP 扩展程序：
  • 在 SDP 解析中跳过无效的媒体说明 (#1087)。

版本 1.4.0

2024 年 7 月 25 日

发布了 androidx.media3:media3-*:1.4.0。版本 1.4.0 包含这些提交内容。

• 通用库：
  • 将假定的空操作跳转调用转发到受保护的 BasePlayer.seekTo() 和 SimpleBasePlayer.handleSeek() 方法，而不是忽略它们。如果您要在自定义播放器中实现这些方法，则可能需要使用 mediaItemIndex == C.INDEX_UNSET 处理这些额外的调用。
  • 移除了对增强型 Java 8 脱糖的编译依赖项 (#1312)。
  • 确保对于非图片 MediaItem，传递给 MediaItem.Builder.setImageDurationMs() 的时长会被忽略（如文档中所述）。
  • 添加 Format.customData 以存储应用提供的有关 Format 实例的自定义信息。
• ExoPlayer：
  • 添加了 BasePreloadManager，它会根据其 rankingData 定义的优先级协调多个来源的预加载。您可以通过扩展此类进行自定义。添加 DefaultPreloadManager，它使用 PreloadMediaSource 将来源的媒体样本预加载到内存中，并使用一个整数 rankingData 来指示界面上某个项的索引。
  • 向 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 中。
  • 将 reset() 添加到 BasePreloadManager，以释放所有保留的来源，同时保留预加载管理器实例。
  • 添加了 ExoPlayer.setPriority()（和 Builder.setPriority()），用于定义 PriorityTaskManager 中使用的优先级值，以及从 API 35 开始的 MediaCodec 重要性。
  • 修复了更新上次重新缓冲时间时导致 CMCD 中出现不正确的 bs（缓冲区耗尽）键的问题 (#1124)。
  • 添加了 PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource)，用于指明来源已加载到末尾。这样，DefaultPreloadManager 和自定义 PreloadMediaSource.PreloadControl 实现就可以预加载下一个来源或执行其他操作。
  • 修复了在内容末尾跳过静音部分可能会触发播放异常的 bug。
  • 将 clear 添加到 PreloadMediaSource 以舍弃预加载期。
  • 添加了新的错误代码 PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED，该代码在编解码器资源被回收用于更高优先级的任务时使用。
  • 允许 AdsMediaSource 在初始内容媒体准备工作完成之前加载前贴片广告 (#1358)。
  • 修复了以下 bug：在原始时段已从清单中移除后，重新准备多时段 DASH 直播时，播放会移至 STATE_ENDED。
  • 在 PreloadMediaSource.PreloadControl 中，将 onTimelineRefreshed() 重命名为 onSourcePrepared()，将 onPrepared() 重命名为 onTracksSelected()。同时相应地重命名 DefaultPreloadManager.Stage 中的 IntDef。
  • 添加了对动态调度的实验性支持，以便更好地使工作与 CPU 唤醒周期保持一致，并延迟唤醒，直到渲染程序可以继续。 您可以在设置 ExoPlayer 实例时使用 experimentalSetDynamicSchedulingEnabled() 启用此功能。
  • 添加了 Renderer.getDurationToProgressUs()。Renderer 可以实现此方法，以向 ExoPlayer 返回播放必须提前的时长，以便渲染器继续播放。如果使用 experimentalSetDynamicSchedulingEnabled() 设置 ExoPlayer，则 ExoPlayer 在计算安排其工作任务的时间时会调用此方法。
  • 添加 MediaCodecAdapter#OnBufferAvailableListener，以便在输入和输出缓冲区可供 MediaCodecRenderer 使用时发出提醒。 MediaCodecRenderer 在收到这些回调时会向 ExoPlayer 发出信号，如果 ExoPlayer 设置了 experimentalSetDynamicSchedulingEnabled()，则 ExoPlayer 会安排其工作循环，因为渲染器可以取得进展。
  • 为 LoadControl 方法使用数据类，而不是单个参数。
  • 添加 ExoPlayer.isReleased() 以检查是否已调用 Exoplayer.release()。
  • 添加了 ExoPlayer.Builder.setMaxSeekToPreviousPositionMs()，用于配置 seekToPrevious() 查找上一项的最大位置 (#1425)。
  • 修复了一些音频焦点不一致的问题，例如在播放器暂停时未报告完全或暂时失去焦点 (#1436)。
  • 修复了因提取器在初始准备步骤后报告其他轨道而可能导致的 IndexOutOfBoundsException (#1476)。
  • ExoPlayer.setVideoEffect() 中的 Effects 将接收已移除渲染器偏移的时间戳 (#1098)。
  • 修复了在处理预读到另一个播放列表项时发生的播放器错误时可能出现的 IllegalArgumentException (#1483)。
• 转换器：
  • 向 ExportResult 添加 audioConversionProcess 和 videoConversionProcess，以指明输出文件中相应轨道的制作方式。
  • 放宽剪辑优化 H.264 级别检查。
  • 添加了对在序列中切换 SDR 和 HDR 输入媒体的支持。
  • 添加了对合成级音频效果的支持。
  • 添加了对将 Ultra HDR 图片转码为 HDR 视频的支持。
  • 修复了 DefaultAudioMixer 在重置和重复使用后无法输出正确字节数的问题。
  • 解决了解码器 bug，该 bug 会导致在处理 PCM 输入时音频声道数上限为立体声。
  • 在 ExoPlayerAssetLoader 中选择轨道时，请忽略音频声道数限制，因为这些限制仅适用于播放。
  • 将 androidx.media3.transformer.Muxer 接口替换为 androidx.media3.muxer.Muxer，并移除 androidx.media3.transformer.Muxer。
  • 修复了从内容 URI 架构加载 HEIC 图片的问题。 (#1373)。
  • 在 AudioGraphInput 中调整音轨时长，以改善音视频同步。
  • 移除 ExportResult.processedInputs 字段。如果您使用此字段来提供编解码器详细信息，请改用 DefaultDecoderFactory.listener。如果发生编解码器异常，ExportException.codecInfo 中会提供编解码器详细信息。
• 提取器：
  • MPEG-TS：通过将数据流的最后一个访问单元传递到样本队列，前滚确保渲染最后一帧的更改 (#7909)。纳入了修复程序，以解决仅 I 帧 HLS 流(#1150) 和 H.262 HLS 流 (#1126) 中出现的问题。
  • MP3：优先采用 Info 帧中的数据大小，而不是底层数据流报告的大小（例如文件大小或 HTTP Content-Length 标头）。 这有助于从恒定比特率跳转计算中排除不可播放的尾部数据（例如专辑封面），从而使跳转更准确 (#1376)。
  • MP3：使用 Info 帧（如果存在）中的帧数和其他数据来计算固定比特率跳转的平均比特率，而不是根据 Info 帧之后的帧的比特率进行推断，因为后者可能人为地偏小，例如 PCUT 帧 (#1376)。
  • 修复了 AVI 容器中的 PCM 音频格式提取问题。
• 音频：
  • 修复了 DTS:X Profile 2 编码属性，以便进行透传播放 (#1299)。
  • 对于分流播放，请在调用 AudioTrack.stop() 之前重置 DefaultAudioSink 中用于跟踪数据流完成情况的字段，以便 AudioTrack.StreamEventCallback#onPresentationEnded 正确识别所有待处理数据何时已播放完毕。
  • 修复了 SilenceSkippingAudioProcessor 中的一个 bug，即不同音频格式（例如立体声到单声道）之间的转换可能会导致处理器抛出异常 (#1352)。
  • 实现 MediaCodecAudioRenderer.getDurationToProgressUs()，以便 ExoPlayer 在 MediaCodecAudioRenderer 可以取得进展时动态安排其主工作循环。
• 视频：
  • 修复了在播放过程中切换 Surface 时 Listener.onRenderedFirstFrame() 到达过早的问题。
  • 修复了杜比视界的解码器回退逻辑，以在需要时使用兼容的 AV1 解码器 (#1389)。
  • 修复了可能因在播放过程中启用视频渲染程序而导致的编解码器异常。
• 文本：
  • 修复了在跳转位置之前开始的字幕会被跳过的问题。 此问题仅在 Media3 1.4.0-alpha01 中引入。
  • 更改默认字幕解析行为，使其在提取期间（而非渲染期间）发生（如需了解提取和渲染之间的区别，请参阅 ExoPlayer 的架构图）。
    • 您可以通过同时调用 MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) 和 TextRenderer.experimentalSetLegacyDecodingEnabled(true) 来替换此更改。如需了解如何将这些组件插入 ExoPlayer 实例，请参阅有关自定义的文档。 这些方法（以及对旧版字幕解码的所有支持）将在未来版本中移除。
    • 具有自定义 SubtitleDecoder 实现的应用需要更新这些实现，改为实现 SubtitleParser（以及 SubtitleParser.Factory，而不是 SubtitleDecoderFactory）。
  • 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)。
  • 修复了当值长度超过一个字节时，MP4 (/iTunes) 数字 gnre（流派）和 tmpo（节奏）标签的读取问题。
  • 将 ID3 TCON 帧传播到 MediaMetadata.genre (#1305)。
• 图片：
  • 添加了对非方形 DASH 缩略图网格的支持 (#1300)。
  • 为 API 34 及更高版本添加了对 AVIF 的支持。
  • 允许将 null 作为 ExoPlayer.setImageOutput() 的参数，以清除之前设置的 ImageOutput。
• DataSource：
  • 实现对 android.resource://package/id 原始资源 URI 的支持，其中 package 与当前应用的软件包不同。 之前没有记录过这种方法，但与按名称访问相比，这是一种更高效的访问其他软件包中资源的方法。
  • 在 DataSpec 构造函数中，主动检查 url 是否不为 null。此参数已被注解为非 null。
  • 允许 ByteArrayDataSource 在 open() 期间将 URI 解析为字节数组，而不是在构建时进行硬编码 (#1405)。
• DRM：
  • 允许在 DefaultDrmSessionManagerProvider 上设置 LoadErrorHandlingPolicy (#1271)。
• 效果：
  • 支持在 SpeedChangeEffect 中的同一 EditedMediaItem 或 Composition 内进行多次速度更改。
  • 支持从 Ultra HDR 位图输入中输出 HLG 和 PQ。
  • 添加了对 EGL_GL_COLORSPACE_BT2020_HLG_EXT 的支持，这改进了 ExoPlayer.setVideoEffect 和 Transformer 的调试 SurfaceView 中的 HLG Surface 输出。
  • 更新叠加层矩阵实现，通过翻转 setOverlayFrameAnchor() 中应用的 x 和 y 值，使其与文档保持一致。如果使用 OverlaySettings.Builder.setOverlayFrameAnchor()，请将 x 和 y 值乘以 -1，以翻转它们。
  • 修复了 TimestampWrapper 与 ExoPlayer#setVideoEffects 搭配使用时会崩溃的 bug (#821)。
  • 将默认 SDR 颜色工作空间从线性颜色更改为电信号 BT 709 SDR 视频。此外，还提供第三个选项，用于保留原始色彩空间。
  • 允许定义 EditedMediaItemSequences 的不确定 Z 顺序 (#1055)。
  • 在不同的 HDR 内容中保持一致的亮度范围（使用 HLG 范围）。
  • 添加了对 HDR 内容上的 Ultra HDR（位图）叠加层的支持。
  • 允许在 API 26 之前使用 SeparableConvolution 效果。
  • 移除了未使用的 OverlaySettings.useHdr，因为叠加层和帧的动态范围必须匹配。
  • 为 TextOverlay 添加了 HDR 支持。可以使用 OverlaySettings.Builder.setHdrLuminanceMultiplier() 调整文本叠加层的亮度。
• IMA 扩展程序：
  • 将应用播放 DAI 广告流所需的 API 升级为稳定版。
  • 向 ImaServerSideAdInsertionMediaSource.AdLoader 添加了 replaceAdTagParameters(Map <String, String>)，以便在运行时替换广告代码参数。
  • 修复了在广告播放期间发生播放器错误时未调用 VideoAdPlayer.VideoAdPlayerCallback.onError() 的 bug (#1334)。
  • 将 IMA SDK 版本提升至 3.33.0，以修复使用 data:// 广告代码 URI 时出现的 NullPointerException (#700)。
• 会话：
  • 将 CommandButton.enabled 的默认值更改为 true，并确保即使关联的命令可用，控制器的值也可以保持为 false。
  • 为 CommandButton 添加了图标常量，应使用这些常量，而不是自定义图标资源。
  • 添加了 MediaSessionService.isPlaybackOngoing()，以便应用查询是否需要在 onTaskRemoved() 中停止服务 (#1219)。
  • 添加 MediaSessionService.pauseAllPlayersAndStopSelf()，以便轻松暂停所有会话的播放，并调用 stopSelf() 来终止 MediaSessionService 的生命周期。
  • 替换 MediaSessionService.onTaskRemoved(Intent)，以提供安全的默认实现，在播放正在进行时让服务在前台运行，否则停止服务。
  • 通过不将时长设置到平台会话元数据中，在直播媒体通知中隐藏进度条 (#1256)。
  • 将 MediaMetadata 的转换与 MediaDescriptionCompat 保持一致，以便在选择元数据属性时使用与 media1 相同的首选顺序和逻辑。
  • 添加了 MediaSession.sendError()，以便向 Media3 控制器发送非严重错误。使用通知控制器（请参阅 MediaSession.getMediaNotificationControllerInfo()）时，自定义错误用于将平台会话的 PlaybackState 更新为具有给定错误信息的错误状态 (#543)。
  • 添加 MediaSession.Callback.onPlayerInteractionFinished()，以便在来自特定控制器的玩家互动系列结束时通知会话。
  • 添加 SessionError，并在 SessionResult 和 LibraryResult 中使用它（而不是错误代码），以提供有关错误的更多信息以及如何解决错误（如果可能）。
  • 发布 media3 控制器测试应用的代码，该应用可用于测试与发布媒体会话的应用之间的互动。
  • 将传递给 media3 的 MediaSession[Builder].setSessionExtras() 的 extra 传播到 media1 控制器的 PlaybackStateCompat.getExtras()。
  • 将严重错误和非严重错误映射到平台会话，以及从平台会话映射严重错误和非严重错误。PlaybackException 会映射到 PlaybackStateCompat 的严重错误状态。发送到媒体通知控制器且包含 MediaSession.sendError(ControllerInfo, SessionError) 的 SessionError 会映射到 PlaybackStateCompat 中的非严重错误，这意味着错误代码和消息已设置，但平台会话的状态仍不同于 STATE_ERROR。
  • 允许按控制器设置会话活动，以覆盖全局会话活动。您可以在连接时通过使用 AcceptedResultBuilder.setSessionActivivty(PendingIntent) 创建 ConnectionResult，为控制器定义会话 activity。连接后，可以使用 MediaSession.setSessionActivity(ControllerInfo, PendingIntent) 更新会话 activity。
  • 改进了对 MediaLibrarySession.Callback 的调用的错误复制。 现在，您可以使用 MediaLibrarySession.Builder.setLibraryErrorReplicationMode() 选择错误类型或停用默认启用的错误复制，从而配置错误复制。
• 界面：
  • 为 PlayerView 添加了在连接到 ExoPlayer 时显示图片的支持 (#1144)。
  • 通过 XML 属性在 PlayerControlView 中添加了各种图标的自定义设置，以便为每个 PlayerView 实例提供不同的可绘制对象，而不是全局替换 (#1200)。
  • 解决了一个平台 bug，该 bug 会导致在 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 扩展程序：
  • 修复了以下 bug：等待不连续性的待处理 EMSG 样本在 HlsSampleStreamWrapper 中以不正确的偏移量委托，从而导致 IndexOutOfBoundsException 或 IllegalArgumentException (#1002)。
  • 修复了 LL-HLS 流的非主要播放列表不断重新加载的 bug (#1240)。
  • 修复了以下 bug：为具有初始化片段的 HLS 启用 CMCD 会导致 Source Error 和 IllegalArgumentException。
  • 修复了在直播播放期间非主要播放列表未刷新的 bug (#1240)。
  • 修复了为 HLS 直播启用 CMCD 会导致 ArrayIndexOutOfBoundsException 的 bug (#1395)。
• DASH 扩展程序：
  • 修复了重新准备多时段直播可能会抛出 IndexOutOfBoundsException 的 bug (#1329)。
  • 添加了对 dashif:Laurl 许可网址的支持 (#1345)。
• Cast 扩展程序：
  • 修复了以下 bug：将 MediaQueueItem 的专辑标题转换为 Media3 媒体文件中的艺术家 (#1255)。
• 测试实用程序：
  • 在 FakeRenderer 中实现 onInit() 和 onRelease()。
  • 将 TestPlayerRunHelper.runUntil()/playUntil() 方法更改为在发生非严重错误（例如向 AnalyticsListener.onVideoCodecError() 报告的错误）时失败。使用新的 TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() 方法链可停用此行为。
• 演示版应用：
  • 在短视频演示应用中使用 DefaultPreloadManager。
  • 允许通过命令行使用 Intent 参数设置重复模式 (#1266)。
  • 如果设备支持，请使用 HttpEngineDataSource 作为 HttpDataSource。
• 移除了已废弃的符号：
  • 移除了 CronetDataSourceFactory。请改用 CronetDataSource.Factory。
  • 移除了部分 DataSpec 构造函数。请改用 DataSpec.Builder。
  • 从 DefaultHttpDataSource、OkHttpDataSource 和 CronetDataSource 中移除了 setContentTypePredicate(Predicate) 方法。请改为在每个 XXXDataSource.Factory 上使用等效方法。
  • 移除了 OkHttpDataSource 构造函数和 OkHttpDataSourceFactory。 请改用 OkHttpDataSource.Factory。
  • 移除了 PlayerMessage.setHandler(Handler)。请改用 setLooper(Looper)。
  • 移除 Timeline.Window.isLive 字段。请改用 isLive() 方法。
  • 移除了 DefaultHttpDataSource 构造函数。改用 DefaultHttpDataSource.Factory。
  • 移除了 DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS。改用 DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS。
  • 移除了 MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean)。请改用 MediaCodecInfo.canReuseCodec(Format, Format)。
  • 移除了 DrmSessionManager.DUMMY 和 getDummyDrmSessionManager() 方法。请改用 DrmSessionManager.DRM_UNSUPPORTED。
  • 移除AnalyticsListener.onAudioInputFormatChanged(EventTime, Format)、AnalyticsListener.onVideoInputFormatChanged(EventTime, Format)、AudioRendererEventListener.onAudioInputFormatChanged(Format)、VideoRendererEventListener.onVideoInputFormatChanged(Format)。请改用接受 DecoderReuseEvaluation 的重载。
  • 移除了 RendererSupport.FormatSupport IntDef 以及 FORMAT_HANDLED、FORMAT_EXCEEDS_CAPABILITIES、FORMAT_UNSUPPORTED_DRM、FORMAT_UNSUPPORTED_SUBTYPE、FORMAT_UNSUPPORTED_TYPE 常量。请改用 androidx.media3.common.C 中的等效 IntDef 和常量（例如 C.FORMAT_HANDLED）。
  • 移除 Bundleable 接口。这包括移除所有 Bundleable.Creator<Foo> CREATOR 常量字段。调用方应改为对每种类型使用 Bundle toBundle() 和 static Foo fromBundle(Bundle) 方法。

版本 1.4.0-rc01

2024 年 7 月 10 日

使用 1.4.0 稳定版。

版本 1.4.0-beta01

2024 年 6 月 26 日

使用 1.4.0 稳定版。

版本 1.4.0-alpha02

2024 年 6 月 7 日

使用 1.4.0 稳定版。

版本 1.4.0-alpha01

2024 年 4 月 17 日

使用 1.4.0 稳定版。

版本 1.3.0

版本 1.3.1

2024 年 4 月 11 日

发布了 androidx.media3:media3-*:1.3.1。版本 1.3.1 包含这些提交内容。

• 通用库：
  • 添加 Format.labels 以允许本地化标签或其他替代标签。
• ExoPlayer：
  • 修复了 PreloadMediaPeriod 再次预加载时无法保留数据流的问题。
  • 在轨道重新选择中，将正确的对应 TrackSelectionResult 应用于播放时段。
  • 仅在媒体文件之间转换时推进播放时段后，才启动提前启用的渲染程序 (#1017)。
  • 为 DefaultVideoFrameProcessor.Factory.Builder.build() 的 ProGuard -keepclasseswithmembers 规则添加了缺失的返回值类型 (#1187)。
• 转换器：
  • 针对 API 30 之前 MediaMuxer 不支持负呈现时间戳而抛出的异常添加了解决方法。
• 轨道选择：
  • DefaultTrackSelector：优先选择帧速率“合理”(>=10fps) 的视频轨道，而不是帧速率较低或未设置帧速率的视频轨道。这可确保播放器在从动态照片中提取的 MP4 中选择“真实”视频轨道，这些 MP4 可能包含两个 HEVC 轨道，其中一个轨道的分辨率较高，但帧数非常少 (#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 设备上，MediaDrm 框架可能会抛出 NoSuchMethodError 而不是 ResourceBusyException 或 NotProvisionedException 的问题 (#1145)。
• 效果：
  • 通过转换色彩空间，改进了 PQ 到 SDR 的色调映射。
• 会话：
  • 修复了控制器替换当前内容时当前位置跳回的问题 (#951)。
  • 修复了以下问题：仅包含非 null extras 的 MediaMetadata 无法在媒体控制器和会话之间传输 (#1176)。
• 界面：
  • 如果 Locale 无法识别显示名称，则回退到包含音轨语言名称 (#988)。
• DASH 扩展程序：
  • 将清单中的所有 Label 元素填充到 Format.labels 中 (#1054)。
• RTSP 扩展程序：
  • 在 SDP 解析中跳过空会话信息值（i 标记）(#1087)。
• 解码器扩展程序（FFmpeg、VP9、AV1、MIDI 等）：
  • 默认情况下，停用 MIDI 扩展作为本地依赖项，因为它需要配置额外的 Maven 制品库。需要从本地依赖项获取此模块的用户可以重新启用它。

版本 1.3.0

2024 年 3 月 6 日

发布了 androidx.media3:media3-*:1.3.0。版本 1.3.0 包含这些提交内容。

• 通用库：
  • 实现对 android.resource://package/[type/]name 原始资源 URI 的支持，其中 package 与当前应用的软件包不同。虽然文档中一直说明此功能有效，但直到现在才正确实现。
  • 将应用代码设置或从媒体中读取的 MIME 类型标准化为全小写。
  • 在 AdPlaybackState 中使用完整的 MediaItem 而不是单个 Uri 来定义广告。
  • 将 minSdk 提高到 19 (Android KitKat)。这与所有其他 AndroidX 库保持一致，并且是我们将 AndroidX 依赖项升级到最新版本所必需的。
  • 当 artworkUri 和 artworkData 中至少有一个不为 null 时，在 MediaMetadata.Builder.populate(MediaMetadata) 中填充这两个值 (#964)。
• ExoPlayer：
  • 添加了 PreloadMediaSource 和 PreloadMediaPeriod，以便应用在播放前在特定起始位置预加载内容媒体源。PreloadMediaSource 负责准备内容媒体来源以接收 Timeline、准备和缓存给定起始位置的时段、选择轨道以及加载该时段的媒体数据。应用通过实现 PreloadMediaSource.PreloadControl 来控制预加载进度，并将预加载的来源设置为播放器进行播放。
  • 添加了 ExoPlayer.setImageOutput，以允许应用设置 ImageRenderer.ImageOutput。
  • 默认情况下，DefaultRenderersFactory 现在会向播放器提供 ImageRenderer，其中 ImageOutput 和 ImageDecoder.Factory.DEFAULT 为 null。
  • 跳过静音时发出 Player.Listener.onPositionDiscontinuity 事件 (#765)。
  • 添加了对在提取期间解析字幕的实验性支持。您可以使用 MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() 启用此功能。
  • 支持使用 PreloadMediaSource 的自适应媒体来源。
  • 使用 HttpEngine API 实现 HttpEngineDataSource（一种 HttpDataSource）。
  • 防止子类化 CompositeSequenceableLoader。此组件之前已设为可扩展，但从未在库中进行子类化。您可以使用装饰器模式封装实例并实现自定义 CompositeSequenceableLoaderFactory，从而进行自定义。
  • 修复了重复相同时间会导致此项中的元数据被清除的问题 (#1007)。
  • 将 BundledChunkExtractor.Factory 和 DefaultHlsExtractorFactory 上的 experimentalSetSubtitleParserFactory 方法重命名为 setSubtitleParserFactory，并禁止传递 null。使用新的 experimentalParseSubtitlesDuringExtraction(boolean) 方法控制解析行为。
  • 添加了对自定义提取期间使用的 SubtitleParser.Factory 的支持。这可以通过 MediaSource.Factory.setSubtitleParserFactory() 实现。
  • 向通过 MergingMediaSource 生成的所有 Format.id 字段添加来源前缀。这有助于确定哪个来源生成了 Format (#883)。
  • 修复了用于验证自定义通用媒体客户端数据 (CMCD) 键名称的正则表达式，将其修改为仅检查连字符 (#1028)。
  • 停止对 CMCD 查询参数进行双重编码 (#1075)。
• 转换器：
  • 添加了对 H.265/HEVC SEF 慢动作视频进行扁平化处理的支持。
  • 提高了转封装速度，尤其是对于“移除视频”编辑操作。
  • 添加了 API，以确保输出文件从视频帧开始。这可以使剪辑操作的输出与播放器实现更加兼容，这些实现直到其呈现时间戳才显示第一个视频帧 (#829)。
  • 添加了对优化单个素材资源 MP4 剪辑操作的支持。
  • 添加了支持，以确保视频帧在输出文件中具有第一个时间戳。修复了在基于 iOS 的播放器上输出文件以黑帧开头的问题 (#829)。
• 轨道选择：
  • 添加了 DefaultTrackSelector.selectImageTrack 以启用图片轨道选择。
  • 添加 TrackSelectionParameters.isPrioritizeImageOverVideoEnabled，以确定在图片轨道和视频轨道都可用时是否选择图片轨道。默认值为 false，这意味着优先选择视频轨道。
• 提取器：
  • 向 MP4 提取器添加了额外的 AV1C 解析，以检索 ColorInfo.colorSpace、ColorInfo.colorTransfer 和 ColorInfo.colorRange 值 (#692)。
  • MP3：对具有 Info 标头（与 Xing 标头等效的 CBR）的文件使用恒定比特率 (CBR) 搜索。以前，我们使用 Info 标头中的跳转表，但与忽略该表并假设文件为 CBR 相比，这会导致精确跳转模式的精确度降低。
  • MPEG2-TS：添加了对 DTS、DTS-LBR 和 DTS:X Profile2 的支持 (#275)。
  • 从 TS 描述符中提取音频类型，并将其映射到角色标志，以便用户做出更明智的音轨选择 (#973)。
• 音频：
  • 通过平滑的音量渐变改进了静音跳过算法；保留了最短静音时长和更自然的静音时长 (#7423)。
  • 更确定地报告跳过的静音部分 (#1035)。
• 视频：
  • 更改接受 VideoFrameProcessor.Factory 参数的 MediaCodecVideoRenderer 构造函数，并将其替换为接受 VideoSinkProvider 参数的构造函数。想要注入自定义 VideoFrameProcessor.Factory 的应用可以实例化使用自定义 VideoFrameProcessor.Factory 的 CompositingVideoSinkProvider，并将视频接收器提供程序传递给 MediaCodecVideoRenderer。
• 文本：
  • 修复了位图提示的序列化问题，以解决使用 DefaultExtractorsFactory.setTextTrackTranscodingEnabled 时的 Tried to marshall a Parcel that contained Binder objects 错误 (#836)。
  • CEA-708：忽略 rowLock 值。CEA-708-E S-2023 规范规定，无论数据流中存在的值如何，都应假定 rowLock 和 columnLock 均为 true（columnLock 支持未实现，因此实际上假定始终为 false）。
• 图片：
  • 添加了对 DASH 缩略图的支持。网格图片会被剪裁，并且系统会在接近呈现时间时向 ImageOutput 提供各个缩略图。
• DRM：
  • 默认情况下，立即播放 DRM 内容中的“清晰前导”未加密样本，即使后续加密样本的密钥尚未准备就绪。如果播放位置到达加密样本时密钥仍未准备就绪，则可能会导致播放中途停顿（但之前播放根本不会在此时间点开始）。此行为可通过 MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey 或 DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys 停用。
    • IMA 扩展程序：
  • 修复了无法播放没有适当文件扩展名的 DASH 和 HLS 广告的问题。
• 会话：
  • 为 TV 应用停用双击检测 (#962)。
  • 修复了仅包含非 null extra 的 MediaItem.RequestMetadata 无法在媒体控制器和会话之间传输的问题。
  • 向 MediaLibrarySession.Builder 添加了仅接受 Context（而非 MediaLibraryService）的构造函数。
• HLS 扩展程序：
  • 将 HlsMediaPeriod 缩减为软件包私有可见性。不应从 HLS 软件包外部直接依赖此类型。
  • 更高效地解析对片段开头的跳转 (#1031)。
• 解码器扩展程序（FFmpeg、VP9、AV1、MIDI 等）：
  • MIDI 解码器：忽略 SysEx 事件消息 (#710)。
• 测试实用程序：
  • 不要暂停TestPlayerRunHelper.playUntilPosition中的播放。测试会使播放保持在播放状态，但会暂停进度，直到测试能够添加断言和进一步的操作。
• 演示版应用：
  • 添加了短视频演示模块，用于演示 PreloadMediaSource 在短视频内容用例中的用法。

版本 1.3.0-rc01

2024 年 2 月 22 日

使用 1.3.0 稳定版。

版本 1.3.0-beta01

2024 年 2 月 7 日

使用 1.3.0 稳定版。

版本 1.3.0-alpha01

2024 年 1 月 15 日

使用 1.3.0 稳定版。

版本 1.2.0

版本 1.2.1

2024 年 1 月 9 日

• ExoPlayer：
  • 修复了以下问题：在 LiveConfiguration.min/maxOffset 范围之外手动跳转时，系统会不断将偏移量调整回 min/maxOffset。
  • 修复了 OPUS 和 VORBIS 声道布局对于 3、5、6、7 和 8 声道不正确的问题 (#8396)。
  • 修复了以下问题：在直播中跳转到零后，轨道选择错误地让直播从其默认位置开始 (#9347)。
  • 修复了以下问题：CmcdData.Factory 的新实例从分块来源接收到 bufferedDurationUs 的负值，从而导致 IllegalArgumentException (#888)。
• 转换器：
  • 解决编码器在配置时因设置高运行速率而抛出异常的问题。
• 提取器：
  • 将 JPEG 动态照片中的次要（不可播放）HEVC 轨道标记为 ROLE_FLAG_ALTERNATE，以防止因其分辨率较高而被自动选择播放。
  • 修复了 TS H264 流的关键帧检测错误 (#864)。
  • 修复了时长超过 47721 秒的 TS 流的时长估算问题 (#855)。
• 音频：
  • 修复了多次调用 SilenceSkippingAudioProcessor 时 EOS 的处理问题 (#712)。
• 视频：
  • 针对 Galaxy Tab S7 FE、Chromecast with Google TV 和 Lenovo M10 FHD Plus 上的设备问题添加了权宜解决方法，该问题会导致 60fps AVC 流被标记为不受支持 (#693)。
• 元数据：
  • 修复了仅从具有大写键的 Vorbis 注释中填充 MediaMetadata 的 bug (#876)。
  • 在解析非常大的 ID3 帧时捕获 OutOfMemoryError，这意味着播放可以继续，只是没有标记信息，而不是完全无法播放。
• DRM：
  • 将针对虚假 ClearKey https://default.url 许可网址的权宜解决方法扩展到 API 33+（之前，该权宜解决方法仅适用于 API 33）(#837)。
  • 修复了在没有将 Surface 附加到播放器的情况下，从加密内容切换到明文内容时出现的 ERROR_DRM_SESSION_NOT_OPENED 问题。该错误是由于错误地使用安全解码器播放明文内容所致。
• 会话：
  • 将自定义键和值放入 MediaMetadataCompat 到 MediaMetadata.extras 以及 MediaMetadata.extras 到 MediaMetadataCompat (#756, #802)。
  • 修复了旧版控制器的广播 notifyChildrenChanged (#644)。
  • 修复了以下 bug：在某些设备上，为已停用的通知 setWhen 计时器设置负时间会导致崩溃 (#903)。
  • 修复了在请求首次通知更新时媒体通知控制器尚未完成连接时出现的 IllegalStateException (#917)。
• 界面：
  • 修复了在 BottomSheetDialogFragment 中与 Material Design 搭配使用时快进和快退按钮不可见的问题 (#511)。
  • 修复了 PlayerControlView 快进按钮中的数字未对齐的问题 (#547)。
• DASH 扩展程序：
  • 在 DASH 清单中，将“f800”解析为 Dolby 的声道数 5 (#688)。
• 解码器扩展程序（FFmpeg、VP9、AV1、MIDI 等）：
  • MIDI：修复了快进会跳过 Program Change 事件的问题 (#704)。
  • 迁移到 FFmpeg 6.0，并将受支持的 NDK 更新为 r26b（#707、#867）。
• Cast 扩展程序：
  • 对 Timeline 的创建进行排查，以避免在投屏设备上加载媒体失败时应用崩溃 (#708)。

版本 1.2.0

2023 年 11 月 15 日

• 通用库：
  • 向 Log.Logger 接口中的方法添加 @Nullable Throwable 参数。这些方法的 message 参数不再包含有关传递给 Log.{d,i,w,e}() 方法的 Throwable 的任何信息，因此如果需要，实现将需要手动附加此信息（可能使用 Logger.appendThrowableString(String, Throwable)）。
  • 修复了 Kotlin 兼容性问题，即无法将可为 null 的泛型类型形参和可为 null 的数组元素类型检测为可为 null。例如 TrackSelectorResult 和 SimpleDecoder 方法参数 (#6792)。
  • 更改 Util.shouldShowPlayButton 中的默认界面和通知行为，以便在播放暂时受到抑制（例如由于暂时失去音频焦点）时显示“播放”按钮。您可以使用 PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) 或 MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) 保持旧版行为 (#11213)。
  • 将 androidx.annotation:annotation-experimental 升级到 1.3.1，以修复 https://issuetracker.google.com/251172715。
  • 将 ExoPlayer.setAudioAttributes 移至 Player 接口。
• ExoPlayer：
  • 修复了 AC4 数据流中因无法正确识别仅解码样本而导致的跳转问题 (#11000)。
  • 添加了在通过 ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput 启用此功能时，禁止在不合适的音频输出设备（例如 Wear OS 设备上的内置扬声器）上播放的功能。如果在没有合适的音频输出设备可用时尝试播放，或者在播放期间所有合适的输出设备都断开连接，则播放抑制原因将更新为 Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT。连接合适的输出设备后，系统会移除抑制原因。
  • 添加 MediaSource.canUpdateMediaItem 和 MediaSource.updateMediaItem，以在通过 Player.replaceMediaItem(s) 创建后接受 MediaItem 更新。
  • 允许通过 Player.replaceMediaItem(s) 为库提供的所有 MediaSource 类进行 MediaItem 更新（#33、#9978）。
  • 将 MimeTypes.TEXT_EXOPLAYER_CUES 改名为 MimeTypes.APPLICATION_MEDIA3_CUES。
  • 添加 PngExtractor，以将整个 PNG 文件作为单个样本发送和读取到 TrackOutput 中。
  • 将 SequenceableLoader 接口中的 SequenceableLoader.continueLoading(long) 方法增强为 SequenceableLoader.continueLoading(LoadingInfo loadingInfo)。LoadingInfo 包含其他参数，除了现有的 playbackPositionUs 之外，还包括 playbackSpeed 和 lastRebufferRealtimeMs。
  • 将 ChunkSource 接口中的 ChunkSource.getNextChunk(long, long, List, ChunkHolder) 方法增强为 ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder)。
  • 向通用媒体客户端数据 (CMCD) 日志记录添加了其他字段：缓冲区耗尽 (bs)、截止时间 (dl)、播放速度 (pr) 和启动 (su) (#8699)。
  • 向 ColorInfo 添加了亮度和色度位深 (#491)。
  • 向通用媒体客户端数据 (CMCD) 日志记录添加了其他字段：下一个对象请求 (nor) 和下一个范围请求 (nrr) (#8699)。
  • 添加了使用查询参数传输通用媒体客户端数据 (CMCD) 数据的功能 (#553)。
  • 修复了 ExperimentalBandwidthMeter 中的 ConcurrentModificationException (#612)。
  • 向 CompositeMediaSource.getMediaTimeForChildMediaTime 添加了 MediaPeriodId 参数。
  • 在 ConcatenatingMediaSource2 中支持 ClippingMediaSource（以及具有时段/窗口时间偏移的其他来源）(#11226)。
  • 更改 BaseRenderer.onStreamChanged()，使其也接收 MediaPeriodId 参数。
• 转换器：
  • 解析图片输入的 EXIF 旋转数据。
  • 移除了 TransformationRequest.HdrMode 注解类型及其关联的常量。请改用 Composition.HdrMode 及其关联的常量。
  • 简化 OverlaySettings 以解决旋转问题。
  • 将 SampleConsumer.queueInputBitmap 的 frameRate 和 durationUs 参数更改为 TimestampIterator。
• 轨道选择：
  • 添加 DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness 以明确允许或禁止非无缝自适应。默认值保持其当前行为 true。
• 提取器：
  • MPEG-TS：通过将数据流的最后一个访问单元传递到样本队列，确保渲染最后一帧 (#7909)。
  • 修复了确定 rotationDegrees 时的拼写错误。将 projectionPosePitch 更改为 projectionPoseRoll (#461)。
  • 移除 Extractor 实例可以直接使用 instanceof 进行检查的假设。如果您想在运行时访问 Extractor 的实现细节，则必须先调用 Extractor.getUnderlyingInstance。
  • 添加 BmpExtractor。
  • 添加 WebpExtractor。
  • 添加 HeifExtractor。
  • 向 Mp4Extractor 添加了 QuickTime 经典支持。
• 音频：
  • 在 MP4 和 Matroska 中添加了对 24/32 位大端序 PCM 的支持，并解析了 MP4 中 lpcm 的 PCM 编码。
  • 添加了对在 MP4 中提取 Vorbis 音频的支持。
  • 添加了 AudioSink.getFormatOffloadSupport(Format)，用于通过 DefaultAudioOffloadSupportProvider 检索接收器可为格式提供的分流支持级别。它会返回包含 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 类。
  • 向 AnalyticsListener、AudioRendererEventListener 和 AudioSink.Listener 添加 onAudioTrackInitialized 和 onAudioTrackReleased 回调。
  • 修复了 DTS Express 音频缓冲区下溢问题 (#650)。
  • 修复了 E-AC3-JOC 的功能检查会抛出 IllegalArgumentException 的 bug (#677)。
• 视频：
  • 允许 MediaCodecVideoRenderer 使用自定义 VideoFrameProcessor.Factory。
  • 修复了以下 bug：如果音频串流以负时间戳开头，则无法渲染第一帧 (#291)。
• 文本：
  • 移除了 ExoplayerCuesDecoder。现在，具有 sampleMimeType = application/x-media3-cues 的文本轨道由 TextRenderer 直接处理，无需 SubtitleDecoder 实例。
• 元数据：
  • 系统将不再针对“仅解码”样本调用 MetadataDecoder.decode，因为无论如何，实现都必须返回 null。
• 效果：
  • 添加 VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>)，用于按时间戳将位图输入加入队列。
  • 将 VideoFrameProcessor.registerInputStream() 更改为非屏蔽。 应用必须实现 VideoFrameProcessor.Listener#onInputStreamRegistered()。
  • 将 VideoFrameProcessor.queueInputBitmap 的 frameRate 和 durationUs 参数更改为 TimestampIterator。
• IMA 扩展程序：
  • 修复了以下 bug：如果多时段 DASH 直播不是播放列表中的第一项，可能会抛出异常 (#571)。
  • 在调用 AdsLoader.destroy() 之前释放 StreamManager
  • 将 IMA SDK 版本提升至 3.31.0。
• 会话：
  • 在 DefaultMediaNotificationProvider 中将通知前台服务行为设置为 FOREGROUND_SERVICE_IMMEDIATE (#167)。
  • 仅在 API 31 以上版本中使用 android.media.session.MediaSession.setMediaButtonBroadcastReceiver()，以避免在 Samsung 设备上出现已废弃 API 的问题 (#167)。
  • 使用媒体通知控制器作为代理，设置用于填充通知和平台会话的可用命令和自定义布局。
  • 在 Media3 中转换由 MediaSessionService.onStartCommand() 接收的媒体按钮事件，而不是将其路由到平台会话，然后再路由回 Media3。这样，调用方控制器始终是媒体通知控制器，并且应用可以轻松地在所有受支持的 API 级别上以相同的方式识别来自通知的调用。
  • 修复了连接到旧版 MediaSessionCompat 时 MediaController.getCurrentPosition() 无法前进的 bug。
  • 添加 MediaLibrarySession.getSubscribedControllers(mediaId) 以方便使用。
  • 替换 MediaLibrarySession.Callback.onSubscribe()，以断言控制器订阅的父级 ID 的可用性。如果成功，订阅会被接受，并且系统会立即调用 notifyChildrenChanged() 以通知浏览器 (#561)。
  • 为 Automotive OS 添加了会话演示模块，并为 Android Auto 启用了会话演示。
  • 当 COMMAND_GET_TIMELINE 不适用于媒体通知控制器时，请勿设置框架会话的队列。由于 Android Auto 作为客户端控制器从框架会话中读取数据，因此 Android Auto 界面中的 queue 按钮不会显示 (#339)。
  • 默认使用 DataSourceBitmapLoader 而不是 SimpleBitmapLoader（#271、#327）。
  • 添加了 MediaSession.Callback.onMediaButtonEvent(Intent)，允许应用替换默认媒体按钮事件处理。
• 界面：
  • 为 Wear OS 设备添加 Player.Listener 实现，以便通过启动系统对话框来处理因 Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT 而导致的播放抑制，从而允许用户连接合适的音频输出设备（例如蓝牙耳机）。如果听众在可配置的超时时间（默认值为 5 分钟）内连接了合适的设备，系统会自动恢复播放。
• 下载内容：
  • 为 DownloadService 声明“数据同步”前台服务类型，以实现 Android 14 兼容性。使用此服务时，应用还需要在清单中将 dataSync 添加为 foregroundServiceType，并添加 FOREGROUND_SERVICE_DATA_SYNC 权限 (#11239)。
• HLS 扩展程序：
  • 以从上次加载开始时间（而非上次加载完成时间）计算的时间间隔刷新 HLS 直播播放列表 (#663)。
• DASH 扩展程序：
  • 允许在片段模板网址中使用多个相同的 DASH 标识符。
  • 添加了对在提取期间解析字幕的实验性支持。此版本更好地支持合并重叠的字幕，包括解决在字幕片段之间过渡时出现的闪烁问题。您可以使用 DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() 启用此功能 (#288)。
• RTSP 扩展程序：
  • 修复了在回退到 TCP 时可能导致 IndexOutOfBoundsException 的竞态条件，或在某些情况下导致播放挂起的问题。
  • 在返回 RtspMediaPeriod 的加载状态时，检查 RTSP 设置中的状态 (#577)。
  • 忽略 Options 响应公共标头中的自定义 Rtsp 请求方法 (#613)。
  • 在发送保持连接的 RTSP 选项请求的时间间隔内使用 RTSP 设置响应超时值 (#662)。
• 解码器扩展程序（FFmpeg、VP9、AV1、MIDI 等）：
  • 发布了 MIDI 解码器模块，该模块支持使用 Jsyn 库合成音频来播放标准 MIDI 文件。
  • 添加 DecoderOutputBuffer.shouldBeSkipped，以直接标记不需要呈现的输出缓冲区。此方法优于即将弃用的 C.BUFFER_FLAG_DECODE_ONLY。
  • 添加了 Decoder.setOutputStartTimeUs 和 SimpleDecoder.isAtLeastOutputStartTimeUs，以允许解码器在开始时间之前丢弃仅解码样本。应优先使用此方法，而不是将被弃用的 Buffer.isDecodeOnly。
  • 修复了将 MIDI 解码器工件发布到 Maven 制品库时出现的 bug。工件已重命名为 media3-exoplayer-midi (#734)。
• Leanback 扩展：
  • 修复了停用 Surface 可能会导致 Leanback 代码中出现 ArithmeticException 的 bug (#617)。
• 测试实用程序：
  • 使 TestExoPlayerBuilder 和 FakeClock 与 Espresso 界面测试和 Compose 界面测试兼容。此版本修复了以下 bug：在 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：
  • 修复了 PlaybackStatsListener 中在播放列表清空后会创建虚假 PlaybackStats 的问题。
  • 向通用媒体客户端数据 (CMCD) 日志记录添加了其他字段：流式传输格式 (sf)、流类型 (st)、版本 (v)、最高比特率 (tb)、对象时长 (d)、测得的吞吐量 (mtp) 和对象类型 (ot) (#8699)。
• 音频：
  • 修复了播放非常短的文件时 Player.getState() 永远不会转换为 STATE_ENDED 的 bug (#538)。
• 音频分流：
  • 根据 RFC 7845，将 Ogg ID 标头和注释标头页附加到比特流，以便进行分流 Opus 播放。
• 视频：
  • H.265/HEVC：修复了解析 SPS 短期和长期参考图片信息的问题。
• 文本：
  • CEA-608：更改了提示截断逻辑，以便仅考虑可见文本。 以前，在将字幕长度限制为 32 个字符时，缩进和制表符偏移量也包含在内（根据规范，这在技术上是正确的）(#11019)。
• IMA 扩展程序：
  • 将 IMA SDK 版本提升至 3.30.3。
• 会话：
  • 将自定义布局添加到控制器的状态，并提供一个 getter 来访问它。当自定义布局发生变化时，系统会调用 MediaController.Listener.onCustomLayoutChanged。如果应用想要向不同的 Media3 控制器发送不同的自定义布局，可以在 MediaSession.Callback.onConnect 中使用 AcceptedResultBuilder 执行此操作，以确保在连接完成后，自定义布局可供控制器使用。
  • 修复了以下问题：MediaLibraryServiceLegacyStub 向不支持此操作的 Result 发送错误，从而产生 UnsupportedOperationException (#78)。
  • 通过旧命令（COMMAND_ADJUST_DEVICE_VOLUME 和 COMMAND_SET_DEVICE_VOLUME）和新命令（COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS 和 COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS）确定 volumeControlType，从而修复 PlayerWrapper 创建 VolumeProviderCompat 的方式 (#554)。

版本 1.1.0

2023 年 7 月 5 日

• 通用库：
  • 添加了音频路由不合适和准备就绪时播放的抑制原因，并更改了抑制时间过长的原因。 (#15)。
  • 向 Player 添加命令：
    • COMMAND_GET_METADATA
    • COMMAND_SET_PLAYLIST_METADATA
    • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
    • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
  • 向 Player 添加了重载方法，允许用户指定音量标志：
    • void setDeviceVolume(int, int)
    • void increaseDeviceVolume(int)
    • void decreaseDeviceVolume(int)
    • void setDeviceMuted(boolean, int)
  • 为 DeviceInfo 添加了 Builder，并弃用了现有构造函数。
  • 添加了 DeviceInfo.routingControllerId，用于指定远程播放的路由控制器 ID。
  • 添加了 Player.replaceMediaItem(s)，作为在同一位置添加和移除内容的快捷方式 (#8046)。
• ExoPlayer：
  • 仅在明确选择启用的情况下，才允许 ExoPlayer 控制设备音量方法。使用 ExoPlayer.Builder.setDeviceVolumeControlEnabled 可访问：
    • getDeviceVolume()
    • isDeviceMuted()
    • setDeviceVolume(int)和setDeviceVolume(int, int)
    • increaseDeviceVolume(int) 和 increaseDeviceVolume(int, int)
    • decreaseDeviceVolume(int)和decreaseDeviceVolume(int, int)
  • 添加了 FilteringMediaSource，可用于从 MediaSource 中过滤可用的轨道类型。
  • 添加了对在自适应流式传输格式 DASH、HLS 和 SmoothStreaming 的传出请求中包含通用媒体客户端数据 (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)。
  • 添加了 ExoPlayer.setVideoEffects()，以便在视频播放期间使用 Effect。
  • 更新 SampleQueue，以将 sourceId 存储为 long，而不是 int。这会更改公共方法 SampleQueue.sourceId 和 SampleQueue.peekSourceId 的签名。
  • 向 LoadControl 方法 shouldStartPlayback 和 onTracksSelected 添加了参数，以便将这些方法与相关 MediaPeriod 相关联。
  • 通过添加时间轴参数来更改 ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) 的签名，该参数包含在映射中用作键的 UID 的时间段。为避免多时段直播出现并发问题，必须执行此操作。
  • 废弃了 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.Builder.setMediaSourceFactory(MediaSource.Factory)。 改用 ExoPlayerAssetLoader.Factory(MediaSource.Factory) 和 Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory)。
  • 移除“Transformer.startTransformation(MediaItem, ParcelFileDescriptor)”。
  • 修复了以下 bug：如果在输入帧等待处理时发出视频流结束信号，转换可能会卡住（导致多路复用器超时）。
  • 通过 MediaCodecList 查询编解码器，而不是使用 findDecoder/EncoderForFormat 实用程序，以扩大支持范围。
  • 移除了 DefaultEncoderFactory 中的 B 帧配置，因为它在某些设备上无法正常运行。
• 轨道选择：
  • 添加了 DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange（默认处于停用状态）。启用后，当渲染器功能发生变化时，DefaultTrackSelector 将触发新的轨道选择。
• 提取器：
  • Ogg：修复了在时长较长的文件中跳转时出现的 bug (#391)。
  • FMP4：修复了 TimestampAdjuster 使用 emsg atom 中的元数据采样时间初始化错误的时间戳偏移量的问题 (#356)。
• 音频：
  • 修复了以下 bug：在启用隧道模式且 AudioProcessors 处于活跃状态（例如，用于无缝剪辑）时，某些播放会失败 (#10847)。
  • 在直接播放（分流）中将 Opus 帧封装在 Ogg 数据包中。
  • 在休眠期间使用分流调度推断当前位置。
  • 添加了 Renderer.release() 和 AudioSink.release()，用于在播放器生命周期结束时释放资源。
  • 监听 DefaultAudioSink 中的音频功能变化。在 DefaultAudioSink 的构造函数中添加一个必需参数 context，DefaultAudioSink 将使用该参数注册为 AudioCapabilitiesReceiver 的监听器，并在收到功能更改通知时更新其 audioCapabilities 属性。
  • 通过 AudioSink.Listener 接口中的新事件 onAudioCapabilitiesChanged 以及触发 onRendererCapabilitiesChanged 事件的新接口 RendererCapabilities.Listener 传播音频功能更改。
  • 添加了 ChannelMixingAudioProcessor，用于对音频声道应用缩放/混音。
  • 向 DecoderDiscardReasons 添加了新的 int 值 DISCARD_REASON_AUDIO_BYPASS_POSSIBLE，以便在音频功能发生变化后，如果可以采用绕过模式，则舍弃音频解码器。
  • 添加了对 DTS Express 和 DTS:X 的直接播放支持 (#335)。
• 视频：
  • 让 MediaCodecVideoRenderer 在停用渲染器时报告宽度和高度为 0 的 VideoSize。当 Player.getVideoSize() 发生变化时，系统会相应地调用 Player.Listener.onVideoSizeChanged。进行此项更改后，当 Player.getCurrentTracks 不支持视频或支持的视频轨道的大小尚未确定时，ExoPlayer 的视频大小（使用 MediaCodecVideoRenderer）的宽度和高度为 0。
• DRM：
  • 降低 DefaultDrmSession 上不应从 DRM 软件包外部调用的多个内部专用方法的可见性：
    • void onMediaDrmEvent(int)
    • void provision()
    • void onProvisionCompleted()
    • onProvisionError(Exception, boolean)
• 多路复用器：
  • 添加了一个新的多路复用器库，可用于创建 MP4 容器文件。
• IMA 扩展程序：
  • 为 DAI 启用多时段 DASH 直播。请注意，当前实现尚不支持在直播中跳转 (#10912)。
  • 修复了以下 bug：由于连续时间轴中计算出的内容位置略有不同，因此在直播中插入了新的广告组。
• 会话：
  • 添加辅助方法 MediaSession.getControllerForCurrentRequest，以获取有关当前正在调用 Player 方法的控制器的信息。
  • 添加了 androidx.media3.session.MediaButtonReceiver，以便应用能够通过蓝牙耳机等发送的媒体按钮事件实现播放恢复 (#167)。
  • 向 MediaSession.Callback.onAddMediaItems 添加了默认实现，以便在请求的 MediaItems 具有 LocalConfiguration（例如 URI）时，允许将其传递给 Player (#282)。
  • 默认情况下，在 Android 12 及更低版本的紧凑媒体通知视图中添加“快退”和“快进”命令按钮 (#410)。
  • 向 MediaSession.Callback.onAddMediaItems 添加了默认实现，以便在请求的 MediaItems 具有 LocalConfiguration（例如 URI）时，允许将其传递给 Player (#282)。
  • 默认情况下，在 Android 12 及更低版本的紧凑媒体通知视图中添加“快退”和“快进”命令按钮 (#410)。
• 界面：
  • 添加 Util 方法 shouldShowPlayButton 和 handlePlayPauseButtonAction，以编写带有播放/暂停按钮的自定义界面元素。
• RTSP 扩展程序：
  • 对于 MPEG4-LATM，如果 Describe Response SDP 消息中缺少 profile-level-id 值，则使用默认值 (#302)。
  • 如果 DESCRIBE 响应标头中存在基本 URI，则使用该基本 URI 从 RTSP 会话中解析相对路径 (#11160)。
• DASH 扩展程序：
  • 从 MediaLoadData.startTimeMs 和 MediaLoadData.endTimeMs 中移除了多时段 DASH 流的媒体时间偏移值。
  • 修复了重新准备多时段直播 Dash 媒体来源会产生 IndexOutOfBoundsException 的 bug (#10838)。
• HLS 扩展程序：
  • 添加 HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long)，为加载线程设置超时，以等待 TimestampAdjuster 初始化。如果初始化未在超时之前完成，系统会抛出 PlaybackException，以避免播放无休止地卡顿。超时默认设置为零 (#323)。
• 测试实用程序：
  • 检查 DataSourceContractTest 中的 URI scheme 是否不区分大小写。
• 移除了已废弃的符号：
  • 移除了 DefaultAudioSink 构造函数，改用 DefaultAudioSink.Builder。
  • 移除 HlsMasterPlaylist，改用 HlsMultivariantPlaylist。
  • 移除了 Player.stop(boolean)。改用 Player.stop() 和 Player.clearMediaItems()（如果 reset 为 true）。
  • 移除了两个已废弃的 SimpleCache 构造函数，请改用接受 DatabaseProvider 的非废弃构造函数，以获得更好的性能。
  • 移除了 DefaultBandwidthMeter 构造函数，改用 DefaultBandwidthMeter.Builder。
  • 移除了 DefaultDrmSessionManager 构造函数，改用 DefaultDrmSessionManager.Builder。
  • 移除了两个已废弃的 HttpDataSource.InvalidResponseCodeException 构造函数，请使用接受额外字段（cause、responseBody）的非废弃构造函数来增强错误日志记录。
  • 移除了 DownloadHelper.forProgressive、DownloadHelper.forHls、DownloadHelper.forDash 和 DownloadHelper.forSmoothStreaming，请改用 DownloadHelper.forMediaItem。
  • 移除了已废弃的 DownloadService 构造函数，请使用未废弃的构造函数，其中包含提供 channelDescriptionResourceId 参数的选项。
  • 移除了已废弃的字符集字符串常量（ASCII_NAME、UTF8_NAME、ISO88591_NAME、UTF16_NAME 和 UTF16LE_NAME），请改用 kotlin.text 软件包、java.nio.charset.StandardCharsets 或 com.google.common.base.Charsets 中的 Kotlin 字符集。
  • 移除了已废弃的 WorkManagerScheduler 构造函数，请改用包含提供 Context 参数选项的非废弃构造函数。
  • 移除了已弃用的方法 createVideoSampleFormat、createAudioSampleFormat、createContainerFormat 和 createSampleFormat，这些方法曾用于实例化 Format 类。 请改用 Format.Builder 创建 Format 的实例。
  • 移除了已废弃的方法 copyWithMaxInputSize、copyWithSubsampleOffsetUs、copyWithLabel、copyWithManifestFormatInfo、copyWithGaplessInfo、copyWithFrameRate、copyWithDrmInitData、copyWithMetadata、copyWithBitrate 和 copyWithVideoSize，请改用 Format.buildUpon() 和 setter 方法。
  • 移除了已废弃的 ExoPlayer.retry()，请改用 prepare()。
  • 移除了已废弃的零参数 DefaultTrackSelector 构造函数，改用 DefaultTrackSelector(Context)。
  • 移除了已废弃的 OfflineLicenseHelper 构造函数，改用 OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)。
  • 移除了已废弃的 DownloadManager 构造函数，改用接受 Executor 的构造函数。
  • 移除了已废弃的 Cue 构造函数，请改用 Cue.Builder。
  • 移除了已废弃的 OfflineLicenseHelper 构造函数，请改用 OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)。
  • 移除了四个已废弃的 AnalyticsListener 方法：
    • 废弃了 onDecoderEnabled，改用 onAudioEnabled 和/或 onVideoEnabled。
    • onDecoderInitialized，请改用 onAudioDecoderInitialized 和/或 onVideoDecoderInitialized。
    • onDecoderInputFormatChanged，请改用 onAudioInputFormatChanged 和/或 onVideoInputFormatChanged。
    • 废弃了 onDecoderDisabled，改用 onAudioDisabled 和/或 onVideoDisabled。
  • 移除了已废弃的 Player.Listener.onSeekProcessed 和 AnalyticsListener.onSeekProcessed，请改用 onPositionDiscontinuity 和 DISCONTINUITY_REASON_SEEK。
  • 移除 ExoPlayer.setHandleWakeLock(boolean)，改用 setWakeMode(int)。
  • 移除已废弃的 DefaultLoadControl.Builder.createDefaultLoadControl()，改用 build()。
  • 移除已废弃的 MediaItem.PlaybackProperties，改用 MediaItem.LocalConfiguration。已弃用的字段 MediaItem.playbackProperties 现在属于 MediaItem.LocalConfiguration 类型。

版本 1.1.0-rc01

2023 年 6 月 21 日

使用 1.1.0 稳定版。

版本 1.1.0-beta01

2023 年 6 月 7 日

使用 1.1.0 稳定版。

版本 1.1.0-alpha01

2023 年 5 月 10 日

使用 1.1.0 稳定版。

版本 1.0.0

版本 1.0.2

2023 年 5 月 18 日

发布了 androidx.media3:media3-*:1.0.2。版本 1.0.2 中包含这些提交内容。

此版本与 ExoPlayer 2.18.7 版本相对应。

此版本包含自 1.0.1 版本以来的以下变更：

• 核心库：
  • 添加了 Buffer.isLastSample()，用于表示 Buffer 是否包含标志 C.BUFFER_FLAG_LAST_SAMPLE。
  • 修复了以下问题：如果最后一个包含帧的样本在未读取“流结束”样本的情况下被移出队列，则最后一帧可能无法渲染。 (#11079)。
• 提取器：
  • 通过重复使用 RTSP 和 MP4 提取器已使用的解析逻辑，修复了 MPEG-TS 文件中 H.265 SPS 的解析问题 (#303)。
• 文本：
  • SSA：如果 UTF-16 文件以字节顺序标记开头，请添加对此类文件的支持 (#319)。
• 会话：
  • 修复了以下问题： 当连接到更新其 操作的旧版 MediaSessionCompat 时，MediaController 不会更新其可用命令。
  • 修复了以下 bug：在 API 30 上，当系统界面使用 params.isRecent == true 调用 Callback.onGetLibraryRoot 时，MediaLibraryService 无法返回 null (#355)。
  • 修复了 MediaSessionService 或 MediaLibraryService 的内存泄漏问题 (#346)。
  • 修复了以下 bug：在 MediaSession 中合并 Timeline 和位置更新可能会导致 MediaController 抛出 IllegalStateException。

版本 1.0.1

2023 年 4 月 18 日

发布了 androidx.media3:media3-*:1.0.1。版本 1.0.1 中包含这些提交内容。

此版本与 ExoPlayer 2.18.6 版本相对应。

• 核心库：
  • 在跳转到默认位置时重置目标直播替换 (#11051)。
  • 修复了媒体中的空样本流可能导致播放卡住的 bug。
• 会话：
  • 修复了以下 bug：由旧版 MediaSessionCompat 发布的多个相同队列项会导致 MediaController 中出现异常 (#290)。
  • 添加了缺少的 MediaSession.broadcastCustomCommand 到旧版 MediaControllerCompat.Callback.onSessionEvent 的转发 (#293)。
  • 修复了调用 MediaSession.setPlayer 不会更新可用命令的 bug。
  • 修复了以下问题：如果从 MediaController 发送的 TrackSelectionOverride 实例引用了具有 Format.metadata 的组，则这些实例会被忽略 (#296)。
  • 修复了以下问题：Player.COMMAND_GET_CURRENT_MEDIA_ITEM 需要可用，才能通过旧版 MediaSessionCompat 访问元数据。
  • 修复了在 MediaSessionService 中使用后台线程上的 MediaSession 实例时导致崩溃的问题 (#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 中包含这些提交内容。

此版本与 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 包含这些提交内容。

此版本与 ExoPlayer 2.18.4 版本相对应。

• 核心库：
  • 修复了 API 33 上的网络类型检测问题 (#10970)。
  • 修复了调用 ExoPlayer.isTunnelingEnabled 时的 NullPointerException (#10977)。
• 下载内容：
  • 使要合并的两个片段的开始时间的最大差异可在 SegmentDownloader 和子类中配置 (#248)。
• 音频：
  • 修复了三星设备上 MP3 无缝播放功能损坏的问题 (#8594)。
  • 修复了在停用音频后立即设置的播放速度可能会被之前的速度更改覆盖的 bug (#10882)。
• 视频：
  • 将 HEVC HDR10 格式映射到 HEVCProfileMain10HDR10，而不是 HEVCProfileMain10。
  • 针对 Chromecast with Google TV 和 Lenovo M10 FHD Plus 上的设备问题添加了权宜解决方法，该问题会导致 60fps AVC 流被标记为不受支持 (#10898)。
  • 修复了在播放帧速率远高于屏幕刷新率的媒体时出现的帧释放性能问题。
• Cast：
  • 修复了在媒体文件之间转换时出现的瞬态 STATE_IDLE (#245)。
• RTSP：
  • 捕获在解析无效 RTSP Describe 响应消息时抛出的 IllegalArgumentException (#10971)。
• 会话：
  • 修复了通知播放/暂停按钮不随播放器状态更新的 bug (#192)。
• IMA 扩展程序：
  • 修复了以下 bug：由于未收到第一个（在没有广告的情况下，也是唯一一个）LOADED 事件，导致没有任何广告的 DAI 视频流无法开始。

版本 1.0.0-rc01

2023 年 2 月 16 日

发布了 androidx.media3:media3-*:1.0.0-rc01。版本 1.0.0-rc01 包含这些提交内容。

此版本与 ExoPlayer 2.18.3 版本相对应。

• 核心库：
  • 调整了渲染程序的解码器排序逻辑，以保持 MediaCodecSelector 的偏好设置，即使解码器报告它可能无法高效地播放媒体也是如此。例如，对于默认选择器，仅提供功能支持的硬件解码器会优先于完全支持该格式的软件解码器 (#10604)。
  • 添加了 ExoPlayer.Builder.setPlaybackLooper，用于为新的 ExoPlayer 实例设置现有的播放线程。
  • 允许清除内容下载管理器帮助程序 (#10776)。
  • 向 BasePlayer.seekTo 添加了参数，以指明用于跳转的命令。
  • 在 API 21 及以上级别加载可绘制对象时使用主题 (#220)。
  • 添加了允许将多个媒体项合并到单个窗口中的 ConcatenatingMediaSource2 (#247)。
• 提取器：
  • 如果示例表 (stbl) 在解析 trak Atom 时缺少必需的示例说明 (stsd)，则抛出 ParserException，而非 NullPointerException。
  • 在 fMP4 中直接跳转到同步帧时会正确跳过示例 (#10941)。
• 音频：
  • 使用压缩音频格式比特率来计算直接播放（直通）中 AudioTrack 的最小缓冲区大小。
• 文本：
  • 修复了当字幕文件不包含任何提示时，向 Subtitle.getEventTime 传递无效（负数）索引的 TextRenderer。
  • SubRip：如果 UTF-16 文件以字节顺序标记开头，请添加对此类文件的支持。
• 元数据：
  • 在 ID3 v2.4 允许的情况下，解析来自 ID3 帧的多个 null 分隔值。
  • 添加了 MediaMetadata.mediaType，以指示内容类型或元数据描述的文件夹类型。
  • 添加了 MediaMetadata.isBrowsable，以替代 MediaMetadata.folderType。下一个版本中将废弃文件夹类型。
• DASH：
  • 为图片适配集添加了完整的解析，包括图块计数 (#3752)。
• 界面：
  • 修复了已废弃的 PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener)，以确保将可见性更改传递给已注册的监听器 (#229)。
  • 修复了使用从右到左 (RTL) 布局时 PlayerView 内中心播放器控件的排序问题 (#227)。
• 会话：
  • 添加了抽象 SimpleBasePlayer，以帮助为自定义播放器实现 Player 接口。
  • 添加了辅助方法，用于将平台会话令牌转换为 Media3 SessionToken (#171)。
  • 使用 onMediaMetadataChanged 来触发平台媒体会话的更新 (#219)。
  • 将媒体会话添加为 DefaultMediaNotificationProvider 的 getMediaButtons() 的参数；为清楚起见，还使用了不可变列表 (#216)。
  • 添加了 onSetMediaItems 回调监听器，以便修改/设置 MediaItem 列表，同时按会话启动索引和位置，然后再设置到播放器上 (#156)。
  • 避免针对非蓝牙媒体按钮事件执行两次点按检测 (#233)。
  • 提高了 QueueTimeline 在出现可疑的旧版会话状态时的稳健性 (#241)。
• 元数据：
  • 在 ID3 v2.4 允许的情况下，解析来自 ID3 帧的多个 null 分隔值。
  • 添加了 MediaMetadata.mediaType，以指示内容类型或元数据描述的文件夹类型。
  • 添加了 MediaMetadata.isBrowsable，以替代 MediaMetadata.folderType。下一个版本中将废弃文件夹类型。
• Cast 扩展程序：
  • 将 Cast SDK 版本升级到 21.2.0。
• IMA 扩展程序：
  • 移除了应用线程上 ImaServerSideAdInsertionMediaSource 的播放器监听器，以避免出现线程问题。
  • 为 ImaServerSideAdInsertionMediaSource.AdsLoader.Builder 添加 focusSkipButtonWhenAvailable 属性，以请求将 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 包含这些提交内容。

此版本与 ExoPlayer 2.18.2 版本相对应。

• 核心库：
  • 添加了 ExoPlayer.isTunnelingEnabled 以检查当前所选轨道是否已启用隧道技术 (#2518)。
  • 添加了 WrappingMediaSource 以简化封装单个 MediaSource 的过程 (#7279)。
  • 在播放因可用内存不足而卡住之前舍弃返回缓冲区。
  • 在已启用分流的情况下关闭用于跟踪“doSomeWork”块的功能。
  • 修复了 PlaybackStatsListener 中快速跳转的会话跟踪问题 (#180)。
  • 在单项播放列表中调用 seekToNext 或 seekToPrevious 时，发送缺失的 onMediaItemTransition 回调 (#10667)。
  • 添加了 Player.getSurfaceSize，用于返回呈现视频时所用 Surface 的大小。
  • 修复了在播放器释放期间移除监听器可能会导致 IllegalStateException 的 bug (#10758)。
• build：
  • 强制执行最低 compileSdkVersion 以避免编译错误 (#10684)。
  • 避免于包含在另一 Gradle build 中时发布块。
• 轨道选择：
  • 如果显示设备不支持杜比视界，请改选轨道。 (#8944)。
• 下载内容：
  • 修复了由于使用同一 PriorityTaskManager 同时下载和播放而导致的 ProgressiveDownloader 中潜在的无限循环 (#10570)。
  • 立即显示下载通知 (#183)。
  • 将并行下载移除次数限制为 1 次，以免过度创建线程 (#10458)。
• 视频：
  • 如果显示设备不支持杜比视界，请尝试改用替代解码器。 (#9794)。
• 音频：
  • 使用 SingleThreadExecutor 释放 AudioTrack 实例，以免同时释放多个播放器时出现 OutOfMemory 错误 (#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：
  • 解决了 Android 13 ClearKey 实现中会返回非空但无效许可网址的 bug。
  • 修复了在播放列表中的 DRM 方案之间切换时（例如从 Widevine 切换为 ClearKey）出现的 setMediaDrmSession failed: session not opened 错误。
• 文本：
  • CEA-608：确保正确处理字段 2 上的服务切换命令 (#10666)。
• DASH：
  • 从清单中解析 EventStream.presentationTimeOffset (#10460)。
• 界面：
  • 使用播放器的当前替换值作为 TrackSelectionDialogBuilder 中的预设值 (#10429)。
• 会话：
  • 确保命令始终以正确顺序执行，即使某些命令需要异步解析也是如此 (#85)。
  • 添加了 DefaultMediaNotificationProvider.Builder 以构建 DefaultMediaNotificationProvider 实例。构建器可以配置提供程序使用的通知 ID、通知渠道 ID 和通知渠道名称。此外，还添加了方法 DefaultMediaNotificationProvider.setSmallIcon(int) 以设置通知小图标。(#104)。
  • 确保不会丢弃在 MediaController.release() 之前发送的命令 (#99)。
  • SimpleBitmapLoader 可以从 file:// URI 加载位图 (#108)。
  • 修复了阻止 MediaController 在一段时间内查找广告的断言 (#122)。
  • 播放结束后，系统会从前台停止 MediaSessionService，并显示通知以重新开始播放最近播放过的媒体文件 (#112)。
  • 不启动具有待处理的暂停 intent 的前台服务 (#167)。
  • 手动隐藏与 DefaultNotificationProvider 在 API 26 和 API 27 上创建的通知关联的“标记”（在 API 28 及更高级别上，标记会自动隐藏）(#131）。
  • 修复了从旧版 MediaSession 到 Media3 MediaController 的第二项 binder 连接导致 IllegalStateException 的 bug (#49)。
• RTSP：
  • 添加了 H263 碎片化数据包处理机制 (#119)。
  • 添加了对 MP4A-LATM 的支持 (#162)。
• IMA：
  • 添加了加载广告信息的超时，以处理 IMA SDK 在加载广告时卡住的情况 (#10510)。
  • 阻止在跳转到内容末尾时跳过中贴片广告 (#10685)。
  • 正确计算包含服务器端插入广告的直播（例如 IMA DAI）的窗口时长 (#10764)。
• FFmpeg 扩展程序：
  • 添加了新的必需标志，以将 FFmpeg 库与 NDK 23.1.7779620 及更高版本关联 (#9933)。
• AV1 扩展程序：
  • 更新了 CMake 版本，以免与最新的 Android Studio 版本不兼容 (#9933)。
• Cast 扩展程序：
  • 实现了 getDeviceInfo()，以便能在使用 MediaController 控制播放时识别 CastPlayer (#142)。
• 转换器：
  • 添加了多路复用器监控定时器，以检测生成输出样本的速度是否过慢。
• 移除了已废弃的符号：
  • 移除了 Transformer.Builder.setOutputMimeType(String)。此功能已被移除。使用默认多路复用器时，MIME 类型将始终为 MP4 格式。

版本 1.0.0-beta02

2022 年 7 月 21 日

发布了 androidx.media3:media3-*:1.0.0-beta02。版本 1.0.0-beta02 包含这些提交内容。

此版本与 ExoPlayer 2.18.1 版本相对应。

• 核心库：
  • 确保使用 ExoPlayer.setShuffleOrder 更改 ShuffleOrder 后会导致使用 reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED 对 Player.Listener#onTimelineChanged 进行调用 (#9889)。
  • 对于渐进式媒体，仅在缓冲位置添加所选轨道 (#10361)。
  • 允许将自定义日志记录器用于所有 ExoPlayer 日志输出 (#9752)。
  • 修复了在 DefaultMediaSourceFactory 中实现 setDataSourceFactory 的问题，后者以前在某些情况下无法正常运行 (#116)。
• 提取器：
  • 修复了解析 H265 短期引用图片集的问题 (#10316)。
  • 修复了解析 esds 框中比特率的问题 (#10381)。
• DASH：
  • 从清单中解析 ClearKey 许可网址 (#10246)。
• 界面：
  • 确保 TalkBack 在播放控件菜单中公布当前有效的速度选项 (#10298)。
• RTSP：
  • 添加了 VP8 碎片化数据包处理机制 (#110)。
• Leanback 扩展：
  • 监听 LeanbackAdapter 中的 playWhenReady 更改 (10420)。
• Cast：
  • 把已传递到播放列表方法的 MediaItem 用作 CastTimeline 中的 Window.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 包含这些提交内容。

这与 ExoPlayer 2.18.0 版本相对应。

• 核心库：
  • 通过 MediaMetricsManager 启用了对 Android 平台诊断信息的支持。ExoPlayer 会将播放事件和性能数据转发到平台，这有助于在设备上提供系统性能和调试信息。如果设备用户启用了使用情况和诊断信息数据分享功能，Google 可能也会收集上述数据。应用可以选择退出不通过 ExoPlayer.Builder.setUsePlatformDiagnostics(false) 为 ExoPlayer 提供平台诊断信息。
  • 修复了使用 MergingMediaSource 时轨道重置太频繁的 bug，例如侧载 (side-loading) 字幕和播放过程中更改所选字幕时 (#10248)。
  • 停止在 API 29 和 30 上检测 5G-NSA 网络类型。这些播放将假设使用 4G 网络。
  • 禁止将 null 传递给 MediaSource.Factory.setDrmSessionManagerProvider 和 MediaSource.Factory.setLoadErrorHandlingPolicy。如果需要，可以显式传递 DefaultDrmSessionManagerProvider 和 DefaultLoadErrorHandlingPolicy 的实例。
  • 添加了 MediaItem.RequestMetadata 来表示在确切 LocalConfiguration 未知的情况下播放媒体所需的元数据。此外，还移除了 MediaMetadata.mediaUrl，因为它现在已包含在 RequestMetadata 中。
  • 添加了 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。这包括“取消废弃” (un-deprecating) Player.Listener.onTracksChanged 方法名称，但使用的是不同的参数类型。
  • 更改了 DefaultTrackSelector.buildUponParameters 和 DefaultTrackSelector.Parameters.buildUpon 以返回 DefaultTrackSelector.Parameters.Builder，而不是已废弃的 DefaultTrackSelector.ParametersBuilder。
  • 添加了 DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities（默认处于启用状态）。启用后，DefaultTrackSelector 会优先选用声道数不超过设备输出功能的音轨。在手持设备上，DefaultTrackSelector 会优先选用立体声/单声道，而非多声道音频格式，除非该多声道格式可以空间化（Android 12L 及更高版本）或属于杜比环绕声格式。此外，在支持音频空间化的设备上，DefaultTrackSelector 将监控空间化程序属性的变化，并在出现这些变化时触发新的音轨选择。具有 television 界面模式的设备不受这些限制的约束，系统会优先选用声道数最多的格式。如需启用此功能，必须使用 Context 构建 DefaultTrackSelector 实例。
• 视频：
  • 已将 DummySurface 重命名为 PlaceholderSurface。
  • 为 MediaCodecVideoRenderer.getCodecMaxInputSize 添加了 AV1 支持。
• 音频：
  • 使用宣传非标准 MIME 类型的 LG AC3 音频解码器。
  • 将 AudioAttributes.getAudioAttributesV21() 的返回值类型从 android.media.AudioAttributes 更改为新的 AudioAttributesV21 封装容器类，以防止 ART 验证速度在级别低于 21 的 API 上变慢。
  • 对平台（级别为 29 及以上的 API）进行查询，或在未设置格式声道数的情况（在启用 HLS 无块准备时会发生）下对音频透传的音频编码声道数进行假设 (10204）。
  • 解码器输出为 12 声道 PCM 音频时使用声道掩码 AudioFormat.CHANNEL_OUT_7POINT1POINT4 来配置 AudioTrack (#10322)。
• DRM
  • 确保格式更改后始终能够立即正确更新 DRM 会话 (10274)。
• 文本：
  • 更改了 Player.getCurrentCues() 以返回 CueGroup，而不是 List<Cue>。
  • SSA：支持 BorderStyle == 3（即 OutlineColour 设置 cue 文件的背景）时的 OutlineColour 样式设置 (#8435)。
  • CEA-708：将数据解析为多个服务块，并忽略与当前所选服务号码无关的块。
  • 移除了过去仅用于处理 Google 内部字幕格式的 RawCcExtractor。
• 提取器：
  • 添加了对 AVI 的支持 (#2092)。
  • Matroska：解析了 Opus 轨道的 DiscardPadding。
  • MP4：解析了 esds 框中的比特率。
  • Ogg：允许重复的 Opus ID 和注释标头 (#10038)。
• 界面：
  • 修复了 useController=false 时将事件传递给 PlayerView 上设置的 OnClickListener 的问题 (#9605)。此外，还修复了针对所有视图配置将事件传递给 OnLongClickListener 的问题。
  • 修复了将 ACTION_UP 之前退出 PlayerView 边界的一系列触摸事件错误处理为点击的问题 (#9861)。
  • 修复了点按操作可能会切换播放，而不是隐藏控件的 PlayerView 无障碍功能问题 (#8627)。
  • 重写了 TrackSelectionView 和 TrackSelectionDialogBuilder，以使用 Player 接口（而不是 ExoPlayer）。这样做将允许视图与其他 Player 实现一起使用，并移除界面模块对 ExoPlayer 模块的依赖关系。这是一项破坏性更改。
  • 不在 PlayerView 轨道选择器中显示强制文字轨道；如果选择了“None”，则保留一个合适的强制文字轨道 (#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 调用，以便将媒体播放到 MediaSession.Callback.onAddMediaItems（而非 onSetMediaUri）。
  • 添加了 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：
  • 将广告轮询频率从每 100 毫秒减少到每 200 毫秒，以便与美国媒体评定委员会 (MRC) 建议保持一致。
• FFmpeg 扩展程序：
  • 将 CMake 版本更新为 3.21.0+，以避免 CMake bug 导致 Android Studio 的 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 包含这些提交内容。

这与 ExoPlayer 2.17.1 版本相对应。

• 音频：
  • 修复了 HLS 中杜比全景声 (E-AC3-JOC) 音频检查功能的错误。
• 提取器：
  • FMP4：修复了包含 v0 和 v1 emsg Atom 的数据流 emsg 示例元数据可能会以错误的顺序输出的问题 (#9996)。
• 文本：
  • 修复了 SingleSampleMediaSource.Factory.setTrackId 和 MediaItem.SubtitleConfiguration.Builder.setId 的互动以优先处理 SubtitleConfiguration 字段，如果未设置，回退到 Factory 值 (#10016)。
• 广告播放：
  • 修复了直播 HLS SSAI 数据流中广告时段之间的音频欠载问题。

版本 1.0.0-alpha02

2022 年 3 月 2 日

发布了 androidx.media3:media3-*:1.0.0-alpha02。版本 1.0.0-alpha02 包含这些提交内容。

这与 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 实例失败时会休眠并重试。这可解决在将 Surface 从一个安全的编解码器切换到另一个编解码器时，某些设备上会出现的问题 (#8696)。
  • 添加了 MediaCodecAdapter.getMetrics() 以允许用户从 MediaCodec 获取指标数据。(#9766)。
  • 修复了 Maven 依赖项解析 (#8353)。
  • 如果直播既没有低延迟功能也没收到要设置速度的用户请求，则停用直播的自动速度调整功能 (#9329)。
  • 已将 DecoderCounters#inputBufferCount 重命名为 queuedInputBufferCount。
  • 将 SimpleExoPlayer.renderers 设为了不公开。可通过 ExoPlayer.getRenderer 访问渲染程序。
  • 更新了一些 AnalyticsListener.EventFlags 常量值，以与 Player.EventFlags 中的值匹配。
  • 将 AnalyticsCollector 拆分为一个接口和默认实现，以允许它在不为应用所需时由 R8 去掉。
• 轨道选择：
  • 支持在轨道选择中使用首选视频角色标志 (#9402)。
  • 将视频轨道选择逻辑更新为：在选择多个视频轨道用于自适应调整时，考虑首选的 MIME 类型和角色标志 (#9519)。
  • 将视频和音频轨道选择逻辑更新为：仅为解码器和硬件支持的级别相同的自适应选择项选择格式 (#9565)。
  • 将视频轨道选择逻辑更新为：如果主要的硬件加速解码器支持多个编解码器，则优先选用效率较高的编解码器 (#4835)。
  • 相较于技术轨道选择约束（例如，首选的 MIME 类型或频道数量上限），优先选用音频内容偏好设置（例如，“默认”音轨或某个与系统语言区域的语言相匹配的轨道）。
  • 修复了以下轨道选择问题：替换一个轨道组不会停用同一类型的其他轨道组 (#9675)。
  • 修复了以下轨道选择问题：同时存在非空和空轨道替换时无法正确应用 (#9649)。
  • 禁止 TrackGroupArray 中有重复的 TrackGroup。始终可通过在 TrackGroup 构造函数中设置 id 而使 TrackGroup 可区分开。这修复了以下问题：通过活跃轨道替换使应用转入后台再继续播放时会发生崩溃 (#9718)。
  • 修正了 AdaptiveTrackSelection 中的逻辑，在网络带宽足够的情况下允许提高质量，即使播放质量已非常接近当时的极限时也是如此 (#9784)。
• 视频：
  • 修复了杜比视界的解码器回退逻辑，以在需要时使用兼容的 H264/H265 解码器。
• 音频：
  • 修复了杜比全景声 (E-AC3-JOC) 的解码器回退逻辑，以在需要时使用兼容的 E-AC3 解码器。
  • 将 AudioCapabilities API 更改为要求明确传递 AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES 而不是 null。
  • 允许通过将 AudioTrackBufferSizeProvider 注入 DefaultAudioSink 来自定义 AudioTrack 缓冲区空间的计算。(#8891)。
  • 在请求的缓冲区空间大于 1 MB 时重试创建 AudioTrack。(#9712)。
• 提取器：
  • WAV：添加了对 RF64 流的支持 (#9543)。
  • 修复了对 H.265 SPS NAL 单元的解析错误 (#9719)。
  • 会解析 Ogg Opus 和 Ogg Vorbis 文件中的 Vorbis 注释（包括 METADATA_BLOCK_PICTURE）。
• 文本：
  • 添加了一个 MediaItem.SubtitleConfiguration.id 字段，该字段会传播到通过配置创建的字幕轨道的 Format.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)。
• 界面：
  • 修复了使用某些主题时 StyledPlayerView 快退按钮和快进按钮中数字的颜色 (#9765)。
  • 正确解析播放速度字符串 (#9811)。
• DASH：
  • 将解析出来的基本属性和补充属性添加到 Representation (#9579)。
  • 支持 forced-subtitle 轨道角色 (#9727)。
  • 停止将 main 轨道角色解读为 C.SELECTION_FLAG_DEFAULT。
  • 修复了未声明 DVB 命名空间的清单的基础网址排除逻辑 (#9856)。
  • 支持相对 MPD.Location 网址 (#9939)。
• HLS：
  • 为仅音频的 HLS 流正确地填充 Format.label (#9608)。
  • 默认使用无块准备来缩短启动时间。如果您的呈现内容包含未在主播放列表中声明的多路复用字幕轨道，您应该将其添加到主播放列表中以供播放，或使用 HlsMediaSource.Factory.setAllowChunklessPreparation(false) 关闭无块准备。
  • 支持在 HLS 中进行关键帧精确定位 (#2882)。
• RTSP：
  • 提供客户端 API 以替换用于任何服务器连接的 SocketFactory (#9606)。
  • 如果基本和摘要式身份验证方法都有，优先选用摘要式身份验证方法 (#9800)。
  • 当 RTSP 轨道时间不可用时及时应对 (#9775)。
  • 忽略无效的 RTP-Info 标头值 (#9619)。
• 转换器：
  • 将要求的最低 API 版本提高到 21。
  • TransformationException 现已用于描述转换期间发生的错误。
  • 添加了 TransformationRequest 以指定转换选项。
  • 允许注册多个监听器。
  • 修复了当读取了部分编解码器输出内容时转换器卡住的问题。
  • 修复了在释放多路复用器抛出项时 Transformer.getProgress 中潜在的 NPE 问题。
  • 添加了用于应用转换的演示版应用。
• MediaSession 扩展程序：
  • 默认情况下，MediaSessionConnector 现会在停止时清除播放列表。希望保留播放列表的应用可以在连接器上调用 setClearMediaItemsOnStop(false)。
• Cast 扩展程序：
  • 修复了导致 CastPlayer 无法正确调用 onIsPlayingChanged 的 bug (#9792)。
  • 支持音频元数据，包括带有 DefaultMediaItemConverter 的海报图片 (#9663)。
• FFmpeg 扩展程序：
  • 让 build_ffmpeg.sh 依赖于 LLVM（而非 GNU）的 bin utils (#9933)。
• Android 12 兼容性：
  • 将 Cast 扩展程序升级为依赖于 com.google.android.gms:play-services-cast-framework:20.1.0。早期版本的 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 包含这些提交内容。

新功能

Media3 是面向媒体支持库（包括 ExoPlayer）的新平台。首个 Alpha 版包含用于实现媒体用例的库的早期功能实现，包括：

• ExoPlayer - 一种适用于 Android 的应用级媒体播放器，可轻松自定义和扩展。
• 用于公开和控制播放的媒体会话功能。这一新的会话模块使用与 ExoPlayer 相同的 Player 接口。
• 用于构建媒体播放界面的界面组件。
• 其他库中用于 ExoPlayer 的模块封装功能，例如通过 IMA SDK 插入广告。

如需了解详情，请参阅 Media3 GitHub 项目。

之前，ExoPlayer 托管在单独的 ExoPlayer GitHub 项目中。在 Media3 中，其软件包名称为 androidx.media3.exoplayer。我们计划在一段时间内继续维护和发布 ExoPlayer GitHub 项目，以便让应用有时间迁移到 Media3。Media3 取代了所有 ExoPlayer 模块，但旧版 media2 和 mediasession 扩展程序除外，后者已被新的 media3-session 模块取代。这可以实现播放器和媒体会话之间的直接集成，而无需使用适配器/连接器类。