README.md 7.3 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
* **支持边播边缓存,使用了[AndroidVideoCache](https://github.com/danikula/AndroidVideoCache)。**
S
Shuyu Guo 已提交
7 8
* **支持视频本身rotation旋转属性。**
* **支持重力旋转与手动旋转。**
S
readme  
shuyu 已提交
9
* **支持列表播放。**
S
Shuyu Guo 已提交
10 11 12 13
* **支持全屏切换动画效果。**
* **支持小窗口播放,可拖动。**
* **支持网络视频加载速度。**
* **支持锁定/解锁全屏点击功能。**
S
shuyu 已提交
14
* **支持快播和慢播。**
S
Shuyu Guo 已提交
15
* **支持调整显示比例:默认、16:9、4:3、填充。**
16
* **支持播放时旋转画面角度(0,90,180,270)。**
S
Shuyu Guo 已提交
17 18 19 20 21 22 23
* **支持镜像旋转**
* **支持暂停前后台切换不黑屏**
* **支持调整不同清晰度的支持。**
* **支持IJKPlayer和EXOPlayer切换。**
* **支持进度条小窗口预览(测试)。**
* **支持Https**
* **支持列表连续播放**
S
shuyu 已提交
24
* **支持全屏与非全屏两套布局切换**
S
Shuyu Guo 已提交
25 26
* **支持弹幕功能**
* **支持concat、rtsp、crypto、mpeg等**
S
readme  
shuyu 已提交
27

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

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

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

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

S
shuyu 已提交
38
#### A、直接引入
S
shuyu 已提交
39
```
S
shuyu 已提交
40
//完整版引入
S
shuyu 已提交
41
compile 'com.shuyu:GSYVideoPlayer:2.0.3'
S
readme  
shuyu 已提交
42

S
shuyu 已提交
43 44
```

S
shuyu 已提交
45
#### B、添加java和你想要的so支持:
46 47

```
S
shuyu 已提交
48
compile 'com.shuyu:gsyVideoPlayer-java:2.0.3'
49 50

//根据你的需求
S
shuyu 已提交
51 52 53 54 55
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'
56 57 58

```

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

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

S
shuyu 已提交
67
compile 'com.shuyu:gsyVideoPlayer-ex_so:2.0.3' 
68 69 70

```

S
shuyu 已提交
71 72 73
#### D、支持使用ijkPlayer的so

```
S
shuyu 已提交
74 75 76 77 78
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 已提交
79
```
80

S
readme  
shuyu 已提交
81 82
--------------------------------------------------------------------------------

S
shuyu 已提交
83
### 2、JitPack引入方法
S
shuyu 已提交
84

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

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

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

S
shuyu 已提交
99
#### A、直接引入
S
readme  
shuyu 已提交
100
```
S
shuyu 已提交
101
//完整版引入
S
shuyu 已提交
102
compile 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer:v2.0.3'
S
shuyu 已提交
103 104 105

```

S
shuyu 已提交
106
#### B、添加java和你想要的so支持:
S
shuyu 已提交
107 108 109

```

S
shuyu 已提交
110
compile 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v2.0.3'
S
shuyu 已提交
111 112

//根据你的需求
S
shuyu 已提交
113 114 115 116 117
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 已提交
118 119 120

```

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

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

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

S
readme  
shuyu 已提交
131
```
S
Shuyu Guo 已提交
132
   
S
readme  
shuyu 已提交
133
--------------------------------------------------------------------------------
S
v1.5.8  
shuyu 已提交
134

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

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

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

S
readme  
shuyu 已提交
141 142 143 144
--------------------------------------------------------------------------------

## 文档Wiki

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

S
readme  
shuyu 已提交
147 148
## 其他

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

S
shuyu 已提交
156
 
S
readme  
shuyu 已提交
157
## 运行效果
S
readme  
shuyu 已提交
158

S
Shuyu Guo 已提交
159
* ### 1、打开一个播放(旋转、镜像、填充)
S
Shuyu Guo 已提交
160
<img src="https://github.com/CarGuo/GSYVideoPlayer/blob/master/11.gif" width="240px" height="426px"/>
S
1.1.5  
shuyu 已提交
161

S
Shuyu Guo 已提交
162
* ### 2、列表/详情模式(动画、旋转、小窗体)
S
Shuyu Guo 已提交
163 164

<div>
S
Shuyu Guo 已提交
165 166 167
<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 已提交
168
</div>
S
shuyu 已提交
169

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

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

S
shuyu 已提交
176

S
shuyu 已提交
177 178
## 近期版本

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

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

S
Shuyu Guo 已提交
187 188 189
-------------------

## 关于Issues
S
shuyu 已提交
190 191 192 193 194 195 196 197 198 199 200 201

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

问题说明:

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

S
readme  
shuyu 已提交
202
## 混淆
S
shuyu 已提交
203

S
shuyu 已提交
204 205 206
```
-keep class tv.danmaku.ijk.** { *; }
-dontwarn tv.danmaku.ijk.**
207 208
-keep class com.shuyu.gsyvideoplayer.** { *; }
-dontwarn com.shuyu.gsyvideoplayer.**
S
todo  
shuyu 已提交
209
```
210

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


216 217 218 219
## License

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