Introducción a esta sección:

Esta sección presenta MediaPlayer, de la multimedia de Android, a través del cual podemos reproducir audio y video con esta API. Esta clase es un componente importante del framework multimedia de Android. Con ella, podemos obtener, decodificar y reproducir audio y video con los mínimos pasos. Soporta tres fuentes de medios diferentes:

  • Recursos locales
  • URI interna, por ejemplo, puedes obtenerla a través de ContentResolver
  • URL externa (stream)

Para la lista de formatos de medios compatibles con Android, consulta:Supported Media FormatsDocumentación

¡En esta sección vamos a usar MediaPlayer para escribir un ejemplo simple de reproducción de audio y video!

Documentación oficial de la API:MediaPlayer


1. Explicación detallada de métodos relacionados


1) Obtener una instancia de MediaPlayer:

Puedesusar `new` directamenteo llamar alcreatemétodo `create` para crear:

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

Además, `create` tiene esta forma:create(Context context, Uri uri, SurfaceHolder holder)Crear un reproductor multimedia a través de una Uri y un SurfaceHolder especificado [clase abstracta]


2) Configurar el archivo de reproducción:

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

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

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

Además, el método `setDataSource()` tiene varias sobrecargas, entre ellas un parámetro de tipo `FileDescriptor`. Al usar esta API, es necesario colocar el archivo en la carpeta `assets`, al mismo nivel que la carpeta `res`, y luego usar el siguiente código para configurar `DataSource`:

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

3) Otros métodos

  • getCurrentPosition( ): obtener la posición de reproducción actual
  • getDuration(): obtener la duración del archivo
  • getVideoHeight(): obtener la altura del video
  • getVideoWidth(): obtener el ancho del video
  • isLooping(): si se reproduce en bucle
  • isPlaying(): si se está reproduciendo
  • pause(): pausar
  • prepare(): preparar (síncrono)
  • prepareAsync(): preparar (asíncrono)
  • release(): liberar el objeto MediaPlayer
  • reset(): restablecer el objeto MediaPlayer
  • seekTo(int msec): especificar la posición de reproducción (tiempo en milisegundos)
  • setAudioStreamType(int streamtype): especificar el tipo de streaming
  • setDisplay(SurfaceHolder sh): configurar el uso de SurfaceHolder para mostrar multimedia
  • setLooping(boolean looping): configurar si se reproduce en bucle
  • setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener): listener de buffer para streaming de red
  • setOnCompletionListener(MediaPlayer.OnCompletionListener listener): listener de finalización de reproducción para streaming de red
  • setOnErrorListener(MediaPlayer.OnErrorListener listener): configurar listener de errores
  • setOnVideoSizeChangedListener(MediaPlayer.OnVideoSizeChangedListener listener): listener de tamaño de video
  • setScreenOnWhilePlaying(boolean screenOn): configurar si se usa SurfaceHolder para mostrar
  • setVolume(float leftVolume, float rightVolume): configurar volumen
  • start(): comenzar a reproducir
  • stop(): detener la reproducción

2. Ejemplos de código de uso

Ejemplo 1: Usar MediaPlayer para reproducir audio:

Imagen del efecto en ejecución:

Código clave:

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;
        }
    }
}

Notas:

Se reproduce un archivo de audio en el directorio `res/raw`. Para crear MediaPlayer se llama al método `create`; antes de la primera reproducción no es necesario llamar a `prepare()`. Si se usa el constructor, entonces es necesario llamar una vez al método `prepare()`. Además, se muestra el código de ejemplo de la documentación oficial para reproducir audio desde las otras dos vías:

Uri local:

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

URL externa:

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: Si reproduces un archivo de audio en línea a través de una URL en forma de streaming, el archivo debe poder descargarse de forma progresiva.


Ejemplo 2: Usar MediaPlayer para reproducir video

MediaPlayer se usa principalmente para reproducir audio; no proporciona una interfaz de salida de imagen, por lo que necesitamos usar otros componentes para mostrar la salida de imagen de MediaPlayer. Podemos usarSurfaceViewSurfaceView para mostrarla. A continuación, usamos SurfaceView para escribir un ejemplo de reproducción de video:

Imagen del efecto en ejecución:

Código de implementación:

Archivo de diseño: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();
    }
}

El código es muy simple. El diseño tiene un SurfaceView, luego se llama a `getHolder` para obtener un objeto SurfaceHolder. Aquí se completan las configuraciones relacionadas con SurfaceView: se establecen la resolución de visualización y una interfaz `Callback`, sobrescribiendo los tres métodos de creación de SurfaceView, cuando cambia y cuando se destruye. Luego los botones controlan la reproducción y la pausa, eso es todo ~


Ejemplo 3: Usar VideoView para reproducir video

Además de usar MediaPlayer + SurfaceView para reproducir video, también podemos usar VideoView para reproducir video directamente. Con solo modificar un poco las cosas podemos lograr la reproducción de video. El efecto en ejecución es igual al anterior, así que no lo publicaré, ¡vamos directamente al código!

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;
        }
    }
}

El código es muy simple, no lo explicaré. Si tienes dudas, descarga un Demo y ejecútalo tú mismo.


3. Descarga del código de ejemplo de esta sección:

MediaPlayerDemo.zip

MediaPlayerDemo2.zip

VideoViewDemo.zip


Resumen de esta sección:

Bien, en esta sección les he presentado brevemente cómo usar MediaPlayer para reproducir audio y combinarlo con SurfaceView para reproducir video. Finalmente, también escribimos un ejemplo de reproducción de video con VideoView. Todos son usos muy simples. Creo que les resultará muy fácil de aprender. Bueno, ¡gracias!