前言

什么是VideoView?

VideoView是Android原生提供的一个封装类,只用以播放视频,视频源可以是本地也可以是网络,支持大部分格式的视频源。

VideoView原理

VideoView继承自SurfaceView,里面封装了一个MediaPlayer用以具体的播放业务,并自带了一个简单的控制界面MediaController。

适用场景

VideoView的功能比较简单,非常适用于那些只单纯地播放视频的场景,如不断循环播放的广告视频。不适用于交互性多的视频播放场景,像调节亮度、调节音量、双击暂停等交互逻辑,VideoView是无法实现的。

1.简单使用步骤

第一步:在布局中添加

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <VideoView
        android:id="@+id/vv_main"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

第二步:设置视频源地址并开始播放

//播放本地视频
 String videoPath= Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MOVIES)+"/dync.mp4";
 //videoPath = "http://vfx.mtime.cn/Video/2019/07/12/mp4/190712140656051701.mp4";
 //设置播放地址,网络视频同样使用此方法,将网址链接放入即可
vvMain.setVideoPath(videoPath);
//开始播放
vvMain.start();

注意:本地视频需要读取存储的权限,网络视频需要网络权限,别忘了添加。

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.INTERNET"/>

简单两步即可实现播放视频,很轻松就能实现视频的播放,这也是VideoView的方便之处。

2.开启视频控制栏

上述VideoView播放视频的方式是没法对其进行任何控制的,如要停止也只能等它播放完毕,VideoView中提供了一个简单的控制栏,具有以下功能。

  • 播放/暂停
  • 查看视频长度与当前位置
  • 进度条拖动
  • 快进15秒
  • 快退5秒

界面如下

安卓开发VideoCompressor使用 android studio videoview_ide


这个控制栏默认是不开启的,如要将之打开,则需要设置MediaController,然后点击视频区域即可弹出此界面。如果视频没有播放或是调用停止方法如stopPlayaback()suspend(),那么此控制栏将不会弹出,调用pause()不影响弹出。

MediaController mediaController = new MediaController(this);
vvMain.setMediaController(mediaController);

此处的context一定要传入activity,否则在点击视频区域时程序会崩溃,报如下错误。

android.view.WindowManager$BadTokenException: Unable to add window -- token null is not valid; is your activity running?

意思是无法将视图添加到window中,因为context不是Activity无法attch Window。

2.1 显示上下首的按钮

如果我想切换到下一个或上一个视频该怎么办,上述界面中并没有这两个按钮啊!难道要自己再添加两个这样的Button,那我还不如自己实现这个控制栏呢。

莫慌,其实MediaController是有这上一首和下一首的按钮的,只不过默认将它隐藏了,只要给他设置个监听方法就可以将之显示出来了。

mediaController.setPrevNextListeners(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //下一首,实现具体的切换逻辑
            }
        }, new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //上一首
            }
        });

就算你设置了两个null,也能将之显示出来,只不过点击按钮没有反应罢了。具体要播放哪个视频,就需要自己维护一个播放列表了。

效果如下图。

安卓开发VideoCompressor使用 android studio videoview_VideoView_02

2.2 控制栏的显示时间

当点击视频区域控制栏会弹出,过一段时间后会自动隐藏,这个时间是多少呢?
3秒
这是默认时间,由MediaController类控制。

private static final int sDefaultTimeout = 3000;

这个时间用是无法更改的,除非不用VideoView,而是使用另一种视频播放方式MediaPlayer+SurfaceView+MediaController在点击事件中自己实现显示逻辑。可参考此篇文章!

3.视频的状态获取与控制

VidewView的可调用方法由两部分组成,一是MediaPlayerControl接口规范,二是它自身实现的方法。

3.1 MediaPlayerControl接口提供的方法

方法

用途

void start();

开始播放视频

void pause();

暂停播放视频

int getDuration();

获取视频总长度,毫秒值

int getCurrentPosition();

获取当前播放位置,毫秒值

void seekTo(int pos);

指定播放某个位置

boolean isPlaying();

视频是否在播放

int getBufferPercentage();

获取缓冲进度,网络视频中使用

boolean canPause();

能否暂停

boolean canSeekBackward();

能否快退

boolean canSeekForward();

能否快进

int getAudioSessionId();

获取音频会话ID

3.2 VideoView自身实现的方法

方法

用途

void resume();

重新播放视频

void stopPlayaback();

停止播放视频

void suspend();

停止播放

void setOnPreparedListener(MediaPlayer.OnPreparedListener l);

视频加载状态的监听

void setOnInfoListener(OnInfoListener l);

视频信息的监听,只有播放时才会调用此监听

void setOnCompletionListener(OnCompletionListener l);

视频播放完毕的监听

void setOnErrorListener(OnErrorListener l);

视频加载或播放异常的监听

4.视频监听器实用技巧

4.1 让视频开始播放的另一种方式

前面说到只需要调用VideoView的start()方法即可完成视频播放的设置,当视频内容加载至内存完成后即会自动开始播放,其实调用VideoView的start方法并不是直接让MediaPlayer开始播放视频,都是需要经过准备阶段这一固定步骤的。

故可在视频的加载监听器中,调用MediaPlayer的start()方法开始视频的播放,效果与VideoView调用start()方法一致。

vvMain.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
            @Override
            public void onPrepared(MediaPlayer mp) {
                mp.start();
            }
        });

当VideoView调用setVideoPath()方法时就会开始加载视频内容至内存中,调用的是

mMediaPlayer.prepareAsync();

所以VideoView的加载过程是一个异步加载。

4.2 实现视频循环播放

一般对于广告视频而言,其必定是不断地循环播放的,而VideoView也可以通过两种方式来达到循环播放的效果。

方式一:通过MediaPlayer方法
mp.setLooping(true);

此方法可用在OnPreparedListener加载回调和OnInfoListener视频信息回调,但不能用在OnCompletionListener播放完毕的回调中,在播放完毕时再调用此方法并不会让视频循环播放。

还有,设置了视频循环播放后,下一轮的播放不会再触发OnPreparedListenerOnInfoListener,但一样会触发在OnCompletionListener和异常回调。

方式二:在播放完毕的回调中,再次开始播放
vvMain.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
            @Override
            public void onCompletion(MediaPlayer mp) {
                mp.start();
                //也可调用videoview的start,效果是一样
                //vvMain.start();
                //调用resume方法可使视频重复播放
//                vvMain.resume();
            }
        });

在这里有三种方式可以实现再次播放

  • MediaPlayer.start()
  • VedioView.start()
  • VedioView.resume()

这三种方式当视频重复播放时都会触发信息回调,与mp.setLooping(true)不太一样。

vvMain.setOnInfoListener(new MediaPlayer.OnInfoListener() {
            @Override
            public boolean onInfo(MediaPlayer mp, int what, int extra) {
                return false;
            }
        });

VedioView.resume()方法还会触发加载状态回调OnPreparedListener,所以说resume()方法其实是再一次加载了这个视频内容,然后从头开始播放,与前二种方式是有所区别,前两种方式是再次播放已经加载好的视频,所以不会再触发OnPreparedListener这个回调。

4.3 去掉视频播放异常时的弹框

当视频加载或播放出现异常时,默认是会有一个弹框的,告诉用户播放出现异常,当点击了这个按钮后,会触发播放完毕的回调OnCompletionListener,弹框示意图如下。

安卓开发VideoCompressor使用 android studio videoview_ide_03


如果想要去掉此异常弹框,那么只需在异常回调中OnErrorListener返回true即可。

vvMain.setOnErrorListener(new MediaPlayer.OnErrorListener() {
            @Override
            public boolean onError(MediaPlayer mp, int what, int extra) {
                return true;
            }
        });

当取消了异常弹框后,界面不会再有提示,也不会再触发完成回调OnCompletionListener