Skip to content

Latest commit

 

History

History
145 lines (137 loc) · 4.69 KB

README_CN.md

File metadata and controls

145 lines (137 loc) · 4.69 KB
Raw

logo

ExoVideoView

demo

ExoVideoView 是一款基于ExoPlayer开发的视频播放器.

ExoVideoView可以做什么 1.自动处理音频焦点。 2.根据传感器自动处理方向。 3.手势支持。 4.多清晰度选择支持。 5.为控制器添加自定义布局. 6.调整显示大小。 7.自定义controller。 8.支持调整控件的可见性。

使用 ExoVideoView

1.依赖

最简单的方式是加入gradle依赖。请确认在工程的build.gradle中添加了JCenter和google()。

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

然后在你的项目中添加如下代码：

implementation 'com.github.JarvanMo:ExoVideoView:2.1.6'

2.在xml中定义

在xml中使用 ExoVideoView:

<com.jarvanmo.exoplayerview.ui.ExoVideoView
     android:id="@+id/videoView"
     android:layout_width="match_parent"
     android:layout_height="300dp"/>

3.在java代码中

ExoVideoView 提供了内建Player：

SimpleMediaSource mediaSource = new SimpleMediaSource(url);//也支持uri
videoView.play(mediaSource);
videoView.play(mediaSource,where);//play from a particular position

也可以使用自义的Player:

videoView.setPlayer(player);

提示:不要忘记释放ExoPlayer:

videoView.releasePlayer();

详情请移步demo.

3.方向管理

ExoVideoView 可以自动处理方向问题，前提是为ExoVideoView设置一个OrientationListener:

    videoView.setOrientationListener(orientation -> {
            if (orientation == SENSOR_PORTRAIT) {
                //do something
            } else if (orientation == SENSOR_LANDSCAPE) {
                //do something
            }
        });

提示：当ExoVideoView自动处理方向问题时，如果在Controller中的context是Activity,那么系统会调用 activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE) or activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR_PORTRAIT); 全屏事件处理也是如此。

4返回管理

首先,重写onKeyDown:

    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {

        if (keyCode == KeyEvent.KEYCODE_BACK) {
            return videoView.onKeyDown(keyCode, event);
        }
        return super.onKeyDown(keyCode, event);
    }

为ExoVideoView设置监听:

    videoView.setBackListener((view, isPortrait) -> {
            if (isPortrait) {
              //do something
            }
            return false;
        });

如果返回值是 true, 系统后续动作会被中断.否则，ExoVideoView会自动处理方向，并且会回调OrientationLister.onOrientationChange() .

高级

1.多清晰度支持

ExoVideoView 内置清晰度选择器.如果开启发多清晰度并添加了多清晰度，内置清晰度选择器将被加入overlayFrameLayout.

        List<ExoMediaSource.Quality> qualities = new ArrayList<>();
        ExoMediaSource.Quality quality =new SimpleQuality(quality,mediaSource.url());
        qualities.add(quality);
        mediaSource.setQualities(qualities);

2.Controller显示模式

ExoVideoPlaybackController 被分为四个部分:

1.Top
2.Top Landscape
3.Bottom
4.Bottom Landscape

每一部分都可以被显示或隐藏:

 app:controller_display_mode="all|none|top|top_landscape|bottom|bottom_landscape"

在java中:

  videoView.setControllerDisplayMode(mode);

3.为controller添加控件

ExoVideoPlaybackController 允许在java代码中添加控件.

  videoView.addCustomView(ExoVideoPlaybackControlView.CUSTOM_VIEW_TOP, view);
  videoView.addCustomView(ExoVideoPlaybackControlView.CUSTOM_VIEW_TOP_LANDSCAPE, view);
  videoView.addCustomView(ExoVideoPlaybackControlView.CUSTOM_VIEW_BOTTOM_LANDSCAPE, view);

4.使用自定义controller

exo_video_playback_control_view.xml是允许自定义的。其中一些属性在ExoVideoPlaybackControlView有定义。具体可看源码。

app:controller_layout_id="@layout/my_controller"

5.更改控件可见性

有些时候我们可能不太喜欢返回，所以就让我们隐藏起来吧：

videoView.changeWidgetVisibility(R.id.exo_player_controller_back,View.INVISIBLE);

获取更多可隐藏的控件,参看 ids_in_controller;

注意：这么做可能比较危险，我不敢保证隐藏以后的效果。

其他

  app:controller_background="@android:color/holo_orange_dark"
  app:use_artwork="true"
  app:default_artwork="@drawable/default_art"