9.1.5 使用MediaPlayer播放

    第6章和第7章(其中处理音频和网络音频)介绍了MediaPlayer类。同样，MediaPlayer类也可以通过大致的方式用于播放视频。

    与使用VideoView或通过意图播放视频相比，将MediaPlayer对象用于视频播放能够为控制播放本身提供最大的灵活性。事实上，在VideoView和通过意图的触发的活动中，用于处理播放的具体机制也是MediaPlayer。

    1.MediaPlayer的状态

     MediaPlayer对象以状态机的方式工作，即它需要以特定的顺序执行操作，而且只有当该对象处于正确的状态时才可以调用各种方法来处理这些操作。

     MediaPlayer类定义了几个监听，从而使用它的应用程序会获得其各种状态的通知，并据此采取相应的操作。

    2.MediaPlayer示例

    下面是使用MediaPlayer创建一个自定义视频播放应用程序的完整示例。

package com.nthm.androidtestActivity;

import java.io.IOException;
import com.nthm.androidtest.R;
import android.app.Activity;
import android.media.MediaPlayer;
import android.media.MediaPlayer.OnCompletionListener;
import android.media.MediaPlayer.OnErrorListener;
import android.media.MediaPlayer.OnInfoListener;
import android.media.MediaPlayer.OnPreparedListener;
import android.media.MediaPlayer.OnSeekCompleteListener;
import android.media.MediaPlayer.OnVideoSizeChangedListener;
import android.os.Bundle;
import android.os.Environment;
import android.view.Display;
import android.view.SurfaceHolder;
import android.view.SurfaceHolder.Callback;
import android.view.SurfaceView;
import android.widget.LinearLayout;

    活动将实现MediaPlayer状态变化的所有监听器以及SurfaceHolder.Callback接口，从而我们能够获得SurfaceView变化的通知。

public class CustomVideoPlayer extends Activity implements
        OnCompletionListener, OnErrorListener, OnInfoListener,
        OnPreparedListener, OnSeekCompleteListener, OnVideoSizeChangedListener,
        Callback {
    private Display currentDisplay;
    private SurfaceView surfaceView;
    private SurfaceHolder surfaceHolder;

    应用程序的关键部件将是MediaPlayer对象。

    private MediaPlayer mediaPlayer;
    private int videoWidth=0;
    private int videoHeight=0;
    private boolean readyToPlay=false;
    public final static String LOGTAG="CUSTOM_VIDEO_PLAYER";
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.customvideoplayer);

    在设置内容视图之后，可以获得在布局XML中定义的SurfaceView的引用以及SurfaceHolder的引用，从而能够监控在底层表面上发生的事情。

        surfaceView=(SurfaceView) findViewById(R.id.SurfaceView);
        surfaceHolder=surfaceView.getHolder();

    由于活动实现了SurfaceHolder.Callback，因此将把它指定为回调监听器。

        surfaceHolder.addCallback(this);

    需要确保底层表面是一个推送缓冲区表面，目前需要将它用于视频播放和摄像头预览。

        surfaceHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);

    现在开始构造实际的MediaPlayer对象。无需传入任何参数，以下代码将返回一个处于“空闲”状态的通用MediaPlayer对象。

        mediaPlayer=new MediaPlayer();

    还将指定活动应该是各种事件的监听器。

        mediaPlayer.setOnCompletionListener(this);
        mediaPlayer.setOnErrorListener(this);
        mediaPlayer.setOnInfoListener(this);
        mediaPlayer.setOnPreparedListener(this);
        mediaPlayer.setOnSeekCompleteListener(this);
        mediaPlayer.setOnVideoSizeChangedListener(this);

    在完成onCreate方法之前，将通知MediaPlayer对象所需要播放的内容，在此示例中，我们选择一个视频文件

        String filePath=Environment.getExternalStorageDirectory().getPath()+"/test.mp4";

    MediaPlayer对象上的setDataSource方法可能会抛出多个异常，因此需呀对他们进行合适的处理。在本例中仅仅是退出；但是在你的应用程序中，你可能希望向用户提供一个机会来选择不同的文件或解释发生了什么错误。

        try {
            mediaPlayer.setDataSource(filePath);
        } catch (IllegalArgumentException e) {
            e.printStackTrace();
            finish();
        } catch (SecurityException e) {
            e.printStackTrace();
            finish();
        } catch (IllegalStateException e) {
            e.printStackTrace();
            finish();
        } catch (IOException e) {
            e.printStackTrace();
            finish();
        }
        currentDisplay=getWindowManager().getDefaultDisplay();
    }

    因为活动实现了SurfaceHolder.Callback，并将其指定为回调监听器，所以将触发以下3个方法。

    当创建SurfaceView中的底层表面时，将会调用surfaceCreated方法。

    @Override
    public void surfaceCreated(SurfaceHolder holder) {

    当创建表面时，通过调用MediaPlayer的setDisplay方法并传入到SurfaceHolder对象，可以指定MediaPlayer将该表面用于播放。

           mediaPlayer.setDisplay(holder);

    最后，在指定表面完成之后可以调用prepare方法。prepare方法会阻塞而不是在后台工作。因此，为了在后台完成它所做的工作，从而不至于绑定应用程序，可以使用prepareAsync方法。不管采用哪种方法，由于实现了OnPreparedListener，并把活动设置为监听器，因此当完成操作时将调用onPrepared方法。

    prepare方法可能会抛出几个需要处理的异常。为简洁起见，本示例仅仅是记录错误日志并退出来。在你的应用程序中，你可能需要适当的处理这些异常。

           try {
            mediaPlayer.prepare();
        } catch (IllegalStateException e) {
            e.printStackTrace();
            finish();
        } catch (IOException e) {
            e.printStackTrace();
            finish();
        }
    }

    当SurfaceView的底层的宽度、高度或其他的参数发生变化时，将调用surfaceChanged方法。在本示例中，不需要在这种情况下做任何事情。

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

    }

    当销毁SurfaceView的底层表面时，将调用surfaceDestroyed方法。在本示例中，当发生这种情况时不做任何事情。

    @Override
    public void surfaceDestroyed(SurfaceHolder holder) {

    }

    由于实现了MediaPlayer.OnCompletionListener，并把活动自身注册为监听器，因此当MediaPlayer完成播放文件时，将调用onCompletion方法。可以使用它来加载另一个视频，或者指定其他一些诸如加载另外一个屏幕的动作。在本示例中仅仅是退出。

    @Override
    public void onCompletion(MediaPlayer mp) {
                finish();
    }

    由于活动实现了MediaPlayer.OnErrorListene，而且把它注册为MediaPlayer对象的错误监听器，因此当发生一个错误时将调用下面的onError方法，但是，可用的错误信息不多，只有两个常量。

   从该方法返回false表明错误没有被处理。如果注册了而一个OnCompletionListener，那么将调用它的onCompletion方法，同时把MediaPlayer对象置于“错误”状态。通过调用reset方法，可以将它重置为“空闲”状态。

    @Override
    public boolean onError(MediaPlayer mp, int what, int extra) {
        return false;
    }

   当出现关于播放媒体的特定信息或者需要发出警告时，将调用在OnInfoListener中指定的onInfo方法。

    @Override
    public boolean onInfo(MediaPlayer mp, int what, int extra) {
        return false;
    }

    在MediaPlayer成功的准备开始播放后，将调用onPrepared方法。可以将该方法指定为正在实现的OnPreparedListener接口的一部分，一旦调用该方法，MediaPlayer就进入“准备就绪”状态，准备开始播放。

    @Override
    public void onPrepared(MediaPlayer mp) {

    在播放视频之前，应该设置表面的大小以匹配视频或显示器的大小，这取决于哪个大小较小。

    首先使用MediaPlayer对象上的getVideoWidth和getVideoHeight方法获得视频的尺寸。

           videoHeight=mp.getVideoHeight();
           videoWidth=mp.getVideoWidth();

    如果视频的宽度或高度大于显示器大小，就需要找出用该使用的比率。

           if(videoWidth>currentDisplay.getWidth()||videoHeight>currentDisplay.getHeight()){
               float heightRatio=(float)videoHeight/(float)currentDisplay.getHeight();
               float widthRatio=(float)videoWidth/(float)currentDisplay.getWidth();
               if(heightRatio>1||widthRatio>1){

    我们将使用较大额比率，同时通过将视频大小除以较大的比率来设置videoHeight和videoWidth。

                   if(heightRatio>widthRatio){
                       videoHeight=(int)Math.ceil((float)videoHeight/(float)heightRatio);
                       videoWidth=(int)Math.ceil((float)videoWidth/(float)heightRatio);
                   }else{
                       videoHeight=(int)Math.ceil((float)videoHeight/(float)widthRatio);
                       videoWidth=(int)Math.ceil((float)videoWidth/(float)widthRatio);
                   }
               }
           }

    现在可以设置用来显示视频的SurfaceView大小，它可以是视频的实际尺寸，或者如果视频大于显示器，那么应该是调整后的尺寸。

           surfaceView.setLayoutParams(new LinearLayout.LayoutParams(videoWidth, videoHeight));

    最后，可以通过调用MediaPlayer对象上的start方法来开始播放视频。

           mp.start();
    }

    将onSeekComplete方法指定为正在实现的OnSeekCompleteListener的一部分，同时把活动注册为MediaPlayer对象的监听。当完成seek命令时调用该方法。

    @Override
    public void onSeekComplete(MediaPlayer mp) {

    }

    将onVideoSizeChanged方法指定为正在实现的OnVideoSizeChangedListener的一部分，同时把活动注册为MediaPlayer对象的监听器。当大小发生变化调用该方法；同时，当指定数据源和读取视频的元数据后将至少调用它一次。

    @Override
    public void onVideoSizeChanged(MediaPlayer mp, int width, int height) {

    }
}

    下面是用于上述活动的布局XML文件customvideoplayer.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:id="@+id/MainView"
    >
    <SurfaceView 
        android:id="@+id/SurfaceView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        />
</LinearLayout>

    3.使用MediaController的MediaPlayer

    在VideoView示例中使用的MediaController视图也可与MediaPlayer一起使用，但是，为了使它能够正确的工作，需要花费大量的工作。

    首先，除了已经实现的其他类之外，我们的类还将实现MediaController.MediaPlayerControl。

import android.widget.MediaController.MediaPlayerControl;

public class CustomVideoPlayer extends Activity implements
        OnCompletionListener, OnErrorListener, OnInfoListener,
        OnPreparedListener, OnSeekCompleteListener, OnVideoSizeChangedListener,
        Callback,MediaPlayerControl{

    此接口定义了MediaController中用来控制播放的一系列函数，需要在活动中实现他们。下面是这些函数及其在CustomVideoPlayer示例中的实现。其中的几个函数只返回true，仅仅指明其拥有此功能。其余的函数将会调用MediaPlayer对象上对应的函数。

    @Override
    public void start() {
        mediaPlayer.start();
    }

    @Override
    public void pause() {
        if(mediaPlayer.isPlaying()){
            mediaPlayer.pause();
        }
    }

    @Override
    public int getDuration() {
        return mediaPlayer.getDuration();
    }

    @Override
    public int getCurrentPosition() {
        return mediaPlayer.getCurrentPosition();
    }

    @Override
    public void seekTo(int pos) {
        mediaPlayer.seekTo(pos);
    }

    @Override
    public boolean isPlaying() {
        return mediaPlayer.isPlaying();
    }

    @Override
    public int getBufferPercentage() {
        return 0;
    }

    @Override
    public boolean canPause() {
        return false;
    }

    @Override
    public boolean canSeekBackward() {
        return false;
    }

    @Override
    public boolean canSeekForward() {
        return false;
    }

    @Override
    public int getAudioSessionId() {
        return 0;
    }

     现在可以自由的添加实际的MediaController对象。我们将连同其余的实例变量一起声明它。

    private MediaController controller;

    在onCreate方法中将其实例化。

        controller=new MediaController(this);

    只有在MediaPlayer准备好之后才会对他进行实际的设置和使用。在onPrepared方法的末尾可以添加以下内容。首先通过调用setMediaPlayer方法指定实现了MediaController.MediaPlayerControl的对象。在本示例中它是当前活动，因此传入this。

   然后设置活动的根视图，从而MediaController可以确定如何显示自身。在上述布局XML中，给定LinearLayout根对象的ID为MainView，因此可以在这里引用它。

   最后启用控制器并显示。

           controller.setMediaPlayer(this);
           controller.setAnchorView(this.findViewById(R.id.MainView));
           controller.setEnabled(true);
           controller.show();

    为了使控制器能够在消失之后重新显示(MediaController的默认行为是在超时之后自动隐藏)，可以重写活动中的onTouchEvent方法，以显示或隐藏他。

    @Override
    public boolean onTouch(View v, MotionEvent event) {
        if(controller.isShowing()){
            controller.hide();
        }else{
            controller.show();
        }
        return false;
    }