1.状态图
对播放音频/视频文件和流的控制是通过一个状态机来管理的。
下图显示一个MediaPlayer对象被支持的播放控制操作驱动的生命周期和状态。椭圆代表MediaPlayer对象可能驻留的状态。弧线表示驱动MediaPlayer在各个状态之间迁移的播放控制操作。这里有两种类型的弧线。
由一个箭头開始的弧代表同步的方法调用。而以双箭头开头的代表的弧线代表异步方法调用。
通过这张图,我们能够知道一个MediaPlayer对象有下面的状态:
1)当一个MediaPlayer对象被刚刚用new操作符创建或是调用了reset()方法后,它就处于Idle状态。当调用了release()方法后。它就处于End状态。这两种状态之间是MediaPlayer对象的生命周期。
1.1) 在一个新构建的MediaPlayer对象和一个调用了reset()方法的MediaPlayer对象之间有一个微小的可是十分重要的区别。
在处于Idle状态时。调用getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamType(int), setLooping(boolean), setVolume(float,
float), pause(), start(), stop(), seekTo(int), prepare() 或者 prepareAsync() 方法都是编程错误。当一个MediaPlayer对象刚被构建的时候。内部的播放引擎和对象的状态都没有改变,在这个时候调用以上的那些方法,框架将无法回调client程序注冊的OnErrorListener.onError()方法;但若这个MediaPlayer对象调用了reset()方法之后,再调用以上的那些方法。内部的播放引擎就会回调client程序注冊的OnErrorListener.onError()方法了,并将错误的状态传入。
1.2) 我们建议,一旦一个MediaPlayer对象不再被使用,应马上调用release()方法来释放在内部的播放引擎中与这个MediaPlayer对象关联的资源。
资源可能包含如硬件加速组件的单态组件。若没有调用release()方法可能会导致之后的MediaPlayer对象实例无法使用这样的单态硬件资源,从而退回到软件实现或执行失败。
一旦MediaPlayer对象进入了End状态。它不能再被使用。也没有办法再迁移到其他状态。
1.3) 此外,使用new操作符创建的MediaPlayer对象处于Idle状态,而那些通过重载的create()便利方法创建的MediaPlayer对象却不是处于Idle状态。其实。假设成功调用了重载的create()方法。那么这些对象已经是Prepare状态了。
2) 在普通情况下,因为种种原因一些播放控制操作可能会失败,如不支持的音频/视频格式,缺少隔行扫描的音频/视频,分辨率太高,流超时等原因,等等。
因此,错误报告和恢复在这样的情况下是很重要的。有时,因为编程错误。在处于无效状态的情况下调用了一个播放控制操作可能发生。
在全部这些错误条件下,内部的播放引擎会调用一个由client程序猿提供的OnErrorListener.onError()方法。client程序猿能够通过调用MediaPlayer.setOnErrorListener(android.media.MediaPlayer.OnErrorListener)方法来注冊OnErrorListener.
2.1) 一旦错误发生。MediaPlayer对象会进入到Error状态。
2.2) 为了重用一个处于Error状态的MediaPlayer对象,能够调用reset()方法来把这个对象恢复成Idle状态。
2.3) 注冊一个OnErrorListener来获知内部播放引擎发生的错误是好的编程习惯。
2.4) 在不合法的状态下调用一些方法。如prepare()。prepareAsync()和setDataSource()方法会抛出IllegalStateException异常。
3) 调用setDataSource(FileDescriptor)方法,或setDataSource(String)方法,或setDataSource(Context,Uri)方法。或setDataSource(FileDescriptor。long,long)方法会使处于Idle状态的对象迁移到Initialized状态。
3.1) 若当此MediaPlayer处于其他的状态下,调用setDataSource()方法。会抛出IllegalStateException异常。
3.2) 好的编程习惯是不要疏忽了调用setDataSource()方法的时候可能会抛出的IllegalArgumentException异常和IOException异常。
4)
在開始播放之前,MediaPlayer对象必需要进入Prepared状态。
4.1) 有两种方法(同步和异步)能够使MediaPlayer对象进入Prepared状态:要么调用prepare()方法(同步),此方法返回就表示该MediaPlayer对象已经进入了Prepared状态;要么调用prepareAsync()方法(异步),此方法会使此MediaPlayer对象进入Preparing状态并返回,而内部的播放引擎会继续未完毕的准备工作。当同步版本号返回时或异步版本号的准备工作全然完毕时就会调用client程序猿提供的OnPreparedListener.onPrepared()监听方法。能够调用MediaPlayer.setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)方法来注冊OnPreparedListener.
4.2) Preparing是一个中间状态,在此状态下调用不论什么具备边影响的方法的结果都是未知的!
4.3) 在不合适的状态下调用prepare()和prepareAsync()方法会抛出IllegalStateException异常。当MediaPlayer对象处于Prepared状态的时候。能够调整音频/视频的属性。如音量。播放时是否一直亮屏,循环播放等。
5)
要開始播放,必须调用start()方法。当此方法成功返回时,MediaPlayer的对象处于Started状态。
isPlaying()方法能够被调用来測试某个MediaPlayer对象是否在Started状态。
5.1) 当处于Started状态时,内部播放引擎会调用client程序猿提供的OnBufferingUpdateListener.onBufferingUpdate()回调方法,此回调方法同意应用程序追踪流播放的缓冲的状态。
5.2) 对一个已经处于Started 状态的MediaPlayer对象调用start()方法没有影响。
6)
播放能够被暂停。停止,以及调整当前播放位置。
当调用pause()方法并返回时。会使MediaPlayer对象进入Paused状态。注意Started与Paused状态的相互转换在内部的播放引擎中是异步的。所以可能须要一点时间在isPlaying()方法中更新状态,若在播放流内容,这段时间可能会有几秒钟。
6.1) 调用start()方法会让一个处于Paused状态的MediaPlayer对象从之前暂停的地方恢复播放。当调用start()方法返回的时候,MediaPlayer对象的状态会又变成Started状态。
6.2) 对一个已经处于Paused状态的MediaPlayer对象pause()方法没有影响。
7)
调用stop()方法会停止播放,而且还会让一个处于Started,Paused,Prepared或PlaybackCompleted状态的MediaPlayer进入Stopped状态。
7.1) 对一个已经处于Stopped状态的MediaPlayer对象stop()方法没有影响。
8)
调用seekTo()方法能够调整播放的位置。
8.1) seekTo(int)方法是异步运行的,所以它能够立即返回。可是实际的定位播放操作可能须要一段时间才干完毕,尤其是播放流形式的音频/视频。当实际的定位播放操作完毕之后,内部的播放引擎会调用client程序猿提供的OnSeekComplete.onSeekComplete()回调方法。能够通过setOnSeekCompleteListener(OnSeekCompleteListener)方法注冊。
8.2) 注意,seekTo(int)方法也能够在其他状态下调用,比方Prepared,Paused和PlaybackCompleted状态。此外,眼下的播放位置。实际能够调用getCurrentPosition()方法得到,它能够帮助如音乐播放器的应用程序不断更新播放进度
9)
当播放到流的末尾。播放就完毕了。
9.1) 假设调用了setLooping(boolean)方法开启了循环模式。那么这个MediaPlayer对象会又一次进入Started状态。
9.2) 若没有开启循环模式。那么内部的播放引擎会调用client程序猿提供的OnCompletion.onCompletion()回调方法。
能够通过调用MediaPlayer.setOnCompletionListener(OnCompletionListener)方法来设置。
内部的播放引擎一旦调用了OnCompletion.onCompletion()回调方法,说明这个MediaPlayer对象进入了PlaybackCompleted状态。
9.3) 当处于PlaybackCompleted状态的时候,能够再调用start()方法来让这个MediaPlayer对象再进入Started状态。