README.md 7.4 KB
Newer Older
S
readme  
shuyu 已提交
1

S
readme  
shuyu 已提交
2
![](https://github.com/CarGuo/GSYVideoPlayer/blob/master/home_logo.png)
S
readme  
shuyu 已提交
3

S
Shuyu Guo 已提交
4 5
## 基于[IJKPlayer](https://github.com/Bilibili/ijkplayer),实现了多功能的视频播放器。 (请仔细阅读下方各项说明,大多数问题可在下方找到解答)。
 
S
readme  
shuyu 已提交
6 7 8 9 10 11
* **支持基本的拖动,声音、亮度调节。**
* **支持边播边缓存,使用了[AndroidVideoCache](https://github.com/danikula/AndroidVideoCache)。**
* **支持视频本身自带rotation的旋转。**
* **增加了重力旋转与手动旋转的同步支持。**
* **支持列表播放。**
* **直接添加控件为封面。**
S
shuyu 已提交
12
* **全屏和播放等的动画效果。**
S
readme  
shuyu 已提交
13 14 15
* **列表的全屏效果优化,多种配置模式。**
* **列表的小窗口播放,可拖动。**
* **网络视频加载速度。**
S
shuyu 已提交
16
* **锁定/解锁全屏点击功能。**
S
shuyu 已提交
17
* **支持快播和慢播。**
S
readme  
shuyu 已提交
18
* **调整显示比例:默认、16:9、4:3。**
19
* **暂停时前后台切换不黑屏**
S
1.4.4  
shuyu 已提交
20
* **调整不同清晰度的支持。**
S
readme  
shuyu 已提交
21
* **支持IJKPlayer和EXOPlayer切换。**
S
shuyu 已提交
22
* **进度条小窗口预览(测试)。**
S
readme  
shuyu 已提交
23
* **Https支持。**
24
* **支持播放时旋转画面角度(0,90,180,270)。**
S
readme  
shuyu 已提交
25
* **连续播放一个列表的视频。**
S
shuyu 已提交
26
* **支持全屏与非全屏两套布局切换**
S
shuyu 已提交
27
* **弹幕支持**
S
shuyu 已提交
28
* **镜像旋转**
S
shuyu 已提交
29
* **完美实现播放、暂停、前后台切换、画面调整等情况不黑屏不突变**
S
Shuyu Guo 已提交
30
* **concat、rtsp、crypto、mpeg**
S
readme  
shuyu 已提交
31

S
shuyu 已提交
32
[![](https://jitpack.io/v/CarGuo/GSYVideoPlayer.svg)](https://jitpack.io/#CarGuo/GSYVideoPlayer)
S
shuyu 已提交
33
[ ![Download](https://api.bintray.com/packages/carguo/GSYVideoPlayer/gsyVideoPlayer/images/download.svg) ](https://bintray.com/carguo/GSYVideoPlayer/gsyVideoPlayer/_latestVersion)
S
readme  
shuyu 已提交
34
[![Build Status](https://travis-ci.org/CarGuo/GSYVideoPlayer.svg?branch=master)](https://travis-ci.org/CarGuo/GSYVideoPlayer)
S
shuyu 已提交
35

S
Shuyu Guo 已提交
36
## 使用依赖(支持jcenter或jitpack)
S
readme  
shuyu 已提交
37

38
### 1、JCenter 引入方法(推荐)
S
shuyu 已提交
39

S
Shuyu Guo 已提交
40
**你可以选择下面三种的其中一种,在module下的build.gradle添加。**
41

S
shuyu 已提交
42
#### A、直接引入
S
shuyu 已提交
43
```
S
shuyu 已提交
44
//完整版引入
S
shuyu 已提交
45
compile 'com.shuyu:GSYVideoPlayer:2.0.3'
S
readme  
shuyu 已提交
46

S
shuyu 已提交
47 48
```

S
shuyu 已提交
49
#### B、添加java和你想要的so支持:
50 51

```
S
shuyu 已提交
52
compile 'com.shuyu:gsyVideoPlayer-java:2.0.3'
53 54

//根据你的需求
S
shuyu 已提交
55 56 57 58 59
compile 'com.shuyu:gsyVideoPlayer-armv5:2.0.3'
compile 'com.shuyu:gsyVideoPlayer-armv7a:2.0.3'
compile 'com.shuyu:gsyVideoPlayer-arm64:2.0.3'
compile 'com.shuyu:gsyVideoPlayer-x64:2.0.3'
compile 'com.shuyu:gsyVideoPlayer-x86:2.0.3'
60 61 62

```

S
shuyu 已提交
63
#### C、支持其他格式协议的(mpeg,rtsp, concat、crypto协议)
64

S
Shuyu Guo 已提交
65 66
A、B普通版本支持263/264/265等,对于mpeg编码会有声音无画面情况。
C 引入的so支持mpeg编码和其他补充协议,但是so包相对变大。
67 68
 
```
S
shuyu 已提交
69
compile 'com.shuyu:gsyVideoPlayer-java:2.0.3' 
70

S
shuyu 已提交
71
compile 'com.shuyu:gsyVideoPlayer-ex_so:2.0.3' 
72 73 74

```

S
shuyu 已提交
75 76 77
#### D、支持使用ijkPlayer的so

```
S
shuyu 已提交
78 79 80 81 82
compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.2'
compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.2'
compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.2'
compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.2'
compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.2'
S
shuyu 已提交
83
```
84

S
readme  
shuyu 已提交
85 86
--------------------------------------------------------------------------------

S
shuyu 已提交
87
### 2、JitPack引入方法
S
shuyu 已提交
88

S
shuyu 已提交
89
#### First、在project下的build.gradle添加
S
readme  
shuyu 已提交
90
```
S
shuyu 已提交
91 92 93 94 95 96
allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}
S
readme  
shuyu 已提交
97
```
S
readme  
shuyu 已提交
98

S
shuyu 已提交
99
#### Sencond、在module下的build.gradle添加
S
readme  
shuyu 已提交
100

S
Shuyu Guo 已提交
101
**你可以选择下面三种的其中一种,在module下的build.gradle添加。**
S
shuyu 已提交
102

S
shuyu 已提交
103
#### A、直接引入
S
readme  
shuyu 已提交
104
```
S
shuyu 已提交
105
//完整版引入
S
shuyu 已提交
106
compile 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer:v2.0.3'
S
shuyu 已提交
107 108 109

```

S
shuyu 已提交
110
#### B、添加java和你想要的so支持:
S
shuyu 已提交
111 112 113

```

S
shuyu 已提交
114
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v2.0.3'
S
shuyu 已提交
115 116

//根据你的需求
S
shuyu 已提交
117 118 119 120 121
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-x64:v2.0.3'
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-x86:v2.0.3'
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-arm64:v2.0.3'
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-armv5:v2.0.3'
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-armv7a:v2.0.3'
S
shuyu 已提交
122 123 124

```

S
shuyu 已提交
125
#### C、支持其他格式协议的(mpeg,rtsp, concat、crypto协议)
S
shuyu 已提交
126

S
Shuyu Guo 已提交
127 128
A、B普通版本支持263/264/265等,对于mpeg编码会有声音无画面情况。
C 方法引入的so支持mpeg编码和其他补充协议,但是so包相对变大。
S
shuyu 已提交
129 130
 
```
S
shuyu 已提交
131
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v2.0.3'
S
shuyu 已提交
132

S
shuyu 已提交
133
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-ex_so:v2.0.3'
S
shuyu 已提交
134

S
readme  
shuyu 已提交
135
```
S
Shuyu Guo 已提交
136
   
S
readme  
shuyu 已提交
137
--------------------------------------------------------------------------------
S
v1.5.8  
shuyu 已提交
138

S
readme  
shuyu 已提交
139
* ### 下方文档以及问题集锦,你想要知道的大部分都在里面。
S
Shuyu Guo 已提交
140 141 142

* ### <a href="https://github.com/CarGuo/GSYVideoPlayer/blob/master/QUESTION.md">有问题请先下面问题集锦中查阅(如依赖不成功,播放不成功等等)。</a>

S
shuyu 已提交
143
* ### QQ群,有兴趣的可以进来(群里平时可能比较吵):174815284 。
S
readme  
shuyu 已提交
144

S
readme  
shuyu 已提交
145 146 147 148
--------------------------------------------------------------------------------

## 文档Wiki

S
shuyu 已提交
149
### [--- 使用说明、接口文档 - 入口](https://github.com/CarGuo/GSYVideoPlayer/wiki)
S
readme  
shuyu 已提交
150

S
readme  
shuyu 已提交
151 152
## 其他

S
shuyu 已提交
153
### [--- 问题集锦 - 入口 ](https://github.com/CarGuo/GSYVideoPlayer/blob/master/QUESTION.md)
S
Shuyu Guo 已提交
154
### [--- 项目支持视频格式(如果遇上黑屏,没声音)](https://github.com/CarGuo/GSYVideoPlayer/blob/master/DECODERS.md)
S
shuyu 已提交
155 156
### [--- IJKPlayer问题 - 入口](http://www.jianshu.com/p/220b00d00deb) 
### [--- IJKPlayer编译自定义SO - 入口](http://www.jianshu.com/p/bd289e25d272) 
S
Shuyu Guo 已提交
157
### [--- 简书详解 (项目的基础)- 入口](http://www.jianshu.com/p/9fe377dd9750)
S
Shuyu Guo 已提交
158
### [--- 版本更新说明 - 入口](https://github.com/CarGuo/GSYVideoPlayer/blob/master/UPDATE_VERSION.md)
S
readme  
shuyu 已提交
159

S
shuyu 已提交
160
 
S
readme  
shuyu 已提交
161
## 运行效果
S
readme  
shuyu 已提交
162 163

* ### 1、打开一个播放
S
Shuyu Guo 已提交
164
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/11.gif" width="240px" height="426px"/>
S
1.1.5  
shuyu 已提交
165

S
readme  
shuyu 已提交
166
* ### 2、列表/详情模式
S
Shuyu Guo 已提交
167 168

<div>
S
Shuyu Guo 已提交
169 170 171
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/22.gif" width="240px" height="426px"/>
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/33.gif" width="240px" height="426px"/>
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/44.gif" width="240px" height="426px"/>
S
Shuyu Guo 已提交
172
</div>
S
shuyu 已提交
173

S
shuyu 已提交
174
* ### 3、弹幕
S
Shuyu Guo 已提交
175
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/55.gif" width="240px" height="426px"/>
S
shuyu 已提交
176 177

* ### 4、进度条小窗口预览
S
Shuyu Guo 已提交
178
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/07.gif" height="240px"/>
S
shuyu 已提交
179

S
shuyu 已提交
180

S
shuyu 已提交
181 182
## 近期版本

S
shuyu 已提交
183 184 185 186 187
### 2.0.3(2017-08-06)
* update ijk to 0.8.2
* fix rtsp 播放问题
* fix 小窗口播放问题
* 调整了部分代码逻辑与结构。
S
shuyu 已提交
188

S
shuyu 已提交
189
### 更多版本请查阅:[版本更新说明](https://github.com/CarGuo/GSYVideoPlayer/blob/master/UPDATE_VERSION.md)
S
readme  
shuyu 已提交
190

S
Shuyu Guo 已提交
191 192 193
-------------------

## 关于Issues
S
shuyu 已提交
194 195 196 197 198 199 200 201 202 203 204 205

```
提问题前可先查阅上方文档和说明,请在Demo中复现问题。

问题说明:

1、说明那个Demo中哪个页面。
2、问题显现和重现步骤。
3、补充问题的视频流url,截图。
4、补充问题的机型,android版本。
```

S
readme  
shuyu 已提交
206
## 混淆
S
shuyu 已提交
207

S
shuyu 已提交
208 209 210
```
-keep class tv.danmaku.ijk.** { *; }
-dontwarn tv.danmaku.ijk.**
211 212
-keep class com.shuyu.gsyvideoplayer.** { *; }
-dontwarn com.shuyu.gsyvideoplayer.**
S
todo  
shuyu 已提交
213
```
214

S
Shuyu Guo 已提交
215
## 依赖大小参考
S
Shuyu Guo 已提交
216
建议使用ndk过滤,详细参考 [参考第四条 : 4、NDK的so支持](http://www.jianshu.com/p/86e4b336c17d)
S
Shuyu Guo 已提交
217 218 219
![](https://ooo.0o0.ooo/2017/06/15/5941f343a39f5.png)


220 221 222 223
## License

```
请参看IJKPlayer和AndroidVideoCache相关协议。
S
Shuyu Guo 已提交
224
项目最开始是从jiecao过来的,只是后来方向不同,所以慢慢的也异化了。
S
Shuyu Guo 已提交
225
```