编辑工程

前提条件

初始化HuaweiVideoEditor运行环境

HuaweiVideoEditor对象是整个编辑工程的入口类，其生命周期与编辑工程保持一致。创建编辑工程，您应首先创建HuaweiVideoEditor对象并初始化其运行环境。当离开编辑工程时，应释放Editor实例。

1. 创建HuaweiVideoEditor对象。
   收起

   自动换行

   深色代码主题

   复制

   HuaweiVideoEditor 
   editor = HuaweiVideoEditor.create(getApplicationContext());

2. 初始化运行环境。
   当HuaweiVideoEditor对象创建之后，此时还没有占用实际的系统资源。需要手动选择其环境初始化的时机，此时视频编辑原子能力SDK内部会创建必须的线程和定时器等。

   收起

   自动换行

   深色代码主题

   复制

   editor.initEnvironment();

   说明

   当销毁HuaweiVideoEditor对象后，必须重新初始化运行环境。

3. 指定预览窗口的布局位置。

   预览窗口负责视频图像画面的渲染，由视频编辑原子能力SDK内部创建SurfaceView来实现。在创建窗口之前，需要在您的App中指定预览窗口的布局位置。

   收起

   自动换行

   深色代码主题

   复制

   <LinearLayout
       android:id="@+id/video_content_layout"
       android:layout_width="0dp"
       android:layout_height="0dp"
       android:background="@color/video_edit_main_bg_color"
       android:gravity="center"
       android:orientation="vertical" />

   收起

   自动换行

   深色代码主题

   复制

   // 指定预览窗口
   LinearLayout 
   mSdkPreviewContainer = 
   view.findViewById(
   R.id.video_content_layout);
   
   // 在initEnvironment()完成之后，设置预览窗口承载的布局
   editor.setDisplay(
   mSdkPreviewContainer);

添加视频、图片

创建一条视频泳道，然后往泳道上添加图片或者视频素材。图片和视频素材需要通过文件路径添加到泳道上。其中图片在泳道上的默认长度为3s。

// 获取时间线对象
HVETimeLine 
timeline = 
editor.getTimeLine();

// 创建视频泳道
HVEVideoLane 
videoLane = 
timeline.appendVideoLane();

// 在视频泳道的末尾，添加视频资源
HVEVideoAsset 
videoAsset = 
videoLane.appendVideoAsset(
"test.mp4");

// 在视频泳道的末尾，添加图片资源
HVEImageAsset 
imageAsset = 
videoLane.appendImageAsset(
"test.jpg");

// 通常我们对泳道上的资源操作的时候，通过泳道来获取资源列表
List<HVEAsset> 
assets = 
videoLane.getAssets();
// 根据资源列表获取资源对象
visibleAsset，根据具体场景
visibleAsset可以转换成HVEVideoAsset或者HVEImageAsset，
i为资源在assets列表的索引
HVEVisibleAsset 
visibleAsset = 
assets.get(
i);

添加音乐

创建一条音乐泳道，然后往泳道上添加音乐素材。音乐素材需要通过文件路径添加到泳道上。

// 创建音乐泳道
HVEAudioLane 
audioLane = 
timeline.appendAudioLane();

// 在音频泳道的末尾，创建音乐资源
HVEAudioAsset 
audioAsset = 
audioLane.appendAudioAsset(
"test.mp3");

添加贴纸和文字

创建一条贴纸文字泳道，然后往泳道上添加贴纸和文字。贴纸需要通过文件路径添加到泳道上，文字只需要指定文本内容。贴纸和文字在泳道上的默认长度都为3s。

// 创建贴纸文字泳道
HVEStickerLane 
stickerLane = 
timeline.appendStickerLane();

// 在泳道的末尾添加贴纸
HVEStickerAsset 
stickerAsset = 
stickerLane.appendStickerAsset(
"test.png");

// 在泳道的末尾添加文字
HVEWordAsset 
wordAsset = 
stickerLane.appendWord(
"输入文字", 
0, 
3000);

添加特效

特效分为两种：外联特效和内嵌特效。

• 添加外联特效。需要添加在特效泳道中，可以跨多个资源，可以任意调节其时间长度。

  创建一条特效泳道，然后往泳道上添加特效，通过构造HVEEffect.Options对象来创建特效。

  收起

  自动换行

  深色代码主题

  复制

  // 创建特效泳道
  HVEEffectLane 
  effectLane = 
  timeline.appendEffectLane();
  
  // 创建一个颜色调节特效,添加到0位置，时长为3000ms
  HVEEffect 
  effect = 
  effectLane.appendEffect(new HVEEffect.Options(HVEEffect.EFFECT_COLORADJUST, 
  "", 
  ""), 
  0, 
  3000);

• 添加内嵌特效。需要添加在资源中，只能作用于单个资源，时间长度与资源一样，无法单独调节。
  内嵌特效必须依附于具体的资源，通常只有视频资源HVEVideoAsset和图片资源HVEImageAsset可以容纳内嵌特效。同一种类型的内嵌特效只能创建一个，重复添加会自动覆盖原先的特效。

  收起

  自动换行

  深色代码主题

  复制

  // 创建一个颜色调节内嵌特效
  HVEEffect 
  effect = 
  visibleAsset.appendEffectUniqueOfType(new HVEEffect.Options(HVEEffect.EFFECT_COLORADJUST, 
  "", 
  ""), ADJUST);

播放时间线

播放时间线需要指定起点和终点，时间线将会按照固定帧率向后推进，同时预览画面和声音保持同步播放。通过注册的播放回调，可以接受播放进度、暂停、播放完成和播放失败事件。

// 注册播放进度回调
editor.setPlayCallback(
callback);

// 播放完整时间线
editor.playTimeLine(
timeline.getStartTime(), 
timeline.getEndTime());

导出

编辑完成后，通过导出接口将时间线上的资源生成输出一个新的视频。通过设置导出回调，可以监听导出进度、完成、失败事件，并且可以指定导出视频的帧率、分辨率、生成路径。

// 导出视频路径
String 
outputPath = 
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)
                    + File.separator + Constant.LOCAL_VIDEO_SAVE_PATH
                    + File.separator + VideoExportActivity.getTime() + ".mp4";

// 导出分辨率
HVEVideoProperty 
videoProperty = new HVEVideoProperty(
1920, 
1080);

// 导出视频
HVEExportManager.exportVideo(
editor, 
callback, 
videoProperty, 
outputPath);