MediaPlayer详解和使用

article/2025/10/2 2:11:32

Android多媒体相关的API，网上基本都能找到很多相关的文章，使用起来也很简单，一直在犹豫要不要写这方面的内容，后来决定还是写一写，一方面算是一个归纳总结，另一方面，也方便以后查阅。这一篇就写一下MediaPlayer。

状态图详解

下图是一个MediaPlayer的生命周期和状态。其中，椭圆代表MediaPlayer可能驻留的状态，弧线表示MediaPlayer的播放控制操作。这里有两种类型的弧线，单箭头弧线代表同步方法调用，双箭头弧线代表异步方法调用。
这里写图片描述

1、新创建的MediaPlayer对象、或者调用了reset()方法的MediaPlayer对象，都处于Idle状态，这两种方法得到的对象，有一个微小但十分重要的差别。

处于Idle状态时，调用 getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamType(), setLooping(), setVolume(), pause(), start(), stop(), seekTo(), prepare(), prepareAsync()方法都会报错。新创建的MediaPlayer对象，调用以上方法，无法接收到注册的OnErrorListener.onError()回调；调用reset()方法的MediaPlayer对象可以接收到回调。

MediaPlayer不再被使用时，应立即调用release()方法来释放资源，资源可能包括硬件加速组件的单态固件，若没有调用release()方法可能会导致之后的MediaPlayer对象实例无法使用这种单态硬件资源，导致异常。

一旦MediaPlayer对象进入了End状态，将不能再被使用，也没有办法再迁移到其他状态。

2、由于种种原因，一些操作可能会失败，如不支持的格式/分辨率太高/流超时等，还有编程错误（比如在无效状态下调用某个操作），此时会回调OnErrorListener.onError()方法（需客户端提前注册listener）。一旦发生错误，MediaPlayer对象会进入Error状态，此时可以调用reset()方法把这个对象恢复到Idle状态。

在不合法的状态下调用一些方法，如prepare()、prepareAsync()和setDataSource()等会抛出ILlegalStateException异常。

3、Idle状态下，调用 setDataSource()方法会迁移到Initialized状态，非Idle状态下调用此方法会报 ILlegalStateException异常。注意，setDataSource()方法可能会抛出IOException异常。

4、调用prepare()、prepareAsync()方法可以迁移到Prepared状态，该状态下才可以进行基本播放操作。

异步的prepareAsync()方法需要通过OnPrepareListener.onPrepared()监听准备是否完成，Preparing是一个中间状态，如果在此状态下调用任何影响播放功能的方法，最终的运行结果都是未知的。

在不合适的状态下调用prepare()和prepareAsync()方法会抛出ILlegalStateException异常。

5、调用start()方法成功返回后，会迁移到Started状态，isPlaying()方法返回是否处于Started状态。迁移到Started状态时，可以通过OnBufferingUpdateListener.onBufferingUpdate()回调得知。

Started状态下调用start()方法没有影响。

6、调用pause()方法并返回时，会迁移到Paused状态。注意，Started与Paused状态的转换在内部的播放引擎中是异步的，所以isPlaying()可能会延时更新，如果是播放网络流媒体，这个延时可能会有几秒。

Paused状态下调用pause()方法没有影响。

7、除了Idle、Initialized状态，其它状态下都可以调用stop()迁移到Stopped状态，Stopped状态下调用stop()方法没有影响。

8、seekTo()方法可以调整播放位置，seekTo()方法是异步的，尤其是播放网络流媒体时延时很明显。实际定位完成后，通过OnSeekComplete.onSeekComplete()通知。

“活动状态”(Prepared、Started、Paused、PlaybackCompleted状态)下都可以调用seekTo()方法。

9、迁移到PlaybackCompleted状态后，如果通过setLooping()方法开启了循环模式，会重新进入到Started状态，并且不会回调OnCompletion.onCompletion()方法、如果没有开启循环，就会回调这个方法。

PlaybackCompleted状态下调用start()方法会迁移到Started状态。

各方法的调用状态

除了下面几个方法调用时需要特别注意状态的判断，其余常用方法，基本所有状态都是OK的，或者即便状态不对也不会报错。如果对某个方法调用有疑问，查阅API文档，下面只列出一些常用的、需要注意状态的方法。

下面这几个方法需要注意下：

1、setDataSource()
有效状态：Idle
调用结果：调用成功，会迁移到Initialized状态
无效状态：报IllegalStateException异常

2、prepare()、prepareAsync()
有效状态：Initialized/Stopped
调用结果：调用成功，会迁移到Prepared/Preparing状态
无效状态：报IllegalStateException异常

3、pause()
有效状态：Started/Paused
调用结果：调用成功，会迁移到Paused状态
无效状态：player进入Error状态

4、start()
有效状态：Prepared/Started/Paused/PlaybackCompleted
调用结果：调用成功，会迁移到Started状态
无效状态：player进入Error状态

5、stop()
有效状态：Prepared/Started/Stopped/Paused/PlaybackCompleted
调用结果：调用成功，会迁移到Stopped状态
无效状态：player进入Error状态

6、seekTo()
有效状态：Prepared/Started/Paused/PlaybackCompleted
调用结果：调用成功，不会改变player的状态
无效状态：player进入Error状态

使用demo

使用之前先整理一下大概要用到播放操作的方法，每个方法的有效状态是怎样。

大概要用到setDataSource()、prepare()、start()、pause()、seekTo()这5个方法，stop()方法一般不用，不播放的时候最好调release()释放资源。其中setDataSource()和prepare()基本就是初始化的时候连续调用，不太需要注意状态，所以剩下需要注意的也就start()、pause()和seekTo()这3个方法。

排除stop()方法和Stopped状态后，从“不可操作”到“可操作”的分界点就在Prepared状态，所以我们可以使用一个变量hasPrepared来标记是否可操作，start()和seekTo()方法在“可操作”状态下都是可以正常调用的。

剩下的就是pause()方法，只能在Started和Paused状态下调用，可以使用一个变量canPause来标记是否可以调用pause()方法。实际上，Prepared和PlaybackCompleted状态在程序中也基本是个瞬时状态，基本不会停留。一旦Prepared，程序就会调用start()方法进行播放；一旦PlaybackCompleted，就会进行下一个曲目的初始化、准备、播放。

那么下面就看一下使用方法吧：

public class MyPlayer implements MediaPlayer.OnPreparedListener, MediaPlayer.OnErrorListener, MediaPlayer.OnCompletionListener {private MediaPlayer mPlayer;private boolean hasPrepared;private void initIfNecessary() {if (null == mPlayer) {mPlayer = new MediaPlayer();mPlayer.setOnErrorListener(this);mPlayer.setOnCompletionListener(this);mPlayer.setOnPreparedListener(this);}}public void play(Context context, Uri dataSource) {hasPrepared = false; // 开始播放前讲Flag置为不可操作initIfNecessary(); // 如果是第一次播放/player已经释放了，就会重新创建、初始化try {mPlayer.reset();mPlayer.setDataSource(context, dataSource); // 设置曲目资源mPlayer.prepareAsync(); // 异步的准备方法} catch (IOException e) {e.printStackTrace();}}public void start() {// release()会释放player、将player置空，所以这里需要判断一下if (null != mPlayer && hasPrepared) {mPlayer.start();}}public void pause() {if (null != mPlayer && hasPrepared) {mPlayer.pause();}}public void seekTo(int position) {if (null != mPlayer && hasPrepared) {mPlayer.seekTo(position);}}// 对于播放视频来说，通过设置SurfaceHolder来设置显示Surface。这个方法不需要判断状态、也不会改变player状态public void setDisplay(SurfaceHolder holder) {if (null != mPlayer) {mPlayer.setDisplay(holder);}}public void release() {hasPrepared = false;mPlayer.stop();mPlayer.release();mPlayer = null;}@Overridepublic void onPrepared(MediaPlayer mp) {hasPrepared = true; // 准备完成后回调到这里start();}@Overridepublic void onCompletion(MediaPlayer mp) {hasPrepared = false;// 通知调用处，调用play()方法进行下一个曲目的播放}@Overridepublic boolean onError(MediaPlayer mp, int what, int extra) {hasPrepared = false;return false;}
}

http://chatgpt.dhexx.cn/article/OTAa4U36.shtml

相关文章

MediaPlayer的使用

MediaPlayer的使用

MediaPlayer的使用 MediaPlayer的使用（2019.07.16）1.视频播放器的原理2.Android系统自带的MediaPlay状态机详解（MediaPlay的生命周期）3.如何使用MediaPlayer播放音频与视频（一 ）播放音频（二&…
阅读更多...
MediaPlayer使用以及常见问题

MediaPlayer使用以及常见问题

前面已经写过一篇类似的文章，但是还不够细致： 采用Android的MediaPlayerSurfaceView设计视频播放器 这里我们重新理一下，并记录一点实际运用时遇到的问题。 MediaPlayer特性 MediaPlayer类用于控制音频文件、视频文件和流的播放。 Media…
阅读更多...
Android MediaPlayer类

Android MediaPlayer类

1. MediaPlayer方法 MediaPlayer创建 可以直接调用构造函数，利用setDataSource()方法设置资源。MediaPlayer mp new MediaPlayer(); // path可以是本地路径，也可以是网络地址 mp.setDataSource(String path);也可以调用create()方法，create…
阅读更多...
MediaPlayer状态图及生命周期

MediaPlayer状态图及生命周期

MediaPlayer状态图及生命周期 MediaPlayer是Android中的uoge多媒体播放类，我们能通过它控制音视频流或本地音视频资源的播放过程。 这一片博客主要介绍MediaPlayer状态图及生命周期。先看一张官网很经典的MediaPlayer状态机的图片。 其中椭圆代表MediaPlayer驻留…
阅读更多...
Android 使用MediaPlayer播放音频详解

Android 使用MediaPlayer播放音频详解

目录 一、官方资料 二、简单介绍 三、MediaPlayer使用 1.创建MediaPlayer实例 2.重要API 3.状态图 4.代码 5.常用API 6.辅助效果 总结 一、官方资料 MediaPlayer 概览https://developer.android.google.cn/guide/topics/media/mediaplayer?hlzh_cn MediaPlayer 文…
阅读更多...
Android -- 多媒体播放之MediaPlayer基础简介

Android -- 多媒体播放之MediaPlayer基础简介

Android -- MediaPlayer基础简介 MediaPlayer是Android中的一个多媒体播放类，我们能通过它控制音视频流或本地音视频资源的播放过程。 这段时间查阅了Android官方文档对MediaPlayer的介绍，同时也看了一些书籍介绍。现在把MediaPlayer的基础内容在此做一…
阅读更多...
网易雷火9.18笔试题

网易雷火9.18笔试题

3小时的题 我迟到了1个小时&#xff0c;提前了40分钟润&#xff0c;花了1个小时20分钟&#xff08;中途有点其他事&#xff09;&#xff0c;a了2道&#xff0c;第三题没思路&#xff0c;第4题不想看&#xff0c;就这样吧 #include <iostream> using namespace std; int…
阅读更多...
网易笔试题总结

网易笔试题总结

var string string; var number 0; var bool true; console.log(number || string); console.log(number && string); console.log(bool || number); console.log(bool && number); 输出结果 如果换下string和num的位置呢 var string string1; var numbe…
阅读更多...
网易2019笔试题

网易2019笔试题

1.苹果分堆 计算累加小组成员数&#xff0c;结合二分查找&#xff0c;复杂度O( min(n, mlogn) ) package wangyi123;import java.util.Scanner;public class groupNum {public static void main(String[] args) {Scanner sc new Scanner(System.in);while (sc.hasNext()) {i…
阅读更多...
2022-08-20-网易笔试题

2022-08-20-网易笔试题

写在前面 题目收集来源自网络&#xff0c;前四题是开发岗的&#xff0c;后四题是算法岗的&#xff0c;因为代码无处提交&#xff0c;不一定正确&#xff0c;就不贴出来了&#xff0c;这里只写一下我的思路吧~欢迎大家一起讨论~~ 1、 思路&#xff1a;因为最大1e9&#xff0c…
阅读更多...
网易游戏策划笔试-20190404

网易游戏策划笔试-20190404

1-7题为文案题&#xff08;答题时请勿参考其他作品&#xff09;&#xff0c;8-23题为数值系统题&#xff0c; 两个方向分别计算分数&#xff0c;最终选择分数更高的方向作为最终成绩&#xff0c;建议优先选择自己擅长或感兴趣的方向进行答题。 8、&#xff08;无需过程&#xf…
阅读更多...
JESD204接口调试总结——JESD204+In-system-ibert

JESD204接口调试总结——JESD204+In-system-ibert

提示&#xff1a;文章写完后&#xff0c;目录可以自动生成&#xff0c;如何生成可参考右边的帮助文档 JESD204接口调试总结——JESD204In-system-ibert 前言IP核的设置IP核连线调试jtag界面总结 前言 之前我们在讲serdes的时候讲到了使用in-system-ibert来进行眼图的扫描&…
阅读更多...
JESD204B IP核的配置与使用

JESD204B IP核的配置与使用

一、JESD204 配置方式&#xff1a; Configuration 1、Transmit or Receive: 选择是作为接收机还是发射机 2、LFMC : 默认值 3、Number of lanes : 传输的通道数&#xff0c;根据实际需求选择 4、pattern&#xff1a;模式的选择&#xff0c;正常情况下两个都不选 5、clocki…
阅读更多...
JESD204接口调试总结——Xilinx JESD204B IP testbench解析

JESD204接口调试总结——Xilinx JESD204B IP testbench解析

提示&#xff1a;文章写完后&#xff0c;目录可以自动生成&#xff0c;如何生成可参考右边的帮助文档 JESD204接口调试总结——Xilinx JESD204B IP testbench解析 IP核配置testbench工程部分代码解读 IP核配置 1、IP核为接收功能 2、LMFC buffer设定为最大 3、4条lane 4、sysre…
阅读更多...
STC15W204S下载

STC15W204S下载

一&#xff1a;所使用测试板。 为8管脚最小板&#xff0c; 二&#xff1a;工程新建。 一&#xff1a;keil c51。 2&#xff1a;新建main,加入工程。 测试程序&#xff1a; #include <reg52.h>//stc15w20s为51内核#define MAIN_Fosc 35000000UL //定义主时钟sbit PIN_LE…
阅读更多...
JESD204B 系统复位与同步选项

JESD204B 系统复位与同步选项

CGS&#xff0c;代码组同步&#xff0c;ILA&#xff0c;初始化多帧序列帧同步&#xff0c;然后进行数据传输 。 系统复位 在系统复位上&#xff1a;JESD204中提供了一个全局的异步时钟复位&#xff0c;rx_reset用来复位整个系统&#xff0c;AXI4-Lite系统总线复位不受此影响&am…
阅读更多...
Atsha204a使用心得

Atsha204a使用心得

最近公司要用到Atsha204a做软件和硬件的绑定加密&#xff0c;于是就调了它的驱动&#xff0c;将使用过程中遇到的坑整理下&#xff0c;也好让各位同仁少加点班&#xff1b;废话少说&#xff0c;直接入正题。 0.加密原理&#xff1a; 主控端和Atsha204a端有相同的16 组密码&am…
阅读更多...
JESD204B接口调试记录3 - 总结

JESD204B接口调试记录3 - 总结

目录 一、介绍下项目历史情况 二、为什么要用fs4模式&#xff1f; 三、为什么要将采样率改成2.5Gsps&#xff1f; 四、时钟芯片参数如何设置&#xff1f; 五、AD芯片参数如何设置&#xff1f; 六、FPGA工程里JESD204 IP如何设置&#xff1f; 七、传输层如何解包&#xff…
阅读更多...
【JESD204B】基于JESD204B协议的ADC、DAC数据传输

【JESD204B】基于JESD204B协议的ADC、DAC数据传输

1、JESD204协议概述 ADC、DAC技术即模数、数模转换技术&#xff0c;在军用和民用领域广泛应用&#xff0c;如现在常用的有微信语音、网络电话、其典型数据处理流程&#xff1a; 语音输入->ADC采样->调制->基站->无线传输->基站->解调->DAC->语音输出…
阅读更多...
理解JESD204B链路参数 Understanding JESD204B Link Parameters

理解JESD204B链路参数 Understanding JESD204B Link Parameters

想要彻底理解参数意义要先看JESD协议标准原文&#xff0c;再看看这文章。这是我花了很久才意识到的道理&#xff0c;不过这篇文章对理解也有一定意义。 这个文章是我看的一篇英文文章的大体翻译&#xff0c;并不是逐行的。文章名《Understanding JESD204B Link Parameters》 L…
阅读更多...
推荐文章

Copyright @ 2022~2023