示例4：视频处理

场景描述

音视频上传时，可以设置媒资处理参数，上传完成后，自动根据设置的参数进行音视频处理。若您需要对已上传的视频进行处理，您也可以调用VOD API实现。

本章节指导用户如何使用API调用的方式处理已上传的视频文件，包括视频转码、截图、加密等，支持同时启动多种处理操作，也可以只启动一种处理操作。

前提条件

已明确需要处理的视频文件所在区域信息，详见使用前必读。
已获取需要处理的视频文件所在区域的项目ID，具体获取方法请参见获取项目ID。

总体流程

获取用户Token
（可选）创建转码模板
（可选）设置搭建的密钥管理服务的URL
创建视频处理任务
查询视频处理执行情况

操作步骤

获取用户Token，用于调用点播接口时进行认证鉴权。

详细信息请参见构造请求。以“华北-北京四”为示例，若您需要调用其它区域的点播接口，请替换成对应区域的IAM终端节点。

POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
Content-Type: application/json

{
  "auth": {
    "identity": {
      "methods": [
        "password"
      ],
      "password": {
        "user": {
          "name": "username", 
          "password": "password", 
          "domain": {
            "name": "domainname"   
          }
        }
      }
    },
    "scope": {
      "project": {
         "name": "projectname"
      }
    }
  }
}

如图1所示，红框中的信息为获取用户Token。

图1 获取用户Token

在视频点播控制台创建自定义转码模板，具体操作请参见转码设置。

您也可以使用点播服务提供的系统转码模板。创建转码模板后，您可以在视频点播控制台获取需要使用的转码模板的模板名称。

图2 获取转码模板名称
在视频点播控制台配置搭建的密钥管理服务的URL，具体操作请参见HLS加密设置。

仅能对转码输出格式为HLS的视频进行加密。若不需要进行加密操作，可以跳过该步骤。

图3 加密设置
创建视频处理任务。
1. 选择POST请求方法并输入URI。
```
https://{endpoint}/v1.0/{project_id}/asset/process
```
2. 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
3. Request Body中传入参数如下：
```
{
	"asset_id": "b4f39691d66cc0ef75d62ee567146e11",
	"template_group_name": "test",
	"auto_encrypt":0,
	"thumbnail":{
		"type":"time",
		"time":12
		
	},
	"subtitle_id":[1]
}
```
  仅在示例1：媒资上传（20M以下）时，请求参数设置了“subtitles”时，才可以在视频处理时，更换字幕文件，设置的“subtitle_id”才有效。
4. 请求响应成功后，返回处理媒资ID。
```
{
  "asset_id": "b4f39691d66cc0ef75d62ee567146e11"
}
```
调用查询详细信息接口查询视频处理执行情况，具体调用方法请参见示例3：获取媒资详情。

视频处理任务执行的时间与视频文件的大小、设置的处理操作个数等有关，建议视频任务提交5-10分钟后再查询执行情况。