MediaPlayer類可用於控制音頻/視頻文件或流的播放

一、構造方法和公有方法

---

構造方法：

Public Constructors

MediaPlayer()

默認構造方法。

公有方法：

Public Methods

static MediaPlayer

create(Context context, Uri uri, SurfaceHolder holder)

指定從資源ID對應的資源文件中來裝載音樂文件，同時指定了SurfaceHolder對象並返回MediaPlyaer對象。

static MediaPlayer

create(Context context, int resid)

指定從資源ID對應的資源文件中來裝載音樂文件，並返回新創建的MediaPlyaer對象。

static MediaPlayer

create(Context context, Uri uri)

從指定Uri裝在音頻文件，並返回新創建的MediaPlayer對象。

int

getCurrentPosition()

獲取當前播放的位置。

int

getDuration()

獲取音頻的時長。

int

getVideoHeight()

獲取視頻的高度。

int

getVideoWidth()

獲取視頻的寬度。

boolean

isLooping()

判斷MediaPlayer是否正在循環播放。

boolean

isPlaying()

判斷MediaPlayer是否正在播放。

void

pause()

暫停播放。

void

prepare()

准備播放（裝載音頻），調用此方法會使MediaPlayer進入Prepared狀態。

void

prepareAsync()

准備播放異步音頻。

void

release()

釋放媒體資源。

void

reset()

重置MediaPlayer進入未初始化狀態。

void

seekTo(int msec)

尋找指定的時間位置。

void

setAudioStreamType(int streamtype)

設置音頻流的類型。

void

setDataSource(String path)

指定裝載path路徑所代表的文件。

void

setDataSource(Context context, Uri uri, Map

指定裝載uri所代表的文件。

void

setDataSource(Context context, Uri uri)

指定裝載uri所代表的文件。

void

setDataSource(FileDescriptor fd, long offset, long length)

指定裝載fd所代表的文件中從offset開始長度為length的文件內容。

void

setDataSource(FileDescriptor fd)

指定裝載fd所代表的文件。

void

setDisplay(SurfaceHolder sh)

設置顯示方式。

void

setLooping(boolean looping)

設置是否循環播放。

void

setNextMediaPlayer(MediaPlayer next)

設置當前流媒體播放完畢,下一個播放的MediaPlayer。

void

setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener)

注冊一個回調函數,在網絡視頻流緩沖變化時調用。

void

setOnCompletionListener(MediaPlayer.OnCompletionListener listener)

為Media Player的播放完成事件綁定事件監聽器。

void

setOnErrorListener(MediaPlayer.OnErrorListener listener)

為MediaPlayer的播放錯誤事件綁定事件監聽器。

void

setOnPreparedListener(MediaPlayer.OnPreparedListener listener)

當MediaPlayer調用prepare()方法時觸發該監聽器。

void

setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)

當MediaPlayer調用seek()方法時觸發該監聽器。

void

setOnVideoSizeChangedListener(MediaPlayer.OnVideoSizeChangedListener listener)

注冊一個用於監聽視頻大小改變的監聽器。

void

setScreenOnWhilePlaying(boolean screenOn)

置是否使用SurfaceHolder來顯示。

void

setSurface(Surface surface)

設置Surface。

void

setVideoScalingMode(int mode)

設置視頻縮放的模式。

void

setVolume(float leftVolume, float rightVolume)

設置播放器的音量。

void

setWakeMode(Context context, int mode)

為MediaPlayer設置低級電源管理行為。.

void

start()

開始或恢復播放。

void

stop()

停止播放。

二、常用方法分析：

---

1.使用進度條：

進度條SeekBar可以用來顯示播放進度，用戶也可以利用SeekBar的滑塊來控制音樂的播放。

SeekBar需要使用的一些方法：

setProgress（int value）：設置滑塊的位置方法為。

setMax(int value)：設置進度條的最大長度。

setOnSeekBarChangeListener(OnSeekBarChangeListener l)：設置SeekBar的進度改變事件。

MusicPlayer需要使用的一些方法:

getDuration()：獲得音樂長度為。

getCurrentPosition()：獲得現在播放的位置。

seekTo(int msec)：調用seekTo()方法可以調整播放的位置。

seekTo(int)方法是異步執行的，所以它可以馬上返回，但是實際的定位播放操作可能需要一段時間才能完成，尤其是播放流形式的音頻/視頻。當實際的定位播放操作完成之後，內部的播放引擎會調用客戶端程序員提供的OnSeekComplete.onSeekComplete()回調方法。可以通過setOnSeekCompleteListener(OnSeekCompleteListener)方法注冊。

seekTo(int)方法也可以在其它狀態下調用，比如Prepared，Paused和PlaybackCompleted狀態。此外，目前的播放位置，實際可以調用getCurrentPosition()方法得到，它可以幫助如音樂播放器的應用程序不斷更新播放進度。

創建並使用進度條的步驟：

第一步：創建一個進度條

 

//進度條

staticSeekBarskbMusic;

skbMusic=(SeekBar)findViewById(R.id.skbMusic);

第二步：為進度條的改變事件注冊並添加監聽器

 

skbMusic.setOnSeekBarChangeListener(sChangeListener);

/**

* SeekBar進度改變事件

*/

OnSeekBarChangeListenersChangeListener=newOnSeekBarChangeListener() {

@Override

public voidonStopTrackingTouch(SeekBar seekBar) {

//TODOAuto-generated method stub

//當拖動停止後，控制mediaPlayer播放指定位置的音樂

MusicService.mediaPlayer.seekTo(seekBar.getProgress());

MusicService.isChanging=false;

}

@Override

public voidonStartTrackingTouch(SeekBar seekBar) {

//TODOAuto-generated method stub

MusicService.isChanging=true;

}

@Override

public voidonProgressChanged(SeekBar seekBar,intprogress,

booleanfromUser) {

//TODOAuto-generated method stub

}

};

第三步：設置進度條的最大長度：

 

//getDuration()方法要在prepare()方法之後，否則會出現Attempt to call getDuration without a valid mediaplayer異常

MusicBox.skbMusic.setMax(mediaPlayer.getDuration());//設置SeekBar的長度

第四步：更新進度條

 

 

//----------定時器記錄播放進度---------//

mTimer =newTimer();

mTimerTask =newTimerTask() {

@Override

publicvoidrun() {

isTimerRunning=true;

if(isChanging==true)//當用戶正在拖動進度進度條時不處理進度條的的進度

return;

MusicBox.skbMusic.setProgress(mediaPlayer.getCurrentPosition());

}

};

//每隔10毫秒檢測一下播放進度

mTimer.schedule(mTimerTask, 0, 10);

 

2.裝載音頻文件：

為了讓MediaPlayer來裝載指定音頻文件，MediaPlayer提供了如下簡單的靜態方法。

static MediaPlayer create(Context context, Uri uri):從指定Uri來裝載音頻文件，並返回新創建的MediaPlayer對象。

static MediaPlayer create(Context context, int resid):從 resid資源 ID對應的資源文件中裝載音頻文件，並返回新創建的MediaPlayer對象。

提示：上而這兩個方法用起來非常方便，但這兩個方法每次都會返回新創建的MediaPlayer對象，如來程序需要使用MediaPlayer循環播放多個音頻文件，使用MediaPlayer的靜態create方法就不太合適了，此時可通過MediaPlayer的setDataSource()方法來裝載指定的音頻文件。MediaPlayer提供了如下方法來指定裝載相應的音頻文件。

setDataSource(String path):指定裝載path路徑所代表的文件。

setDataSource(FileDescriptor fd, long offset,long length)：指定裝載fd所代表的文件中從offset開始長度為length的文件內容。

setDataSource(FileDescriptor fd):指定裝載fd所代表的文件。

setDataSource(Context context, Uri uri):指定裝載uri所代表的文件。

提示：執行上面所示的setDataSource()方法之後，MediaPlayer並未真正去裝載那些音頻文件，還需要調用MediaPlayer的prepare()方法去准備音頻，所謂“准備”，就是讓MediaPlayer真正去裝載音頻文件。

使用已有的MediaPlayer對象裝載“一首”歌曲的代碼模板為：

 

mPlayer.reset();

//裝戰下一竹歌曲

mPlayer.setDataSource(M/mnt/sdcard/next.mp3);

//准備聲音 mPlayer.prepare();

"播放

mPlayer.start();

}

catch(IOException e)

e.printStackTrace();

}

MediaPlayer提供了一些綁定事件監聽器的方法，用於監聽MediaPlayer播放過程中所發生的特定事件，綁定事件監聽器的方法如下。3.與MediaPlayer有關的事件監聽器：

setOnCompletionListener(MediaPlayer.OnCompletionListener listener)：為 Media Player的播放完成事件綁定事件監聽器。

setOnErrorListener(MediaPlayer.OnErrorListener listener)：為MediaPlayer的播放錯誤事件綁定事件監聽器。

setOnPreparedListener(MediaPlayer.OnPreparedListener listener)：當 MediaPlayer調用prepare()方法時觸發該監聽器。

setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)：當MediaPlayer調用seek()方法時觸發該監聽器。

因此可以在創建一個MediaPlayer對象之後，通過為該MediaPlayer綁定監聽器來監聽相應的事件，例如如下代碼：

 

//為MediaPlayer的播放完成事件綁定事件監聽器

mPlayer.setOnErrorListener(newOnErrorListener() {

@Override

publicbooleanonError(MediaPlayer mp,intwhat,intextra) {

//TODOAuto-generated method stub

//針對錯誤進行相應的處理

// ... ...

}

});

//為MediaPlayer的播放完成講件綁定市件監聽器

mPlayer.setOnCompletionListener(newOnCompletionListener() {

@Override

publicvoidonCompletion(MediaPlayer mp) {

//TODOAuto-generated method stub

current++;

prepareAndPlay(current);

}

});

三、MediaPlayer播放不同來源的音頻文件：

---

1.播放應用的資源文件

播放應用的資源文件需要兩步即：

1) 調用MediaPlayer的create(Context context，int resid)方法加指定資源文件。

2) 調用 MediaPlayer的 start()、pause()、stop()等方法控制播放即可。

例如如下代碼:

 

MediaPlayer mPlayer=newMediaPlayer();

mPlayer.create(this, R.raw.music);

播放應用的資源文件按如下步驟執行。2. 播放應用的原始資源文件

1) 調用 Context的 getAssets()方法獲取應用的 AssetManager。

2) 調用AssetManager對象的openFd(String name)方法打開指定的原生資源，該方法返回一個AssetFileDescriptor對象。

3) 調用 AssetFileDescriptor的 getFileDescriptor()、getStartOffset()和 getLength()方法來獲取音頻文件的FileDescriptor、開始位置、長度等。

4) 創建MediaPlayer對象(或利用已有的MediaPlayer對象)，並調用MediaPlayer對象的setDataSource(FileDescriptor fd，long offset, long length)方法來裝載音頻資源。

5) 調用MediaPlayer對象的prepare()方法准備音頻。

6) 調用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代碼片段：

 

/獲取assets目錄下指定文件的AssetFileDescriptor對象

AssetFileDescriptor assetFileDescriptor=assetManager.openFd(musics[current]);

mediaPlayer.reset();//初始化mediaPlayer對象

mediaPlayer.setDataSource(assetFileDescriptor.getFileDescriptor(), assetFileDescriptor.getStartOffset(), assetFileDescriptor.getLength());

//准備播放音樂

mediaPlayer.prepare();

//播放音樂

mediaPlayer.start();

 

播放外部存儲器上音頻文件按如下步驟執行。

1) 創建MediaPlayer對象(或利用已有的MediaPlayer對象)，並調用MediaPlayer對象的setDateSource(String path)方法裝載指定的音頻文件。

2) 調用MediaPlayer對象的prepare()方法准備音頻。

3) 調用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代碼：

 

//加載SD卡上的指定資源音頻文件

mPlayer.setDataSource("/mnt/You Are The One.mp3");

mPlayer.prepare();//准備因音頻

mPlayer.start();//播放音頻

播放來自網絡的音頻文件冇兩種方式：1.直接使用MediaPlayer的靜態create(Context context, Uri uri)方法；2.調用 MediaPlayer的setDataSource(Context context,Uri uri)裝載指定Uri對應的音頻文件。4.播放來自網絡的音頻文件

以第二種方式播放來自網絡的音頻文件的步驟如下。

1. 根據網絡上的音頻文件所在的位置創建Uri對象。

2. 創建MediaPlayer對象(或利用己有的MediaPlayer對象)，並調用MediaPlayer對象的 setDateSource(Context context,Uri uri)方法裝載Uri對應的音頻文件。

3. 調用MediaPlayer對象的prepare()方法准備音頻。

4. 調用MediaPlayer的start()、pause()、stop()等方法控制播放即可。

例如如下代碼片段：

 

Uri uri = Uri.parse("http://play.baidu.com/heihei.mp3");

MediaPlayer mPlayer =newMediaPlayer();

//使用MediaPlayer根據Uri來加載指定的聲音文件

mPlayer.setDataSource(this, uri);

mPlayer.prepare();//准備因音頻

mPlayer.start();//播放音頻

四、解析MdiaPlayer的狀態圖MediaPlayer除了調用prepare()方法來准備聲音之外，還以調用prepareAsync()來准備聲音，prepareAsync()與普通prepare()方法的區別在於，prepareAsync()是異步的，它不會阻塞當前的UI線程。

---

 

這張狀態轉換圖清晰的描述了MediaPlayer的各個狀態，也列舉了主要的方法的調用時序，每種方法只能在一些特定的狀態下使用，如果使用時MediaPlayer的狀態不正確則會引發IllegalStateException異常。

 

Idle狀態：當使用new()方法創建一個MediaPlayer對象或者調用了其reset()方法時，該MediaPlayer對象處於idle狀態。這兩種方法的一個重要差別就是：如果在這個狀態下調用了getDuration()等方法（相當於調用時機不正確），通過reset()方法進入idle狀態的話會觸發OnErrorListener.onError()，並且MediaPlayer會進入Error狀態；如果是新創建的MediaPlayer對象，則並不會觸發onError(),也不會進入Error狀態。

 

End狀態：通過release()方法可以進入End狀態，只要MediaPlayer對象不再被使用，就應當盡快將其通過release()方法釋放掉，以釋放相關的軟硬件組件資源，這其中有些資源是只有一份的（相當於臨界資源）。如果MediaPlayer對象進入了End狀態，則不會在進入任何其他狀態了。

 

Initialized狀態：這個狀態比較簡單，MediaPlayer調用setDataSource()方法就進入Initialized狀態，表示此時要播放的文件已經設置好了。

 

Prepared狀態：初始化完成之後還需要通過調用prepare()或prepareAsync()方法，這兩個方法一個是同步的一個是異步的，只有進入Prepared狀態，才表明MediaPlayer到目前為止都沒有錯誤，可以進行文件播放。

 

Preparing狀態：這個狀態比較好理解，主要是和prepareAsync()配合，如果異步准備完成，會觸發OnPreparedListener.onPrepared()，進而進入Prepared狀態。

 

Started狀態：顯然，MediaPlayer一旦准備好，就可以調用start()方法，這樣MediaPlayer就處於Started狀態，這表明MediaPlayer正在播放文件過程中。可以使用isPlaying()測試MediaPlayer是否處於了Started狀態。如果播放完畢，而又設置了循環播放，則MediaPlayer仍然會處於Started狀態，類似的，如果在該狀態下MediaPlayer調用了seekTo()或者start()方法均可以讓MediaPlayer停留在Started狀態。

 

Paused狀態：Started狀態下MediaPlayer調用pause()方法可以暫停MediaPlayer，從而進入Paused狀態，MediaPlayer暫停後再次調用start()則可以繼續MediaPlayer的播放，轉到Started狀態，暫停狀態時可以調用seekTo()方法，這是不會改變狀態的。

 

Stop狀態：Started或者Paused狀態下均可調用stop()停止MediaPlayer，而處於Stop狀態的MediaPlayer要想重新播放，需要通過prepareAsync()和prepare()回到先前的Prepared狀態重新開始才可以。

 

PlaybackCompleted狀態：文件正常播放完畢，而又沒有設置循環播放的話就進入該狀態，並會觸發OnCompletionListener的onCompletion()方法。此時可以調用start()方法重新從頭播放文件，也可以stop()停止MediaPlayer，或者也可以seekTo()來重新定位播放位置。

 

Error狀態：如果由於某種原因MediaPlayer出現了錯誤，會觸發OnErrorListener.onError()事件，此時MediaPlayer即進入Error狀態，及時捕捉並妥善處理這些錯誤是很重要的，可以幫助我們及時釋放相關的軟硬件資源，也可以改善用戶體驗。通過setOnErrorListener(android.media.MediaPlayer.OnErrorListener)可以設置該監聽器。如果MediaPlayer進入了Error狀態，可以通過調用reset()來恢復，使得MediaPlayer重新返回到Idle狀態。