导入编辑

简介

阿里云短视频SDK编辑模块提供了视频特效的编辑能力。具备滤镜、音乐、动图、字幕、MV、音效、特效、变速、转场、涂鸦等视频编辑功能。开发者可以通过简单的几步快速让自己的App拥有专业视频编辑的能力，还可以通过配置文件个性化定制视频编辑页面的UI风格。同时，您也可以参考Demo，使用SDK深度定制属于您自己的编辑模块。

编辑功能集成

tips：编辑功能只支持标准版&专业版并且集成步骤一致，功能通过License控制。

创建示例工程SVideoEditorDemo。

步骤1. 文件导入

• 拷贝必须的library和gradle相关文件夹到示例工程

• 模块说明

• 将assets拷贝到工程中

• assets

tips: 视频编辑所需要的基础资源，zip文件需要放在目录AliyunEditorDemo下。

步骤2. 引入包和build.gradle设置

• 在Android Project 的settings.gradle文件中添加以下引用

include ':AliyunSVideoBase'//短视频基础包
include ':AliyunSvideoMusic'//短视频音乐控件
include ':AliyunEditor:editor_demo'//编辑模块ui和功能实现模块
include ':AliyunCrop:crop'//裁剪ui模块
include ':AlivcMedia'//媒体资源选择库
include ':AliyunVideoCommon'//
include ':AliyunFileDownLoader'//资源数据库和下载模块

• build.gradle中添加ndk和dependencies配置

defaultConfig {
        //...
        ndk {
            abiFilters "armeabi-v7a","arm64-v8a"
            //短视频目前不支持x86架构
        }
    }
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    //...
    //短视频专业版依赖库
    implementation project(':AliyunEditor')
    implementation project(':AliyunFileDownLoader')
    implementation project(':AliyunSVideoBase')
}

• 在工程的build.gradle中添加thirdparty-lib/config.gradle的应用

buildscript {
        //...
        apply from: 'thirdparty-lib/config.gradle'
        dependencies {
            classpath '...'
    }
}

• 在工程的build.gradle中添加maven仓库地址

allprojects {
    repositories {
        google()
        jcenter()
        maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
    }
}

步骤3. 添加权限

在AndroidManifest.xml文件中加入以下权限，添加过的可以跳过此步骤。

    <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" />

Android 6.0以上系统需要做动态权限请求。

步骤4. 在Application的oncreate方法中做初始化

• 创建MyApplication继承android.app.Application

    @Override
    public void onCreate() {
        super.onCreate();
        QupaiHttpFinal.getInstance().initOkHttpFinal();
        DownloaderManager.getInstance().init(this);
    }

• 在AndroidManifest.xml指定创建的Application

• 如果项目中已经指定了自己Application，则只需要将onCreate中的方法添加到自己的Application。

步骤5. 功能使用

tips：编辑需要存储权限，为保证6.0以上机器可以正确使用您需要申请动态权限，您如果出现界面黑屏或者其他异常情况，请务必保证您拥有权限。

• 使用默认参数进入编辑功能

        AlivcEditInputParam param = new AlivcEditInputParam.Builder()
            .build();
        EditorMediaActivity.startImport(this, param);

• UI配置

  UI配置需要为Activity指定主题，定义如下(非必须指定，如不指定即为默认主题)。

<style name="AlivcEditUIStyle" parent="Theme.AppCompat.Light.NoActionBar">
    <!--滤镜item对应的图片-->
    <item name="filterImage">@mipmap/aliyun_svideo_filter</item>
    <!--音乐图标-->
    <item name="musicImage">@mipmap/aliyun_svideo_music</item>
    <!--动图图标-->
    <item name="pasterImage">@mipmap/aliyun_svideo_overlay</item>
    <!--字幕图标-->
    <item name="captionImage">@mipmap/aliyun_svideo_caption</item>
    <!--MV图标-->
    <item name="mvImage">@mipmap/aliyun_svideo_mv</item>
    <!--特效图标-->
    <item name="effectImage">@mipmap/alivc_svideo_effect</item>
    <!--时间特效图标-->
    <item name="timeImage">@mipmap/aliyun_svideo_time</item>
    <!--转场图标-->
    <item name="translationImage">@mipmap/aliyun_svideo_transition</item>
    <!--涂鸦图标-->
    <item name="paintImage">@mipmap/aliyun_svideo_paint</item>
    <!--播放对应图标-->
    <item name="playImage">@mipmap/aliyun_svideo_play</item>
    <!--暂停对应图标-->
    <item name="pauseImage">@mipmap/aliyun_svideo_pause</item>
    <!--编辑完成对应图标-->
    <item name="finishImage">@mipmap/aliyun_svideo_complete_red</item>
</style>