androidx/media

AndroidX Media 是一组面向 Android 应用开发者的媒体库：通过 ExoPlayer 实现本地与流媒体播放，通过 Transformer 实现视频编辑，并提供媒体会话来控制播放。它本身不是成品播放器应用，而是供开发者在自己的 Android 应用中集成播放或编辑功能使用的库。

提供什么、如何工作

README 将其概括为三大方向：播放（ExoPlayer）、视频编辑（Transformer）和媒体会话。它们以独立模块的形式发布，应用可以按需只引入需要的模块。例如，一个需要播放 DASH 流并自带播放界面的应用，会同时依赖 ExoPlayer、DASH 和 UI 三个模块 AndroidX Media README。更详细的资料放在开发者指南、类参考和发布说明中 AndroidX Media README，官方项目入口见 Media3 页面 Media3 概览。

典型流程是：Android 开发者在应用的 Gradle 构建中加入相应的 Media3 模块依赖，开启 Java 8 兼容，然后调用库 API 实现播放或编辑，需要时再接入媒体会话控制。具体步骤和示例主要在开发者指南与媒体开发中心，而不在 README 里 开发者指南 媒体开发中心。

两种引入方式

1. 使用已发布模块：从 Google Maven 仓库获取，并按需依赖各个模块。同一项目内使用的所有 Media3 模块必须版本一致 AndroidX Media README。这是常规应用开发中较简单的方式。
2. 本地检出：克隆仓库并作为 included build 引入，适合需要本地修改或使用 main 分支的场景。此时构建文件里写的已发布版本会被忽略 AndroidX Media README。部分模块不在 Maven 上提供，必须走本地方式；例如 MIDI 解码器需要配置 JitPack 并显式启用 MIDI 模块 README。

两种方式都要求 Android 项目使用 Gradle 并配置 Java 8 兼容 AndroidX Media README。本地方式还需要 Android SDK；如果未设置 sdk.dir，可能出现 NDK not configured 错误 AndroidX Media README。

API 稳定性与迁移

最常用的 API 享有向后兼容保证；面向高级用例的 API 被标记为不稳定，需要加入 OptIn 注解才能使用时不出 lint 警告 不稳定 API 文档 AndroidX Media README。已有 ExoPlayer 或 MediaSession 项目有专门的迁移指南 迁移指南。

仓库采用 Apache-2.0 许可证 androidx/media。开发工作在 main 分支进行，稳定版本位于 release 分支 AndroidX Media README。Media3 只在记录到的一个日期（2026-10-30，3,060 stars，当日 +3）出现在趋势榜上，这不足以判断趋势。