# GSYVideoPlayer **Repository Path**: yanglei324/GSYVideoPlayer ## Basic Information - **Project Name**: GSYVideoPlayer - **Description**: 基于IJKPlayer（兼容系统MediaPlayer与EXOPlayer2），实现了多功能的视频播放器。 - **Primary Language**: Android - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 60 - **Forks**: 13 - **Created**: 2019-01-24 - **Last Updated**: 2025-06-05 ## Categories & Tags **Categories**: multimedia, android-modules **Tags**: None ## README ![](https://github.com/CarGuo/GSYVideoPlayer/blob/master/img/home_logo.png) ## 基于[IJKPlayer](https://github.com/Bilibili/ijkplayer)（兼容系统MediaPlayer与EXOPlayer2），实现了多功能的视频播放器。 (请仔细阅读下方各项说明，大多数问题可在下方找到解答)。 类型 | 功能 -------- | --- **缓存**|**边播边缓存，使用了[AndroidVideoCache](https://github.com/danikula/AndroidVideoCache)；ExoPlayer使用SimpleCache。** **协议**|**h263\4\5、Https、concat、rtsp、hls、rtmp、crypto、mpeg等等。[（ijk模式格式支持）](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/DECODERS.md)** **滤镜**|**简单滤镜（马赛克、黑白、色彩过滤、高斯、模糊、模糊等等20多种）、动画、（水印、画面多重播放等）。** **帧图**|**视频第一帧、视频帧截图功能，视频生成gif功能。** **播放**|**列表播放、列表连续播放、重力旋转与手动旋转、视频本身rotation旋转属性、快播和慢播、网络视频加载速度。** **画面**|**调整显示比例:默认、16:9、4:3、填充；播放时旋转画面角度（0,90,180,270）；镜像旋转。** **内核**|**IJKPlayer、EXOPlayer、MediaPlayer切换、自定义内核** **布局**|**全屏与非全屏两套布局切换、没有任何操作控件的纯播放支持、弹幕功能、继承自定义任何布局。** **播放**|**单例播放、多个同时播放、视频列表滑动自动播放、列表切换详情页面无缝播放。** **窗口**|**小窗口、多窗体下（包括桌面）的小窗口播放。** **广告**|**片头广告、跳过广告支持、中间插入广告功能。** **更多**|**暂停前后台切换不黑屏；调整不同清晰度的支持；无缝切换支持；锁定/解锁全屏点击功能；进度条小窗口预览（测试）。** **自定义**|**可自定义渲染层、自定义管理层、自定义播放层（控制层）、自定义缓存层。** [ ![Download](https://api.bintray.com/packages/carguo/GSYVideoPlayer/gsyVideoPlayer-java/images/download.svg) ](https://bintray.com/carguo/GSYVideoPlayer/gsyVideoPlayer-java/_latestVersion) [![](https://jitpack.io/v/CarGuo/GSYVideoPlayer.svg)](https://jitpack.io/#CarGuo/GSYVideoPlayer) [ ![Download](https://api.bintray.com/packages/carguo/GSYVideoPlayer/gsyVideoPlayer/images/download.svg) ](https://bintray.com/carguo/GSYVideoPlayer/gsyVideoPlayer/_latestVersion) [![Build Status](https://travis-ci.org/CarGuo/GSYVideoPlayer.svg?branch=master)](https://travis-ci.org/CarGuo/GSYVideoPlayer) []() [![GitHub stars](https://img.shields.io/github/stars/CarGuo/GSYVideoPlayer.svg)](https://github.com/CarGuo/GSYVideoPlayer/stargazers) [![GitHub forks](https://img.shields.io/github/forks/CarGuo/GSYVideoPlayer.svg)](https://github.com/CarGuo/GSYVideoPlayer/network) [![GitHub issues](https://img.shields.io/github/issues/CarGuo/GSYVideoPlayer.svg)](https://github.com/CarGuo/GSYVideoPlayer/issues) [![GitHub license](https://img.shields.io/github/license/CarGuo/GSYVideoPlayer.svg)](https://github.com/CarGuo/GSYVideoPlayer/blob/master/LICENSE) ### [-----------------微信赞赏链接-----------------](https://github.com/CarGuo/GSYVideoPlayer/blob/master/img/thanks.jpg) ### [--------------Demo APK 下载地址---------------](https://github.com/CarGuo/GSYVideoPlayer/releases) ## 一、使用依赖 #### 6.0版本调整了部分API，请查看：[--- 版本更新说明 - 入口](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/UPDATE_VERSION.md)。 ### 1、JCenter 引入方法（推荐） **你可以选择下面三种的其中一种，在module下的build.gradle添加。** #### A、直接引入 ``` //完整版引入 implementation 'com.shuyu:GSYVideoPlayer:6.0.3' ``` #### B、添加java和你想要的so支持： ``` implementation 'com.shuyu:gsyVideoPlayer-java:6.0.3' //是否需要ExoPlayer模式 implementation 'com.shuyu:GSYVideoPlayer-exo2:6.0.3' //根据你的需求ijk模式的so implementation 'com.shuyu:gsyVideoPlayer-armv5:6.0.3' implementation 'com.shuyu:gsyVideoPlayer-armv7a:6.0.3' implementation 'com.shuyu:gsyVideoPlayer-arm64:6.0.3' implementation 'com.shuyu:gsyVideoPlayer-x64:6.0.3' implementation 'com.shuyu:gsyVideoPlayer-x86:6.0.3' ``` #### C、支持其他格式协议的（mpeg，rtsp, concat、crypto协议） A、B普通版本支持263/264/265等，对于mpeg编码会有声音无画面情况。 C 引入的so支持mpeg编码和其他补充协议，但是so包相对变大。 ``` implementation 'com.shuyu:gsyVideoPlayer-java:6.0.3' //是否需要ExoPlayer模式 implementation 'com.shuyu:GSYVideoPlayer-exo2:6.0.3' //更多ijk的编码支持 implementation 'com.shuyu:gsyVideoPlayer-ex_so:6.0.3' ``` ### [--- 更多依赖方式请点击 - ](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/DEPENDENCIES.md) ## 二、其他推荐 ### * QQ群，有兴趣的欢迎（平时吹水吐槽多，因为人数饱和，目前开启付费入群）：174815284 。 ### * [Flutter Github客户端](https://github.com/CarGuo/GSYGithubAPPFlutter) 、[React Native Github客户端](https://github.com/CarGuo/GSYGithubAPP) 、 [Weex Github客户端](https://github.com/CarGuo/GSYGithubAPPWeex) 、 [原生 Kotlin Github客户端](https://github.com/CarGuo/GSYGithubAPPKotlin) ### * [RickText](https://github.com/CarGuo/RickText) ### * [LazyRecyclerAdapter](https://github.com/CarGuo/LazyRecyclerAdapter) ## 三、文档Wiki 文档 | 传送门 -------- | --- **使用说明**|***[--- 简单使用，快速上手文档](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/USE.md)*** **项目解析说明**|***[--- 项目解析说明、包含项目架构和解析](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/GSYVIDEO_PLAYER_PROJECT_INFO.md)*** 接口文档入口|**[--- 使用说明、接口文档 - 入口](https://github.com/CarGuo/GSYVideoPlayer/wiki)** **问题集锦入口**|***[--- 问题集锦 - 入口（大部分你遇到的问题都在这里解决） ](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/QUESTION.md)*** 编码格式|**[--- IJK模式支持视频格式大全](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/DECODERS.md)** 编译自定义SO|**[--- IJKPlayer编译自定义SO - 入口](http://www.jianshu.com/p/bd289e25d272)** 版本更新说明|**[--- 版本更新说明 - 入口](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/UPDATE_VERSION.md)** ![框架图](https://raw.githubusercontent.com/CarGuo/GSYVideoPlayer/master/img/StructureChart2.jpg) ## 四、运行效果 * ### 1、打开一个播放(旋转、镜像、填充) * ### 2、列表/详情模式(动画、旋转、小窗体)
* ### 3、弹幕 * ### 4、滤镜和GL动画 * ### 6、背景铺满模糊播放 * ### 7、进度条小窗口预览 ## 五、近期版本 ### 6.0.3(2019-01-15) * update exoPlayer to 2.9.3 * update gradle 3.3.0 * update build sdk 28 * update support sdk 27.1.1 * 修復exoplayer内核的一些问题。 ### 6.0.2(2018-12-21) * update exoPlayer to 2.9.1 * Deprecated setupLazy * fix exoPlayer looper * add `overrideExtension` to exoPlayer ### 6.0.1 (2018-10-14) * 正式发布6.0版本，调整player和cache加载模式。 ``` PlayerFactory.setPlayManager(Exo2PlayerManager.class);//EXO模式 PlayerFactory.setPlayManager(SystemPlayerManager.class);//系统模式 PlayerFactory.setPlayManager(IjkPlayerManager.class);//ijk模式 CacheFactory.setCacheManager(ExoPlayerCacheManager.class);//exo缓存模式，支持m3u8，只支持exo CacheFactory.setCacheManager(ProxyCacheManager.class);//代理缓存模式，支持所有模式，不支持m3u8等 ``` * 修复 ProxyCacheManager header设置无效问题。 * 去除无用资源。 * 修复某种场景下的内存泄漏问题。 ### 更多版本请查阅：[版本更新说明](https://github.com/CarGuo/GSYVideoPlayer/blob/master/doc/UPDATE_VERSION.md) ## 六、关于Issues ``` 提问题前可先查阅上方文档和说明，请在Demo中复现问题。 问题说明： 1、说明那个Demo中哪个页面。 2、问题显现和重现步骤。 3、补充问题的视频流url，截图。 4、补充问题的机型，android版本。 ``` ## 七、混淆 ``` -keep class com.shuyu.gsyvideoplayer.video.** { *; } -dontwarn com.shuyu.gsyvideoplayer.video.** -keep class com.shuyu.gsyvideoplayer.video.base.** { *; } -dontwarn com.shuyu.gsyvideoplayer.video.base.** -keep class com.shuyu.gsyvideoplayer.utils.** { *; } -dontwarn com.shuyu.gsyvideoplayer.utils.** -keep class tv.danmaku.ijk.** { *; } -dontwarn tv.danmaku.ijk.** -keep public class * extends android.view.View{ *** get*(); void set*(***); public (android.content.Context); public (android.content.Context, android.util.AttributeSet); public (android.content.Context, android.util.AttributeSet, int); } ``` ## 温馨提示 ``` 关于自定义和出现问题的请先看问题集锦、demo、issue。 多了解一些音视频的基础常识，对容器，音视频编码，ffmpeg先做一些了解，以及mediacodec等的不同。 尽量少出现为什么别的能播的问题哟。 播放器的可自定义还是挺高的，定制请参考demo，多看源码。现在的功能有些多，demo也在不断的更新。 一些新功能和项目结构也在不断的调整。 欢迎提出问题，谢谢。 ``` ## 依赖大小参考 建议使用ndk过滤，详细参考 [参考第四条 ： 4、NDK的so支持](http://www.jianshu.com/p/86e4b336c17d) ![](https://ooo.0o0.ooo/2017/06/15/5941f343a39f5.png) ## 非常感谢您的支持 #### 撸码不易，如果对你有所帮助，欢迎您的赞赏 ##### 微信赞赏码 ## License ``` 请参看IJKPlayer和AndroidVideoCache相关协议。 项目最开始是从jiecao过来的，改着改着直接重构了。 偶尔有一变量和方法名可能还有点jiaozi的影子，但是基本是一个新项目。 ```