android MediaPlayer API大全已經方法詳解(轉載)

来源:http://www.cnblogs.com/xiaoxiaing/archive/2016/05/17/5502179.html
-Advertisement-
Play Games

通過這張圖,我們可以知道一個MediaPlayer對象有以下的狀態:1)當一個MediaPlayer對象被剛剛用new操作符創建或是調用了reset()方法後,它就處於Idle狀態。當調用了release()方法後,它就處於End狀態。這兩種狀態之間是MediaPlayer對象的生命周期。1.1) ...


Android <wbr>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狀態的時候,可以調整音頻/視頻的屬性,如音量,播放時是否一直亮屏,迴圈播放等。 


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

5.1) 當處於Started狀態時,內部播放引擎會調用客戶端程式員提供的OnBufferingUpdateListener.onBufferingUpdate()回調方法,此回調方法允許應用程式追蹤流播放的緩衝的狀態。

5.2) 對一個已經處於Started 狀態的MediaPlayer對象調用start()方法沒有影響。


6) 播放可以被暫停,停止,以及調整當前播放位置。當調用pause()方法並返回時,會使MediaPlayer對象進入Paused狀態。註意Started與Paused狀態的相互轉換在內部的播放引擎中是非同步的。所以可能需要一點時間在isPlaying()方法中更新狀態,若在播放流內容,這段時間可能會有幾秒鐘。

6.1) 調用start()方法會讓一個處於Paused狀態的MediaPlayer對象從之前暫停的地方恢復播放。當調用start()方法返回的時候,MediaPlayer對象的狀態會又變成Started狀態。

6.2) 對一個已經處於Paused狀態的MediaPlayer對象pause()方法沒有影響。


7) 調用stop()方法會停止播放,並且還會讓一個處於Started,Paused,Prepared或PlaybackCompleted狀態的MediaPlayer進入Stopped狀態。

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


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

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

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


9) 當播放到流的末尾,播放就完成了。

9.1) 如果調用了setLooping(boolean)方法開啟了迴圈模式,那麼這個MediaPlayer對象會重新進入Started狀態。

9.2) 若沒有開啟迴圈模式,那麼內部的播放引擎會調用客戶端程式員提供的OnCompletion.onCompletion()回調方法。可以通過調用MediaPlayer.setOnCompletionListener(OnCompletionListener)方法來設置。內部的播放引擎一旦調用了OnCompletion.onCompletion()回調方法,說明這個MediaPlayer對象進入了PlaybackCompleted狀態。

9.3) 當處於PlaybackCompleted狀態的時候,可以再調用start()方法來讓這個MediaPlayer對象再進入Started狀態。 

#################################################################################################

這張狀態轉換圖清晰的描述了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狀態。

補充一點開發時遇見的問題:

在停止播放的是代碼應這樣寫才可以在下次播放時重新開始播放

private void stop(){
  if(mediaplayer!=null){//mediaplayer 是MediaPlayer的 instance
   mediaplayer.stop();
      try{
    mediaplayer.prepare();//stop後下次重新播放要首先進入prepared狀態
    mediaplayer.seekTo(0);//須將播放時間設置到0;這樣才能在下次播放是重新開始,否則會繼續上次播放
   }catch(IOException e){
    e.printStackTrace();
   }
  }


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 數據存儲的持久化技術 數據存儲主要有五種方式: (1)文件存儲或者SD卡 (2)SharedPreferences (3)SQLite (4)ContentProvider (5)網路存儲 下麵簡單介紹一下前三種存儲 1.文件存儲 比較適合存儲一些簡單的文本數據或者二進位數據,主要用到的方法是ope ...
  • 在網上找到的資料比較零散,這部分學起來感覺也有點空虛,內容就只包括隱藏鍵盤和鍵盤高度兩部分 隱藏鍵盤其實就在我學習iOS開發的第一個程式裡面已經實踐過了,不過當時還懵懵懂懂,現在就瞭解了是什麼一回事,就記錄一下,也額外加點內容上去。 說這個鍵盤的出現和隱藏是和輸入框獲取和失去焦點有關係,輸入框獲取了 ...
  • 我不喜歡那些泛泛而談的去講那些形而上學的道理,更不喜歡記那些既定的東西。靠記憶去彌補思考的人,容易陷入人云亦云的境地,最後必定被記憶所圍困,而最終消亡的是創造力。希望這個高手之路系列能夠記錄我學習安卓的點點滴滴。從而匯成流,聚為江,成為海。 下麵就結合代碼分析一下ClassLoader這個東西。 安 ...
  • OC NSFileManager(文件路徑操作) 初始化 獲取當前目錄 更改當前目錄 創建新目錄 拷貝目錄(文件) 移動目錄(文件) 刪除目錄(文件 通過遞歸枚舉目錄下所有文件及目錄 獲取當前目錄下的文件及目錄 創建文件 判斷文件是否存在 獲取文件屬性 從文件讀二進位流 ` ` ...
  • 前言:對Rx不瞭解的朋友可以先看我的第一篇博文 RxJava 和 RxAndroid ,是對Rxjava的基本介紹 1、merge操作符,合併觀察對象 運行結果 ...
  • LoginViewController * loginVC = [[LoginViewController alloc]init]; 找window的三種方式 1、// UIWindow * window = [UIApplication sharedApplication].delegate.wi ...
  • 1. 避免界面在處理耗時(讀取資料庫,網路請求)操作時卡死,在另外一條線程中處理這些操作,然後在主線程中更新UI。代碼比NSThread NSOperation簡潔很多,而且GCD會自動根據任務在多核處理器上分配資源,優化程式。 dispatch_async(dispatch_get_global_ ...
  • UIWebView *webView = [[UIWebView alloc] initWithFrame:CGRectMake(0, 0, KScreenWidth, KScreenHeight-64)]; webView.backgroundColor=YYCToothWashViewBgCol ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...