9.2 MediaPlayer播放音频与视频

本节引言：

本节带来的是Android多媒体中的——MediaPlayer，我们可以通过这个API来播放音频和视频
该类是Androd多媒体框架中的一个重要组件，通过该类，我们可以以最小的步骤来获取，解码
和播放音视频。它支持三种不同的媒体来源：

• 本地资源
• 内部的URI，比如你可以通过ContentResolver来获取
• 外部URL(流)
  对于Android所支持的的媒体格式列表

对于Android支持的媒体格式列表，可见：Supported Media Formats 文档

本节我们就来用MediaPlayer来写个简单的播放音视频的例子！

官方API文档：MediaPlayer

1.相关方法详解

1）获得MediaPlayer实例：

可以直接new或者调用create方法创建：

MediaPlayer mp = new MediaPlayer();
MediaPlayer mp = MediaPlayer.create(this, R.raw.test);  //无需再调用setDataSource

另外create还有这样的形式：
create(Context context, Uri uri, SurfaceHolder holder)
通过Uri和指定 SurfaceHolder 【抽象类】 创建一个多媒体播放器

2）设置播放文件：

//①raw下的资源：
MediaPlayer.create(this, R.raw.test);

//②本地文件路径：
mp.setDataSource("/sdcard/test.mp3");

//③网络URL文件：
mp.setDataSource("http://www.xxx.com/music/test.mp3");

另外setDataSource()方法有多个，里面有这样一个类型的参数：FileDescriptor，在使用这个
API的时候，需要把文件放到res文件夹平级的assets文件夹里，然后使用下述代码设置DataSource：

AssetFileDescriptor fileDescriptor = getAssets().openFd("rain.mp3");
m_mediaPlayer.setDataSource(fileDescriptor.getFileDescriptor(),fileDescriptor.getStartOffset(), fileDescriptor.getLength());

3）其他方法

• getCurrentPosition( )：得到当前的播放位置
• getDuration() ：得到文件的时间
• getVideoHeight() ：得到视频高度
• getVideoWidth() ：得到视频宽度
• isLooping()：是否循环播放
• isPlaying()：是否正在播放
• pause()：暂停
• prepare()：准备(同步)
• prepareAsync()：准备(异步)
• release()：释放MediaPlayer对象
• reset()：重置MediaPlayer对象
• seekTo(int msec)：指定播放的位置（以毫秒为单位的时间）
• setAudioStreamType(int streamtype)：指定流媒体的类型
• setDisplay(SurfaceHolder sh)：设置用SurfaceHolder来显示多媒体
• setLooping(boolean looping)：设置是否循环播放
• setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener)：
  网络流媒体的缓冲监听
• setOnCompletionListener(MediaPlayer.OnCompletionListener listener)：
  网络流媒体播放结束监听
• setOnErrorListener(MediaPlayer.OnErrorListener listener)：
  设置错误信息监听
• setOnVideoSizeChangedListener(MediaPlayer.OnVideoSizeChangedListener listener)：
  视频尺寸监听
• setScreenOnWhilePlaying(boolean screenOn)：设置是否使用SurfaceHolder显示
• setVolume(float leftVolume, float rightVolume)：设置音量
• start()：开始播放
• stop()：停止播放

2.使用代码示例

示例一：使用MediaPlayer播放音频：

运行效果图：

关键代码：

public class MainActivity extends AppCompatActivity implements View.OnClickListener{

    private Button btn_play;
    private Button btn_pause;
    private Button btn_stop;
    private MediaPlayer mPlayer = null;
    private boolean isRelease = true;   //判断是否MediaPlayer是否释放的标志

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bindViews();
    }

    private void bindViews() {
        btn_play = (Button) findViewById(R.id.btn_play);
        btn_pause = (Button) findViewById(R.id.btn_pause);
        btn_stop = (Button) findViewById(R.id.btn_stop);

        btn_play.setOnClickListener(this);
        btn_pause.setOnClickListener(this);
        btn_stop.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_play:
                if(isRelease){
                    mPlayer = MediaPlayer.create(this,R.raw.fly);
                    isRelease = false;
                }
                mPlayer.start();   //开始播放
                btn_play.setEnabled(false);
                btn_pause.setEnabled(true);
                btn_stop.setEnabled(true);
                break;
            case R.id.btn_pause:
                mPlayer.pause();     //停止播放
                btn_play.setEnabled(true);
                btn_pause.setEnabled(false);
                btn_stop.setEnabled(false);
                break;
            case R.id.btn_stop:
                mPlayer.reset();     //重置MediaPlayer
                mPlayer.release();   //释放MediaPlayer
                isRelease = true;
                btn_play.setEnabled(true);
                btn_pause.setEnabled(false);
                btn_stop.setEnabled(false);
                break;
        }
    }
}

注意事项：

播放的是res/raw目录下的音频文件，创建MediaPlayer调用的是create方法，第一次启动播放前
不需要再调用prepare()，如果是使用构造方法构造的话，则需要调用一次prepare()方法！
另外贴下官方文档中，从其他两种途径播放音频的示例代码:

本地Uri：

Uri myUri = ....; // initialize Uri here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
mediaPlayer.setDataSource(getApplicationContext(), myUri);
mediaPlayer.prepare();
mediaPlayer.start();

外部URL：

String url = "http://........"; // your URL here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
mediaPlayer.setDataSource(url);
mediaPlayer.prepare(); // might take long! (for buffering, etc)
mediaPlayer.start();

Note：假如你通过一个URL以流的形式播放在线音频文件，该文件必须可以进行
渐进式下载

示例二：使用MediaPlayer播放视频

MediaPlayer主要用于播放音频，没有提供图像输出界面，所以我们需要借助其他的
组件来显示MediaPlayer播放的图像输出，我们可以使用用SurfaceView
来显示，下面我们使用SurfaceView来写个视频播放的例子：

运行效果图：

实现代码：

布局文件：activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="5dp">

    <SurfaceView
        android:id="@+id/sfv_show"
        android:layout_width="match_parent"
        android:layout_height="300dp" />

    <Button
        android:id="@+id/btn_start"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="开始" />

    <Button
        android:id="@+id/btn_pause"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="暂停 " />

    <Button
        android:id="@+id/btn_stop"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="终止" />
    
</LinearLayout>

MainActivity.java：

public class MainActivity extends AppCompatActivity implements View.OnClickListener, SurfaceHolder.Callback {

    private MediaPlayer mPlayer = null;
    private SurfaceView sfv_show;
    private SurfaceHolder surfaceHolder;
    private Button btn_start;
    private Button btn_pause;
    private Button btn_stop;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bindViews();
    }

    private void bindViews() {
        sfv_show = (SurfaceView) findViewById(R.id.sfv_show);
        btn_start = (Button) findViewById(R.id.btn_start);
        btn_pause = (Button) findViewById(R.id.btn_pause);
        btn_stop = (Button) findViewById(R.id.btn_stop);

        btn_start.setOnClickListener(this);
        btn_pause.setOnClickListener(this);
        btn_stop.setOnClickListener(this);

        //初始化SurfaceHolder类，SurfaceView的控制器
        surfaceHolder = sfv_show.getHolder();
        surfaceHolder.addCallback(this);
        surfaceHolder.setFixedSize(320, 220);   //显示的分辨率,不设置为视频默认

    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_start:
                mPlayer.start();
                break;
            case R.id.btn_pause:
                mPlayer.pause();
                break;
            case R.id.btn_stop:
                mPlayer.stop();
                break;
        }
    }

    @Override
    public void surfaceCreated(SurfaceHolder holder) {
        mPlayer = MediaPlayer.create(MainActivity.this, R.raw.lesson);
        mPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
        mPlayer.setDisplay(surfaceHolder);    //设置显示视频显示在SurfaceView上
    }

    @Override
    public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {}

    @Override
    public void surfaceDestroyed(SurfaceHolder holder) {}

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (mPlayer.isPlaying()) {
            mPlayer.stop();
        }
        mPlayer.release();
    }
}

代码很简单，布局有个SurfaceView，然后调用getHolder获得一个SurfaceHolder对象，
在这里完成SurfaceView相关的设置，设置了显示的分辨率以及一个Callback接口，
重写了SurfaceView创建时，发生变化时，以及销毁时的三个方法！然后按钮控制播放
以及暂停而已~

示例三：使用VideoView播放视频

除了使用MediaPlayer + SurfaceView播放视频的方式，我们还可以使用VideoView来直接
播放视频，我们稍微改点东西就可以实现视频播放！运行效果和上面的一致，就不贴了，
直接上代码！

MainActivity.java：

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private VideoView videoView;
    private Button btn_start;
    private Button btn_pause;
    private Button btn_stop;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bindViews();
    }
    
    private void bindViews() {
        videoView = (VideoView) findViewById(R.id.videoView);
        btn_start = (Button) findViewById(R.id.btn_start);
        btn_pause = (Button) findViewById(R.id.btn_pause);
        btn_stop = (Button) findViewById(R.id.btn_stop);

        btn_start.setOnClickListener(this);
        btn_pause.setOnClickListener(this);
        btn_stop.setOnClickListener(this);
        
        //根据文件路径播放
        if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
            videoView.setVideoPath(Environment.getExternalStorageDirectory() + "/lesson.mp4");
        }

        //读取放在raw目录下的文件
        //videoView.setVideoURI(Uri.parse("android.resource://com.jay.videoviewdemo/" + R.raw.lesson));
        videoView.setMediaController(new MediaController(this));
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_start:
                videoView.start();
                break;
            case R.id.btn_pause:
                videoView.pause();
                break;
            case R.id.btn_stop:
                videoView.stopPlayback();
                break;
        }
    }
}

代码非常简单，就不解释了~有疑问的自己下个Demo运行下即可~

3.本节示例代码下载：

MediaPlayerDemo.zip

MediaPlayerDemo2.zip

VideoViewDemo.zip

本节小结：

好的，本节跟大家简单的介绍了下如何使用MediaPlayer播放音频以及结合SurfaceView
来播放视频，最后还写了一个用VideoView播放视频的例子，都是些非常简单的用法~
相信大家学习起来非常简单~嗯，谢谢~