MediaPlayer

最新推荐文章于 2024-05-06 12:41:47 发布

翻译最新推荐文章于 2024-05-06 12:41:47 发布 · 547 阅读

文章标签：

#mediaplayer

音视频开发专栏收录该内容

32 篇文章

订阅专栏

MediaPlayer的继承关系：
public class MediaPlayer
extends Object implements VolumeAutomation

java.lang.Object
↳ android.media.MediaPlayer

MediaPlayer class can be used to control playback of audio/video files and streams. An example on how to use the methods in this class can be found in VideoView.

MediaPlayer类可用于控制音频/视频文件和流的播放。在VideoView中可以找到有关如何使用此类中的方法的示例。

Playback control of audio/video files and streams is managed as a state machine. The following diagram shows the life cycle and the states of a MediaPlayer object driven by the supported playback control operations. The ovals represent the states a MediaPlayer object may reside in. The arcs represent the playback control operations that drive the object state transition. There are two types of arcs. The arcs with a single arrow head represent synchronous method calls, while those with a double arrow head represent asynchronous method calls.

下面图表表现出来生命周期和MediaPlayer类的控制操作，椭圆体描述了MediaPlayer 类的状态，弧线描述了重放控制的运作，有两种箭头，单箭头的弧线代表同步方法的调用，爽箭头代表异步方法的调用。
这里写图片描述

从这个图我们可以看出MediaPlayer类有如下的状态：

当一个 MediaPlayer类刚用new或者在reset()调用后创建，这时处于空闲状态，在release() 调用后则处于结束状态，在这两个状态之间就是MediaPlaye的生命周期。

新创建的MediaPlayer类和调用reset()后的MediaPlayer类，有着很微妙但很重要的区别：
在空闲状态调用诸如getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamType(int),setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(int), prepare() or prepareAsync()会报错。
如果这些方法在MediaPlayer类正确创建以后，内部播放组件和类的状态变化不能够调用回调方法OnErrorListener.onError() 。但是，这些方法在reset()后被正确调用的话，内部播放组件就会调用用户提供的回调方法OnErrorListener.onError()，并且类的状态也会转为Error 状态。
一旦MediaPlayer类很长时间不被用到，则立即调用release()，使与MediaPlayer类关联的内部播放组件所用到的资源能够立即被释放。一旦MediaPlayer类处于end状态，那样的话MediaPlayer类就无法在被用到了，也不能够回到其他任何状态。
此外，MediaPlayer类用new创建处于空闲状态，当用create创建时MediaPlayer类不在空闲状态，事实上当成功调用create方法调用时，这个对象已经处于Prepared 状态了。

总之，一些播放控制操作会失败是有很多原因的，比如不支持的audio/video格式，不完整的audio/video,分辨率太高，流超时等等。因此在这些情况下，错误报告和恢复很是重要。通常在无效的状态下调用一个播放控制会导致程序错误。在所有错误的情况下，内部播放组件调用用户提供的OnErrorListener.onError() 方法，前提是OnErrorListener（）被事先用setOnErrorListener(android.media.MediaPlayer.OnErrorListener)注册过。

一旦错误发生记录错误是很重要的，MediaPlayer类进入Error 状态，即使error监听病没有在应用中注册。
为了重新使用在错误状态的MediaPlayer类和从错误中恢复，可以调用reset()恢复这个类到空闲状态。
在应用中注册OnErrorListener去发现内部播放组件的错误通知是很好的程序设计惯例。
抛出IllegalStateException去防止程序错误：如调用prepare()和prepareAsync(),或者在无效超载状态调用setDataSource().

MediaPlayer类在播放之前要首先进入Prepared状态，有两种方法可以到达Prepared状态（异步方法和同步方法）。

一旦调用prepare()方法，类就进入Prepared状态，调用prepareAsync()方法，直到处于休息状态内部播放组件完成准备工作之前类一直处于Preparing状态。当准备工作完成或者调用prepare()时，内部播放组件会调用用户提供的回调方法：OnPreparedListener接口的onPrepared() 方法，前提是OnPreparedListener 被事先用setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener) 注册）这时类进入Prepared状态。

当调用start()方法成功后，MediaPlayer类进入Started状态。

内部播放组件会调用OnBufferingUpdateListener.onBufferingUpdate() 回调方法，前提是
OnBufferingUpdateListener被事先用setOnBufferingUpdateListener(OnBufferingUpdateListener)注册。这个回调方法允许应用跟踪缓存状态。

当调用seekTo(int),播放的位置就可以被调整。

调用seekTo(int)时，实际的寻求工作需要一段时间去完成，特别是视频或者是音频正在播放的时候。当实际的寻求工作完成时会调用OnSeekComplete.onSeekComplete()，如果OnSeekCompleteListener提前用setOnSeekCompleteListener(OnSeekCompleteListener).注册过。
需要注意的是，seekTo(int)可以在其他的状态调用，例如 Prepared, Paused andPlaybackCompleted s这些状态。
此外，用getCurrentPosition(),方法可以找到当前的播放位置。这个对应用很有帮助，例如音乐播放器需要跟踪播放进度的时候。

当播放到达数据流的末尾，播放就完成了。

如果循环模式设置了setLooping(ture)，那么MediaPlayer类保持Started状态。
如果循环模式设置为false，播放组件就会调用OnCompletion.onCompletion(),前提是OnCompletionListener提前用 setOnCompletionListener(OnCompletionListener)注册过，这时类进入PlaybackCompleted 状态。
当进入PlaybackCompleted 状态，调用start()方法，就会在音频和视频源的开头重新开始播放。