文档首页/ 媒体处理 MPC/ API参考/ 应用示例/ 示例1：新建转码模板
更新时间：2024-11-12 GMT+08:00
查看PDF
分享

示例1：新建转码模板

场景描述

若您需要使用自定义的转码模板进行音视频转码，可以先在提交转码任务前，按实际需求创建转码模板。

前提条件

  • 已获取需要创建转码模板区域的项目ID，具体获取方法请参见获取项目ID。
  • 已明确需要创建转码模板所在的区域信息，并获取该区域的Endpoint，您可以从地区和终端节点获取。

总体流程

涉及API

当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

操作步骤

  1. 获取用户Token，用于MPC接口调用时的认证鉴权。

    在“我的凭证”页面获取username、password、domainname、projectname，调用如下接口获取Token。详细信息请参见构造请求。 
    POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
Content-Type: application/json
{
  "auth": {
    "identity": {
      "methods": [
        "password"
      ],
      "password": {
        "user": {
          "name": "********", //用户名。
          "password": "********", //用户登录密码。
          "domain": {
            "name": "domainname" //用户所属的账号名称。  
          }
        }
      }
    },
    "scope": {
      "project": {
         "name": "*******"  //项目名称。
      }
    }
  }
}

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

    图1 获取用户Token

  2. 选择POST请求方法并输入URI。 

     https://{endpoint}/v1/{project_id}/template/transcodings
    “mpc.cn-north-4.myhuaweicloud.com”为媒体处理服务的终端节点，您可以在区域和终端节点中获取。

    调用IAM接口的区域需与调用媒体处理接口的区域一致，如调用“cn-north-4”区域的IAM接口获取用户Token，则该Token仅能用于调用“cn-north-4”区域媒体处理接口的鉴权。

  3. 在请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。
  4. 在请求消息体中传入如下所示的参数。 

    {
	"template_name":"MP4_H.264_1920x1080_6000_HEAAC",
	"video":{
		"codec":1,
		"bitrate":6000,
		"profile":3,
		"level":15,
		"preset":3,
		"ref_frames_count":4,
		"max_iframes_interval":5,
		"bframes_count":4,
		"frame_rate":1,
		"width":1920,
		"height":1080,
		"aspect_ratio":0
	},
	"audio":{
		"codec":1,
		"sample_rate":4,
		"bitrate":128,
		"channels":2
	},
	"common":{
		"PVC":0,
		"hls_interval":5,
		"dash_interval":5,
		"pack_type":1
	}
}

    请求响应成功后，返回转码模板ID，状态码为201 Created。

    {
  "template_id":1001
}

    若请求失败，返回如下所示的错误码及错误描述。

    {
  "error_code": "MPC.100101",
  "error_msg": "template error, it's name MP4_H.264_1920x1080_6000_HEAAC is same with template 274764。"
}

父主题： 应用示例