GSYVideoPlayer是一个国产的移动端视频播放器，它采用了IJKPlayer、Media3(EXOPlayer)、MediaPlayer、AliPlayer等四种播放器内核，支持弹幕、滤镜、广告等多项功能。
GSYVideoPlayer的Github主页为https://github.com/CarGuo/GSYVideoPlayer，截止2024年8月18日，该项目的Github星标数为2万，副本数为0.42万，这个成绩算是相当不错的了，要知道FFmpeg项目同期在Github的星标数也才4.44万。 不过在App工程中集成GSYVideoPlayer的话，得注意环境配置以免导入失败。具体的导入操作步骤说明如下：
一、安装Android Studio Jellyfish
虽然GSYVideoPlayer主页没有说明要在哪个版本的Android Studio中导入该库，但在实际操作中发现，即使是前两年推出的Android Studio Dolphin（小海豚版本）都无法正常导入GSYVideoPlayer，就更别说更早的Android Studio了。 若想正常导入并成功调用GSYVideoPlayer，还需安装较新的Android Studio，比如小水母版本的Android Studio Jellyfish。尽管小水母版本的新建App工程采用Kotlin编码，不过GSYVideoPlayer支持Java编码，所以仍然可以在Java代码中调用GSYVideoPlayer。
二、修改App工程的配置
首先打开App项目的settings.gradle，在repositories节点内部补充下面两行仓库配置，以便从指定仓库拉取GSYVideoPlayer库。
代码语言：javascript复制maven { url 'https://jitpack.io' }
maven { url "https://maven.aliyun.com/repository/public" }接着打开App模块的build.gradle，在dependencies节点内部内部补充下面配置，表示引入9.0.0版本的GSYVideoPlayer库。
代码语言：javascript复制// 支持Java
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'
// 支持arm64指令集
implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-arm64:v9.0.0-release-jitpack'然后打开App模块的AndroidManifest.xml，补充下面的互联网权限配置：
代码语言：javascript复制<uses-permission android:name="android.permission.INTERNET" />完成以上三处配置修改之后，才能在App代码中使用GSYVideoPlayer的播放器控件。
三、在App代码中使用播放器
GSYVideoPlayer提供了三种播放器控件，分别是NormalGSYVideoPlayer、GSYADVideoPlayer和ListGSYVideoPlayer，它们在App代码中的用法分别说明如下：
1、普通播放器NormalGSYVideoPlayer
NormalGSYVideoPlayer用来播放单个视频文件，在XML文件中放置该控件的代码如下所示：
代码语言：javascript复制<com.shuyu.gsyvideoplayer.video.NormalGSYVideoPlayer
android:id="@ id/video_player"
android:layout_width="match_parent"
android:layout_height="300dp" />2、广告播放器GSYADVideoPlayer
GSYADVideoPlayer用来播放视频文件的片头广告，注意该控件要和NormalGSYVideoPlayer搭配使用。在XML文件中放置该控件的代码如下所示：
代码语言：javascript复制<RelativeLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.shuyu.gsyvideoplayer.video.NormalGSYVideoPlayer
android:id="@ id/detail_player"
android:layout_width="match_parent"
android:layout_height="300dp" />
<com.shuyu.gsyvideoplayer.video.GSYADVideoPlayer
android:id="@ id/ad_player"
android:layout_width="match_parent"
android:layout_height="300dp"
android:visibility="gone" />
</RelativeLayout>3、列表播放器ListGSYVideoPlayer
ListGSYVideoPlayer用来播放在时间上按顺序排成列表的若干视频文件，在XML文件中放置该控件的代码如下所示：
代码语言：javascript复制<com.shuyu.gsyvideoplayer.video.ListGSYVideoPlayer
android:id="@ id/detail_player"
android:layout_width="match_parent"
android:layout_height="300dp" />在XML文件中放置上述三个播放器的任意一种控件之后，再回到Java代码执行视频播放操作。以NormalGSYVideoPlayer为例，通过Java播放单个视频文件的代码例子如下：
代码语言：javascript复制private static String URL_MP4 = "https://video.zohi.tv/fs/transcode/20240520/8cc/355193-1716184798-transv.mp4";
private NormalGSYVideoPlayer video_player;
private OrientationUtils orientationUtils;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_simple_player);
video_player = findViewById(R.id.video_player);
// 设置旋转
orientationUtils = new OrientationUtils(this, video_player);
// 设置全屏按键功能,这是使用的是选择屏幕，而不是全屏
video_player.getFullscreenButton().setOnClickListener(v -> {
// 不需要屏幕旋转，还需要设置 setNeedOrientationUtils(false)
orientationUtils.resolveByClick();
});
// 不需要屏幕旋转
video_player.setNeedOrientationUtils(false);
findViewById(R.id.btn_play_mp4).setOnClickListener(v -> {
video_player.setUp(URL_MP4, true, "数字中国峰会迎宾曲");
});
}然后运行测试App，观察NormalGSYVideoPlayer播放网络视频的效果如下图所示：
因为NormalGSYVideoPlayer的播放内核基于IJKPlayer、EXOPlayer和AliPlayer，默认就支持HLS、RTMP等直播链接，所以无需改动代码，只要把视频地址换成以m3u8结尾的HLS链接，或者以rtmp开头的RTMP链接，即可让NormalGSYVideoPlayer播放直播内容。利用NormalGSYVideoPlayer播放直播视频的效果图如下所示：
更多详细的FFmpeg开发知识参见《FFmpeg开发实战：从零基础到短视频上线》一书。
