FFmpeg开发笔记(五十二)移动端的国产视频播放器GSYVideoPlayer
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开发知识参见