Android教程網 >> Android技術 >> Android開發實例 >> Android應用開發入門（五十八）MediaPlayer介紹及使用

Android應用開發入門（五十八）MediaPlayer介紹及使用

編輯：Android開發實例

前言

　　Android提供了常見的音頻、視頻的編碼、解碼機制。借助於多媒體類MediaPlayer的支持，開發人員可以很方便在在應用中播放音頻、視頻。本文主要講解在Android平台下如何播放一個音頻文件。

　　本文主要內容如下：

MediaPlayer
MediaPlayer的音頻源
使用MediaPlayer播放音樂
MediaPlayer使用技巧
Demo--一個簡單的MP3播放器

MediaPlayer

　　上面提到過，Android下對於音頻、視頻的支持均需要使用到MediaPlayer，它主要用來控制Android下播放文件或流的類。MediaPlayer處於Android多媒體包下"android.media.MediaPlayer"，僅有一個無參的構造函數，雖然僅為我們提供了一個無參的構造函數，為了方便我們初始化，還為我們提供了幾個靜態的create()方法用於完成MediaPlayer初始化的工作。

static MediaPlayer create(Context context,int resid)：通過音頻資源的Id來創建一個MediaPlayer實例。
static MediaPlayer create(Context context,Uri uri)：通過一個音頻資源的Uri地址來創建一個MediaPlayer實例。

　　MediaPlayer除了通過上面兩個create()方法在初始化的時候指定媒體資源，還可以通過MediaPlayer.setDataSource()方法為初始化後的MediaPlayer設置媒體資源，setDataSource()具有多個重載函數，適用於不同的媒體資源來源，以下講解幾個常用的，其他的可以查閱官方文檔。

void setDataSource(String path)：通過一個媒體資源的地址指定MediaPlayer的數據源，這裡的path可以是一個本地路徑，也可以是網絡路徑。
void setDataSource(Context context,Uri uri)：通過一個Uri指定MediaPlayer的數據源，這裡的Uri可以是網絡路徑或這一個內容提供者的Uri。
void setDataSource(FileDescriptor fd)：通過一個FileDescriptor指定一個MediaPlayer的數據源。

MediaPlayer的音頻源

　　通過上面介紹的初始化MediaPlayer的播放時媒體數據源的方法可以看出，MediaPlayer支持的數據源有：本地文件、內部的Uri（內容提供者）、外部Uri。

　　如，設置一個本地SD卡的資源：

mediaPlayer = new MediaPlayer();  
mediaPlayer.setDataSource("/sdcarc/a.mp3");

　　注意讀內存卡，還需要設定訪問內存卡的權限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

　　如，設置一個外部uri的網絡流媒體資源：

mediaPlayer = new MediaPlayer();  
mediaPlayer.setDataSource(http://192.168.1.102:1231/music/a.mp3);

　　如果訪問網絡流媒體資源，還需要設置訪問網絡的權限：

<uses-permission android:name="android.permission.INTERNET"/>

使用MediaPlayer播放音樂

　　MediaPlayer其實是一個封裝的很好的音頻、視頻流媒體操作類，如果查看其源碼，會發現其內部是調用的native方法，所以它其實是有C++實現的。

　　既然是一個流媒體操作類，那麼必然涉及到，播放、暫停、停止等操作，實際上MediaPlayer也為我們提供了相應的方法來直接操作流媒體。

void statr()：開始或恢復播放。
void stop()：停止播放。
void pause()：暫停播放。

　　通過上面三個方法，只要設定好流媒體數據源，即可在應用中播放流媒體資源，為了更好的操作流媒體，MediaPlayer還為我們提供了一些其他的方法，這裡列出一些常用的，詳細內容參閱官方文檔。

int getDuration()：獲取流媒體的總播放時長，單位是毫秒。
int getCurrentPosition()：獲取當前流媒體的播放的位置，單位是毫秒。
void seekTo(int msec)：設置當前MediaPlayer的播放位置，單位是毫秒。
void setLooping(boolean looping)：設置是否循環播放。
boolean isLooping()：判斷是否循環播放。
boolean isPlaying()：判斷是否正在播放。
void prepare()：同步的方式裝載流媒體文件。
void prepareAsync()：異步的方式裝載流媒體文件。
void release ()：回收流媒體資源。
void setAudioStreamType(int streamtype)：設置播放流媒體類型。
void setWakeMode(Context context, int mode)：設置CPU喚醒的狀態。
setNextMediaPlayer(MediaPlayer next)：設置當前流媒體播放完畢，下一個播放的MediaPlayer。

　　大部分方法的看方法名就可以理解，但是有幾個方法需要單獨說明一下。

　　在使用MediaPlayer播放一段流媒體的時候，需要使用prepare()或prepareAsync()方法把流媒體裝載進MediaPlayer，才可以調用start()方法播放流媒體。　　　　　　　　　　　　　　　　　

　　setAudioStreamType()方法用於指定播放流媒體的類型，它傳遞的是一個int類型的數據，均以常量定義在AudioManager類中，一般我們播放音頻文件，設置為AudioManager.STREAM_MUSIC即可。

　　除了上面介紹的一些方法外，MediaPlayer還提供了一些事件的回調函數，這裡介紹幾個常用的：

setOnCompletionListener(MediaPlayer.OnCompletionListener listener)：當流媒體播放完畢的時候回調。
setOnErrorListener(MediaPlayer.OnErrorListener listener)：當播放中發生錯誤的時候回調。
setOnPreparedListener(MediaPlayer.OnPreparedListener listener)：當裝載流媒體完畢的時候回調。
setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)：當使用seekTo()設置播放位置的時候回調。

MediaPlayer使用技巧

　　在使用MediaPlayer的使用過程中，有個小技巧需要說明一下：

　　1、在使用start()播放流媒體之前，需要裝載流媒體資源。這裡最好使用prepareAsync()用異步的方式裝載流媒體資源。因為流媒體資源的裝載是會消耗系統資源的，在一些硬件不理想的設備上，如果使用prepare()同步的方式裝載資源，可能會造成UI界面的卡頓，這是非常影響用於體驗的。因為推薦使用異步裝載的方式，為了避免還沒有裝載完成就調用start()而報錯的問題，需要綁定MediaPlayer.setOnPreparedListener()事件，它將在異步裝載完成之後回調。異步裝載還有一個好處就是避免裝載超時引發ANR（(Application Not Responding）錯誤。

mediaPlayer = new MediaPlayer();  
                mediaPlayer.setDataSource(path);  
                mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);  
                  
                // 通過異步的方式裝載媒體資源  
                mediaPlayer.prepareAsync();  
                mediaPlayer.setOnPreparedListener(new OnPreparedListener() {                      
                    @Override 
                    public void onPrepared(MediaPlayer mp) {  
                        // 裝載完畢回調  
                        mediaPlayer.start();  
                    }  
                });

　　2、使用完MediaPlayer需要回收資源。MediaPlayer是很消耗系統資源的，所以在使用完MediaPlayer，不要等待系統自動回收，最好是主動回收資源。

if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
    mediaPlayer.stop();  
    mediaPlayer.release();  
    mediaPlayer = null;  
}

　　3、使用MediaPlayer最好使用一個Service來使用，並且在Service的onDestory()方法中回收MediaPlayer資源，實際上，就算是直接使用Activity承載MediaPlayer，也最好在銷毀的時候判斷一下MediaPlayer是否被回收，如果未被回收，回收其資源，因為底層調用的native方法，如果不銷毀還是會在底層繼續播放，而承載的組件已經被銷毀了，這個時候就無法獲取到這個MediaPlayer進而控制它。

@Override 
    protected void onDestroy() {  
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
            mediaPlayer.stop();  
            mediaPlayer.release();  
            mediaPlayer = null;  
        }  
        super.onDestroy();  
    }

　　4、對於單曲循環之類的操作，除了可以使用setLooping()方法進行設置之外，還可以為MediaPlayer注冊回調函數，MediaPlayer.setOnCompletionListener()，它會在MediaPlayer播放完畢被回調。

// 設置循環播放  
//                mediaPlayer.setLooping(true);  
                mediaPlayer.setOnCompletionListener(new OnCompletionListener() {  
                      
                    @Override 
                    public void onCompletion(MediaPlayer mp) {  
                        // 在播放完畢被回調  
                        play();                          
                    }  
                });

　　5、因為MediaPlayer一直操作的是一個流媒體，所以無可避免的可能一段流媒體資源，前半段可以正常播放，而中間一段因為解析或者源文件錯誤等問題，造成中間一段無法播放問題，需要我們處理這個錯誤，否則會影響Ux（用戶體驗）。可以為MediaPlayer注冊回調函數setOnErrorListener()來設置出錯之後的解決辦法，一般重新播放或者播放下一個流媒體即可。　

mediaPlayer.setOnErrorListener(new OnErrorListener() {  
                      
                    @Override 
                    public boolean onError(MediaPlayer mp, int what, int extra) {  
                        play();  
                        return false;  
                    }  
                });

Demo--一個簡單的MP3播放器

　　上面已經介紹了MediaPlayer播放一段音頻文件的所有需要用到的內容。下面通過一個簡單的Demo來演示如何使用MediaPlayer播放一個SD卡上的MP3文件。操作MediaPlayer應該放在Service中完成，這裡為了簡單，使用Activity直接操作MediaPlayer。代碼注釋裡寫的很清楚裡，這裡不再累述。

　　執行這個示例需要在/sdcard/目錄下存在xm.mp3的文件。　

package cn.bgxt.mediaplayerdemo;  
 
import java.io.File;  
import android.media.AudioManager;  
import android.media.MediaPlayer;  
import android.media.MediaPlayer.OnCompletionListener;  
import android.media.MediaPlayer.OnErrorListener;  
import android.media.MediaPlayer.OnPreparedListener;  
import android.os.Bundle;  
import android.app.Activity;  
import android.view.View;  
import android.widget.Button;  
import android.widget.EditText;  
import android.widget.Toast;  
 
public class MainActivity extends Activity {  
    private EditText et_path;  
    private Button btn_play, btn_pause, btn_replay, btn_stop;  
    private MediaPlayer mediaPlayer;  
 
    @Override 
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
 
        et_path = (EditText) findViewById(R.id.et_path);  
        btn_play = (Button) findViewById(R.id.btn_play);  
        btn_pause = (Button) findViewById(R.id.btn_pause);  
        btn_replay = (Button) findViewById(R.id.btn_replay);  
        btn_stop = (Button) findViewById(R.id.btn_stop);  
 
        btn_play.setOnClickListener(click);  
        btn_pause.setOnClickListener(click);  
        btn_replay.setOnClickListener(click);  
        btn_stop.setOnClickListener(click);  
    }  
 
    private View.OnClickListener click = new View.OnClickListener() {  
 
        @Override 
        public void onClick(View v) {  
 
            switch (v.getId()) {  
            case R.id.btn_play:  
                play();  
                break;  
            case R.id.btn_pause:  
                pause();  
                break;  
            case R.id.btn_replay:  
                replay();  
                break;  
            case R.id.btn_stop:  
                stop();  
                break;  
            default:  
                break;  
            }  
        }  
    };  
    /**  
     * 播放音樂  
     */ 
    protected void play() {  
        String path = et_path.getText().toString().trim();  
        File file = new File(path);  
        if (file.exists() && file.length() > 0) {  
            try {  
                mediaPlayer = new MediaPlayer();  
                // 設置指定的流媒體地址  
                mediaPlayer.setDataSource(path);  
                // 設置音頻流的類型  
                mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);  
 
                // 通過異步的方式裝載媒體資源  
                mediaPlayer.prepareAsync();  
                mediaPlayer.setOnPreparedListener(new OnPreparedListener() {  
                    @Override 
                    public void onPrepared(MediaPlayer mp) {  
                        // 裝載完畢 開始播放流媒體  
                        mediaPlayer.start();  
                        Toast.makeText(MainActivity.this, "開始播放", 0).show();  
                        // 避免重復播放，把播放按鈕設置為不可用  
                        btn_play.setEnabled(false);  
                    }  
                });  
                // 設置循環播放  
                // mediaPlayer.setLooping(true);  
                mediaPlayer.setOnCompletionListener(new OnCompletionListener() {  
 
                    @Override 
                    public void onCompletion(MediaPlayer mp) {  
                        // 在播放完畢被回調  
                        btn_play.setEnabled(true);  
                    }  
                });  
 
                mediaPlayer.setOnErrorListener(new OnErrorListener() {  
 
                    @Override 
                    public boolean onError(MediaPlayer mp, int what, int extra) {  
                        // 如果發生錯誤，重新播放  
                        replay();  
                        return false;  
                    }  
                });  
            } catch (Exception e) {  
                e.printStackTrace();  
                Toast.makeText(this, "播放失敗", 0).show();  
            }  
        } else {  
            Toast.makeText(this, "文件不存在", 0).show();  
        }  
 
    }  
    /**  
     * 暫停  
     */ 
    protected void pause() {  
        if (btn_pause.getText().toString().trim().equals("繼續")) {  
            btn_pause.setText("暫停");  
            mediaPlayer.start();  
            Toast.makeText(this, "繼續播放", 0).show();  
            return;  
        }  
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
            mediaPlayer.pause();  
            btn_pause.setText("繼續");  
            Toast.makeText(this, "暫停播放", 0).show();  
        }  
 
    }  
      
    /**  
     * 重新播放  
     */ 
    protected void replay() {  
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
            mediaPlayer.seekTo(0);  
            Toast.makeText(this, "重新播放", 0).show();  
            btn_pause.setText("暫停");  
            return;  
        }          
        play();  
    }  
      
    /**  
     * 停止播放  
     */ 
    protected void stop() {  
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
            mediaPlayer.stop();  
            mediaPlayer.release();  
            mediaPlayer = null;  
            btn_play.setEnabled(true);  
            Toast.makeText(this, "停止播放", 0).show();  
        }  
 
    }  
 
    @Override 
    protected void onDestroy() {  
        // 在activity結束的時候回收資源  
        if (mediaPlayer != null && mediaPlayer.isPlaying()) {  
            mediaPlayer.stop();  
            mediaPlayer.release();  
            mediaPlayer = null;  
        }  
        super.onDestroy();  
    }  
}

　　效果展示：

　　源碼下載

Android開發實例

Android編程入門 Android技術基礎 Android資訊關於Android編程 Android開發 Android開發環境 Android開發實例

相關文章