歡迎來到Linux教程網
Linux教程網
Linux教程網
Linux教程網
您现在的位置: Linux教程網 >> UnixLinux >  >> Linux編程 >> Linux編程

Android MediaPlayer狀態機

翻譯Android Reference Manual的MediaPlayer的狀態機

對播放音頻/視頻文件和流的控制是通過一個狀態機來管理的。下圖顯示一個MediaPlayer對象被支持的播放控制操作驅動的生命周期和狀態。橢圓代表MediaPlayer對象可能駐留的狀態。弧線表示驅動MediaPlayer在各個狀態之間遷移的播放控制操作。這裡有兩種類型的弧線。由一個箭頭開始的弧代表同步的方法調用,而以雙箭頭開頭的代表的弧線代表異步方法調用
 


通過這張圖,我們可以知道一個MediaPlayer對象有以下的狀態:

1)當一個MediaPlayer對象被剛剛用new操作符創建或是調用了reset()方法後,它就處於Idle狀態。當調用了release()方法後,它就處於End狀態。這兩種狀態之間是MediaPlayer對象的生命周期。
1.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()方法了,並將錯誤的狀態傳入。
1.2) 我們建議,一旦一個MediaPlayer對象不再被使用,應立即調用release()方法來釋放在內部的播放引擎中與這個MediaPlayer對象關聯的資源。資源可能包括如硬件加速組件的單態組件,若沒有調用release()方法可能會導致之後的MediaPlayer對象實例無法使用這種單態硬件資源,從而退回到軟件實現或運行失敗。一旦MediaPlayer對象進入了End狀態,它不能再被使用,也沒有辦法再遷移到其它狀態。
1.3) 此外,使用new操作符創建的MediaPlayer對象處於Idle狀態,而那些通過重載的create()便利方法創建的MediaPlayer對象卻不是處於Idle狀態。事實上,如果成功調用了重載的create()方法,那麼這些對象已經是Prepare狀態了。 

2) 在一般情況下,由於種種原因一些播放控制操作可能會失敗,如不支持的音頻/視頻格式,缺少隔行掃描的音頻/視頻,分辨率太高,流超時等原因,等等。因此,錯誤報告和恢復在這種情況下是非常重要的。有時,由於編程錯誤,在處於無效狀態的情況下調用了一個播放控制操作可能發生。在所有這些錯誤條件下,內部的播放引擎會調用一個由客戶端程序員提供的OnErrorListener.onError()方法。客戶端程序員可以通過調用MediaPlayer.setOnErrorListener(android.media.MediaPlayer.OnErrorListener)方法來注冊OnErrorListener.
2.1) 一旦發生錯誤,MediaPlayer對象會進入到Error狀態。
2.2) 為了重用一個處於Error狀態的MediaPlayer對象,可以調用reset()方法來把這個對象恢復成Idle狀態。
2.3) 注冊一個OnErrorListener來獲知內部播放引擎發生的錯誤是好的編程習慣。
2.4) 在不合法的狀態下調用一些方法,如prepare(),prepareAsync()setDataSource()方法會拋出IllegalStateException異常。 

3) 調用setDataSource(FileDescriptor)方法,或setDataSource(String)方法,或setDataSource(Context,Uri)方法,或setDataSource(FileDescriptor,long,long)方法會使處於Idle狀態的對象遷移到Initialized狀態。
3.1) 若當此MediaPlayer處於其它的狀態下,調用setDataSource()方法,會拋出IllegalStateException異常。
3.2) 好的編程習慣是不要疏忽了調用setDataSource()方法的時候可能會拋出的IllegalArgumentException異常和IOException異常。 

4) 在開始播放之前,MediaPlayer對象必須要進入Prepared狀態。
4.1) 有兩種方法(同步和異步)可以使MediaPlayer對象進入Prepared狀態:要麼調用prepare()方法(同步),此方法返回就表示該MediaPlayer對象已經進入了Prepared狀態;要麼調用prepareAsync()方法(異步),此方法會使此MediaPlayer對象進入Preparing狀態並返回,而內部的播放引擎會繼續未完成的准備工作。當同步版本返回時或異步版本的准備工作完全完成時就會調用客戶端程序員提供的OnPreparedListener.onPrepared()監聽方法。可以調用MediaPlayer.setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)方法來注冊OnPreparedListener.
4.2) Preparing是一個中間狀態,在此狀態下調用任何具備邊影響的方法的結果都是未知的!
4.3) 在不合適的狀態下調用prepare()prepareAsync()方法會拋出IllegalStateException異常。當MediaPlayer對象處於Prepared狀態的時候,可以調整音頻/視頻的屬性,如音量,播放時是否一直亮屏,循環播放等。 

Copyright © Linux教程網 All Rights Reserved