深入Android MediaPlayer的使用方法詳解

1）如何獲得MediaPlayer實例：
可以使用直接new的方式：
MediaPlayer mp = new MediaPlayer();
也可以使用create的方式，如：
MediaPlayer mp = MediaPlayer.create(this, R.raw.test);//這時就不用調用setDataSource了

2) 如何設置要播放的文件：
MediaPlayer要播放的文件主要包括3個來源：
a. 用戶在應用中事先自帶的resource資源
例如：MediaPlayer.create(this, R.raw.test);
b. 存儲在SD卡或其他文件路徑下的媒體文件
例如：mp.setDataSource("/sdcard/test.mp3");
c. 網絡上的媒體文件
例如：mp.setDataSource("http://www.citynorth.cn/music/confucius.mp3");

MediaPlayer的setDataSource一共四個方法：
setDataSource (String path)
setDataSource (FileDescriptor fd)
setDataSource (Context context, Uri uri)
setDataSource (FileDescriptor fd, long offset, long length)
 
其中使用FileDescriptor時，需要將文件放到與res文件夾平級的assets文件夾裏，然後使用：
AssetFileDescriptor fileDescriptor = getAssets().openFd("rain.mp3");
m_mediaPlayer.setDataSource(fileDescriptor.getFileDescriptor(),fileDescriptor.getStartOffset(), fileDescriptor.getLength());
來設置datasource

3）對播放器的主要控制方法：
Android通過控制播放器的狀態的方式來控制媒體文件的播放，其中：
prepare()和prepareAsync() 提供了同步和異步兩種方式設置播放器進入prepare狀態，需要注意的是，如果MediaPlayer實例是由create方法創建的，那麼第一次啓動播放前不需要再調用prepare（）了，因爲create方法裏已經調用過了。
start()是真正啓動文件播放的方法，
pause()和stop()比較簡單，起到暫停和停止播放的作用，

seekTo()是定位方法，可以讓播放器從指定的位置開始播放，需要注意的是該方法是個異步方法，也就是說該方法返回時並不意味着定位完成，尤其是播放的網絡文件，真正定位完成時會觸發OnSeekComplete.onSeekComplete()，如果需要是可以調用setOnSeekCompleteListener(OnSeekCompleteListener)設置監聽器來處理的。
release()可以釋放播放器佔用的資源，一旦確定不再使用播放器時應當儘早調用它釋放資源。
reset()可以使播放器從Error狀態中恢復過來，重新會到Idle狀態。

4）設置播放器的監聽器：
MediaPlayer提供了一些設置不同監聽器的方法來更好地對播放器的工作狀態進行監聽，以期及時處理各種情況，
如： setOnCompletionListener(MediaPlayer.OnCompletionListener listener)、
setOnErrorListener(MediaPlayer.OnErrorListener listener)等,設置播放器時需要考慮到播放器可能出現的情況設置好監聽和處理邏輯，以保持播放器的健壯性。

下面是一個結合seekbar而簡易實現的在線播放和下載功能的音樂播放器demo

效果實現：

本篇博客是在多線程下載那篇博客增加在線播放音樂實現，下面是提供項目下載地址：

http://download.csdn.net/detail/wwj_748/7018493

下面介紹具體實現過程：

定義一個具有緩衝效果的播放器：Player

我們看到的緩衝效果，是通過設置拖動條SeekBar的二級進度實現的，這就要設置MediaPlayer的緩衝更新的監聽了。

具體代碼實現：

package com.wwj.download.util;

import java.io.IOException;
import java.util.Timer;
import java.util.TimerTask;

import android.media.AudioManager;
import android.media.MediaPlayer;
import android.media.MediaPlayer.OnBufferingUpdateListener;
import android.media.MediaPlayer.OnCompletionListener;
import android.media.MediaPlayer.OnPreparedListener;
import android.os.Handler;
import android.util.Log;
import android.widget.SeekBar;

public class Player implements OnBufferingUpdateListener, OnCompletionListener,
        OnPreparedListener {

    public MediaPlayer mediaPlayer; // 媒體播放器
    private SeekBar seekBar; // 拖動條
    private Timer mTimer = new Timer(); // 計時器

    // 初始化播放器
    public Player(SeekBar seekBar) {
        super();
        this.seekBar = seekBar;
        try {
            mediaPlayer = new MediaPlayer();
            mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);// 設置媒體流類型
            mediaPlayer.setOnBufferingUpdateListener(this);
            mediaPlayer.setOnPreparedListener(this);
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 每一秒觸發一次
        mTimer.schedule(timerTask, 0, 1000);
    }

    // 計時器
    TimerTask timerTask = new TimerTask() {

        @Override
        public void run() {
            if (mediaPlayer == null)
                return;
            if (mediaPlayer.isPlaying() && seekBar.isPressed() == false) {
                handler.sendEmptyMessage(0); // 發送消息
            }
        }
    };

    Handler handler = new Handler() {
        public void handleMessage(android.os.Message msg) {
            int position = mediaPlayer.getCurrentPosition();
            int duration = mediaPlayer.getDuration();
            if (duration > 0) {
                // 計算進度（獲取進度條最大刻度*當前音樂播放位置 / 當前音樂時長）
                long pos = seekBar.getMax() * position / duration;
                seekBar.setProgress((int) pos);
            }
        };
    };

    public void play() {
        mediaPlayer.start();
    }

    /**
     *
     * @param url
     *            url地址
     */
    public void playUrl(String url) {
        try {
            mediaPlayer.reset();
            mediaPlayer.setDataSource(url); // 設置數據源
            mediaPlayer.prepare(); // prepare自動播放
        } catch (IllegalArgumentException e) {
            e.printStackTrace();
        } catch (SecurityException e) {
            e.printStackTrace();
        } catch (IllegalStateException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 暫停
    public void pause() {
        mediaPlayer.pause();
    }

    // 停止
    public void stop() {
        if (mediaPlayer != null) {
            mediaPlayer.stop();
            mediaPlayer.release();
            mediaPlayer = null;
        }
    }

    // 播放準備
    @Override
    public void onPrepared(MediaPlayer mp) {
        mp.start();
        Log.e("mediaPlayer", "onPrepared");
    }

    // 播放完成
    @Override
    public void onCompletion(MediaPlayer mp) {
        Log.e("mediaPlayer", "onCompletion");
    }

    /**
     * 緩衝更新
     */
    @Override
    public void onBufferingUpdate(MediaPlayer mp, int percent) {
        seekBar.setSecondaryProgress(percent);
        int currentProgress = seekBar.getMax()
                * mediaPlayer.getCurrentPosition() / mediaPlayer.getDuration();
        Log.e(currentProgress + "% play", percent + " buffer");
    }

}

package com.wwj.download;

import java.io.File;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;

import android.app.Activity;
import android.os.Bundle;
import android.os.Environment;
import android.os.Handler;
import android.os.Message;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ProgressBar;
import android.widget.SeekBar;
import android.widget.SeekBar.OnSeekBarChangeListener;
import android.widget.TextView;
import android.widget.Toast;

import com.wwj.download.util.Player;
import com.wwj.net.download.DownloadProgressListener;
import com.wwj.net.download.FileDownloader;

public class MainActivity extends Activity {
    private static final int PROCESSING = 1;
    private static final int FAILURE = -1;

    private EditText pathText; // url地址
    private TextView resultView;
    private Button downloadButton;
    private Button stopButton;
    private ProgressBar progressBar;
    private Button playBtn;
    private Player player; // 播放器
    private SeekBar musicProgress; // 音樂進度

    private Handler handler = new UIHandler();

    private final class UIHandler extends Handler {
        public void handleMessage(Message msg) {
            switch (msg.what) {
            case PROCESSING: // 更新進度
                progressBar.setProgress(msg.getData().getInt("size"));
                float num = (float) progressBar.getProgress()
                        / (float) progressBar.getMax();
                int result = (int) (num * 100); // 計算進度
                resultView.setText(result + "%");
                if (progressBar.getProgress() == progressBar.getMax()) { // 下載完成
                    Toast.makeText(getApplicationContext(), R.string.success,
                            Toast.LENGTH_LONG).show();
                }
                break;
            case FAILURE: // 下載失敗
                Toast.makeText(getApplicationContext(), R.string.error,
                        Toast.LENGTH_LONG).show();
                break;
            }
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        pathText = (EditText) findViewById(R.id.path);
        resultView = (TextView) findViewById(R.id.resultView);
        downloadButton = (Button) findViewById(R.id.downloadbutton);
        stopButton = (Button) findViewById(R.id.stopbutton);
        progressBar = (ProgressBar) findViewById(R.id.progressBar);
        ButtonClickListener listener = new ButtonClickListener();
        downloadButton.setOnClickListener(listener);
        stopButton.setOnClickListener(listener);
        playBtn = (Button) findViewById(R.id.btn_online_play);
        playBtn.setOnClickListener(listener);
        musicProgress = (SeekBar) findViewById(R.id.music_progress);
        player = new Player(musicProgress);
        musicProgress.setOnSeekBarChangeListener(new SeekBarChangeEvent());
    }

    private final class ButtonClickListener implements View.OnClickListener {
        @Override
        public void onClick(View v) {
            switch (v.getId()) {
            case R.id.downloadbutton: // 開始下載
                // http://abv.cn/music/光輝歲月.mp3，可以換成其他文件下載的鏈接
                String path = pathText.getText().toString();
                String filename = path.substring(path.lastIndexOf('/') + 1);

                try {
                    // URL編碼（這裏是爲了將中文進行URL編碼）
                    filename = URLEncoder.encode(filename, "UTF-8");
                } catch (UnsupportedEncodingException e) {
                    e.printStackTrace();
                }

                path = path.substring(0, path.lastIndexOf("/") + 1) + filename;
                if (Environment.getExternalStorageState().equals(
                        Environment.MEDIA_MOUNTED)) {
                    // File savDir =
                    // Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MOVIES);
                    // 保存路徑
                    File savDir = Environment.getExternalStorageDirectory();
                    download(path, savDir);
                } else {
                    Toast.makeText(getApplicationContext(),
                            R.string.sdcarderror, Toast.LENGTH_LONG).show();
                }
                downloadButton.setEnabled(false);
                stopButton.setEnabled(true);
                break;
            case R.id.stopbutton: // 暫停下載
                exit();
                Toast.makeText(getApplicationContext(),
                        "Now thread is Stopping!!", Toast.LENGTH_LONG).show();
                downloadButton.setEnabled(true);
                stopButton.setEnabled(false);
                break;
            case R.id.btn_online_play:
                new Thread(new Runnable() {

                    @Override
                    public void run() {
                        player.playUrl(pathText.getText().toString());
                    }
                }).start();
                break;
            }
        }

        /*
         * 由於用戶的輸入事件(點擊button, 觸摸屏幕....)是由主線程負責處理的，如果主線程處於工作狀態，
         * 此時用戶產生的輸入事件如果沒能在5秒內得到處理，系統就會報“應用無響應”錯誤。
         * 所以在主線程裏不能執行一件比較耗時的工作，否則會因主線程阻塞而無法處理用戶的輸入事件，
         * 導致“應用無響應”錯誤的出現。耗時的工作應該在子線程裏執行。
         */
        private DownloadTask task;

        private void exit() {
            if (task != null)
                task.exit();
        }

        private void download(String path, File savDir) {
            task = new DownloadTask(path, savDir);
            new Thread(task).start();
        }

        /**
         *
         * UI控件畫面的重繪(更新)是由主線程負責處理的，如果在子線程中更新UI控件的值，更新後的值不會重繪到屏幕上
         * 一定要在主線程裏更新UI控件的值，這樣才能在屏幕上顯示出來，不能在子線程中更新UI控件的值
         *
         */
        private final class DownloadTask implements Runnable {
            private String path;
            private File saveDir;
            private FileDownloader loader;

            public DownloadTask(String path, File saveDir) {
                this.path = path;
                this.saveDir = saveDir;
            }

            /**
             * 退出下載
             */
            public void exit() {
                if (loader != null)
                    loader.exit();
            }

            DownloadProgressListener downloadProgressListener = new DownloadProgressListener() {
                @Override
                public void onDownloadSize(int size) {
                    Message msg = new Message();
                    msg.what = PROCESSING;
                    msg.getData().putInt("size", size);
                    handler.sendMessage(msg);
                }
            };

            public void run() {
                try {
                    // 實例化一個文件下載器
                    loader = new FileDownloader(getApplicationContext(), path,
                            saveDir, 3);
                    // 設置進度條最大值
                    progressBar.setMax(loader.getFileSize());
                    loader.download(downloadProgressListener);
                } catch (Exception e) {
                    e.printStackTrace();
                    handler.sendMessage(handler.obtainMessage(FAILURE)); // 發送一條空消息對象
                }
            }
        }
    }

    // 進度改變
    class SeekBarChangeEvent implements OnSeekBarChangeListener {
        int progress;

        @Override
        public void onProgressChanged(SeekBar seekBar, int progress,
                boolean fromUser) {
            // 原本是(progress/seekBar.getMax())*player.mediaPlayer.getDuration()
            this.progress = progress * player.mediaPlayer.getDuration()
                    / seekBar.getMax();
        }

        @Override
        public void onStartTrackingTouch(SeekBar seekBar) {

        }

        @Override
        public void onStopTrackingTouch(SeekBar seekBar) {
            // seekTo()的參數是相對與影片時間的數字，而不是與seekBar.getMax()相對的數字
            player.mediaPlayer.seekTo(progress);
        }

    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (player != null) {
            player.stop();
            player = null;
        }
    }

}