### 前言

**短视频模板**，是快捷创作短视频的一种方式，一般由专业设计师或模板创作人制作，用户只需替换视频模板中的部分素材，便可生成一支与模板一样的创意视频。这种省时省力、无需“烧脑”构思创意的“套模板”视频创作方法，深受用户喜爱。

### 应用场景

短视频模板在短视频APP、视频剪辑工具、拍摄美化工具、旅游出行、电商、新闻等垂域应用广泛。例如：

在视频剪辑工具、拍摄美化工具垂域，短视频模板功能可以降低视频剪辑门槛、激发用户创作，进而提升应用的用户活跃度；

在旅游出行应用中，用户可以通过“套模板”的方式用视频记录旅途中的风土人情；

在电商应用中，商家可通过套用商品展示模板的方式，快速制作商品展示视频；

在新闻资讯应用中，用户可套用新闻模板，快速发布新闻讯息。

### 华为HMS Core视频编辑服务模板能力

HMS Core[视频编辑服务](https://developer.huawei.com/consumer/cn/hms/huawei-video-editor?ha_source=hms1)近期开放了模板功能，并预置了一些不同场景的视频模板供开发者测试使用，后续还将陆续丰富模板品类和数量。

### 接入简单、省时省力

HMS Core[视频编辑服务](https://developer.huawei.com/consumer/cn/hms/huawei-video-editor?ha_source=hms1)提供了涵盖模板栏目列表、模板详情、模板工程、导入导出等详细的开发接口、接口说明和接入步骤，代码简单、清晰，开发省时省力。

### 云端管理、高效运营

HMS Core[视频编辑服务](https://developer.huawei.com/consumer/cn/hms/huawei-video-editor?ha_source=hms1)在AGC后台为开发者提供了编排素材的后台，运营人员可以在web端完成模板栏目编排、标签管理、国家/地区设置、上下架模板内容、快速检索查询信息等。
 
![](https://oscimg.oschina.net/oscnet/up-160bcf194ea85962ad6afc959770bed9bb7.png)

### 集成代码

#### 1. 开发准备

详细准备步骤可参考[华为开发者联盟官网](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/config-agc-0000001101108580?ha_source=hms1)

#### 2.	编辑工程集成

2.1 设置应用的鉴权信息

可以通过api_key或者Access Token来设置应用鉴权信息。

通过setAccessToken方法设置Access Token，在应用启动时初始化设置一次即可，无需多次设置。

```
MediaApplication.getInstance().setAccessToken("your access token");
```

通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。

```
MediaApplication.getInstance().setApiKey("your ApiKey");
```

2.2设置唯一标识ID，即License ID。

License ID是进行管控的有效凭证，您要保证设置License ID的唯一性。

```
MediaApplication.getInstance().setLicenseId("License ID");
```

2.2.1初始化Editor运行环境

创建编辑工程，需要首先创建Editor对象并初始化其运行环境。当离开编辑工程时，应释放Editor实例。

(1)	创建Editor对象

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

(2)	指定预览窗口的布局位置

预览窗口负责视频图像画面的渲染，由视频编辑原子能力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);

// 设置预览窗口承载的布局 
editor.setDisplay(mSdkPreviewContainer);
```

(3)	初始化运行环境，如果License鉴权失败，会抛出LicenseException。

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

```
try {
        editor.initEnvironment();
   } catch (LicenseException error) { 
        SmartLog.e(TAG, "initEnvironment failed: " + error.getErrorMsg());    
        finish();
        return;
   }
```

#### 3.	模板能力集成

```
// 获取模板栏目列表
final HVEColumnInfo[] column = new HVEColumnInfo[1];
HVETemplateManager.getInstance().getColumnInfos(new HVETemplateManager.HVETemplateColumnsCallback() {
        @Override
        public void onSuccess(List<HVEColumnInfo> result) {
           // 获取模板栏目列表成功
           column[0] = result.get(0);
        }

@Override
        public void onFail(int error) {
           // 获取模板栏目列表失败
        }
});

// 获取模板详情
final String[] templateIds = new String[1];
// size为需要请求数据的数量 > 0，offset为需要请求数据的偏移量 ≥ 0，true代表强制获取网络数据
HVETemplateManager.getInstance().getTemplateInfos(column[0].getColumnId(), size, offset, true, new HVETemplateManager.HVETemplateInfosCallback() {
        @Override
        public void onSuccess(List<HVETemplateInfo> result, boolean hasMore) {
           // 获取模板详情成功
           HVETemplateInfo templateInfo = result.get(0);
           // 获取模板ID
           templateIds[0] = templateInfo.getId();
        }

@Override
        public void onFail(int errorCode) {
           // 获取模板详情失败
        }
});

// 待获取模板详情成功后，获取模板ID
String templateId = templateIds[0];

// 获取模板工程
final List<HVETemplateElement>[] editableElementList = new ArrayList[1];;
HVETemplateManager.getInstance().getTemplateProject(templateId, new HVETemplateManager.HVETemplateProjectCallback() {
        @Override
        public void onSuccess(List<HVETemplateElement> editableElements) {
           // 获取成功后跳转到选择资源界面，把选中的本地资源路径更新到editableElements
           editableElementList[0] = editableElements;
        }

@Override
        public void onProgress(int progress) {
           // 获取进度
        }

@Override
        public void onFail(int errorCode) {
           // 获取失败
        }
});

// 准备模板工程
HVETemplateManager.getInstance().prepareTemplateProject(templateId, new HVETemplateManager.HVETemplateProjectPrepareCallback() {
        @Override
        public void onSuccess() {
            // 准备模板工程成功，可以生成HuaweiVideoEditor实例进行播放、预览、导出等操作         
        }
        @Override
        public void onProgress(int progress) {
            // 准备进度
        }

@Override
        public void onFail(int errorCode) {
            // 准备失败
        }
});

// 在模板准备成功后，生成HuaweiVideoEditor实例
// 拥有editor之后就可以进行播放或者导出操作，详情见播放时间线和导出
HuaweiVideoEditor editor = HuaweiVideoEditor.create(templateId, editableElementList[0]);
try {
      editor.initEnvironment();
} catch (LicenseException e) {
      SmartLog.e(TAG, "editor initEnvironment ERROR.");
}   
```

### Demo演示

![](https://oscimg.oschina.net/oscnet/up-b5e1b559b3b88aa2170ef4df42010753b1d.gif)
 
 **了解更多详情>>**

访问[华为开发者联盟官网](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
获取[开发指导文档](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
华为移动服务开源仓库地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**关注我们，第一时间了解 HMS Core 最新技术资讯~**

ITPub博客

HMS Core 视频编辑服务开放模板能力，助力用户一键Get同款酷炫视频

最新文章