MediaPlayer 音頻播放 示例
狀態機、流程圖、生命週期
對播放音頻/視頻文件和流的控制是經過一個
狀態機來管理的。下圖顯示一個MediaPlayer對象被支持的播放控制操做驅動的生命週期和狀態。
橢圓表明MediaPlayer對象可能駐留的狀態，弧線表示驅動MediaPlayer在各個狀態之間遷移的播放控制操做。
這裏有兩種類型的弧線：由一個箭頭開始的弧表明同步的方法調用，而以雙箭頭開頭的表明的弧線表明異步方法調用。
經過這張圖，咱們能夠知道一個MediaPlayer對象有如下的狀態：
一、當一個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狀態了。
二、 在通常狀況下，因爲種種緣由一些播放控制操做可能會失敗，如不支持的音頻/視頻格式，缺乏隔行掃描的音頻/視頻，分辨率過高，流超時等緣由，等等。所以，錯誤報告和恢復在這種狀況下是很是重要的。有時，因爲編程錯誤，在處於無效狀態的狀況下調用了一個播放控制操做可能發生。在全部這些錯誤條件下，內部的播放引擎會調用一個由客戶端程序員提供的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異常。
三、 調用setDataSource(***)方法方法會使處於Idle狀態的對象遷移到Initialized狀態。
- 3.1) 若當此MediaPlayer處於其它的狀態下，調用setDataSource()方法，會拋出IllegalStateException異常。
- 3.2) 好的編程習慣是不要疏忽了調用setDataSource()方法的時候可能會拋出的IllegalArgumentException異常和IOException異常。
四、在開始播放以前，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狀態的時候，能夠調整音頻/視頻的屬性，如音量，播放時是否一直亮屏，循環播放等。
五、要開始播放，必須調用start()方法。當此方法成功返回時，MediaPlayer的對象處於Started狀態。isPlaying()方法能夠被調用來測試某個MediaPlayer對象是否在Started狀態。
- 5.1) 當處於Started狀態時，內部播放引擎會調用客戶端程序員提供的OnBufferingUpdateListener.onBufferingUpdate()回調方法，此回調方法容許應用程序追蹤流播放的緩衝的狀態。
- 5.2) 對一個已經處於Started 狀態的MediaPlayer對象調用start()方法沒有影響。
六、播放能夠被暫停，中止，以及調整當前播放位置。當調用pause()方法並返回時，會使MediaPlayer對象進入Paused狀態。注意Started與Paused狀態的相互轉換在內部的播放引擎中是異步的。因此可能須要一點時間在isPlaying()方法中更新狀態，若在播放流內容，這段時間可能會有幾秒鐘。
- 6.1) 調用start()方法會讓一個處於Paused狀態的MediaPlayer對象從以前暫停的地方恢復播放。當調用start()方法返回的時候，MediaPlayer對象的狀態會又變成Started狀態。
- 6.2) 對一個已經處於Paused狀態的MediaPlayer對象pause()方法沒有影響。
七、調用stop()方法會中止播放，而且還會讓一個處於Started，Paused，Prepared或PlaybackCompleted狀態的MediaPlayer進入Stopped狀態。
- 7.1) 對一個已經處於Stopped狀態的MediaPlayer對象stop()方法沒有影響。
八、調用seekTo()方法能夠調整播放的位置。
- 8.1) seekTo(int)方法是異步執行的，因此它能夠立刻返回，可是實際的定位播放操做可能須要一段時間才能完成，尤爲是播放流形式的音頻/視頻。當實際的定位播放操做完成以後，內部的播放引擎會調用客戶端程序員提供的OnSeekComplete.onSeekComplete()回調方法。能夠經過setOnSeekCompleteListener(OnSeekCompleteListener)方法註冊。
- 8.2) 注意，seekTo(int)方法也能夠在其它狀態下調用，好比Prepared，Paused和PlaybackCompleted狀態。此外，目前的播放位置，實際能夠調用getCurrentPosition()方法獲得，它能夠幫助如音樂播放器的應用程序不斷更新播放進度
九、當播放到流的末尾，播放就完成了。
- 9.1) 若是調用了setLooping(boolean)方法開啓了循環模式，那麼這個MediaPlayer對象會從新進入Started狀態。
- 9.2) 若沒有開啓循環模式，那麼內部的播放引擎會調用客戶端程序員提供的OnCompletion.onCompletion()回調方法。能夠經過調用MediaPlayer.setOnCompletionListener(OnCompletionListener)方法來設置。內部的播放引擎一旦調用了OnCompletion.onCompletion()回調方法，說明這個MediaPlayer對象進入了PlaybackCompleted狀態。
- 9.3) 當處於PlaybackCompleted狀態的時候，能夠再調用start()方法來讓這個MediaPlayer對象再進入Started狀態。
經常使用API
靜態構造方法
- public static MediaPlayer create(Context context, Uri uri, SurfaceHolder holder) 指定從資源ID對應的資源文件中來裝載音樂文件，同時指定了SurfaceHolder對象並返回MediaPlyaer對象
- public static MediaPlayer create(Context context, int resid) 指定從資源ID對應的資源文件中來裝載音樂文件，並返回MediaPlyaer對象
- public static MediaPlayer create(Context context, Uri uri) 指定從Uri對應的資源文件中來裝載音樂文件，並返回MediaPlyaer對象
經常使用方法，所有是
public void
格式的
- start () 開始或恢復播放
- stop() 中止播放
- pause() 暫停播放
- setDataSource (String path) 從指定的裝載path路徑所表明的文件
- setDataSource (FileDescriptor fd, long offset, long length) 指定裝載fd所表明的文件中從offset開始、長度爲length的文件內容
- setDataSource (FileDescriptor fd) 指定裝載fd所表明的文件
- setDataSource (Context context, Uri uri) 指定裝載uri所表明的文件
- setDataSource (Context context, Uri uri, Map<String, String> headers) 指定裝載uri所表明的文件
- prepare() 準備，setDataSource()方法以後，MediaPlayer並未去裝載音頻文件，調用prepare()後纔去準備音頻
- prepareAsync() 異步準備
- setLooping(boolean looping) 設置是否循環播放這個音樂文件
- setSurface(Surface surface) 設置Surface
- setVolume(float leftVolume,float rightVolume) 設置音量
- setDisplay(SurfaceHolder sh) 設置顯示方式
- seekTo(int mses) 尋求指定的時間位置。
- isLooping() 判斷是否循環播放
- isPlaying() 判斷是否正在播放
- release() 釋放相關該MediaPlayer對象的資源。
綁定事件監聽器
- setOnCompletionListener (MediaPlayer.OnCompletionListener listener) 爲MediaPlayer的播放完成事件綁定事件監聽器
- setOnErrorListener (MediaPlayer.OnErrorListener listener) 爲MediaPlayer的播放錯誤事件綁定事件監聽器
- setOnPreparedListener (MediaPlayer.OnPreparedListener listener) 當MediaPlayer調用prepare()方法時觸發該監聽器
- setOnSeekCompleteListener (MediaPlayer.OnSeekCompleteListener listener) 當MediaPlayer調用seek()方法的時候觸發該監聽器
示例說明
權限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
代碼
// 項目中，這些播放等方法都是放在服務中的，經過綁定服務，調用服務的方法。目的：防止後臺播放時被系統回收
public class MainActivity extends Activity implements OnClickListener {
private EditText et_path, et_Url;
private Button bt_play, bt_playUrl, bt_pause, bt_stop, bt_replay;
private MediaPlayer mediaPlayer;//多媒體播放器
private static final String STATE_CONTINUE = "繼續";
private static final String STATE_PAUSE = "暫停";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
et_path = (EditText) findViewById(R.id.et_path);
et_Url = (EditText) findViewById(R.id.et_Url);
bt_play = (Button) findViewById(R.id.bt_play);
bt_playUrl = (Button) findViewById(R.id.bt_playUrl);
bt_pause = (Button) findViewById(R.id.bt_pause);
bt_stop = (Button) findViewById(R.id.bt_stop);
bt_replay = (Button) findViewById(R.id.bt_replay);
bt_play.setOnClickListener(this);
bt_playUrl.setOnClickListener(this);
bt_pause.setOnClickListener(this);
bt_stop.setOnClickListener(this);
bt_replay.setOnClickListener(this);
mediaPlayer = new MediaPlayer();
mediaPlayer.setOnCompletionListener(new OnCompletionListener() {//播放完畢後回調
public void onCompletion(MediaPlayer mp) {
Toast.makeText(MainActivity.this, "播放完畢！", 0).show();
mediaPlayer.reset();//MediaPlayer同時只能播放一個音樂文件，若要播另外一個音樂文件，需先設置爲初始狀態
bt_playUrl.setEnabled(true);
bt_play.setEnabled(true);
}
});
mediaPlayer.setOnPreparedListener(new OnPreparedListener() {//準備完畢後回調
@Override
public void onPrepared(MediaPlayer mp) {
mediaPlayer.start();//只有準備好之後才能播放
Toast.makeText(MainActivity.this, "哈哈，準備好了！", 0).show();
}
});
mediaPlayer.setOnErrorListener(new OnErrorListener() {
@Override
public boolean onError(MediaPlayer paramMediaPlayer, int paramInt1, int paramInt2) {
Toast.makeText(MainActivity.this, "報錯了--" + paramInt1 + "--" + paramInt2, 0).show();
return false;
}
});
}
@Override
protected void onDestroy() {
super.onDestroy();
if (mediaPlayer != null) {
mediaPlayer.stop();
mediaPlayer.release();//釋放播放器資源
mediaPlayer = null;
}
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.bt_play:
play();
break;
case R.id.bt_playUrl:
playUrl();
break;
case R.id.bt_pause:
pause();
break;
case R.id.bt_stop:
stop();
break;
case R.id.bt_replay:
replay();
break;
default:
break;
}
}
//******************************************************************************************************************
/**
* 播放本地音樂
*/
public void play() {
String filepath = et_path.getText().toString().trim();
File file = new File(filepath);
if (file.exists()) {
try {
mediaPlayer.setDataSource(filepath);//設置播放的數據源
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);//設置音頻流的類型，不是必須的
mediaPlayer.prepare();//準備開始播放，prepare方法是native類型的，播放的邏輯是由c代碼在新的線程裏面執行的
bt_play.setEnabled(false);//播放時將「播放」按鈕設置爲不可點擊
bt_playUrl.setEnabled(false);
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "請檢查是否有寫SD卡權限", 0).show();
}
} else {
Toast.makeText(this, "文件不存在", 0).show();
}
}
/**
* 播放網絡音樂
*/
public void playUrl() {
String url = et_Url.getText().toString().trim();
if (!TextUtils.isEmpty(url)) {
try {
mediaPlayer.setDataSource(url);//參數能夠直接是網絡路徑
mediaPlayer.prepareAsync();//異步準備
bt_playUrl.setEnabled(false);//準備時就將「播放」按鈕設置爲不可點擊
bt_play.setEnabled(false);
Toast.makeText(MainActivity.this, "準備中，可能須要點時間……", 1).show();
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "播放失敗，請檢查是否有網絡權限", 0).show();
}
} else {
Toast.makeText(this, "路徑不能爲空", 0).show();
}
}
/**
* 暫停
*/
public void pause() {
if (mediaPlayer != null) {
if (mediaPlayer.isPlaying()) {//只有播放器已初始化而且正在播放纔可暫停
mediaPlayer.pause();
bt_pause.setText(STATE_CONTINUE);
} else {
mediaPlayer.start();
bt_pause.setText(STATE_PAUSE);
return;
}
}
}
/**
* 中止
*/
public void stop() {
if (mediaPlayer != null && mediaPlayer.isPlaying()) {
mediaPlayer.stop();
}
mediaPlayer.reset();
bt_play.setEnabled(true);
bt_playUrl.setEnabled(true);
bt_pause.setText("暫停");
}
/**
* 重播
*/
public void replay() {
if (mediaPlayer != null) {
mediaPlayer.start();
//這裏調用start方法沒意義，對一個已經處於Started 狀態的MediaPlayer對象調用start()方法沒有影響
mediaPlayer.seekTo(0);//重頭開始播放本音樂
}
bt_pause.setText("暫停");
}
}
佈局
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_gravity="center_horizontal"
android:orientation="vertical" >
<EditText
android:id="@+id/et_path"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="/sdcard/1.mp3" />
<EditText
android:id="@+id/et_Url"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="http://music.baidutt.com/up/kwcywukk/ydsspc.mp3" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal" >
<Button
android:id="@+id/bt_play"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="播放本地音樂" />
<Button
android:id="@+id/bt_playUrl"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="播放網絡音樂" />
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal" >
<Button
android:id="@+id/bt_pause"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="暫停" />
<Button
android:id="@+id/bt_stop"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="中止" />
<Button
android:id="@+id/bt_replay"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="重播" />
</LinearLayout>
</LinearLayout>
相關文章
- 1. android MediaPlayer音頻播放demo
- 2. 76.MediaPlayer[音頻播放]
- 3. 2.2 音樂播放示例
- 4. android MediaPlayer播放音視頻流程
- 5. MediaPlayer視頻播放
- 6. MediaPlayer-循環播放音頻文件
- 7. 安卓使用MediaPlayer播放音頻
- 8. android: 播放音頻
- 9. Android 播放音頻
- 10. Android播放音頻
- 更多相關文章...
- • Thymeleaf+SpringMVC5示例 - Thymeleaf 教程
- • Thymeleaf Servlet Hellow World示例 - Thymeleaf 教程
- • SpringBoot中properties文件不能自動提示解決方法
- • IDEA下SpringBoot工程配置文件沒有提示
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
歡迎關注本站公眾號,獲取更多信息
相關文章