EasyPusher是一款国产的RTSP直播录制推流客户端工具,它支持Windows、Linux、Android、iOS等操作系统。EasyPusher采用RTSP推流协议,其中安卓版EasyPusher的Github托管地址为https://github.com/EasyDarwin/EasyPusher-Android。
不过EasyPusher有好几年没更新了,尤其安卓版的EasyPusher仍在调用过时的support支持库,而非推出多年的AndroidX库。为了让EasyPusher-Android源码能够在最新的Android Studio上跑起来,需要对下载后的EasyPusher-Android源码进行若干改造。以下的改造内容基于Android Studio Dolphin(小海豚版本),详细的改造步骤说明如下。
1、升级编译的SDK版本
使用Android Studio Dolphin打开下载后的EasyPusher-Android项目,把模块build.gradle里面的compileSdkVersion和targetSdkVersion都从26改为28,因为小海豚版本的Android Studio最低支持到API28。
2、迁移到Androidx
上个步骤修改了模块build.gradle,单击"Sync Now"同步配置变动。等待同步完成,依次选择顶部菜单:Refactor→Migrate to AndroidX,表示把App工程迁移到AndroidX支持库,接着Android Studio就自动把App工程里的support库配置与相关类统统换成AndroidX的相应对象。
3、指定本地NDK的版本号
然后依次选择顶部菜单:Build→Make Project,发现App编译报错"No toolchains found in the NDK toolchains folder for ABI with prefix: arm-linux-androideabi",这是因为Android Studio没找到合适的NDK版本。解决办法是在配置文件中指定本地NDK的版本号(注意事先在SDK Manager中勾选对应版本的ndk,具体参见《FFmpeg开发实战:从零基础到短视频上线》一书第12章的"12.1.1 搭建Android的NDK开发环境"),打开模块build.gradle,把下面这行
buildToolsVersion '28.0.3'
改为下面这行
//buildToolsVersion '28.0.3'
ndkVersion '21.4.7075529' // 这里的ndkVersion改为自己电脑上的ndk版本号
接着单击"Sync Now"同步配置变动。
4、升级App工程的Gradle版本号
然后依次选择顶部菜单:Build→Make Project,发现App编译报错"java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException",这是因为EasyPusher-Android默认的Gradle版本太低。解决办法是升级EasyPusher-Android项目的Gradle版本号,先把gradle/wrapper/gradle-wrapper.properties里的distributionUrl值改为下面这个:
https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
再把项目级别build.gradle里面的节点路径buildscript→dependencies→classpath值改为下面这个:
'com.android.tools.build:gradle:4.2.1'
接着单击"Sync Now"同步配置变动。
5、编译并运行EasyPusher-Android
然后依次选择顶部菜单:Build→Make Project,等待编译通过后依次选择顶部菜单:Run→Run 'app',在调试的真机上即可看到EasyPusher-Android的App界面如下图所示。
点击App界面右下角的设置按钮,打开设置页面如下图所示,注意修改上方编辑框中的服务端推流地址,比如rtsp://124.70.***.***/live/test。
注意,由于EasyPusher仅支持RTSP推流,不支持RTMP等其他推流协议,因此上面只能填写RTSP推流链接。至于服务端的流媒体服务器,可采用ZLMediaKit,有关ZLMediaKit的使用说明详见之前的文章《Linux环境安装ZLMediaKit实现视频推流》。
更多详细的FFmpeg开发知识参见《FFmpeg开发实战:从零基础到短视频上线》一书。