备案控制台
文档
产品文档
输入文档关键字查找
首页 对象存储 操作指南 数据处理 媒体处理 媒体处理参数 视频拼接

视频拼接

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

您可以通过视频拼接功能，将多个视频拼接为一个视频并转换为需要的格式。本文介绍视频拼接功能参数及示例。

使用场景

  • 短视频创作：在短视频平台上，用户经常需要将不同场景拍摄的短视频片段进行拼接，形成一个连贯的故事或展示多个不同的内容点。

  • 电影与电视制作：在影视后期制作中，视频拼接是基本操作。导演和剪辑师会将多个镜头组合在一起，以构建剧情、塑造角色或展现视觉效果。

  • 广告宣传：广告片的制作过程中，为了表现产品的多样使用场景或突出不同特点，会把各个独立拍摄的场景无缝衔接起来。

  • 企业宣传片：公司或组织制作宣传片时，往往需要将各种产品特写、员工采访、工作现场等多种场景组合，形成统一的品牌故事。

注意事项

  • 视频拼接仅支持异步处理（x-oss-async-process处理方式）。

  • 使用视频拼接前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和AttachOSSBucket。

  • 不支持匿名访问。

  • 必须拥有IMM处理所需的相关权限。更多信息，请参见权限。

  • 当使用默认采样率或声道数进行转码时，拼接可能由于目标视频容器的兼容性而失败。

参数说明

操作名称：video/concat

具体参数如下表所示。

拼接参数

video/concat的拼接顺序按照pre与sur在请求串中的先后顺序进行拼接，具体如下：

  • /pre：前置拼接的视频文件。

  • /sur：后置拼接的视频文件。

参数

类型

是否必须

描述

ss

int

否

前缀、后缀视频的拼接起始时间，单位为毫秒。取值：

  • 0（默认值）：从起始位置开始。

  • 大于0：从第ss毫秒开始。

t

int

否

前缀、后缀视频的拼接持续时长，单位为毫秒。取值：

  • 0（默认值）：持续到结束位置。

  • 大于0：持续t毫秒。

o

string

是

当前Bucket下的OSS Object，需要以Base64 URL安全方式编码。

转码参数

参数

类型

是否必须

描述

ss

int

否

被拼接视频的拼接起始时间，单位为毫秒。取值：

  • 0（默认值）：从起始位置开始。

  • 大于0：从第ss毫秒开始。

t

int

否

被拼接视频的拼接持续时长，单位为毫秒。取值：

  • 0（默认值）：持续到结束位置。

  • 大于0：持续t毫秒。

f

string

是

视频容器：

  • mp4

  • mkv

  • mov

  • asf

  • avi

  • mxf

  • ts

  • flv

vn

int

否

是否禁用视频流。取值：

  • 0（默认值）：不禁用。

  • 1：禁用。

vcodec

string

是

视频codec（编码格式）。取值：

  • h264：h264编码格式。

  • h265：h265编码格式。

说明

mxf与flv不支持h265。

fps

float

否

视频帧率。默认与align指定的源视频一致，取值范围为0~240。

fpsopt

int

否

视频帧率选项。取值：

  • 0：始终使用目标帧率。

  • 1：拼接列表中存在源视频帧率小于fps时使用拼接列表中最小的源视频帧率。

  • 2：拼接列表中存在源视频帧率小于fps时返回失败。

说明

该参数需要与fps一同设置。

pixfmt

string

否

像素采样格式。默认与align指定的源视频一致，取值：

  • yuv420p

  • yuv420p10le

  • yuv422p

  • yuv422p10le

  • yuv444p

  • yuv444p10le

s

string

否

分辨率。

  • 格式为w x h，即宽 x 高。

  • 宽和高的取值应为2的倍数，且取值范围为64~4096。例如：4096x4096、64x64等。

sopt

int

否

分辨率选项。取值：

  • 0：始终使用目标分辨率。

  • 1：拼接列表中存在源视频分辨率小于s时使用拼接列表中最小的源视频分辨率。

  • 2：拼接列表中存在源视频分辨率小于s时返回失败。

说明

该参数需要与s一同设置。

scaletype

string

否

缩放方式。取值：

  • crop：缩放并裁剪。

  • stretch（默认值）：拉伸以填满。

  • fill：缩放并保留黑边。

  • fit：缩放并不保留黑边，等比缩放。

arotate

int

否

自适应分辨率方向。取值：

  • 0（默认值）：关闭。

  • 1：打开。

g

int

否

关键帧间隔。默认值为150。取值范围：1~100000。

vb

int

否

视频比特率（码率），单位为比特/秒（bps）。取值范围：10000~100000000。

说明

该参数与crf互斥，表示不同码率控制算法。若都不设置则按照输出分辨率的默认码率进行编码。

vbopt

int

否

视频码率选项。取值：

  • 0：始终使用目标视频码率。

  • 1：拼接列表中存在源视频码率小于vb时使用拼接列表中最小的源视频码率。

  • 2：拼接列表中存在源视频码率小于vb时返回失败。

说明

该参数需要与vb一同设置。

crf

float

否

码率控制因子。取值范围：0~51。数值越大画质越差，建议取值范围为18~38。

maxrate

int

否

峰值码率，单位为比特/秒（bps），默认为0。取值范围：10000~100000000。

说明

该参数需要与crf一同设置。

bufsize

int

否

缓冲区大小，单位为比特（bits），默认为0。取值范围：10000~200000000。

说明

该参数需要与crf一同设置。

an

int

否

是否禁用音频流。取值：

  • 0（默认值）：不禁用。

  • 1：禁用。

acodec

string

是

音频codec（编码格式）。取值：

  • mp3

  • aac

  • flac

  • vorbis

  • ac3

  • opus

  • pcm

说明

mp4不支持pcm；mov不支持flac与opus；asf不支持opus；avi不支持opus；mxf只支持pcm；ts不支持flac、vorbis、amr与pcm；flv不支持flac、vorbis、amr、opus与pcm。

ar

int

否

音频采样率。默认与align指定的源视频一致，取值：

  • 8000

  • 11025

  • 12000

  • 16000

  • 22050

  • 24000

  • 32000

  • 44100

  • 48000

  • 64000

  • 88200

  • 96000

说明

不同格式支持的采样率有所不同，mp3仅支持48kHz及以下；opus支持8kHz、12kHz、16kHz、24kHz与48kHz；ac3支持32kHz、44.1kHz与48kHz；amr仅支持8kHz与16kHz。

ac

int

否

音频声道数。默认与align指定的源视频一致，取值范围：1~8。

说明

不同格式支持的声道数有所不同，mp3仅支持单、双声道；ac3最大支持6声道（5.1）；amr仅支持单声道。

aq

int

否

音频压缩质量。取值范围：0~100。

说明

该参数与ab互斥，若都不设置则按照编码器默认码率进行编码。

ab

int

否

音频比特率（码率）。单位为比特/秒（bps）。取值范围：1000~10000000。

abopt

string

否

音频码率选项。取值：

  • 0（默认值）：始终使用目标音频码率。

  • 1：拼接列表中存在源音频码率小于ab时使用拼接列表中最小的源音频码率。

  • 2：拼接列表中存在源音频码率小于ab时返回失败。

说明

该参数需要与ab一同设置。

align

int

否

主视频文件（提供默认转码参数）在拼接列表中的序号，默认为0（对齐拼接列表中第一个视频文件）。

说明

视频拼接时也会用到sys/saveas和notify参数。更多信息，请参见另存为和消息通知。

媒体分片参数

/segment：分片参数

参数

类型

是否必须

描述

f

string

是

分片格式。取值：

  • hls

  • dash

t

int

是

分片长度，单位为毫秒。取值范围：0~3600000。

说明

媒体分片仅支持mp4与ts容器。

使用REST API

将3段不同格式视频拼接为1段mp4格式视频

拼接信息

  • 拼接前

    • 视频名称：pre.mov、example.mkv、sur.mov

  • 处理方式

    • 拼接时长与顺序：

      视频名称

      顺序

      时长

      pre.mov

      1

      整段视频

      example.mkv

      2

      第10秒到结尾

      sur.mov

      3

      开头到第十秒

    • 转码完成消息通知：发送MNS消息

  • 拼接后

    • 视频信息

      • 视频格式：h264

      • 视频帧率：25fps

      • 视频码率：1 Mbps

    • 音频信息

      • 音频格式：aac

      • 音频配置：48kHz采样率，双声道

      • 音频码率：96 Kbps

    • 文件存储路径

      • mp4文件：oss://outbucket/outobj.mp4

处理示例

// 对文件example.mkv进行视频拼接。
POST /exmaple.mkv?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
 
x-oss-async-process=video/concat,ss_10000,f_mp4,vcodec_h264,fps_25,vb_1000000,acodec_aac,ab_96000,ar_48000,ac_2,align_1/pre,o_cHJlLm1vdgo/sur,o_c3VyMS5hYWMK,t_10000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqLnthdXRvZXh0fQo/notify,topic_QXVkaW9Db252ZXJ0

使用SDK

视频拼接仅支持异步处理，SDK使用方法请参见使用SDK。

文档推荐
  • 本页导读 （1）
文档反馈