Android MediaPlayer分析

首先介紹一下各種狀态:

明确一個概念,Idle(new MediaPlayer後)和End(MediaPlayer.reset()後)間的狀态是MediaPlayer的生命周期

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狀态。

狀态機

1. 當一個MediaPlayer對象被剛剛用new操作符建立或是調用了reset()方法後，它就處于Idle狀态。當調用了release()方法後，它就處于End狀态。這兩種狀态之間是MediaPlayer對象的生命周期。

    1)在一個新建構的MediaPlayer對象和一個調用了reset()方法的MediaPlayer對象之間有一個微小的但是十分重要的差别。

    在處于Idle狀态時，調用getCurrentPosition(), getDuration(), getVideoHeight(), getVideoWidth(), setAudioStreamType(int), setLooping(boolean), setVolume(float, float), pause(), start(), stop(), seekTo(int), prepare() 或者 prepareAsync() 方法都是程式設計錯誤。

    當一個MediaPlayer對象剛被建構的時候，内部的播放引擎和對象的狀态都沒有改變，在這個時候調用以上的那些方法，架構将無法回調用戶端程式注冊的OnErrorListener.onError()方法；

     但若這個MediaPlayer對象調用了reset()方法之後，再調用以上的那些方法，内部的播放引擎就會回調用戶端程式注冊的OnErrorListener.onError()方法了，并将錯誤的狀态傳入。

    2) 建議一旦一個MediaPlayer對象不再被使用，應立即調用release()方法來釋放在内部的播放引擎中與這個MediaPlayer對象關聯的資源。

        資源可能包括如硬體加速元件的單态元件，若沒有調用release()方法可能會導緻之後的MediaPlayer對象執行個體無法使用這種單态硬體資源，進而退回到軟體實作或運作失敗。一旦MediaPlayer對象進入了End狀态，它不能再被使用，也沒有辦法再遷移到其它狀态。

    3)此外，使用new操作符建立的MediaPlayer對象處于Idle狀态，而那些通過重載的create()便利方法建立的MediaPlayer對象卻不是處于Idle狀态。事實上，如果成功調用了重載的create()方法，那麼這些對象已經是Prepare狀态了。 

2. 在一般情況下，由于種種原因一些播放控制操作可能會失敗，如不支援的音頻/視訊格式，缺少隔行掃描的音頻/視訊，分辨率太高，流逾時等原因，等等。是以，錯誤報告和恢複在這種情況下是非常重要的。有時，由于程式設計錯誤，在處于無效狀态的情況下調用了一個播放控制操作可能發生。在所有這些錯誤條件下，内部的播放引擎會調用一個由用戶端程式員提供的OnErrorListener.onError()方法。用戶端程式員可以通過調用MediaPlayer.setOnErrorListener（android.media.MediaPlayer.OnErrorListener）方法來注冊OnErrorListener.

    1)一旦發生錯誤，MediaPlayer對象會進入到Error狀态。

    2) 為了重用一個處于Error狀态的MediaPlayer對象，可以調用reset()方法來把這個對象恢複成Idle狀态。

    3) 注冊一個OnErrorListener來獲知内部播放引擎發生的錯誤是好的程式設計習慣。

    4) 在不合法的狀态下調用一些方法，如prepare()，prepareAsync()和setDataSource()方法會抛出IllegalStateException異常。 

3. 調用setDataSource(FileDescriptor)方法，或setDataSource(String)方法，或setDataSource(Context，Uri)方法，或setDataSource(FileDescriptor，long，long)方法會使處于Idle狀态的對象遷移到Initialized狀态。

    1) 若當此MediaPlayer處于其它的狀态下，調用setDataSource()方法，會抛出IllegalStateException異常。

    2) 好的程式設計習慣是不要疏忽了調用setDataSource()方法的時候可能會抛出的IllegalArgumentException異常和IOException異常。 

4. 在開始播放之前，MediaPlayer對象必須要進入Prepared狀态。

    1) 有兩種方法（同步和異步）可以使MediaPlayer對象進入Prepared狀态：

    第一種是調用prepare()方法（同步），此方法傳回就表示該MediaPlayer對象已經進入了Prepared狀态；

    第二種是調用prepareAsync()方法（異步），此方法會使此MediaPlayer對象進入Preparing狀态并傳回，而内部的播放引擎會繼續未完成的準備工作。當同步版本傳回時或異步版本的準備工作完全完成時就會調用用戶端程式員提供的OnPreparedListener.onPrepared()監聽方法。可以調用MediaPlayer.setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)方法來注冊OnPreparedListener.

    2) Preparing是一個中間狀态，在此狀态下調用任何具備邊影響的方法的結果都是未知的！

    3) 在不合适的狀态下調用prepare()和prepareAsync()方法會抛出IllegalStateException異常。當MediaPlayer對象處于Prepared狀态的時候，可以調整音頻/視訊的屬性，如音量，播放時是否一直亮屏，循環播放等。 

5. 要開始播放，必須調用start()方法。當此方法成功傳回時，MediaPlayer的對象處于Started狀态。isPlaying()方法可以被調用來測試某個MediaPlayer對象是否在Started狀态。

     1) 當處于Started狀态時，内部播放引擎會調用用戶端程式員提供的OnBufferingUpdateListener.onBufferingUpdate()回調方法，此回調方法允許應用程式追蹤流播放的緩沖的狀态。

    2) 對一個已經處于Started 狀态的MediaPlayer對象調用start()方法沒有影響。

6. 播放可以被暫停，停止，以及調整目前播放位置。當調用pause()方法并傳回時，會使MediaPlayer對象進入Paused狀态。注意Started與Paused狀态的互相轉換在内部的播放引擎中是異步的。是以可能需要一點時間在isPlaying()方法中更新狀态，若在播放流内容，這段時間可能會有幾秒鐘。

    1) 調用start()方法會讓一個處于Paused狀态的MediaPlayer對象從之前暫停的地方恢複播放。當調用start()方法傳回的時候，MediaPlayer對象的狀态會又變成Started狀态。

    2) 對一個已經處于Paused狀态的MediaPlayer對象pause()方法沒有影響。

7. 調用stop()方法會停止播放，并且還會讓一個處于Started，Paused，Prepared或PlaybackCompleted狀态的MediaPlayer進入Stopped狀态。

    對一個已經處于Stopped狀态的MediaPlayer對象stop()方法沒有影響。

8. 調用seekTo()方法可以調整播放的位置。

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

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

9. 當播放到流的末尾，播放就完成了。

    1) 如果調用了setLooping(boolean)方法開啟了循環模式，那麼這個MediaPlayer對象會重新進入Started狀态。

    2) 若沒有開啟循環模式，那麼内部的播放引擎會調用用戶端程式員提供的OnCompletion.onCompletion()回調方法。可以通過調用MediaPlayer.setOnCompletionListener(OnCompletionListener)方法來設定。内部的播放引擎一旦調用了OnCompletion.onCompletion()回調方法，說明這個MediaPlayer對象進入了PlaybackCompleted狀态。

    3) 當處于PlaybackCompleted狀态的時候，可以再調用start()方法來讓這個MediaPlayer對象再進入Started狀态。