Logo
Project Icon

GSYVideoPlayer

多内核安卓视频播放器 支持自定义和丰富功能

GSYVideoPlayer视频播放器多功能自定义缓存Github开源项目

GSYVideoPlayer是一款开源的安卓视频播放器，集成了IJKPlayer、Media3、MediaPlayer和AliPlayer等多种内核。它支持边播边缓存、多协议播放、滤镜效果、帧截图等基础功能,还提供自定义布局、广告插入、字幕显示等高级特性。该播放器功能丰富,扩展性强,适合开发者快速实现各类视频播放需求。

访问官网访问官网GithubGithub文档文档论文论文
介绍相关项目

支持 IJKPlayer、Media3(EXOPlayer2)、MediaPlayer、AliPlayer，实现了多功能的视频播放器。（请仔细阅读下方各项说明，大多数问题可在下方找到解答）。

鸿蒙版本openharmony-tpc/GSYVideoPlayer

如果克隆太慢或者图片看不到，可尝试从码云地址下载

类型功能
缓存边播边缓存，使用了AndroidVideoCache；Media3(ExoPlayer)使用SimpleCache。
协议h263\4\5、Https、concat、rtsp、hls、rtmp、crypto、mpeg等等。（ijk模式格式支持）
滤镜简单滤镜（马赛克、黑白、色彩过滤、高斯、模糊、模糊等等20多种）、动画、（水印、画面多重播放等）。
帧图视频第一帧、视频帧截图功能，视频生成gif功能。
播放列表播放、列表连续播放、重力旋转与手动旋转、视频本身rotation旋转属性、快播和慢播、网络视频加载速度。
画面调整显示比例：默认、16:9、4:3、填充；播放时旋转画面角度（0,90,180,270）；镜像旋转。
内核IJKPlayer、Media3(EXOPlayer)、MediaPlayer、AliPlayer切换、自定义内核
布局全屏与非全屏两套布局切换、没有任何操作控件的纯播放支持、弹幕功能、继承自定义任何布局。
播放单例播放、多个同时播放、视频列表滑动自动播放、列表切换详情页面无缝播放。
窗口小窗口、多窗体下（包括桌面）的小窗口播放。
广告片头广告、跳过广告支持、中间插入广告功能。
字幕media3(exo2)模式下支持自定增加外挂字幕。
dashmedia3(exo2) 模式支持dash
stream支持元数据播放
适配 16kex_so 适配 16K Page Size
openssl目前 arm64 使用 openssl 1.1.1w
FFmpeg目前 arm64 使用 FFmpeg 4.1.6
更多暂停前后台切换不黑屏；调整不同清晰度的支持；无缝切换支持；锁定/解锁全屏点击功能；进度条小窗口预览（测试）。
自定义可自定义渲染层、自定义管理层、自定义播放层（控制层）、自定义缓存层。

构建状态 Github Actions GitHub stars GitHub forks GitHub issues GitHub license

公众号掘金知乎CSDN简书
GSYTech点我点我点我点我

--------------Demo APK 下载地址---------------

一、使用依赖

--- 版本更新说明 --- 。

1、Jitpack 引入方法（推荐，JCenter 即将关闭）

首先，在项目的 build.gradle 中添加

allprojects {
    repositories {
		...
        maven { url 'https://jitpack.io' }
        maven { url "https://maven.aliyun.com/repository/public" }
    }
}

你可以选择以下三种方式中的一种，在模块的 build.gradle 中添加。

A、直接引入

 //完整版引入
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer:v9.0.0-release-jitpack'


 //是否需要 AliPlayer 模式
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer-aliplay:v9.0.0-release-jitpack'

B、添加 Java 和你想要的 so 支持：

 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v9.0.0-release-jitpack'

 //是否需要 ExoPlayer 模式
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer-exo2:v9.0.0-release-jitpack'

 //是否需要 AliPlayer 模式
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer-aliplay:v9.0.0-release-jitpack'

 //根据你的需求选择 ijk 模式的 so
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-arm64:v9.0.0-release-jitpack'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-armv7a:v9.0.0-release-jitpack'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-armv5:v9.0.0-release-jitpack'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-x86:v9.0.0-release-jitpack'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-x64:v9.0.0-release-jitpack'

C、支持其他格式协议（mpeg、rtsp、concat、crypto 协议，支持 16k 页面大小）

A、B 普通版本支持 263/264/265 等，对于 mpeg 编码会出现有声音无画面的情况。 C 引入的 so 支持 mpeg 编码和其他补充协议，但 so 包相对较大。

 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v9.0.0-release-jitpack'

 //是否需要 ExoPlayer 模式
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer-exo2:v9.0.0-release-jitpack'

 //是否需要 AliPlayer 模式
 implementation 'com.github.CarGuo.GSYVideoPlayer:GSYVideoPlayer-aliplay:v9.0.0-release-jitpack'

 //更多 ijk 的编码支持
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-ex_so:v9.0.0-release-jitpack'

代码中的全局切换支持（更多请参看下方文档和 demo）


//EXOPlayer 内核，支持更多格式
PlayerFactory.setPlayManager(Exo2PlayerManager.class);
//系统内核模式
PlayerFactory.setPlayManager(SystemPlayerManager.class);
//ijk 内核，默认模式
PlayerFactory.setPlayManager(IjkPlayerManager.class);
//aliplay 内核，默认模式
PlayerFactory.setPlayManager(AliPlayerManager.class);


//exo 缓存模式，支持 m3u8，只支持 exo
CacheFactory.setCacheManager(ExoPlayerCacheManager.class);
//代理缓存模式，支持所有模式，不支持 m3u8 等，默认
CacheFactory.setCacheManager(ProxyCacheManager.class);
//切换渲染模式
GSYVideoType.setShowType(GSYVideoType.SCREEN_MATCH_FULL);
//默认显示比例
GSYVideoType.SCREEN_TYPE_DEFAULT = 0;
//16:9
GSYVideoType.SCREEN_TYPE_16_9 = 1;
//4:3
GSYVideoType.SCREEN_TYPE_4_3 = 2;
//全屏裁减显示，为了显示正常 CoverImageView 建议使用FrameLayout作为父布局
GSYVideoType.SCREEN_TYPE_FULL = 4;
//全屏拉伸显示，使用这个属性时，surface_container建议使用FrameLayout
GSYVideoType.SCREEN_MATCH_FULL = -4;
/***
 * SCREEN_TYPE_CUSTOM 下自定义显示比例
 * @param screenScaleRatio  高宽比，如 16：9
 */
public static void setScreenScaleRatio(float screenScaleRatio)


//切换绘制模式
GSYVideoType.setRenderType(GSYVideoType.SUFRACE);
GSYVideoType.setRenderType(GSYVideoType.GLSURFACE);
GSYVideoType.setRenderType(GSYVideoType.TEXTURE);


//ijk关闭log
IjkPlayerManager.setLogLevel(IjkMediaPlayer.IJK_LOG_SILENT);


//exoplayer自定义MediaSource
ExoSourceManager.setExoMediaSourceInterceptListener(new ExoMediaSourceInterceptListener() {
    @Override
    public MediaSource getMediaSource(String dataSource, boolean preview, boolean cacheEnable, boolean isLooping, File cacheDir) {
        //可自定义MediaSource
        return null;
    }
});

--- 更多依赖方式请点击 -

二、其他推荐

* 我所在的技术社区：掘金

* QQ群，有兴趣的欢迎（平时吹水吐槽多，因为人数饱和，就是日常瞎扯，没人解决问题的）：174815284 。

* Flutter Github客户端 、React Native Github客户端 、 Weex Github客户端 、 原生 Kotlin Github客户端

* RxFFmpeg Android 的音视频编辑工具

* oarplayer Rtmp播放器,基于MediaCodec与srs-librtmp,不依赖ffmpeg

* 鸿蒙版本openharmony-tpc/GSYVideoPlayer

三、文档Wiki

文档传送门
使用说明--- 简单使用，快速上手文档
建议阅读--- 移动开发者必知的音视频基础知识1、--- 移动开发者必知的音视频基础知识2
项目解析说明--- 项目解析说明、包含项目架构和解析
接口文档入口--- 使用说明、接口文档 - 入口
问题集锦入口--- 问题集锦 - 入口（大部分你遇到的问题都在这里解决）
编码格式--- IJK so文件配置格式说明
编译自定义SO--- IJKPlayer编译自定义SO - 入口
版本更新说明--- 版本更新说明 - 入口
compileSdk 太高--- #3514

框架图

四、运行效果

  • 1、打开一个播放(旋转、镜像、填充)

  • 2、列表/详情模式(动画、旋转、小窗体)

  • 3、弹幕

  • 4、滤镜和GL动画

  • 6、背景铺满模糊播放

  • 7、进度条小窗口预览

五、近期版本

v9.0.0-release-jitpack (2024-07-29)

  • ex_so 支持16k页面大小
  • 更新 media3 1.4.0
  • 修复 #4014
  • 修复 #3999 和 #3649 系统 mediaPlayer setSpeed 导致播放
  • 修复 #3972 ListGSYVideoPlayer 轮播场景焦点未移除导致播放器状态错误

v8.6.0-release-jitpack (2024-03-07)

  • 更新 media 1.3.0
  • 更新 exo 源拦截监听器
  • 修复 #3900

v8.5.0-release-jitpack (2023-11-20)

  • 更新 media 1.2.0 和 compileSdk 34
  • 将 exoplayer 更新为 androidx media
  • 修复 #3874
  • 修复问题 3855 (#3856)
  • 添加 #3843

更多版本请查阅：版本更新说明

六、关于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 com.shuyu.gsyvideoplayer.player.** {*;}
-dontwarn com.shuyu.gsyvideoplayer.player.**
-keep class tv.danmaku.ijk.** { *; }
-dontwarn tv.danmaku.ijk.**
-keep class androidx.media3.** {*;}
-keep interface androidx.media3.**

-keep class com.shuyu.alipay.** {*;}
-keep interface com.shuyu.alipay.**

-keep public class * extends android.view.View{
    *** get*();
    void set*(***);
    public <init>(android.content.Context);
    public <init>(android.content.Context, java.lang.Boolean);
    public <init>(android.content.Context, android.util.AttributeSet);
    public <init>(android.content.Context, android.util.AttributeSet, int);
}

如果是阿里云播放器，可以参考它的文档（https://help.aliyun.com/document_detail/124711.html?spm=a2c4g.124711.0.0.7fa0125dkwUPoU），需要新增一些 keep 规则：

-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

温馨提示

如果克隆太慢，可尝试从码云地址下载

关于自定义和出现问题的请先看问题集锦、demo、issue。

多了解一些音视频的基础常识，对容器，音视频编码，ffmpeg先做一些了解，以及mediacodec等的不同。
尽量少出现为什么别的能播的问题哟。

播放器的可自定义还是挺高的，定制请参考demo，多看源码。现在的功能有些多，demo也在不断的更新。

一些新功能和项目结构也在不断的调整。

欢迎提出问题，谢谢。

依赖大小参考

建议使用NDK进行过滤，详细参考 第四条：4、NDK的so支持

Star历史图表

Star历史图表

温馨提示

开源项目主要用于交流学习，不提供技术支持，也不接受商务合作，纯属兴趣驱动的公益开源项目

许可证

请参阅IJKPlayer和AndroidVideoCache相关协议。
该项目最初源自jiecao，经过不断修改最终完全重构。
偶尔可能还能看到一些变量和方法名带有jiaozi的痕迹，但基本上已经是一个全新的项目。
相关项目
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手，通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能，支持100+编程语言，与主流编辑器无缝集成，显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台，能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐，Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案，通过智能技术简化视频制作流程。无论是企业宣传还是个人分享，有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持，能够阅读和理解用户上传的文件内容，解析网页信息，并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题，Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术，为商家提供一键生成商品图和营销文案的服务，显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台，让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型，免费访问各种图像生成与AI训练工具，从Stable Diffusion等基础模型开始，轻松实现创新图像生成。体验前沿的AI技术，推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器，它将改变您观看视频的方式！SubCat结合了先进的人工智能技术，为您提供即时视频字幕翻译，无论是本地视频还是网络流媒体，让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台，利用前沿AI技术，为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图，再到文案生成，美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具，简化了选题、文献检索至论文撰写的整个过程。通过简单设定，平台可快速生成高质量论文大纲和全文，配合图表、参考文献等一应俱全，同时提供开题报告和答辩PPT等增值服务，保障数据安全，有效提升写作效率和论文质量。

使用协议隐私政策广告服务
投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号