安卓MediaPlayer

1、androidMediaPlayerAPIMediaPlayer類可用于控制音頻/視頻文件或流的播放。關(guān)于如何使用這個類的方法還可以閱讀VideoView類的文檔。1 .狀態(tài)圖對播放音頻/視頻文件和流的控制是通過一個狀態(tài)機來管理的。下圖顯示一個MediaPlayer對象被支持的播放控制操作驅(qū)動的生命周期和狀態(tài)。橢圓代表MediaPlayer對象可能駐留的狀態(tài)。弧線表示驅(qū)動MediaPlayer在各個狀態(tài)之間遷移的播放控制操作。這里有兩種類型的弧線。由一個箭頭開始的弧代表同步的方法調(diào)用，而以雙箭頭開頭的代表的弧線代表異步方法調(diào)用。IdleresetQreleaseEndsetDataSource

2、QOnErrorListener.oiiErrorOErrorprepareAsyiicQPrepamigInitializedpiepaieQOiiPreparedListener.onPreparedOstartQprepareAsyncOStartedseekToQ/pauseQPausedstopQ(note:seekToQLoopuig=true&&playbackcompletesstart。pmbeginning)stopQPreparedtop。pauseOStoppedLoopuig=fMse&&onCompletionOinvokedonOn

3、CompletioiiListenerlaybackComplete通過這張圖，我們可以知道一個MediaPlayer對象有以下的狀態(tài)：1)當一個MediaPlayer對象被岡U剛用new操作符創(chuàng)建或是調(diào)用了reset()方法后，它就處于Idle狀態(tài)。當調(diào)用了release()方法后，它就處于End狀態(tài)。這兩種狀態(tài)之間是MediaPlayer對象的生命周期。1.1) 在一個新構(gòu)建的MediaPlayer對象和一個調(diào)用了reset()方法的MediaPlayer對象之間有一個微小的但是十分重要的差別。在處于Idle狀態(tài)時，調(diào)用getCurrentPosition(),getDuration(),

4、getVideoHeight(),getVideoWidth(),setAudioStreamType(int),setLooping(boolean),setVolume(float,float),pause(),start(),stop(),seekTo(int),prepare()或者prepareAsync()方法都是編程錯誤。當一個MediaPlayer對象剛被構(gòu)建的時候，內(nèi)部的播放引擎和對象的狀態(tài)都沒有改變，在這個時候調(diào)用以上的那些方法，框架將無法回調(diào)客戶端程序注冊的OnErrorListener.onError()方法；但若這個MediaPlayer對象調(diào)用了reset()方法之

5、后，再調(diào)用以上的那些方法，內(nèi)部的播放引擎就會回調(diào)客戶端程序注冊的OnErrorListener.onError()方法了，并將錯誤的狀態(tài)傳入。1.2) 我們建議，一旦一個MediaPlayer對象不再被使用，應(yīng)立即調(diào)用release()方法來釋放在內(nèi)部的播放引擎中與這個MediaPlayer對象關(guān)聯(lián)的資源。資源可能包括如硬件加速組件的單態(tài)組件，若沒有調(diào)用release()方法可能會導(dǎo)致之后的MediaPlayer對象實例無法使用這種單態(tài)硬件資源，從而退回到軟件實現(xiàn)或運行失敗。一旦MediaPlayer對象進入了End狀態(tài)，它不能再被使用，也沒有辦法再遷移到其它狀態(tài)。1.3) 此外，使用new操

6、作符創(chuàng)建的MediaPlayer對象處于Idle狀態(tài)，而那些通過重成功調(diào)用了重載的create()方法，那么這些對象已經(jīng)是Prepare狀態(tài)了。2)在一般情況下，由于種種原因一些播放控制操作可能會失敗，如不支持的音頻/視頻格式，缺少隔行掃描的音頻/視頻，分辨率太高，流超時等原因，等等。因此，錯誤報告和恢復(fù)在這種情況下是非常重要的。有時，由于編程錯誤，在處于無效狀態(tài)的情況下調(diào)用了一個播放控制操作可能發(fā)生。在所有這些錯誤條件下，內(nèi)部的播放引擎會調(diào)用一個由客戶端程序員提供的OnErrorListener.onError()方法?？蛻舳顺绦騿T可以通過調(diào)用MediaPlayer.setOnErrorLi

7、stener(android.media.MediaPlayer.OnErrorListener)方法來注冊O(shè)nErrorListener.1) 一旦發(fā)生錯誤，MediaPlayer對象會進入到Error狀態(tài)。1) 為了重用一個處于Error狀態(tài)的MediaPlayer對象，可以調(diào)用reset()方法來把這個對象恢復(fù)成Idle狀態(tài)。1) 注冊一個OnErrorListener來獲知內(nèi)部播放引擎發(fā)生的錯誤是好的編程習(xí)慣。1) 在不合法的狀態(tài)下調(diào)用一些方法，如prepare(),prepareAsync()和setDataSource()方法會拋出IllegalStateException異常。3

8、)調(diào)用setDataSource(FileDescriptor)方法，或setDataSource(String)方法，或setDataSource(Context,Uri)方法，或setDataSource(FileDescriptor,long,long)方法會使處于Idle狀態(tài)的對象遷移到Initialized狀態(tài)。方法，會拋出若當此MediaPlayer處于其它的狀態(tài)下，調(diào)用setDataSource()IllegalStateException異常。好的編程習(xí)慣是不要疏忽了調(diào)用setDataSource()方法的時候可能會拋出的IllegalArgumentException異常和I

9、OException異常。4)在開始播放之前，MediaPlayer對象必須要進入Prepared狀態(tài)。有兩種方法(同步和異步)可以使MediaPlayer對象進入Prepared狀態(tài)：要么調(diào)用prepare()方法(同步)，此方法返回就表示該MediaPlayer對象已經(jīng)進入了Prepared狀態(tài)；要么調(diào)用prepareAsync()方法(異步)，此方法會使此MediaPlayer對象進入Preparing狀態(tài)并返回，而內(nèi)部的播放引擎會繼續(xù)未完成的準備工作。當同步版本返回時或異步版本的準備工作完全完成時就會調(diào)用客戶端程序員提供的OnPreparedListener.onPrepared()監(jiān)

10、聽方法?？梢哉{(diào)用MediaPlayer.setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)方法來注冊O(shè)nPreparedListener.Preparing是一個中間狀態(tài)，在此狀態(tài)下調(diào)用任何具備邊影響的方法的結(jié)果都是未知的！在不合適的狀態(tài)下調(diào)用prepare()和prepareAsync()方法會拋出IllegalStateException異常。當MediaPlayer對象處于Prepared狀態(tài)的時候，可以調(diào)整音頻/視頻的屬性，如音量，播放時是否一直亮屏，循環(huán)播放等。于Started狀態(tài)。isPlaying

11、()方法可以被調(diào)用來測試某個MediaPlayer對象是否在Started狀態(tài)。當處于Started狀態(tài)時，內(nèi)部播放引擎會調(diào)用客戶端程序員提供的OnBufferingUpdateListener.onBufferingUpdate()回調(diào)方法，此回調(diào)方法允許應(yīng)用程序追蹤流播放的緩沖的狀態(tài)。對一個已經(jīng)處于Started狀態(tài)的MediaPlayer對象調(diào)用start()方法沒有影響。6)播放可以被暫停，停止，以及調(diào)整當前播放位置。當調(diào)用pause()方法并返回時，會使MediaPlayer對象進入Paused狀態(tài)。注意Started與Paused狀態(tài)的相互轉(zhuǎn)換在內(nèi)部的播放引擎中是異步的。所以可能需

12、要一點時間在isPlaying()方法中更新狀態(tài)，若在播放流內(nèi)容，這段時間可能會有幾秒鐘。調(diào)用start()方法會讓一個處于Paused狀態(tài)的MediaPlayer對象從之前暫停的地方恢復(fù)播放。當調(diào)用start()方法返回的時候，MediaPlayer對象的狀態(tài)會又變成Started狀態(tài)。對一個已經(jīng)處于Paused狀態(tài)的MediaPlayer對象pause()方法沒有影響。7)調(diào)用stop()方法會停止播放，并且還會讓一個處于Started,Paused,Prepared或PlaybackCompleted狀態(tài)的MediaPlayer進入Stopped狀態(tài)。8)調(diào)用seekTo()方法可以調(diào)整

13、播放的位置。seekTo(int)方法是異步執(zhí)行的，所以它可以馬上返回，但是實際的定位播放操作可能需要一段時間才能完成，尤其是播放流形式的音頻/視頻。當實際的定位播放操作完成之后，內(nèi)部的播放引擎會調(diào)用客戶端程序員提供的OnSeekComplete.onSeekComplete()回調(diào)方法。可以通過setOnSeekCompleteListener(OnSeekCompleteListener)方法注冊。注意，seekTo(int)方法也可以在其它狀態(tài)下調(diào)用，比如Prepared,Paused和PlaybackCompleted狀態(tài)。此外，目前的播放位置，實際可以調(diào)用getCurrentPosition()方法得到，它可以幫助如音樂播放器的應(yīng)用程序不斷更新播放進度9)當播放到流的末尾，播放就完成了。如果調(diào)用了setLooping(boolean)方法開啟了循環(huán)模式，那么這個MediaPlayer對象會重新進入Started狀態(tài)。若沒有開啟循環(huán)模式，那么內(nèi)部的播放引擎會調(diào)用客戶端程序員提供的OnCom