![logo](./images/default_art.png)
# ExoVideoView
![demo](./images/demo.gif)
ExoVideoView 是一款基于[ExoPlayer](https://github.com/google/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:
```xml
```
### 3.在java代码中
ExoVideoView 提供了内建```Player```:
```java
SimpleMediaSource mediaSource = new SimpleMediaSource(url);//也支持uri
videoView.play(mediaSource);
videoView.play(mediaSource,where);//play from a particular position
```
也可以使用自义的Player:
```java
videoView.setPlayer(player);
```
提示:不要忘记释放ExoPlayer:
```java
videoView.releasePlayer();
```
详情请移步[demo]().
### 3.方向管理
ExoVideoView 可以自动处理方向问题,前提是为ExoVideoView设置一个OrientationListener:
```java
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:
```java
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_BACK) {
return videoView.onKeyDown(keyCode, event);
}
return super.onKeyDown(keyCode, event);
}
```
为ExoVideoView设置监听:
```java
videoView.setBackListener((view, isPortrait) -> {
if (isPortrait) {
//do something
}
return false;
});
```
如果返回值是 ```true```, 系统后续动作会被中断.否则,ExoVideoView会自动处理方向,并且会回调```OrientationLister.onOrientationChange()``` .
## 高级
### 1.多清晰度支持
ExoVideoView 内置清晰度选择器.如果开启发多清晰度并添加了多清晰度,内置清晰度选择器将被加入```overlayFrameLayout```.
```java
List 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
```
每一部分都可以被显示或隐藏:
```xml
app:controller_display_mode="all|none|top|top_landscape|bottom|bottom_landscape"
```
在java中:
```java
videoView.setControllerDisplayMode(mode);
```
### 3.为controller添加控件
```ExoVideoPlaybackController``` 允许在java代码中添加控件.
```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```有定义。具体可看源码。
```xml
app:controller_layout_id="@layout/my_controller"
```
### 5.更改控件可见性
有些时候我们可能不太喜欢返回,所以就让我们隐藏起来吧:
```java
videoView.changeWidgetVisibility(R.id.exo_player_controller_back,View.INVISIBLE);
```
获取更多可隐藏的控件,参看 [ids_in_controller](./exoplayerview/src/main/res/values/ids.xml);
> 注意:这么做可能比较危险,我不敢保证隐藏以后的效果。
## 其他
```
app:controller_background="@android:color/holo_orange_dark"
app:use_artwork="true"
app:default_artwork="@drawable/default_art"
```