Android 多媒体MediaPlayer使用详解
一、简介
Mediaplayer可以用来控制音频或者视频文件、流的播放。(MediaPlayer class can be used to control playback of audio/video files and streams. )
这里是Android的官方API关于Mediaplayer的介绍:http://developers.androidcn.com/reference/android/media/MediaPlayer.html
二、MediaPlayer支持的格式
- H.263 3GPP(.3gp) and MPEG-4 (.mp4)
- H.264 AVC 3GPP (.3gp) and MPEG-4 (.mp4)
- MPEG-4 SP 3GPP (.3gp)
三、MediaPlayer支持的格式生命周期
四、常用方法
- 方法 说明
- MediaPlayer 构造方法
- create 创建一个要播放的多媒体
- getCurrentPosition 得到当前播放位置
- getDuration 得到文件的时间
- getVideoHeight 得到视频的高度
- getVideoWidth 得到视频的宽度
- isLooping 是否循环播放
- isPlaying 是否正在播放
- pause 暂停
- prepare 准备(同步)
- prepareAsync 准备(异步)
- release 释放MediaPlayer对象相关的资源
- reset 重置MediaPlayer对象为刚刚创建的状态
- seekTo 指定播放的位置(以毫秒为单位的时间)
- setAudioStreamType 设置流媒体的类型
- setDataSource 设置多媒体数据来源(位置)
- setDisplay 设置用SurfaceHolder来显示多媒体
- setLooping 设置是否循环播放
- setOnButteringUpdateListener 网络流媒体的缓冲监听
- setOnErrorListener 设置错误信息监听
- setOnVideoSizeChangedListener 视频尺寸监听
- setScreenOnWhilePlaying 设置是否使用SurfaceHolder来保持屏幕显示
- setVolume 设置音量
- start 开始播放
- stop 停止播放
1. 获取实例
MediaPlayer mp = new MediaPlayer();
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.mp4”);
c. 网络上的媒体文件
例如:mp.setDataSource(“http://2449.vod.myqcloud.com/2449_22ca37a6ea9011e5acaaf51d105342e3.f20.mp4“);
3. 主要控制方法 ###
prepare()和prepareAsync():提供了同步和异步两种方式设置播放器进入prepare状态,需要注意的是,如果MediaPlayer实例是由create方法创建的,那么第一次启动播放前不需要再调用prepare()了,因为create方法里已经调用过了。
start():是真正启动文件播放的方法。
pause()和stop():比较简单,起到暂停和停止播放的作用,
seekTo():是定位方法,可以让播放器从指定的位置开始播放,需要注意的是该方法是个异步方法,也就是说该方法返回时并不意味着定位完成,尤其是播放的网络文件,真正定位完成时会触发OnSeekComplete.onSeekComplete(),如果需要是可以调用setOnSeekCompleteListener(OnSeekCompleteListener)设置监听器来处理的。
release():可以释放播放器占用的资源,一旦确定不再使用播放器时应当尽早调用它释放资源。
reset():可以使播放器从Error状态中恢复过来,重新会到Idle状态。
4.常用监听事件
mediaPlayer.setOnCompletionListener(this); //播放完成监听--对应回调方法:onCompletion(MediaPlayer player)
mediaPlayer.setOnErrorListener(this); //播放异常监听--对应回调方法:onError(MediaPlayer player, int whatError, int extra)
mediaPlayer.setOnInfoListener(this); //当一些特定信息出现或者警告时监听--对应回调方法:onInfo(MediaPlayer player, int whatInfo, int extra)
mediaPlayer.setOnPreparedListener(this); //mediaplayer准备完成监听--对应回调方法:onPrepared(MediaPlayer player)
mediaPlayer.setOnSeekCompleteListener(this); //seek操作完成时监听--对应回调方法:onSeekComplete(MediaPlayer arg0)
mediaPlayer.setOnVideoSizeChangedListener(this);//当video大小改变时监听--对应回调方法:onVideoSizeChanged(MediaPlayer arg0, int arg1, int arg2)
视频播放Demo
package com.devin.videodemo;
import android.media.MediaPlayer;
import android.os.Bundle;
import android.os.Environment;
import android.support.v7.app.AppCompatActivity;
import android.view.Display;
import android.view.SurfaceHolder;
import android.view.SurfaceView;
import android.widget.LinearLayout;
import android.widget.SeekBar;
import android.widget.TextView;
import java.io.IOException;
public class MainActivity extends AppCompatActivity implements MediaPlayer.OnCompletionListener, MediaPlayer.OnErrorListener, MediaPlayer.OnInfoListener,
MediaPlayer.OnPreparedListener, MediaPlayer.OnSeekCompleteListener, MediaPlayer.OnVideoSizeChangedListener, SurfaceHolder.Callback, SeekBar.OnSeekBarChangeListener {
private Display currDisplay;
private SurfaceView surfaceView;
private SeekBar seekBar;
private TextView curTime;
private TextView totalTime;
private SurfaceHolder holder;
private MediaPlayer player;
private int vWidth, vHeight;
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.video_surface);
init();
}
private void init() {
surfaceView = (SurfaceView) findViewById(R.id.video_surface);
seekBar = (SeekBar) findViewById(R.id.seekBar);
curTime = (TextView) findViewById(R.id.curTime);
totalTime = (TextView) findViewById(R.id.totalTime);
//给SurfaceView添加CallBack监听
holder = surfaceView.getHolder();
holder.addCallback(this);
//为了可以播放视频或者使用Camera预览,我们需要指定其Buffer类型
holder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
//下面开始实例化MediaPlayer对象
player = new MediaPlayer();
player.setOnCompletionListener(this);
player.setOnErrorListener(this);
player.setOnInfoListener(this);
player.setOnPreparedListener(this);
player.setOnSeekCompleteListener(this);
player.setOnVideoSizeChangedListener(this);
seekBar.setOnSeekBarChangeListener(this);
Debug.d("Begin:::");
//然后指定需要播放文件的路径,初始化MediaPlayer
String dataPath = Environment.getExternalStorageDirectory().getPath() + "/test2.mp4";
String url = "http://2449.vod.myqcloud.com/2449_22ca37a6ea9011e5acaaf51d105342e3.f20.mp4";
try {
player.setDataSource(dataPath);
//player.setDataSource(url);
Debug.d("Next:::set play path");
} catch (IllegalArgumentException e) {
e.printStackTrace();
} catch (IllegalStateException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
//然后,我们取得当前Display对象
currDisplay = this.getWindowManager().getDefaultDisplay();
}
@Override
public void surfaceChanged(SurfaceHolder arg0, int arg1, int arg2, int arg3) {
// 当Surface尺寸等参数改变时触发
Debug.d("Surface Change::surfaceChanged called");
}
@Override
public void surfaceCreated(SurfaceHolder holder) {
// 当SurfaceView中的Surface被创建的时候被调用
//在这里我们指定MediaPlayer在当前的Surface中进行播放
player.setDisplay(holder);
//在指定了MediaPlayer播放的容器后,我们就可以使用prepare(同步)或者prepareAsync(异步)来准备播放了
player.prepareAsync();
}
@Override
public void surfaceDestroyed(SurfaceHolder holder) {
Debug.d("Surface Destory:::surfaceDestroyed called");
}
@Override
public void onVideoSizeChanged(MediaPlayer mp, int width, int height) {
// 当video大小改变时触发
//这个方法在设置player的source后至少触发一次
Debug.d("Video Size Change:::onVideoSizeChanged called");
}
@Override
public void onSeekComplete(MediaPlayer mediaPlayer) {
// seek操作完成时触发
Debug.d("Seek Completion:::onSeekComplete called");
curTime.setText(toTime(seekBar.getProgress()));
}
@Override
public void onPrepared(MediaPlayer player) {
// 当prepare完成后,该方法触发,在这里我们播放视频
//首先取得video的宽和高
vWidth = player.getVideoWidth();
vHeight = player.getVideoHeight();
int duration = player.getDuration();
Debug.d("vWidth:" + vWidth + "----vHeight:" + vHeight);
Debug.d("cWidth:" + currDisplay.getWidth() + "----cHeight:" + currDisplay.getHeight());
Debug.d("VideoDuration:" + duration);
seekBar.setMax(duration / 1000);//设置进度条
totalTime.setText(toTime(duration / 1000));
if (vWidth > currDisplay.getWidth() || vHeight > currDisplay.getHeight()) {
//如果video的宽或者高超出了当前屏幕的大小,则要进行缩放
float wRatio = (float) vWidth / (float) currDisplay.getWidth();
float hRatio = (float) vHeight / (float) currDisplay.getHeight();
//选择大的一个进行缩放
float ratio = Math.max(wRatio, hRatio);
vWidth = (int) Math.ceil((float) vWidth / ratio);
vHeight = (int) Math.ceil((float) vHeight / ratio);
//设置surfaceView的布局参数
surfaceView.setLayoutParams(new LinearLayout.LayoutParams(vWidth, vHeight));
}
//然后开始播放视频
Debug.d("Video player.start");
player.start();
//设置进度条动态更新
seekBar.postDelayed(runnable, 1000);
}
Runnable runnable = new Runnable() {
@Override
public void run() {
seekBar.setProgress(seekBar.getProgress() + 1);
curTime.setText(toTime(seekBar.getProgress()));
if (seekBar.getProgress() < seekBar.getMax()) {
seekBar.postDelayed(this, 1000);
}
}
};
@Override
public boolean onInfo(MediaPlayer player, int whatInfo, int extra) {
// 当一些特定信息出现或者警告时触发
switch (whatInfo) {
case MediaPlayer.MEDIA_INFO_BAD_INTERLEAVING:
break;
case MediaPlayer.MEDIA_INFO_METADATA_UPDATE:
break;
case MediaPlayer.MEDIA_INFO_VIDEO_TRACK_LAGGING:
break;
case MediaPlayer.MEDIA_INFO_NOT_SEEKABLE:
break;
}
return false;
}
@Override
public boolean onError(MediaPlayer player, int whatError, int extra) {
Debug.d("Play Error:::onError called");
switch (whatError) {
case MediaPlayer.MEDIA_ERROR_SERVER_DIED:
Debug.d("Play Error:::media_error_server_died");
break;
case MediaPlayer.MEDIA_ERROR_UNKNOWN:
Debug.d("Play Error:::播放错误,未知错误");
break;
case MediaPlayer.MEDIA_ERROR_IO:
Debug.d("Play Error:::media_error_io");
break;
case MediaPlayer.MEDIA_ERROR_MALFORMED:
Debug.d("Play Error:::media_error_malformed");
break;
case MediaPlayer.MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK:
Debug.d("Play Error:::一般视频播放比较慢或视频本身有问题会引发");
break;
case MediaPlayer.MEDIA_ERROR_TIMED_OUT:
Debug.d("Play Error:::media_error_timed_out");
break;
case MediaPlayer.MEDIA_ERROR_UNSUPPORTED:
Debug.d("Play Error:::media_error_unsupported");
break;
}
return false;
}
@Override
public void onCompletion(MediaPlayer player) {
// 当MediaPlayer播放完成后触发
Debug.d("Play Over:::onCompletion called");
if (player != null) {
player.release();
seekBar.removeCallbacks(runnable);
}
}
@Override
public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
Debug.d("progress:" + progress);
player.seekTo(progress * 1000);
}
@Override
public void onStartTrackingTouch(SeekBar seekBar) {
}
@Override
public void onStopTrackingTouch(SeekBar seekBar) {
}
@Override
protected void onPause() {
super.onPause();
if (player.isPlaying()) {
player.pause();
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (player != null) {
player.stop();
player.release();
seekBar.removeCallbacks(runnable);
}
}
private String toTime(int s) {
long hour = s / 3600;
long minute = s % 3600 / 60;
long second = s % 60;
String b = "";
String c = "";
String d = "";
if (second < 10) {
b = "0";
}
if (minute < 10) {
c = "0";
}
if (hour < 10) {
d = "0";
}
return d + hour + ":" + c + minute + ":" + b + second;
}
}
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:weightSum="5">
<SurfaceView
android:id="@+id/video_surface"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="2" />
<android.support.v7.widget.AppCompatSeekBar
android:id="@+id/seekBar"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="8dp">
<TextView
android:id="@+id/totalTime"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentLeft="true"
android:gravity="right"
android:text="09:54" />
<TextView
android:id="@+id/curTime"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentRight="true"
android:gravity="right"
android:text="09:54"
android:textColor="#ff0000" />
</RelativeLayout>