视频拼接

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

使用场景

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

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

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

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

注意事项

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

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

  • 不支持匿名访问。

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

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

  • 进行视频拼接时,最大支持的视频数量为 11 个。

参数说明

操作名称:video/concat

具体参数如下表所示。

拼接参数

video/concat的拼接顺序按照presur在请求串中的先后顺序进行拼接,具体如下:

  • /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、webm

vn

int

是否禁用视频流。取值:

  • 0(默认值):不禁用。

  • 1:禁用。

vcodec

string

视频codec(编码格式)。取值:

  • h264:h264编码格式。

  • h265:h265编码格式。

  • vp9:vp9编码格式。

说明

mxf与flv不支持h265。

fps

float

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

fpsopt

int

视频帧率选项。取值:

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

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

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

说明

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

pixfmt

string

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

  • yuv420p

  • yuva420p

  • 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(对齐拼接列表中第一个视频文件)。

adepth

int

音频采样位深,取值为16或24。

说明

该参数仅在acodec为flac时有效

说明

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

媒体分片参数

/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使用方法请参见异步处理