控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

新增拼接模板

最近更新时间:2021-05-19 15:45:11

功能描述

CreateMediaTemplate 用于新增拼接模板。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

请求

请求实例

POST /template HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

<body>

说明:

Authorization: Auth String (详情请参见 请求签名 文档)。

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详情请参见 公共请求头部 文档。

非公共头部

该请求操作无特殊的请求头部信息。

请求体

该请求操作的实现需要有如下请求体。

<Request>
   <Tag>Concat</Tag>
   <Name>TemplateName</Name>
   <ConcatTemplate>
        <ConcatFragment>
            <Mode>Start</Mode>
            <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
        </ConcatFragment>
        <ConcatFragment>
            <Mode>End</Mode>
            <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
        </ConcatFragment>
        <Audio>
            <Codec>mp3</Codec>
            <Samplerate></Samplerate>
            <Bitrate></Bitrate>
            <Channels></Channels>
        </Audio>
        <Video>
            <Codec>H.264</Codec>
            <Bitrate>1000</Bitrate>
            <Width>1280</Width>
            <Height></Height>
            <Fps>30</Fps>
        </Video>
        <Container>
            <Format>mp4</Format>
        </Container>
   </ConcatTemplate>
</Request>

具体数据描述如下:

节点名称(关键字) 父节点 描述 类型
Response 保存结果的容器 Container

Container 类型 Request 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 必选
Tag Request 模板类型:Concat String
Name Request 模板名称仅支持中文、英文、数字、_、-和* String
ConcatTemplate Request 拼接模板 Container

Container 类型 ConcatTemplate 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 必选 默认值 限制
ConcatFragment Request.ConcatTemplate 拼接节点 Container
Audio Request.ConcatTemplate 音频参数 Container 媒体原始值 目标文件不需要 Audio 信息,
需要设置 Audio.Remove 为 true
Video Request.ConcatTemplate 视频参数 Container 媒体原始值 目标文件不需要 Video 信息,
需要设置 Video.Remove 为 true
Container Request.ConcatTemplate 封装格式 Container

Container 类型 ConcatFragment 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 必选 默认值 限制
Url Request.ConcatTemplate.
ConcatFragment
拼接对象地址 String 同 bucket 对象文件
Mode Request.ConcatTemplate.
ConcatFragment
节点类型 String
  • Start:开头
  • End:结尾
  • Container 类型 Audio 的具体数据描述如下:

    节点名称(关键字) 父节点 描述 类型 必选 默认值 限制
    Codec Request.ConcatTemplate.
    Audio
    编解码格式 String 文件原编码 取值 aac、mp3
    Samplerate Request.ConcatTemplate.
    Audio
    采样率 String 文件原采样率
  • 单位:Hz
  • 可选 11025、22050、32000、44100、48000、96000
  • 不同的封装,mp3 支持不同的采样率,如下表所示
  • Bitrate Request.ConcatTemplate.
    Audio
    音频码率 String 文件原音频码率
  • 单位:Kbps
  • 值范围:[8,1000]
  • Channels Request.ConcatTemplate.
    Audio
    声道数 String 文件原声道数
  • 当 Codec 设置为 aac,支持1、2、4、5、6、8
  • 当 Codec 设置为 mp3,支持1、2
  • Y表示支持这种采样率,N表示不支持

    封装格式/音频采样率 11025 22050 32000 44100 48000 96000
    mp3 Y Y Y Y Y N

    Container 类型 Container 的具体数据描述如下:

    节点名称(关键字) 父节点 描述 类型 必选
    Format Request.ConcatTemplate.
    Container
    容器格式:mp4,flv,hls,ts, mp3, aac String

    Container 类型 Video 的具体数据描述如下:

    节点名称(关键字) 父节点 描述 类型 必选 默认值 限制
    Codec Request.ConcatTemplate.
    Video
    编解码格式 String H.264 H.264
    Width Request.ConcatTemplate.
    Video
    String 视频原始宽度
  • 值范围:[128,4096]
  • 单位:px
  • 若只设置 Width 时,按照视频原始比例计算 Height
  • Height Request.ConcatTemplate.
    Video
    String 视频原始高度
  • 值范围:[128,4096]
  • 单位:px
  • 若只设置 Height 时,按照视频原始比例计算 Width
  • Fps Request.ConcatTemplate.
    Video
    帧率 String 视频原始帧率
  • 值范围:(0,60]
  • 单位:fps
  • Bitrate Request.ConcatTemplate.
    Video
    视频输出文件的码率 String 视频原始码率
  • 值范围:[10,50000]
  • 单位:Kbps
  • Remove Request.ConcatTemplate.
    Video
    是否删除视频流 String false 取值 true、false

    响应

    响应头

    公共响应头

    该响应包含公共响应头,了解公共响应头详情请参见 公共响应头部 文档。

    特有响应头

    该响应无特殊的响应头。

    响应体

    该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

    <Response>
        <Template>
            <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
            <Tag>Concat</Tag>
            <Name>TemplateName</Name>
            <ConcatTemplate>
                <ConcatFragment>
                    <Mode>Start</Mode>
                    <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
                </ConcatFragment>
                <ConcatFragment>
                    <Mode>End</Mode>
                    <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
                </ConcatFragment>
                <Audio>
                    <Codec>mp3</Codec>
                    <Samplerate></Samplerate>
                    <Bitrate></Bitrate>
                    <Channels></Channels>
                </Audio>
                <Video>
                    <Codec>H.264</Codec>
                    <Bitrate>1000</Bitrate>
                    <Width>1280</Width>
                    <Height></Height>
                    <Fps>30</Fps>
                </Video>
                <Container>
                    <Format>mp4</Format>
                </Container>
            </ConcatTemplate>
            <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
            <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
        </Template>
    </Response>

    具体的数据内容如下:

    节点名称(关键字) 父节点 描述 类型
    Response 保存结果的容器 Container

    Container 节点 Response 的内容:

    节点名称(关键字) 父节点 描述 类型
    TemplateId Response 模板 ID String
    TotalCount Response 模版总数 Int
    PageNumber Response 当前页数,同请求中的 pageNumber Int
    PageSize Response 每页个数,同请求中的 pageSize Int
    ConcatTemplate Response 拼接信息,详情请见同页面请求体 ConcatTemplate 的具体数据描述 Container

    错误码

    该请求无特有错误信息,常见的错误信息请参见 错误码 文档。

    实际案例

    请求

    POST /template HTTP/1.1
    Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
    Host:bucket-1250000000.ci.ap-beijing.myqcloud.com
    Content-Length: 1666
    Content-Type: application/xml
    
    
    
    <Request>
       <Tag>Concat</Tag>
       <Name>TemplateName</Name>
       <ConcatTemplate>
            <ConcatFragment>
                <Mode>Start</Mode>
                <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
            </ConcatFragment>
            <ConcatFragment>
                <Mode>End</Mode>
                <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
            </ConcatFragment>
            <Audio>
                <Codec>mp3</Codec>
                <Samplerate></Samplerate>
                <Bitrate></Bitrate>
                <Channels></Channels>
            </Audio>
            <Video>
                <Codec>H.264</Codec>
                <Bitrate>1000</Bitrate>
                <Width>1280</Width>
                <Height></Height>
                <Fps>30</Fps>
            </Video>
            <Container>
                <Format>mp4</Format>
            </Container>
       </ConcatTemplate>
    </Request>

    响应

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 100
    Connection: keep-alive
    Date: Thu, 15 Jun 2017 12:37:29 GMT
    Server: tencent-ci
    x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzh****=
    
    
    
    <Response>
        <Template>
            <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
            <Tag>Concat</Tag>
            <Name>TemplateName</Name>
            <ConcatTemplate>
                <ConcatFragment>
                    <Mode>Start</Mode>
                    <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
                </ConcatFragment>
                <ConcatFragment>
                    <Mode>End</Mode>
                    <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
                </ConcatFragment>
                <Audio>
                    <Codec>mp3</Codec>
                    <Samplerate></Samplerate>
                    <Bitrate></Bitrate>
                    <Channels></Channels>
                </Audio>
                <Video>
                    <Codec>H.264</Codec>
                    <Bitrate>1000</Bitrate>
                    <Width>1280</Width>
                    <Height></Height>
                    <Fps>30</Fps>
                </Video>
                <Container>
                    <Format>mp4</Format>
                </Container>
            </ConcatTemplate>
            <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
            <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
        </Template>
    </Response>

    目录