最近公司新需求要增加短视频模块,公司决定使用阿里云的短视频sdk。
阿里云应该是业界大佬了,产品很完善,文档也很规整,但是唯一遗憾的是我可能没有赶上最新的文档,还是有些坑的,因为官网目前是根据3.6.x版本的文档。因此针对3.7.7版本未更新文档前,根据官网文档集成后要么闪退要么一直报错的问题可以参考下,若以后官网文档更新了也可以用作基本集成流程。
那么就在文章里直接说明3.7.7版本短视频安卓sdk的完整集成流程了,这里做集成标准版的参考,其他版本其实同理的问题基本一样。
首先,需要项目最小支持版本18, 下载对应级别sdk(基础版、标准版、专业版),官网下载地址
我这里是以标准版为例,其余版本同理,明显可见与官网文档结构不同的是多了一个AliyunVideoCommon的包,等下会用到。
步骤一:导入文件
官网是按视频录制、视频裁剪、视频编辑三大模块分别导入的,我这里则同时导入了(需要集成基础版的同学不必这么集成,可以根据官网一步步来,因为编辑模块用不到)。
1.将这些选中状态的文件一并复制到项目根目录下:
2.导入.so文件
将app/src/main/jniLibs文件夹下的.so文件,拷贝到工程下指定的的so库中。(若不需要专业版面部识别功能,去掉libAliFaceAREngine.so和libFaceAREngine.so.so)
步骤3:配置gradle
1.引入模块
将下列代码复制到项目的 settings.gradle文件里。
include ':AlivcCore'
include ':AliyunSVideoBase'
include ':AliyunFileDownLoader:downloadermanager'
include ':AliyunSvideoMusic'
include ':AliyunRecorder:record_demo'
include ':AliyunCrop:crop_demo'//裁剪ui模块
include ':AliyunVideoSdk'
include ':AliyunEditor:editor_demo'//编辑模块ui和功能实现模块
include ':AliyunImport:import_demo'//录制、编辑、裁剪的设置ui
2.添加配置文件
由于Demo中所依赖的一些第三方开源库、sdk版本等配置,是通过thirdparty-lib中的配置文件config.gradle做统一管理的,以需要引入该文件。
apply from: 'thirdparty-lib/config.gradle'
将这句代码拷贝到工程级别的bulid.gradle中。
3.添加依赖
下面依赖的代码,加到您工程的主模块(一般是app)的build.gradle中的dependencies里面。
//录制的依赖
implementationproject(':AliyunRecorder:record_demo')
implementation externalAliyunOSS
//裁剪的依赖
implementation project(':AliyunCrop:crop_demo')
//编辑的依赖
api project(':AliyunEditor:editor_demo')
implementation project(':AliyunImport:import_demo')
implementation project(':AliyunFileDownLoader:downloadermanager')
4.添加权限
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
这里就开始有坑点了,记得刚才说过的AliyunVideoCommon包吗?如果你按照官网的来,那么同步gradle的时候就会出现如下情况:
提示说AliyunSVideoBase模块里面依赖了AliyunVideoCommon模块,找不到,所以我们需要新增第一步:在官网的引入模块代码上加入这个包的引入:
include ':AliyunVideoCommon'
编译运行,终于是找到这个包了,但是又新增了一个错误:
找不到这里面的依赖包,具体因该是短信方面的,这里我对比demo找了很久终于发现需要在项目级的build.gradle中新增如下两句代码:
为了方便大家复制,我拿下来:
maven { url"http://maven.aliyun.com/nexus/content/repositories/releases" }
至此,某些同学运行时会出现以下情况,但并不影响,此时项目已经可以正常运行了。
三大模块之录制
录制需要camera权限和存储权限,为保证6.0以上机器可以正确使用您需要申请动态权限,您如果出现界面黑屏或者其他异常情况,请务必保证您拥有权限。
public void startRecord(View view) {
AliyunSnapVideoParam recordParam = new AliyunSnapVideoParam.Builder() .build();
AlivcSvideoRecordActivity.startRecord(this, recordParam);
}
注册一个录制完成之后的跳转Activity,使用时如果需要在录制完成之后跳自定义的页面,可以在AliyunSvideoActionConfig中注册。
//录制完成默认进入编辑页面
AliyunSvideoActionConfig.getInstance().registerRecordFinishActivity("com.aliyun.demo.editor.EditorActivity");
三大模块之裁剪
裁剪需要存储权限,为保证6.0以上机器可以正确使用您需要申请动态权限,您如果出现界面黑屏或者其他异常情况,请务必保证您拥有权限。
AliyunSnapVideoParam mCropParam = new AliyunSnapVideoParam.Builder().build();
AliyunVideoCropActivity.startCropForResult(MainActivity.this,REQUEST_CROP,mCropParam);
在onActivityResult中获取裁剪后视频的路径:
@Override
protected voidonActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode,resultCode,data);
if(requestCode == REQUEST_CROP){
if(resultCode == Activity.RESULT_OK &&data!= null){
int type = data.getIntExtra(MediaActivity.RESULT_TYPE,0);
if(type== MediaActivity.RESULT_TYPE_CROP){
String path =data.getStringExtra(CropKey.RESULT_KEY_CROP_PATH);
Toast.makeText(this,
"文件路径为 "+ path + " 时长为 " +data.getLongExtra(CropKey.RESULT_KEY_DURATION,0),
Toast.LENGTH_SHORT).show();
}
}else if(resultCode== Activity.RESULT_CANCELED){
Toast.makeText(this,"用户取消裁剪",Toast.LENGTH_SHORT).show();
}
}
}
注册一个裁剪完成之后的跳转Activity,使用时如果需要在裁剪完成之后跳自定义的页面,可以在AliyunSvideoActionConfig中注册:
//默认裁剪完成返回上个页面
AliyunSvideoActionConfig.getInstance().registerCropFinishActivity(null);
三大模块之编辑
首先说一下:编辑模块是标准版和专业版才有的,标准版也只有部分功能,基础版就不需要做这个模块了哦
1.将编辑时需要的资源文件(特效、滤镜、水印等)复制到项目的assets目录下
然后初始化Application的oncreate方法,创建MyApplication继承android.app.Application
@Override
public voidonCreate() {
super.onCreate();
QupaiHttpFinal.getInstance().initOkHttpFinal();
com.aliyun.vod.common.httpfinal.QupaiHttpFinal.getInstance().initOkHttpFinal();
DownloaderManager.getInstance().init(this);
}
在AndroidManifest.xml指定创建的Application:
如果按照官网的基本使用方法,则会遇到第三个坑,新版本根本没有这个类了
于是继续对比demo,发现demo中已经弃用了这句代码,而是使用如下代码:
AlivcSvideoEditParamparam = new AlivcSvideoEditParam.Build().build();
com.aliyun.demo.importer.MediaActivity.startImport(MainActivity.this, param);
注册一个编辑合成之后的跳转Activity,使用时如果需要在编辑合成完成之后跳自定义的发布页面,可以在AliyunSvideoActionConfig中注册。
//编辑完成后跳转上传页面
AliyunSvideoActionConfig.getInstance().registerEditFinishActivity("com.aliyun.demo.publish.UploadActivity");
至此。文档更新中出现的三个坑的解决方案已经介绍完毕,如果官网文档更新了就作为一次短暂的记录吧!