media player 狀態與方法

7.2.2  MediaPlayer的状态

音频和视频的播放过程也就是MediaPlayer对象的状态转换过程。深入理解MediaPlayer的状态机是灵活驾驭OPhone多媒体编程的基础。图7-3是MediaPlayer的状态图，其中MediaPlayer的状态用椭圆形标记，状态的切换由箭头表示，单箭头代表状态的切换是同步操作，双箭头代表状态的切换是异步操作。

1. 创建与销毁

MediaPlayer可以通过静态方法MediaPlayer.create()或者new操作符来创建。这两种方法创建的MediaPlayer对象处于的状态是不同的，使用create()方法创建的MediaPlayer对象处于prepared状态，因为系统已经根据参数的资源ID调用了setDataSource()和prepare()方法；使用new操作符创建的MediaPlayer对象则处于idle状态。除了刚刚构建的MediaPlayer对象处于idle状态外，调用reset()方法后的MediaPlayer状态也同样处于idle状态。由于处于idle状态的MediaPlayer还没有设置数据源，无法获得多媒体的时长、视频的高度等信息，因此现在调用下列方法是典型的编程错误。对于刚刚创建的MediaPlayer对象调用如下方法，底层系统不会调用MediaPlayer注册的OnErrorListener，MediaPlayer的状态也不会改变。对于通过调用reset()方法进入idle状态的MediaPlayer对象调用如下方法，则会导致底层系统调用OnErrorListener.onError()方法，MediaPlayer对象将进入error状态。

（点击查看大图）图7-3  MediaPlayer的状态图

getCurrentPosition()

getDruation()

getVideoWidth()

getVideoHeight()

setAudioStreamType()

setLooping()

setVolume()

pause()

start()

stop()

seekTo()

prepare()

prepareAsync()

对于不再需要的MediaPlayer对象，一定要通过调用release()方法使其进入到end状态，因为这关系到资源的释放问题。如果MediaPlayer对象不释放硬件加速器等资源，随后创建的MediaPlayer对象就无法使用这唯一的资源，甚至导致创建失败。处于end状态的MediaPlayer意味着它的生命周期终结，无法再回到其他状态了。

2. 初始化

在播放音频和视频之前必须对MediaPlayer进行初始化操作，这主要由两步工作完成。调用重载的setDataSource()方法将使MediaPlayer对象进入到initialized状态，随后调用prepare()或者prepareAsync()方法将使MediaPlayer对象进入到prepared状态。由于prepareAsync()方式是异步调用，因此通常为MediaPlayer注册OnPreparedListener()，并在onPrepare()方法中启动播放器。当MediaPlayer对象处于prepared状态时，意味着调用者已经可以获得多媒体的时长等信息，此时可以调用MediaPlayer的相关方法设置播放器的属性。例如，调用setVolume(float leftVolume, float rightVolume)设置播放器的音量。

3. 播放、暂停和停止

调用start()方法，MediaPlayer将进入到started状态。isPlaying()方法可以用来判断MediaPlayer是否处在started状态。当MediaPlayer从网络上播放多媒体文件时，可以通过onBufferingUpdateListener.onBufferingUpdate(MediaPlayer mp,int percent)来监听缓冲的进度，其中percent是0～100的整数，代表已经缓冲好的多媒体数据的百分比。

调用pause()方法，MediaPlayer将进入到paused状态。需要注意的是，从started到paused、从paused到started状态的转换是异步过程，也就是说，可能经过一段时间才能更新MediaPlayer的状态。在调用isPlaying()来查询播放器的状态时需要考虑这一点。

调用stop()方法，MediaPlayer将进入到stopped状态。一旦MediaPlayer进入stopped状态，必须再次调用prepare()或者prepareAsyn()才能使其进入到prepared状态，以便复用此MediaPlayer对象，再次播放多媒体文件。

4. 快进和快退

调用seekTo()方法可以调整MediaPlayer的媒体时间，以实现快退和快进的功能。seekTo()方法也是异步的，方法会立即返回，但是媒体时间调整的工作可能需要一段时间才能完成。如果为MediaPlayer设置了onSeekCompleteListener，那么onSeekComplete()方法将被调用。需要说明的一点是，seekTo()不仅可以在started状态下调用，还可以在paused、prepared和playbackCompleted状态下调用。

5. 播放结束状态

如果播放状态自然结束，MediaPlayer可能进入两种可能的状态。当循环播放模式设置为true时，MediaPlayer对象保持started状态不变；当循环播放模式设置为false时，MediaPlayer对象的onCompletionListener.onCompletion()方法会被调用，MediaPlayer对象进入到playbackCompleted状态。对于处于playbackCompleted状态的播放器，再次调用start()方法，将重新播放音/视频文件。需要注意的是，当播放器结束时，音/视频的时长、视频的尺寸信息依然可以通过调用getDuration()、getVideoWidth()和getVideoHeight()等方法获得。

6. 错误处理

在播放器播放音/视频文件时，可能发生各种各样的错误，比如IO错误、多媒体文件格式错误等。正确处理播放过程中的各种错误显得尤为重要。为了监听错误信息，可以为MediaPlayer对象注册onErrorListener监听器，当错误发生时，onErrorListener.onError()方法会被调用，MediaPlayer对象进入到error状态。如果希望复用MediaPlayer对象并从错误中恢复过来，那么可以调用reset()方法使MediaPlayer再次进入到idle状态。总之，监视MediaPlayer的状态是非常重要的，在错误发生之际提示用户，并恢复播放器的状态才是正确的处理方法。

除了上述的错误之外，如果在不恰当的时间调用了某方法，则会抛出IllegalStateException异常，在程序中应该使用try/catch块捕获到此类的编程错误。

至此，我们已经详细地介绍了MediaPlayer的状态图，下面通过一个具体的媒体播放器实例向读者介绍如何使用MediaPlayer的相关API。