编辑视频

视频源管理操作

//1.获取视频源管理器
AliyunIClipConstructor contructor = AliyunIEditor.getSourcePartManager();


//[可选] 2.添加视频或图片

//在时间轴最后添加视频或图片，其中视频用AliyunVideoClip，图片用AliyunImageClipAliyunImageClip
contructor.addMediaClip(AliyunClip clip);

//在指定位置的添加视频或图片，其中视频用AliyunVideoClip，图片用AliyunImageClipAliyunImageClip
contructor.addMediaClip(int index, AliyunClip clip);

//[可选] 3.删除视频或图片

//删除最后一个视频或图片
contructor.deleteMediaClip();

//删除某一个指定的视频或图片
contructor.deleteMediaClip(int index);

//[可选] 4.替换视频或图片
//替换指定位置视频或图片
contructor.updateMediaClip(int index, AliyunClip clip);

//替换所有的视频或图片
contructor.updateAllClips(List<AliyunClip> clips);


//5.应用更新源：视频源操作完成后，要调用该方法应用更新，操作才会生效
AliyunIEditor.applySourceChange();

其他相关操作

//交换视频源顺序    
contructor.swap(int pos1, int pos2);

//获取当前视频源个数    
contructor.getMediaPartCount();

//获取当前视频源列表    
contructor.getAllClips();

目前支持设置的视频特效包括滤镜、转场和MV，支持自定义制作，制作方法请参见滤镜及转场和MV。代码中需要使用的参数详情，请参考接口文档。接口链接请参见相关类功能。

• 滤镜分为lut滤镜、静态滤镜和动效滤镜。

  • lut滤镜：使用Lookup Table方式进行像素替换。

  • 静态滤镜：通过编写着色语言方式进行像素计算，不支持带动画效果。Bean为EffectBean，接口参数请参考EffectBean。

  • 动效滤镜：通过编写着色语言方式进行像素计算，带动画效果。Bean为EffectFilter，接口参数请参考EffectFilter。

• 目前短视频SDK提供的转场效果包括：TransitionCircle（圆形打开）、TransitionFade（淡入淡出）、TransitionFiveStar（五角星）、TransitionShutter（百叶窗）、TransitionTranslate（平移）。

lut滤镜

LUTEffectBean bean = new LUTEffectBean();
bean.setPath("image_01.png");
bean.setIntensity(1.f);

//添加lut滤镜
mAliyunIEditor.applyLutFilter(bean);
//删除lut滤镜
mAliyunIEditor.applyLutFilter(null);

静态滤镜

EffectBean effect = new EffectBean();
effect.setId(id)
effect.setSource(new Souce(filePath));

//添加滤镜
AliyunIEditor.applyFilter(effect);
//删除滤镜
AliyunIEditor.applyFilter(new EffectBean());

动效滤镜

EffectFilter effectFilter = new EffectFilter(new Souce(filePath));
effectFilter.setStartTime(startTime);
effectFilter.setDuration(duration);

//添加动效滤镜
AliyunIEditor.addAnimationFilter(effectFilter);

//删除指定动效滤镜
AliyunIEditor.removeAnimationFilter(effectFilter);
//删除所有动效滤镜
AliyunIEditor.clearAllAnimationFilter();

转场

//1.设置转场
//设置一个转场，index为转场位置，从0开始记，取消转场的话，transition传null即可
AliyunEditor.setTransition(int index, TransitionBase transition); 

//设置批量转场，取消转场的话，transition传null即可
AliyunEditor.setTransition(Map<Integer, TransitionBase> transitions); //设置多个转场


//2.更新转场
//从某个转场更新成另一个转场，transition不允许为null
AliyunEditor.updateTransition(int index, TransitionBase transition); 

支持自定义MV，MV的制作规范请参见MV。

//添加MV
AliyunIEditor.applyMV(EffectBean effect);

//删除MV
AliyunIEditor.applyMV(null);

短视频SDK支持对每路音频流设置音效，目前提供的音效包括如下：

• AudioEffectType.EFFECT_TYPE_LOLITA（萝莉）

• AudioEffectType.EFFECT_TYPE_REVERB（混响）

• AudioEffectType.EFFECT_TYPE_UNCLE（大叔）

• AudioEffectType.EFFECT_TYPE_ECHO（回声）

• AudioEffectType.EFFECT_TYPE_ROBOT（机器人）

• AudioEffectType.EFFECT_TYPE_BIG_DEVIL（大魔王）

• AudioEffectType.EFFECT_TYPE_MINIONS（小黄人）

• AudioEffectType.EFFECT_TYPE_DIALECT（方言）

画中画功能允许在现有主轨道的基础上，添加一个或者多个画中画。

• 主轨道：编辑页面默认轨道，有且仅有一个主轨道，一个主轨道可以有多个视频流。

• 画中画：允许添加多个画中画，画中画允许设置位置，缩放，旋转等。创建画中画默认创建一个画中画轨道。画中画可以在不同画中画轨道中移动。

添加/删除字幕

Source fontSouce = null;
long startTime = 0L;
long duration = 20000L;

//1. 添加字幕
AliyunPasterControllerCompoundCaption captionController = pasterManager.addCaptionWithStartTime('输入文字', null, fontSouce, startTime,duration);

//2. 删除字幕
controller.remove()

AliyunPasterControllerCompoundCaption包含了字幕的所有操作，详细请查看接口说明。每次更新完字幕属性后，必须调用AliyunPasterControllerCompoundCaption.apply()。

//设置颜色
captionController.setColor(AliyunColor color);
//设置字体
captionController.setFontPath(ISouce fontPath);
//应用以上更新
captionController.apply();

工程配置信息获取

//初始化
AliyunIEditor.init(SurfaceView surfaceView, Context context);
//获取配置信息
AliyunEditorProject project = AliyunIEditor.getEditorProject();

初始化草稿管理器

AliyunDraftManager draftManager = AliyunDraftManager.getInstance(context);

获取草稿列表

//异步获取草稿列表
AliyunDraftManager.getInstance(getContext())
                          .getDraftListByAsync(new AliyunDraftListCallback() {
                              @Override
                              public void onFailure(final String msg) {
                                  //获取列表异常
                              }

                              @Override
                              public void onSuccess(final List<AliyunDraft> draftList) {
                                  //草稿列表回调
                              }
                          });

根据草稿ID删除草稿

//删除草稿，draft为草稿列表单个item(草稿列表通过草稿列表接口获取)
AliyunDraftManager.getInstance(v.getContext()).deleteDraft(draft.getId());

草稿重命名

//重命名，draft为草稿列表单个item(草稿列表通过草稿列表接口获取)
AliyunDraftManager.getInstance(v.getContext()).rename(draft.getId(), newName);

草稿复制

//复制后会返回新草稿，draft为草稿列表单个item(草稿列表通过草稿列表接口获取)
AliyunDraft newDraft = AliyunDraftManager.getInstance(v.getContext()).copy(draft.getId());

草稿加载

//draft为草稿列表单个item(草稿列表通过草稿列表接口获取)
AliyunDraftManager.getInstance(v.getContext()).preLoadDraft(draft, new AliyunDraftResourceLoader() {

                @Override
                public void onHandleResourceTasks(final List<AliyunDraftResTask> tasks) {
                    //缺少相关资源，返回需要处理的资源任务，必须对任务进行处理，可选项：修复、忽略、删除
                    HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                    for (AliyunDraftResTask task : tasks) {
                        if (task.getSource() != null && !StringUtils.isEmpty(task.getSource().getURL())) {
                            if (map.containsKey(task.getSource().getURL())) {
                                map.get(task.getSource().getURL()).add(task);
                            } else {
                                List<AliyunDraftResTask> list = new ArrayList<>();
                                list.add(task);
                                map.put(task.getSource().getURL(), list);
                            }
                        } else {
                            //必须对任务进行处理，可选项：修复、忽略、删除
                            if (task.getResModuleType() == AliyunResModuleType.MAIN_VIDEO) {
                                task.getSource().setPath(EditorCommon.SD_DIR + "svideo_res/image/aliyun_svideo_failed.jpg");
                                task.onHandleCallback(task.getSource());
                            } else if(task.getResModuleType() == AliyunResModuleType.TRANSITION) {
                                //删除
                                task.onRemove();
                            } else {
                                //忽略
                                task.onIgnore();
                            }
                        }
                        for (final Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                            //key为资源地址，Value为对应资源地址需要处理的任务
                            final List<AliyunDraftResTask> list = entry.getValue();
                            try {
                                final String url = entry.getKey();
                                //判断是否是平台资源
                                if (url.startsWith(AlivcResUtil.SCHEME)) {
                                    //平台资源加载回调封装
                                    AlivcResUtil.LoadCallback callback = new AlivcResUtil.LoadCallback() {
                                        @Override
                                        public void onSuccess(String path) {
                                            for (AliyunDraftResTask task : list) {
                                                Source source = task.getSource();
                                                source.setPath(path);
                                                task.onHandleCallback(source);
                                            }
                                        }

                                        @Override
                                        public void onFailure(String type, String msg) {
                                            Log.d("CloudDraft", "loadRes>Failure>type>" + type + ">msg>" + msg);
                                            for (AliyunDraftResTask task : list) {
                                                task.onIgnore();
                                            }
                                        }
                                    };
                                    //加载平台资源，具体代码看demo
                                    AlivcResUtil.loadRes(context, url, callback);
                                } else {
                                    //下载用户资源，具体代码看demo
                                    downloadRes(url, new File(item.getEditorProjectUri()).getParent(), list);
                                }
                            } catch (Exception e) {
                                //出错
                                for (AliyunDraftResTask item : list) {
                                    item.onIgnore();
                                }
                            }
                        }
                    }
                }

                @Override
                public void onFailure(final String msg) {
                    //预加载失败
                    Toast.makeText(v.getContext(), "预加载失败", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onSuccess() {
                    //预加载处理成功即可进入编辑界面，draft为草稿列表单个item(草稿列表通过草稿列表接口获取)，通过draft.getEditorProjectUri()来加载草稿
                    EditorActivity.startEdit(v.getContext(), draft);
                }
            });

上传草稿需配合草稿服务端，服务端简单代码示例下载。

//draft为草稿列表单个item(草稿列表通过草稿列表接口获取)
AliyunDraftManager.getInstance(context)
                          .uploadDraft(draft, new AliyunDraftResourceUploader() {
                              @Override
                              public void onHandleResourceTasks(final List<AliyunDraftResTask> tasks) {
                                  //需要处理的上传资源任务
                                  HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                                  //过滤重复资源
                                  for (AliyunDraftResTask task : tasks) {
                                      if (task.getSource() == null) {
                                          task.onIgnore();
                                          continue;
                                      }
                                      //URL为空或者不以alivc_resource开头需要做上传处理
                                      String url = task.getSource().getURL();
                                      if (StringUtils.isEmpty(url) || !url.startsWith("alivc_resource")) {
                                          if (map.containsKey(task.getSource().getPath())) {
                                              map.get(task.getSource().getPath()).add(task);
                                          } else {
                                              List<AliyunDraftResTask> list = new ArrayList<>();
                                              list.add(task);
                                              map.put(task.getSource().getPath(), list);
                                          }
                                      } else {
                                          //忽略出错
                                          task.onIgnore();
                                      }
                                  }
                                  for (Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                                      try {
                                          for (AliyunDraftResTask task : tasks) {
                                              Source source = task.getSource();
                                              //上传成功后回调远程地址
                                              source.setURL();
                                              task.onHandleCallback(source);
                                          }
                                      } catch (Exception e) {
                                          //忽略出错
                                          List<AliyunDraftResTask> list = entry.getValue();
                                          for (AliyunDraftResTask item:list){
                                              item.onIgnore();
                                          }
                                      }
                                  }
                              }

                              @Override
                              public void onSuccess(final String projectPath, String coverUrl) {
                                  //资源全部上传成功后，返回工程配置地址和封面地址
                                  //可自行处理上传到云端，其他用户就可以通过工程配置地址恢复草稿到编辑状态
                              }

                              @Override
                              public void onFailure(final String msg) {
                                  Toast.makeText(context,"备份失败",Toast.LENGTH_SHORT).show();
                              }
                          });

下载草稿需配合草稿服务端，服务端简单代码示例下载。

//根据草稿工程配置下载草稿相关资源，file为工程配置文件(草稿备份后从服务器下载下来的)
AliyunDraftManager.getInstance(context).downloadDraft(file, new AliyunDraftResourceDownloader() {
            @Override
            public void onHandleResourceTasks(final String projectDir, final List<AliyunDraftResTask> tasks) {
                //待处理的草稿资源任务，需要下载草稿里面包含的资源
                HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                //过滤重复资源
                for (AliyunDraftResTask task : tasks) {
                    if (task.getSource() == null || StringUtils.isEmpty(task.getSource().getURL())) {
                        task.onIgnore();
                    } else if (map.containsKey(task.getSource().getURL())) {
                        map.get(task.getSource().getURL()).add(task);
                    } else {
                        List<AliyunDraftResTask> list = new ArrayList<>();
                        list.add(task);
                        map.put(task.getSource().getURL(), list);
                    }
                }
                for (final Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                    final List<AliyunDraftResTask> list = entry.getValue();
                    try {
                        final String url = entry.getKey();
                        //这里需要根据url下载草稿资源
                        for (AliyunDraftResTask task : list) {
                            Source source = task.getSource();
                            //下载完成后回调资源本地地址
                            source.setPath(path);
                            //如果是MV则解压出ID赋值给Source供显示还原
                            if (task.getResModuleType() == AliyunResModuleType.MV) {
                                try {
                                    source.setId(Uri.parse(url).getQueryParameter("gid"));
                                }catch (Exception ignored){
                                }
                            }
                            task.onHandleCallback(source);
                        }
                    } catch (Exception e) {
                        //出错
                        for (AliyunDraftResTask item : list) {
                            item.onIgnore();
                        }
                    }
                }

            }

            @Override
            public void onSuccess(final AliyunDraft draft) {
                //资源全部下载完成后设置服务端ProjectID到本地草稿用来关联云端草稿
                AliyunDraftManager.getInstance(context).setProjectId(draft.getId(), projectId);
                Toast.makeText(context,"成功恢复到本地",Toast.LENGTH_SHORT).show();
                //恢复成功后就可以在本地草稿列表查看
            }

            @Override
            public void onFailure(final String msg) {
                Toast.makeText(context,"恢复到本地失败",Toast.LENGTH_SHORT).show();
            }
        });

时间特效

// 1.变速
//3.7.0版本开始变速接口可以针对多段视频/图片添加
int effectId;
effectId = AliyunIEditor.rate(float rate, long startTime, long duration, boolean needOriginDuration);

// 2.反复
effectId = AliyunIEditor.repeat(int times, long startTime, long duration, boolean needOriginDuration);

//3.倒放
//特别注意：对于GOP大于5的视频需要先转码，否则将无法倒播。对于视频GOP的检查可以用NativeParser.getMaxGopSize()来获取。转码时将GOP SIZE设置为1，即CropParam.setGop(1);
effectId = AliyunIEditor.invert();


// 删除时间特效
AliyunIEditor.deleteTimeEffect(effectId);

水印分为普通水印及片尾水印。普通水印会贯穿整个视频流时长，而片尾水印会在视频流结尾处添加水印。

//水印例子 水印的大小为 ：水印图片的宽高和显示区域的宽高比，注意保持图片的比例，不然显示不完全
//水印的位置为 ：以水印图片中心点为基准，显示区域宽高的比例为偏移量，0,0为左上角，1,1为右下角

//普通水印
AliyunIEditor.applyWaterMark(String imgPath, float sizeX, float sizeY, float posX, float posY);

//片尾水印
AliyunIEditor.addTailWaterMark(String imagePath, float sizeX, float sizeY, float posX, float posY, long durationUs);

短视频SDK封装了一套涂鸦接口，包含画板、画笔等，整个涂鸦操作由涂鸦控制器（AliyunICanvasController）完成。

• 画板：涂鸦对应的UI交互View，可以添加到UI交互的ViewGroup。

• 画笔：一个android.graphics.Paint对象，开发者可以从外部设置，也可以使用默认画笔。