简介本资源是面向Android开发初学者的MediaPlayer核心组件实战学习包聚焦音视频播放功能实现解决新手在多媒体应用开发中初始化、数据源设置、异步准备、生命周期管理及事件监听等关键问题。压缩包为RAR格式共56个文件包含15个编译后class文件、13个UI资源png图、11个布局与配置xml文件、3个核心java源码、3个依赖jar包以及apk安装包、mp3测试音频、proguard混淆配置等完整呈现一个可运行的MediaPlayerDemo项目结构总大小10.57MB。目前已有331人学习下载。读者可直接导入Android Studio运行调试深入理解setDataSource、prepareAsync、start/pause/stop控制流、OnPreparedListener与OnErrorListener回调机制并掌握Activity中MediaPlayer资源释放的最佳实践是系统掌握Android原生媒体播放开发的优质入门范例。1. MediaPlayer 到底是什么一个你每天都在用、却从没注意过的“音频视频管家”想象一下你手机里装着几十个 App刷短视频的、听播客的、看网课的、甚至闹钟响铃——它们背后几乎都藏着同一个“隐形员工”不是程序员不是服务器而是一个叫 MediaPlayer 的系统级组件。它不露脸不弹窗但只要声音一响、画面一动它就在后台默默调度资源告诉手机芯片“现在要解码 H.264 视频”提醒内存“这段音频流先缓存 200ms”还顺手拦住另一个 App 想同时播放铃声的请求说“等会儿我正占着声卡呢。”很多人第一次听说 MediaPlayer是在写代码报错时看到MediaPlayer.create()报空指针或调试时发现视频卡在“准备中”死活不动。它不像按钮、输入框那样看得见摸得着却比它们更“固执”——状态机复杂、生命周期敏感、错误不报具体原因常被开发者称为“黑匣子里的玄学模块”。但正因为它被操作系统深度集成、原生支持硬解加速、无需额外下载解码库所以成了绝大多数音视频功能的默认起点。搞懂它不是为了背 API而是为了避开那些“明明代码没错就是播不出”的血泪翻车现场。2. 为什么 MediaPlayer 不是“随便 new 一下就能用”的对象它的设计逻辑藏在状态机里2.1 它本质是个“状态驱动的播放引擎”不是普通工具类MediaPlayer 的核心不是方法而是状态。官方文档画了一张著名的状态转换图Idle → Initialized → Prepared → Started → Paused → Stopped → PlaybackCompleted → Error。这可不是画着好看的流程图——每调一个方法比如setDataSource()、prepare()、start()都必须严格落在当前合法状态上否则直接抛异常。打个比方它像一台老式胶片放映机。你不能在胶片还没装进片盒Idle时就按“开始放映”start也不能在胶片正高速转动Started时突然拆开片门换胶卷调setDataSource()。prepare()就是“拉紧胶片、校准灯泡、检查音轨同步”的预热过程prepareAsync()则是让技师去隔壁房间干这事主控台不卡住——但你得等他敲门说“好了”才能按播放键。2.2 生命周期和 Activity/Fragment 绑得太紧稍不注意就内存泄漏MediaPlayer 内部持有音频焦点、硬件编解码器、Surface用于视频渲染等重量级资源。这些资源不会因为你new MediaPlayer()就自动释放也不会因为你finish()了 Activity 就跟着消失。常见翻车场景在onCreate()里创建 MediaPlayeronDestroy()却忘了调release()→ 后台持续占用解码器其他 App 播放失败在onPause()暂停播放却在onResume()忘了恢复 → 用户切回来发现静音用MediaPlayer.create(context, resId)创建后以为它自己会管生命周期 → 实际它只在首次播放前 prepare之后全靠你手动管理。提示create()方法本质是new MediaPlayer().setDataSource().prepare()的快捷封装但它不帮你 hold 住引用。一旦 Activity 被系统回收这个 MediaPlayer 对象若还在后台 decode就成了悬空资源。2.3 硬件加速不是“开关”而是由系统在 prepare 阶段动态协商很多人以为setAudioStreamType(AudioManager.STREAM_MUSIC)就是开启硬解其实这只是告诉系统“我打算播音乐请按音乐流规则分配音量和焦点”。真正的硬解决策发生在prepare()或prepareAsync()期间系统根据setDataSource()提供的 URI 类型本地文件网络 HTTPRTSP 流、文件封装格式MP4MKV、编码格式H.264AV1、设备芯片能力是否支持该 codec 的 DSP 加速动态选择软解CPU 解码还是硬解GPU/DSP 解码。这意味着同一段 MP4在旗舰机上可能走硬解秒开在旧平板上可能因缺少 H.265 硬解支持而 fallback 到软解导致卡顿甚至 OOM。3. MediaPlayer 和 ExoPlayer、VideoView 到底差在哪三者不是“升级替代”而是“分工不同”3.1 VideoViewMediaPlayer 的“傻瓜遥控器”适合极简需求VideoView 是 Android SDK 自带的 View 组件底层就是封装了一个 MediaPlayer SurfaceView。它把setVideoPath()、start()、pause()这些操作变成一行代码连进度条、全屏按钮都给你配好。适用场景App 里只需要嵌入一个本地视频介绍页不关心缓冲策略、不需自定义 UI、不处理 DRM。致命短板无法监听缓冲进度onBufferingUpdate()、不能切换音轨/字幕、不支持 DASH/HLS 自适应流、出错时只给OnErrorListener一个泛泛的what/extra错误码查不到具体是 DNS 失败还是证书过期。3.2 ExoPlayerMediaPlayer 的“专业工作室”为复杂场景而生ExoPlayer 是 Google 开源的媒体播放库设计哲学和 MediaPlayer 完全相反MediaPlayer 是“系统内置、开箱即用、但难定制”ExoPlayer 是“纯 Java/Kotlin 实现、所有模块可替换、但需自己搭流水线”。它把播放拆成MediaSource数据源、Renderer解码渲染器、TrackSelector音轨/字幕选择器、LoadControl缓冲策略四大可插拔模块。你可以用DashMediaSource播 DASH 流用HlsMediaSource播 HLS自定义TrackSelector实现“网络差时自动切 480pWiFi 下切 4K”替换DefaultLoadControl把缓冲阈值从默认 50s 改成 10s适配低延迟直播甚至用FakeTrackRenderer模拟音轨做语音合成测试。注意ExoPlayer 不是 MediaPlayer 的“高配版”它不依赖系统 MediaPlayer也不走系统音频焦点管理需手动调AudioManager。它强大但也意味着更多需要你操心的细节。3.3 常见误区 / 易混概念辨析易混点为什么容易混怎么清晰区分“MediaPlayer 支持 HLS 吗”很多人看到setDataSource(https://xxx.m3u8)就以为能播 HLSAndroid 4.1 系统 MediaPlayer仅支持基础 HLS无加密、无多音轨、无 EXT-X-BYTERANGE且行为不稳定ExoPlayer 才是 HLS 的第一选择。setDataSource()传 m3u8大概率在 prepare 阶段直接报IOException。“MediaPlayer.prepare() 和 prepareAsync() 只是同步异步区别”表面看只是阻塞与否开发者常随意替换prepare()在当前线程阻塞直到准备完成绝对不能在主线程调用ANRprepareAsync()异步执行但必须注册OnPreparedListener在回调里才能安全调start()—— 回调不在主线程需runOnUiThread更新 UI。漏掉回调 播放无声。“MediaPlayer.release() 和 reset() 都是重置可以互换”文档里都说“释放资源”新手以为调哪个都行reset()是把 MediaPlayer退回 Idle 状态可再次setDataSource()release()是彻底销毁对象不可再用。若你计划复用同一个 MediaPlayer 播多个视频该用reset()若 Activity 销毁必须用release()否则内存泄漏。“setLooping(true) 就是无限循环播放”看名字很直白但实际有隐藏条件它只对PlaybackCompleted状态生效。如果视频因网络中断、解码失败进入Error状态setLooping(true)完全无效。真要循环得自己监听OnErrorListener捕获错误后手动seekTo(0)start()。“MediaPlayer 能播 RTMP 直播流吗”RTMP 是传统直播协议有人想省事直接喂地址Android 系统 MediaPlayer 原生不支持 RTMP。setDataSource(rtmp://xxx)必然失败。必须用 FFmpeg如 librtmp或 ExoPlayer 自定义MediaSource实现。4. 它的“脾气”藏在参数和配置里几个关键设置决定成败4.1 setAudioStreamType() 不是选音质而是选“声音归谁管”这个方法的参数不是STREAM_HIGH_QUALITY而是STREAM_MUSIC、STREAM_ALARM、STREAM_NOTIFICATION等。它本质是告诉 Android 音频系统“我这个播放属于哪一类声音事件”STREAM_MUSIC走媒体音量滑块受 DND请勿打扰影响小支持蓝牙 A2DP 传输STREAM_ALARM强制响铃DND 也无法屏蔽但可能被系统降频以保电量STREAM_VOICE_CALL走听筒/蓝牙耳机通话通道用于 VoIP。错误用法用STREAM_NOTIFICATION播背景音乐 → 用户调高媒体音量你的音乐依然无声用STREAM_MUSIC播闹钟 → DND 开启时闹钟不响。4.2 setVolume() 控制的是“相对增益”不是绝对音量setVolume(left, right)的取值范围是0.0f静音到1.0f原始音量它不改变系统总音量只调节 MediaPlayer 输出信号的放大倍数。举个例子系统媒体音量调到 50%你设setVolume(0.5f, 0.5f)实际听到的是 25% 音量。它适合做淡入淡出动画ValueAnimator.ofFloat(0f, 1f)但不适合做“用户音量调节”——那个得调AudioManager。4.3 setDataSource() 的 URI 格式决定底层加载方式MediaPlayer 对不同 URI 前缀有硬编码逻辑file:///sdcard/video.mp4→ 走FileDescriptor直接读取最快content://media/external/video/media/123→ 走ContentResolver.openAssetFileDescriptor()需权限READ_EXTERNAL_STORAGEhttp://xxx.com/video.mp4→ 走HttpURLConnection支持 Range 请求断点续传https://xxx.com/video.mp4→ 同上但需设备信任该 HTTPS 证书链Android 7.0 默认不信任用户安装证书。血泪经验用file://路径播 Android 10 分区存储下的文件会失败SecurityException必须转content://URI 或用FileDescriptor。4.4 prepareAsync() 的回调时机比你想的更“不可控”OnPreparedListener.onPrepared()被触发只代表“解码器已初始化、首帧数据已准备好”不代表第一帧已渲染到屏幕。尤其在 SurfaceView 场景下onPrepared()可能早于SurfaceHolder.Callback.surfaceCreated()导致start()时找不到 Surface静音播放。正确姿势surfaceView.getHolder().addCallback(new SurfaceHolder.Callback() { Override public void surfaceCreated(SurfaceHolder holder) { // 此时 Surface 已就绪可安全 setSurface() mediaPlayer.setSurface(holder.getSurface()); } // ... 其他回调 }); // prepareAsync 后在 onPrepared 里 start() mediaPlayer.setOnPreparedListener(mp - mp.start());5. 什么时候该用 MediaPlayer什么时候该果断换 ExoPlayer一份边界清晰的决策清单5.1 坚定选择 MediaPlayer 的 4 种真实场景场景为什么 MediaPlayer 更优关键落地细节本地资源快速预览如相册内点击缩略图播视频启动快、无额外依赖、系统级优化成熟用MediaPlayer.create(context, R.raw.video)create()内部已prepare()拿到就start()播放完立即release()。系统级功能集成如闹钟、计时器、语音助手反馈音需与系统音频焦点、DND、蓝牙策略深度协同必须用STREAM_ALARM/STREAM_NOTIFICATION并在onAudioFocusChange()中响应焦点丢失如暂停播放。极简教育 App 的课件视频单个 MP4无交互无网络APK 包体敏感不想引入 500KB 的 ExoPlayer 依赖用VideoView封装android:layout_widthmatch_parent即可全屏setOnCompletionListener()后自动跳转下一节。后台服务播放通知音效如消息到达提示音需在 Service 中长期存活MediaPlayer 更轻量在onStartCommand()中创建 MediaPlayersetLooping(false)播放完release()务必在onDestroy()中release()防泄漏。5.2 一旦出现以下任一信号立刻停用 MediaPlayer转向 ExoPlayer信号为什么 MediaPlayer 无法解决ExoPlayer 如何破局需要播放 HLS/DASH 自适应流系统 MediaPlayer 对 HLS 支持残缺DASH 完全不支持HlsMediaSource/DashMediaSource原生支持自动切换码率DefaultTrackSelector可编程控制。要求精确缓冲控制如直播延迟 3sMediaPlayer 缓冲策略黑盒setVideoScalingMode()无法控制解码队列长度DefaultLoadControl可设minBufferMs1000,maxBufferMs3000,bufferForPlaybackAfterRebufferMs250精细调控。需 DRM 保护内容如付费课程视频MediaPlayer 仅支持 Widevine L1/L3 基础集成无自定义 license server 能力MediaSource可注入DrmSessionManager支持自定义HttpDataSource.Factory发送 license 请求头、处理 token。UI 高度定制化如弹幕、画中画、变速播放VideoView 的 UI 层不可替换MediaPlayer 无渲染控制权ExoPlayer 的PlayerView是FrameLayout可自由 addView 弹幕层PlaybackParameters支持 0.1x~4x 无缝变速PictureInPictureParams原生支持画中画。5.3 一个真实踩坑案例某跨平台系统音视频模块的重构抉择某高校实验室开发的在线实验平台最初用 MediaPlayer 播放教师录制的 MP4 实验演示视频。上线半年后用户投诉集中爆发iOS 端学生用 iPhone 播放正常Android 端部分华为手机黑屏教师上传的 4K 视频在旧平板上卡顿严重日志显示DecoderInitializationException新增“双语字幕切换”需求MediaPlayer 无字幕 API。团队排查发现黑屏源于华为 EMUI 系统对 MediaPlayer 的 Surface 渲染兼容问题setSurface()在某些机型需配合setVideoScalingMode(MediaPlayer.VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING)卡顿是因旧平板芯片不支持 H.265 硬解MediaPlayer fallback 软解后 CPU 占用 95%字幕只能靠TextView手动解析 SRT 文件并seekTo()同步误差达 2s。最终方案保留 MediaPlayer 用于本地离线缓存视频的快速回放利用其create()的便捷性新接入的在线课程流全部切 ExoPlayer。用SimpleExoPlayer替代MediaPlayerPlayerView嵌入原有布局字幕用SubtitleViewDRM 用DefaultDrmSessionManager接学校自有 license server。重构后卡顿率下降 92%字幕同步误差 100ms黑屏问题归零。从那以后我每次接到“加个播放功能”的需求第一件事不是写new MediaPlayer()而是掏出这张决策表先问“播什么格式跑在什么设备要不要自定义”再决定用 MediaPlayer 还是 ExoPlayer。少一次盲目封装就少三天线上 debug。希望帮到你。本文还有配套的精品资源点击获取
简介本资源是面向Android开发初学者的MediaPlayer核心组件实战学习包聚焦音视频播放功能实现解决新手在多媒体应用开发中初始化、数据源设置、异步准备、生命周期管理及事件监听等关键问题。压缩包为RAR格式共56个文件包含15个编译后class文件、13个UI资源png图、11个布局与配置xml文件、3个核心java源码、3个依赖jar包以及apk安装包、mp3测试音频、proguard混淆配置等完整呈现一个可运行的MediaPlayerDemo项目结构总大小10.57MB。目前已有331人学习下载。读者可直接导入Android Studio运行调试深入理解setDataSource、prepareAsync、start/pause/stop控制流、OnPreparedListener与OnErrorListener回调机制并掌握Activity中MediaPlayer资源释放的最佳实践是系统掌握Android原生媒体播放开发的优质入门范例。1. MediaPlayer 到底是什么一个你每天都在用、却从没注意过的“音频视频管家”想象一下你手机里装着几十个 App刷短视频的、听播客的、看网课的、甚至闹钟响铃——它们背后几乎都藏着同一个“隐形员工”不是程序员不是服务器而是一个叫 MediaPlayer 的系统级组件。它不露脸不弹窗但只要声音一响、画面一动它就在后台默默调度资源告诉手机芯片“现在要解码 H.264 视频”提醒内存“这段音频流先缓存 200ms”还顺手拦住另一个 App 想同时播放铃声的请求说“等会儿我正占着声卡呢。”很多人第一次听说 MediaPlayer是在写代码报错时看到MediaPlayer.create()报空指针或调试时发现视频卡在“准备中”死活不动。它不像按钮、输入框那样看得见摸得着却比它们更“固执”——状态机复杂、生命周期敏感、错误不报具体原因常被开发者称为“黑匣子里的玄学模块”。但正因为它被操作系统深度集成、原生支持硬解加速、无需额外下载解码库所以成了绝大多数音视频功能的默认起点。搞懂它不是为了背 API而是为了避开那些“明明代码没错就是播不出”的血泪翻车现场。2. 为什么 MediaPlayer 不是“随便 new 一下就能用”的对象它的设计逻辑藏在状态机里2.1 它本质是个“状态驱动的播放引擎”不是普通工具类MediaPlayer 的核心不是方法而是状态。官方文档画了一张著名的状态转换图Idle → Initialized → Prepared → Started → Paused → Stopped → PlaybackCompleted → Error。这可不是画着好看的流程图——每调一个方法比如setDataSource()、prepare()、start()都必须严格落在当前合法状态上否则直接抛异常。打个比方它像一台老式胶片放映机。你不能在胶片还没装进片盒Idle时就按“开始放映”start也不能在胶片正高速转动Started时突然拆开片门换胶卷调setDataSource()。prepare()就是“拉紧胶片、校准灯泡、检查音轨同步”的预热过程prepareAsync()则是让技师去隔壁房间干这事主控台不卡住——但你得等他敲门说“好了”才能按播放键。2.2 生命周期和 Activity/Fragment 绑得太紧稍不注意就内存泄漏MediaPlayer 内部持有音频焦点、硬件编解码器、Surface用于视频渲染等重量级资源。这些资源不会因为你new MediaPlayer()就自动释放也不会因为你finish()了 Activity 就跟着消失。常见翻车场景在onCreate()里创建 MediaPlayeronDestroy()却忘了调release()→ 后台持续占用解码器其他 App 播放失败在onPause()暂停播放却在onResume()忘了恢复 → 用户切回来发现静音用MediaPlayer.create(context, resId)创建后以为它自己会管生命周期 → 实际它只在首次播放前 prepare之后全靠你手动管理。提示create()方法本质是new MediaPlayer().setDataSource().prepare()的快捷封装但它不帮你 hold 住引用。一旦 Activity 被系统回收这个 MediaPlayer 对象若还在后台 decode就成了悬空资源。2.3 硬件加速不是“开关”而是由系统在 prepare 阶段动态协商很多人以为setAudioStreamType(AudioManager.STREAM_MUSIC)就是开启硬解其实这只是告诉系统“我打算播音乐请按音乐流规则分配音量和焦点”。真正的硬解决策发生在prepare()或prepareAsync()期间系统根据setDataSource()提供的 URI 类型本地文件网络 HTTPRTSP 流、文件封装格式MP4MKV、编码格式H.264AV1、设备芯片能力是否支持该 codec 的 DSP 加速动态选择软解CPU 解码还是硬解GPU/DSP 解码。这意味着同一段 MP4在旗舰机上可能走硬解秒开在旧平板上可能因缺少 H.265 硬解支持而 fallback 到软解导致卡顿甚至 OOM。3. MediaPlayer 和 ExoPlayer、VideoView 到底差在哪三者不是“升级替代”而是“分工不同”3.1 VideoViewMediaPlayer 的“傻瓜遥控器”适合极简需求VideoView 是 Android SDK 自带的 View 组件底层就是封装了一个 MediaPlayer SurfaceView。它把setVideoPath()、start()、pause()这些操作变成一行代码连进度条、全屏按钮都给你配好。适用场景App 里只需要嵌入一个本地视频介绍页不关心缓冲策略、不需自定义 UI、不处理 DRM。致命短板无法监听缓冲进度onBufferingUpdate()、不能切换音轨/字幕、不支持 DASH/HLS 自适应流、出错时只给OnErrorListener一个泛泛的what/extra错误码查不到具体是 DNS 失败还是证书过期。3.2 ExoPlayerMediaPlayer 的“专业工作室”为复杂场景而生ExoPlayer 是 Google 开源的媒体播放库设计哲学和 MediaPlayer 完全相反MediaPlayer 是“系统内置、开箱即用、但难定制”ExoPlayer 是“纯 Java/Kotlin 实现、所有模块可替换、但需自己搭流水线”。它把播放拆成MediaSource数据源、Renderer解码渲染器、TrackSelector音轨/字幕选择器、LoadControl缓冲策略四大可插拔模块。你可以用DashMediaSource播 DASH 流用HlsMediaSource播 HLS自定义TrackSelector实现“网络差时自动切 480pWiFi 下切 4K”替换DefaultLoadControl把缓冲阈值从默认 50s 改成 10s适配低延迟直播甚至用FakeTrackRenderer模拟音轨做语音合成测试。注意ExoPlayer 不是 MediaPlayer 的“高配版”它不依赖系统 MediaPlayer也不走系统音频焦点管理需手动调AudioManager。它强大但也意味着更多需要你操心的细节。3.3 常见误区 / 易混概念辨析易混点为什么容易混怎么清晰区分“MediaPlayer 支持 HLS 吗”很多人看到setDataSource(https://xxx.m3u8)就以为能播 HLSAndroid 4.1 系统 MediaPlayer仅支持基础 HLS无加密、无多音轨、无 EXT-X-BYTERANGE且行为不稳定ExoPlayer 才是 HLS 的第一选择。setDataSource()传 m3u8大概率在 prepare 阶段直接报IOException。“MediaPlayer.prepare() 和 prepareAsync() 只是同步异步区别”表面看只是阻塞与否开发者常随意替换prepare()在当前线程阻塞直到准备完成绝对不能在主线程调用ANRprepareAsync()异步执行但必须注册OnPreparedListener在回调里才能安全调start()—— 回调不在主线程需runOnUiThread更新 UI。漏掉回调 播放无声。“MediaPlayer.release() 和 reset() 都是重置可以互换”文档里都说“释放资源”新手以为调哪个都行reset()是把 MediaPlayer退回 Idle 状态可再次setDataSource()release()是彻底销毁对象不可再用。若你计划复用同一个 MediaPlayer 播多个视频该用reset()若 Activity 销毁必须用release()否则内存泄漏。“setLooping(true) 就是无限循环播放”看名字很直白但实际有隐藏条件它只对PlaybackCompleted状态生效。如果视频因网络中断、解码失败进入Error状态setLooping(true)完全无效。真要循环得自己监听OnErrorListener捕获错误后手动seekTo(0)start()。“MediaPlayer 能播 RTMP 直播流吗”RTMP 是传统直播协议有人想省事直接喂地址Android 系统 MediaPlayer 原生不支持 RTMP。setDataSource(rtmp://xxx)必然失败。必须用 FFmpeg如 librtmp或 ExoPlayer 自定义MediaSource实现。4. 它的“脾气”藏在参数和配置里几个关键设置决定成败4.1 setAudioStreamType() 不是选音质而是选“声音归谁管”这个方法的参数不是STREAM_HIGH_QUALITY而是STREAM_MUSIC、STREAM_ALARM、STREAM_NOTIFICATION等。它本质是告诉 Android 音频系统“我这个播放属于哪一类声音事件”STREAM_MUSIC走媒体音量滑块受 DND请勿打扰影响小支持蓝牙 A2DP 传输STREAM_ALARM强制响铃DND 也无法屏蔽但可能被系统降频以保电量STREAM_VOICE_CALL走听筒/蓝牙耳机通话通道用于 VoIP。错误用法用STREAM_NOTIFICATION播背景音乐 → 用户调高媒体音量你的音乐依然无声用STREAM_MUSIC播闹钟 → DND 开启时闹钟不响。4.2 setVolume() 控制的是“相对增益”不是绝对音量setVolume(left, right)的取值范围是0.0f静音到1.0f原始音量它不改变系统总音量只调节 MediaPlayer 输出信号的放大倍数。举个例子系统媒体音量调到 50%你设setVolume(0.5f, 0.5f)实际听到的是 25% 音量。它适合做淡入淡出动画ValueAnimator.ofFloat(0f, 1f)但不适合做“用户音量调节”——那个得调AudioManager。4.3 setDataSource() 的 URI 格式决定底层加载方式MediaPlayer 对不同 URI 前缀有硬编码逻辑file:///sdcard/video.mp4→ 走FileDescriptor直接读取最快content://media/external/video/media/123→ 走ContentResolver.openAssetFileDescriptor()需权限READ_EXTERNAL_STORAGEhttp://xxx.com/video.mp4→ 走HttpURLConnection支持 Range 请求断点续传https://xxx.com/video.mp4→ 同上但需设备信任该 HTTPS 证书链Android 7.0 默认不信任用户安装证书。血泪经验用file://路径播 Android 10 分区存储下的文件会失败SecurityException必须转content://URI 或用FileDescriptor。4.4 prepareAsync() 的回调时机比你想的更“不可控”OnPreparedListener.onPrepared()被触发只代表“解码器已初始化、首帧数据已准备好”不代表第一帧已渲染到屏幕。尤其在 SurfaceView 场景下onPrepared()可能早于SurfaceHolder.Callback.surfaceCreated()导致start()时找不到 Surface静音播放。正确姿势surfaceView.getHolder().addCallback(new SurfaceHolder.Callback() { Override public void surfaceCreated(SurfaceHolder holder) { // 此时 Surface 已就绪可安全 setSurface() mediaPlayer.setSurface(holder.getSurface()); } // ... 其他回调 }); // prepareAsync 后在 onPrepared 里 start() mediaPlayer.setOnPreparedListener(mp - mp.start());5. 什么时候该用 MediaPlayer什么时候该果断换 ExoPlayer一份边界清晰的决策清单5.1 坚定选择 MediaPlayer 的 4 种真实场景场景为什么 MediaPlayer 更优关键落地细节本地资源快速预览如相册内点击缩略图播视频启动快、无额外依赖、系统级优化成熟用MediaPlayer.create(context, R.raw.video)create()内部已prepare()拿到就start()播放完立即release()。系统级功能集成如闹钟、计时器、语音助手反馈音需与系统音频焦点、DND、蓝牙策略深度协同必须用STREAM_ALARM/STREAM_NOTIFICATION并在onAudioFocusChange()中响应焦点丢失如暂停播放。极简教育 App 的课件视频单个 MP4无交互无网络APK 包体敏感不想引入 500KB 的 ExoPlayer 依赖用VideoView封装android:layout_widthmatch_parent即可全屏setOnCompletionListener()后自动跳转下一节。后台服务播放通知音效如消息到达提示音需在 Service 中长期存活MediaPlayer 更轻量在onStartCommand()中创建 MediaPlayersetLooping(false)播放完release()务必在onDestroy()中release()防泄漏。5.2 一旦出现以下任一信号立刻停用 MediaPlayer转向 ExoPlayer信号为什么 MediaPlayer 无法解决ExoPlayer 如何破局需要播放 HLS/DASH 自适应流系统 MediaPlayer 对 HLS 支持残缺DASH 完全不支持HlsMediaSource/DashMediaSource原生支持自动切换码率DefaultTrackSelector可编程控制。要求精确缓冲控制如直播延迟 3sMediaPlayer 缓冲策略黑盒setVideoScalingMode()无法控制解码队列长度DefaultLoadControl可设minBufferMs1000,maxBufferMs3000,bufferForPlaybackAfterRebufferMs250精细调控。需 DRM 保护内容如付费课程视频MediaPlayer 仅支持 Widevine L1/L3 基础集成无自定义 license server 能力MediaSource可注入DrmSessionManager支持自定义HttpDataSource.Factory发送 license 请求头、处理 token。UI 高度定制化如弹幕、画中画、变速播放VideoView 的 UI 层不可替换MediaPlayer 无渲染控制权ExoPlayer 的PlayerView是FrameLayout可自由 addView 弹幕层PlaybackParameters支持 0.1x~4x 无缝变速PictureInPictureParams原生支持画中画。5.3 一个真实踩坑案例某跨平台系统音视频模块的重构抉择某高校实验室开发的在线实验平台最初用 MediaPlayer 播放教师录制的 MP4 实验演示视频。上线半年后用户投诉集中爆发iOS 端学生用 iPhone 播放正常Android 端部分华为手机黑屏教师上传的 4K 视频在旧平板上卡顿严重日志显示DecoderInitializationException新增“双语字幕切换”需求MediaPlayer 无字幕 API。团队排查发现黑屏源于华为 EMUI 系统对 MediaPlayer 的 Surface 渲染兼容问题setSurface()在某些机型需配合setVideoScalingMode(MediaPlayer.VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING)卡顿是因旧平板芯片不支持 H.265 硬解MediaPlayer fallback 软解后 CPU 占用 95%字幕只能靠TextView手动解析 SRT 文件并seekTo()同步误差达 2s。最终方案保留 MediaPlayer 用于本地离线缓存视频的快速回放利用其create()的便捷性新接入的在线课程流全部切 ExoPlayer。用SimpleExoPlayer替代MediaPlayerPlayerView嵌入原有布局字幕用SubtitleViewDRM 用DefaultDrmSessionManager接学校自有 license server。重构后卡顿率下降 92%字幕同步误差 100ms黑屏问题归零。从那以后我每次接到“加个播放功能”的需求第一件事不是写new MediaPlayer()而是掏出这张决策表先问“播什么格式跑在什么设备要不要自定义”再决定用 MediaPlayer 还是 ExoPlayer。少一次盲目封装就少三天线上 debug。希望帮到你。本文还有配套的精品资源点击获取
