Введение в этот раздел:
В этом разделе рассматривается MediaPlayer в мультимедиа Android. С помощью этого API мы можем воспроизводить аудио и видео. Этот класс является важным компонентом мультимедийной платформы Android. С помощью этого класса мы можем получать, декодировать и воспроизводить аудио и видео с минимальными усилиями. Он поддерживает три различных источника мультимедиа:
- Локальные ресурсы
- Внутренний URI, например, его можно получить через ContentResolver
- Внешний URL (поток)
Список поддерживаемых Android медиаформатов см. в:Поддерживаемые медиаформатыДокументация
В этом разделе мы будем использовать 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 необходимо поместить файл в папку assets, которая находится на том же уровне, что и папка res, а затем использовать следующий код для установки 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. Примеры кода
Пример 1: Использование 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();
Примечание: Если вы воспроизводите онлайн-аудиофайл по URL как поток, файл должен поддерживать прогрессивную загрузку.
Пример 2: Использование 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! Затем кнопки управляют воспроизведением и паузой, вот и всё~
Пример 3: Использование 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;
}
}
}
Код очень прост, поэтому объяснения не нужны~ Если у вас есть вопросы, просто скачайте демо и запустите его~
3. Скачать пример кода для этого раздела:
MediaPlayerDemo.zip
MediaPlayerDemo2.zip
VideoViewDemo.zip
Итоги этого раздела:
Итак, в этом разделе мы кратко рассмотрели, как использовать MediaPlayer для воспроизведения аудио и в сочетании с SurfaceView для воспроизведения видео. В конце мы также написали пример воспроизведения видео с помощью VideoView. Всё это очень простое использование~ Я уверен, всем будет очень легко учиться. Что ж, спасибо~