FFmpeg开发笔记（五十二）移动端的国产视频播放器GSYVideoPlayer

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库。

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

接着打开App模块的build.gradle，在dependencies节点内部内部补充下面配置，表示引入9.0.0版本的GSYVideoPlayer库。

// 支持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，补充下面的互联网权限配置：

<uses-permission android:name="android.permission.INTERNET" />

完成以上三处配置修改之后，才能在App代码中使用GSYVideoPlayer的播放器控件。

三、在App代码中使用播放器

GSYVideoPlayer提供了三种播放器控件，分别是NormalGSYVideoPlayer、GSYADVideoPlayer和ListGSYVideoPlayer，它们在App代码中的用法分别说明如下：

1、普通播放器NormalGSYVideoPlayer

NormalGSYVideoPlayer用来播放单个视频文件，在XML文件中放置该控件的代码如下所示：

<com.shuyu.gsyvideoplayer.video.NormalGSYVideoPlayer
    android:id="@+id/video_player"
    android:layout_width="match_parent"
    android:layout_height="300dp" />

2、广告播放器GSYADVideoPlayer

GSYADVideoPlayer用来播放视频文件的片头广告，注意该控件要和NormalGSYVideoPlayer搭配使用。在XML文件中放置该控件的代码如下所示：

<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文件中放置该控件的代码如下所示：

<com.shuyu.gsyvideoplayer.video.ListGSYVideoPlayer
    android:id="@+id/detail_player"
    android:layout_width="match_parent"
    android:layout_height="300dp" />

在XML文件中放置上述三个播放器的任意一种控件之后，再回到Java代码执行视频播放操作。以NormalGSYVideoPlayer为例，通过Java播放单个视频文件的代码例子如下：

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开发实战：从零基础到短视频上线》一书。