Android 原生 MediaPlayer 和 MediaCodec 的區別和聯系（二）

目錄：

　　（3）Android 官方網站 對 MediaPlayer的介紹

正文：

　　  Android 官方網站 對 MediaPlayer的介紹        

        MediaPlayer     　　public class MediaPlayer      　　extends Object implements VolumeAutomation, AudioRouting           MediaPlayer類被用來控制音/視頻檔案和流的播放，可以在VideoView中找到有關如何使用此類中的方法的示例，         這里涉及的主題是：         1. 狀態圖         2. 有效和無效狀態         3. 權限         4. 注冊資訊和錯誤回呼                  ★ 開發者指南              有關如何使用MediaPlayer的更多資訊，請閱讀Media Playback開發人員指南，           狀態圖         音/視頻檔案和流的播放控制是作為一個狀態機來進行管理，下圖顯示了受支持的播放控制操作驅動的MediaPlayer物件的生命周期和狀態， 橢圓表示MediaPlayer物件可能駐留的狀態，弧表示驅動物件狀態轉換的播放控制操作，有兩種型別的弧， 單箭頭的弧表示同步方法呼叫，而雙箭頭的弧表示異步方法呼叫，                   　　     　　從這個狀態圖中，可以看到MediaPlayer物件具有以下狀態：

• 當使用 new 創建MediaPlayer物件或者在呼叫 reset() 之后，它處于空閑狀態; 并且在呼叫 release() 之后，它處于 End 狀態， 在這兩個狀態之間是MediaPlayer物件的生命周期，

            1. 一個新構造的 MediaPlayer 物件 和 呼叫 reset() 方法后的MediaPlayer物件之間存在微妙但重要的區別，針對這兩種情況的空閑狀態下呼叫諸如 getCurrentPosition(), getDuration(), getVideoHeight(),getVideoWidth(),setAudioAttributes(AudioAttributes), setLooping(boolean),setVolume(float, float),pause(), start(), stop(), seekTo(long, int), prepare() or prepareAsync() 方法是程式設計錯誤，如果在一個 MediaPlayer 物件被構造后任意呼叫這些方法，則內部播放引擎不會呼叫用戶提供的回呼方法OnErrorListener.onError()，并且該物件狀態保持不變；但是如果這些方法是在reset()后被呼叫，則內部播放引擎將呼叫用戶提供的回呼方法OnErrorListener.onError()，并且該物件將被轉換為 Error 狀態，             2. 還建議一旦不再使用MediaPlayer物件，立即呼叫release()，以便可以立即釋放與MediaPlayer物件關聯的內部播放器引擎使用的資源， 資源可能包括單一資源（如硬體加速組件）和呼叫release（）失敗可能導致MediaPlayer物件的后續實體回退到軟體實作或完全失敗（？）， 一旦MediaPlayer物件處于End狀態，就無法再使用它，也無法將其恢復到任何其他狀態，             3. 此外，使用new創建的MediaPlayer物件處于空閑狀態，而使用其中一個多載的方便的創建方法創建的物件不處于空閑狀態， 實際上，如果使用create方法創建成功，則物件處于Prepared狀態，

• 通常，一些播放控制操作可能由于各種原因而失敗，例如不支持的音頻／視頻格式，交錯的音頻／視頻，解析度太高，流超時等，因此，在這些情況下，關注錯誤報告和恢復是非常重要的，有時，由于編程錯誤，也可能在無效狀態下呼叫播放控制操作，在所有這些錯誤條件下，如果開發者事先通過setOnErrorListener(android.media.MediaPlayer.OnErrorListener)注冊了 one rrorListener ，則內部播放器引擎會呼叫開發者提供的 one rrorListener.onError() 方法，

            1. 重要的是要注意，一旦發生錯誤，MediaPlayer物件就會進入錯誤狀態（Error state）（除非如上所述），即使應用程式尚未注冊錯誤監聽器也是如此，             2. 為了重用處于錯誤狀態的MediaPlayer物件并從錯誤中恢復，可以呼叫reset()將物件恢復到其空閑狀態（Idle state），             3. 讓應用程式注冊OnErrorListener以查找內部播放器引擎的錯誤通知是一種很好的編程習慣，             4. 呼叫譬如 prepare(),prepareAsync()時，或者一個在無效狀態（Idle state）重寫的 setDataSource  方法時，拋出IllegalStateException 可以防止編程錯誤，

• 呼叫 setDataSource(FileDescriptor), 或 setDataSource(String), 或 setDataSource(Context, Uri), 或 setDataSource(FileDescriptor, long, long), 或 setDataSource(MediaDataSource) 

           將一個 MediaPlayer 物件從空閑狀態（Idle state） 轉換為 初始狀態（Initialized state），             1. 如果在任何其他狀態下呼叫 setDataSource() ，則拋出 IllegalStateException，             2. 關注從多載的 setDataSource 方法 可能會拋出 IllegalArgumentException 和 IOException 是一種很好的編程習慣，

• 在開始播放之前，MediaPlayer 物件必須先進入準備狀態，

            1. 有兩種方法（同步與異步）可以達到Prepared狀態（Prepared state）：呼叫prepare()（同步），一旦方法呼叫回傳就將物件轉換為Prepared狀態（Prepared state），或者呼叫prepareAsync()（ 異步），它在呼叫回傳后首先將物件轉換為Preparation狀態（Preparing state）（幾乎正確地發生），同時內部播放器引擎繼續處理其余的準備作業，直到準備作業完成， 當準備完成或者prepare() 呼叫回傳時，如果事先通過setOnPreparedListener（android.media.MediaPlayer.OnPreparedListener）注冊了OnPreparedListener，則內部播放器引擎會呼叫開發者提供的OnPreparedListener介面的回呼方法onPrepared（），             2. 重要的是要注意，準備狀態是暫時狀態，并且在MediaPlayer物件處于準備狀態時呼叫任何具有副作用的方法的行為是未定義的，             3. 在任何其他狀態呼叫 prepare() 或 prepareAsync() ，則拋出 IllegalStateException，             4. 在Prepared狀態（Prepared state）下，可以通過呼叫相應的set方法來調整音頻/音量，screenOnWhilePlaying，回圈等屬性，

• 要開始播放，必須呼叫 start() ，start() 回傳成功后，MediaPlayer物件則處于 Started狀態（Started state），isPlaying()可用來測驗  MediaPlayer物件是否處于 Started狀態（Started state），

            1. 處于Started狀態（Started state）時，如果事先通過 setOnBufferingUpdateListener(OnBufferingUpdateListener)注冊了OnBufferingUpdateListener，則內部播放器引擎會呼叫用戶提供的.OnBufferingUpdateListener.onBufferingUpdate() 回呼方法， 此回呼允許應用程式在流式傳輸音頻/視頻時跟蹤緩沖狀態，             2. 呼叫 start() 對已處于Started狀態的MediaPlayer物件沒有影響，

• 播放可以暫停和停止，并可以調整當前播放位置， 可以通過pause()暫停播放， 當對pause()的呼叫回傳時，MediaPlayer物件進入Paused狀態（Pausedstate）， 請注意，從“已啟動”狀態（Started state）到“暫停”狀態（Paused state）的轉換（反之亦然）在播放器引擎中異步發生， 在呼叫isPlaying()時更新狀態可能需要一些時間，對于流內容，它可能需要幾秒鐘，

            1. 呼叫start()以恢復暫停的MediaPlayer物件的播放，并且恢復的播放位置與暫停的位置相同， 當對start()的呼叫回傳時，暫停的MediaPlayer物件將回傳到Started狀態（Started state），             2. 呼叫pause()對已處于Paused狀態的MediaPlayer物件沒有影響，

• 呼叫stop()會停止播放并導致處于Started，Paused，Prepared或PlaybackCompleted狀態（state）的MediaPlayer進入Stopped狀態（Stopped state），

            1. 一旦處于Stopped狀態（Stopped state），在呼叫prepare()或prepareAsync()以將MediaPlayer物件再次設定為Prepared狀態（Prepared state）之前，無法啟動播放，             2. 呼叫stop()對已處于Stopped狀態（Stopped state）的MediaPlayer物件沒有影響，

• 可以通過呼叫seekTo(long, int)調整播放位置

            1. 盡管異步seekTo(long, int)呼叫立即回傳，但實際的尋位操作可能需要一段時間才能完成，特別是對于流式傳輸的音頻/視頻， 當實際尋位操作完成時，如果事先通過setOnSeekCompleteListener(OnSeekCompleteListener)注冊了OnSeekCompleteListener，則內部播放器引擎會呼叫開發者提供的OnSeekComplete.onSeekComplete() ，             2. 請注意，seekTo(long, int)也可以在其他狀態中呼叫，例如Prepared，Paused和PlaybackCompleted狀態（state）， 當在這些狀態中呼叫seekTo(long, int)時，如果流具有視頻且請求的位置有效，則將顯示一個視頻幀，             3. 此外，可以通過呼叫getCurrentPosition()來檢索實際當前播放位置，這對于需要跟蹤播放進度的音樂播放器等應用程式很有幫助，

• 當播放到達流的結尾時，播放完成，

            1. 如果使用setLooping(boolean)將回圈模式設定為true，則MediaPlayer物件應保持為Started狀態（Started state），             2. 如果回圈模式設定為false，則播放器引擎呼叫開發者提供的回呼方法OnCompletion.onCompletion()，如果事先通過 setOnCompletionListener(OnCompletionListener)注冊了OnCompletionListener， 呼叫回呼信號表示物件現在處于PlaybackCompleted狀態（PlaybackCompleted state），             3. 在PlaybackCompleted狀態（PlaybackCompleted state）下，呼叫start()可以從音頻/視頻源的開頭重新開始播放，           有效和無效狀態     

Method Name	Valid Sates	Invalid States	Comments
attachAuxEffect	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Error}	This method must be called after setDataSource. Calling it does not change the object state.
getAudioSessionId	any	{}	This method can be called in any state and calling it does not change the object state.
getCurrentPosition	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getDuration	{Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getVideoHeight	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getVideoWidth	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
isPlaying	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
pause	{Started, Paused, PlaybackCompleted}	{Idle, Initialized, Prepared, Stopped, Error}	Successful invoke of this method in a valid state transfers the object to the Paused state. Calling this method in an invalid state transfers the object to the Error state.
prepare	{Initialized, Stopped}	{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Prepared state. Calling this method in an invalid state throws an IllegalStateException.
prepareAsync	{Initialized, Stopped}	{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Preparing state. Calling this method in an invalid state throws an IllegalStateException.
release	any	{}	After release(), the object is no longer available.
reset	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	{}	After reset(), the object is like being just created.
seekTo	{Prepared, Started, Paused, PlaybackCompleted}	{Idle, Initialized, Stopped, Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
setAudioAttributes	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method does not change the state. In order for the target audio attributes type to become effective, this method must be called before prepare() or prepareAsync().
setAudioSessionId	{Idle}	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	This method must be called in idle state as the audio session ID must be known before calling setDataSource. Calling it does not change the object state.
setAudioStreamType (deprecated)	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method does not change the state. In order for the target audio stream type to become effective, this method must be called before prepare() or prepareAsync().
setAuxEffectSendLevel	any	{}	Calling this method does not change the object state.
setDataSource	{Idle}	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Initialized state. Calling this method in an invalid state throws an IllegalStateException.
setDisplay	any	{}	This method can be called in any state and calling it does not change the object state.
setSurface	any	{}	This method can be called in any state and calling it does not change the object state.
setVideoScalingMode	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Error}	Successful invoke of this method does not change the state.
setLooping	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
isLooping	any	{}	This method can be called in any state and calling it does not change the object state.
setOnBufferingUpdateListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnCompletionListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnErrorListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnPreparedListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnSeekCompleteListener	any	{}	This method can be called in any state and calling it does not change the object state.
setPlaybackParams	{Initialized, Prepared, Started, Paused, PlaybackCompleted, Error}	{Idle, Stopped}	This method will change state in some cases, depending on when it's called.
setScreenOnWhilePlaying	any	{}	This method can be called in any state and calling it does not change the object state.
setVolume	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method does not change the state.
setWakeMode	any	{}	This method can be called in any state and calling it does not change the object state.
start	{Prepared, Started, Paused, PlaybackCompleted}	{Idle, Initialized, Stopped, Error}	Successful invoke of this method in a valid state transfers the object to the Started state. Calling this method in an invalid state transfers the object to the Error state.
stop	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method in a valid state transfers the object to the Stopped state. Calling this method in an invalid state transfers the object to the Error state.
getTrackInfo	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
addTimedTextSource	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
selectTrack	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
deselectTrack	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.

          權限         可能需要宣告相應的WAKE_LOCK權限<uses-permission>元素，         當使用網路內容時該類要求宣告 Manifest.permission.INTERNET 權限，           回呼         應用程式可能希望注冊資訊和錯誤事件，以便在播放或流式傳輸期間獲知某些內部狀態更新和可能的運行時錯誤，注冊這些事件是由正確設定相應的監聽器（通過呼叫setOnPreparedListener(OnPreparedListener) setOnPreparedListener，setOnVideoSizeChangedListener(OnVideoSizeChangedListener) setOnVideoSizeChangedListener，setOnSeekCompleteListener(OnSeekCompleteListener)setOnSeekCompleteListener，setOnCompletionListener(OnCompletionListener) setOnCompletionListener，setOnBufferingUpdateListener(OnBufferingUpdateListener) setOnBufferingUpdateListener，setOnInfoListener(OnInfoListener) setOnInfoListener，setOnErrorListener(OnErrorListener) setOnErrorListener等完成）， 為了接收與這些偵聽器關聯的相應回呼，應用程式需要在運行自己的Looper執行緒上創建MediaPlayer物件（默認情況下，主UI執行緒正在運行Looper），

轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/212109.html

標籤：其他

上一篇：centOS7下Spark安裝配置

下一篇：【涂鴉物聯網足跡】物聯網基礎介紹篇