视频拼接

更新时间:2025-04-02 04:19:51

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

功能简介

视频拼接是将多个视频片段合并为一个完整视频并转换为所需格式的能力。

002

使用场景

  • 影视制作:在电影、电视剧及短片的制作过程中,视频拼接是核心环节之一,协助剪辑师将不同的镜头和场景整合,以构建完整的叙事结构。

  • 内容创作:在短视频社交媒体平台上,内容创作者通常运用视频拼接技术制作Vlog、教程或主题视频,以提升内容的吸引力和可视性。

  • 教育与培训:教师和培训师可以通过拼接不同的视频片段,以结合理论与实践的方式制作教学视频,从而促进学生的理解与学习。

  • 体育赛事回放:在体育转播中,视频拼接技术被用于制作精彩瞬间集锦,以帮助观众回顾比赛中激动人心的时刻。

如何使用

前提条件

视频拼接

仅支持使用Java、Python、Go SDK通过异步处理的方式完成视频拼接。

Java
Python
Go

要求使用3.17.4及以上版本的Java SDK。

import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.AsyncProcessObjectRequest;
import com.aliyun.oss.model.AsyncProcessObjectResult;
import com.aliyuncs.exceptions.ClientException;

import java.util.Base64;

public class Demo {
    public static void main(String[] args) throws ClientException {
        // yourEndpoint填写Bucket所在地域对应的Endpoint。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 指定阿里云通用Region ID,例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 指定Bucket名称。
        String bucketName = "examplebucket";
        // 指定拼接后的视频文件名称。
        String targetObject = "dest.mp4";
        // 指定原视频文件名称。
        String sourceVideo = "src.mp4";
        // 指定需要拼接的视频文件名称。
        String video1 = "concat1.mp4";
        String video2 = "concat2.mp4";
        // 创建OSSClient实例。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 对视频文件名称进行编码。
            String video1Encoded = Base64.getUrlEncoder().withoutPadding().encodeToString(video1.getBytes());
            String video2Encoded = Base64.getUrlEncoder().withoutPadding().encodeToString(video2.getBytes());
            // 构建视频处理样式字符串以及视频拼接处理参数。
            String style = String.format("video/concat,ss_0,f_mp4,vcodec_h264,fps_25,vb_1000000,acodec_aac,ab_96000,ar_48000,ac_2,align_1/pre,o_%s/sur,o_%s,t_0", video1Encoded, video2Encoded);
            // 构建异步处理指令。
            String bucketEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(bucketName.getBytes());
            String targetEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(targetObject.getBytes());
            String process = String.format("%s|sys/saveas,b_%s,o_%s/notify,topic_QXVkaW9Db252ZXJ0", style, bucketEncoded, targetEncoded);
            // 创建AsyncProcessObjectRequest对象。
            AsyncProcessObjectRequest request = new AsyncProcessObjectRequest(bucketName, sourceVideo, process);
            // 执行异步处理任务。
            AsyncProcessObjectResult response = ossClient.asyncProcessObject(request);
            System.out.println("EventId: " + response.getEventId());
            System.out.println("RequestId: " + response.getRequestId());
            System.out.println("TaskId: " + response.getTaskId());

        } finally {
            // 关闭OSSClient。
            ossClient.shutdown();
        }
    }
}

要求使用Python SDK 2.18.4及以上版本。

# -*- coding: utf-8 -*-
import base64
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

def main():
    # 从环境变量中获取临时访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET。
    auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
    # 填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
    # 指定阿里云通用Region ID,例如cn-hangzhou。
    region = 'cn-hangzhou'

    # 指定Bucket名称,例如examplebucket。
    bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

    # 指定拼接后的视频名称。
    target_object = 'out.mp4'
    # 指定原视频文件名称。
    source_video = 'emrfinal.mp4'
    # 指定需要拼接的视频文件名称。
    video1 = 'osshdfs.mp4'
    video2 = 'product.mp4'
    # 构建视频处理的样式字符串以及视频拼接处理参数。
    video1_encoded = base64.urlsafe_b64encode(video1.encode()).decode().rstrip('=')
    video2_encoded = base64.urlsafe_b64encode(video2.encode()).decode().rstrip('=')
    style = f"video/concat,ss_0,f_mp4,vcodec_h264,fps_25,vb_1000000,acodec_aac,ab_96000,ar_48000,ac_2,align_1/pre,o_{video1_encoded}/sur,o_{video2_encoded},t_0"
    # 构建异步处理指令。
    bucket_encoded = base64.urlsafe_b64encode('examplebucket'.encode()).decode().rstrip('=')
    target_encoded = base64.urlsafe_b64encode(target_object.encode()).decode().rstrip('=')
    process = f"{style}|sys/saveas,b_{bucket_encoded},o_{target_encoded}/notify,topic_QXVkaW9Db252ZXJ0"
    print(process)
    # 执行异步处理任务。
    try:
        result = bucket.async_process_object(source_video, process)
        print(f"EventId: {result.event_id}")
        print(f"RequestId: {result.request_id}")
        print(f"TaskId: {result.task_id}")
    except Exception as e:
        print(f"Error: {e}")


if __name__ == "__main__":
    main()

要求使用Go SDK 3.0.2及以上版本。

package main

import (
    "encoding/base64"
    "fmt"
    "os"
    "strings"

    "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    // 从环境变量中获取临时访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }
    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其他Region请按实际情况填写。
    // yourRegion指定阿里云通用Region ID,例如cn-hangzhou。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("yourRegion"))
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }
    // 指定Bucket名称,例如examplebucket。
    bucketName := "examplebucket"

    bucket, err := client.Bucket(bucketName)
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }
    // 填写拼接后的视频文件名称。
    targetObject := "dest.mp4"
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }
    // 指定原视频文件名称。
    sourcevideo := "src.mp4"
    // 指定需要拼接的视频文件名称。
    video1 := "concat1.mp4"
    video2 := "concat2.mp4"
    // 构建视频处理的样式字符串以及视频拼接处理参数。    
    style := fmt.Sprintf("video/concat,ss_0,f_mp4,vcodec_h264,fps_25,vb_1000000,acodec_aac,ab_96000,ar_48000,ac_2,align_1/pre,o_%s/sur,o_%s,t_0", strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(video1)), "="), strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(video2)), "="))
    // 构建异步处理指令。
    process := fmt.Sprintf("%s|sys/saveas,b_%v,o_%v/notify,topic_QXVkaW9Db252ZXJ0", style, strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(bucketName)), "="), strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(targetObject)), "="))
    fmt.Printf("%#v\n", process)
    rs, err := bucket.AsyncProcessObject(sourcevideo, process)
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }
    fmt.Printf("EventId:%s\n", rs.EventId)
    fmt.Printf("RequestId:%s\n", rs.RequestId)
    fmt.Printf("TaskId:%s\n", rs.TaskId)
}

参数说明

操作名称: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编码格式。

说明

mxfflv不支持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不支持flacopus;asf不支持opus;avi不支持opus;mxf只支持pcm;ts不支持flac、vorbis、amrpcm;flv不支持flac、vorbis、amr、opuspcm。

ar

int

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

  • 8000

  • 11025

  • 12000

  • 16000

  • 22050

  • 24000

  • 32000

  • 44100

  • 48000

  • 64000

  • 88200

  • 96000

说明

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

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

音频采样位深,取值为1624。

说明

该参数仅在acodecflac时有效

说明

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

媒体分片参数

/segment:分片参数

参数

类型

是否必须

描述

参数

类型

是否必须

描述

f

string

分片格式。取值:

  • hls

  • dash

t

int

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

说明

媒体分片仅支持mp4ts容器。

相关API

视频拼接为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 /example.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

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM PolicyBucket Policy授予操作权限。

API

Action

说明

API

Action

说明

GetObject

oss:GetObject

下载Object。

oss:GetObjectVersion

下载Object时,如果通过versionId指定了Object的版本,则需要授予此操作的权限。

kms:Decrypt

下载Object时,如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS,则需要此操作的权限。

API

Action

说明

API

Action

说明

HeadObject

oss:GetObject

获取某个Object的元数据。

API

Action

说明

API

Action

说明

PutObject

oss:PutObject

上传Object。

oss:PutObjectTagging

上传Object时,如果通过x-oss-tagging指定Object的标签,则需要此操作的权限。

kms:GenerateDataKey

上传Object时,如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS,则需要这两个操作的权限。

kms:Decrypt

API

Action

说明

API

Action

说明

CreateMediaConvertTask

imm:CreateMediaConvertTask

使用IMM进行媒体转码的权限。

计费说明

在视频拼接过程中,由于调用了 IMM 服务,会同时在 OSS 和 IMM 两侧产生计费项。具体说明如下:

  • OSS 侧: 需要调用 GetObject 接口添加 x-oss-async-process 参数进行视频拼接,同时调用 HeadObject 接口以获取 Object的元数据。拼接完成后,再通过 PutObject 接口将生成的视频上传至Bucket,将产生以下计费项,详细定价请参见OSS产品定价

    API

    计费项

    说明

    API

    计费项

    说明

    GetObject

    GET 类型请求

    根据成功的请求次数计算请求费用。

    外网流出流量费用

    如果是通过外网Endpoint(示例值oss-cn-hangzhou.aliyuncs.com)或者传输加速Endpoint(示例值oss-accelerate.aliyuncs.com)调用GetObject接口时,会产生外网流出流量费用,根据数据容量大小计费。

    低频访问数据取回容量

    如果取回的数据是低频访问数据,会产生低频访问数据取回容量的费用,按数据取回量计费。

    归档直读数据取回容量

    如果读取的是归档的ObjectBucket开启了归档直读,会产生归档直读数据取回容量费用,根据取回的数据容量大小计费。

    传输加速

    如果开启了传输加速功能且使用传输加速域名访问您的Bucket会产生传输加速费用,根据数据容量大小计费。

    API

    计费项

    说明

    API

    计费项

    说明

    PutObject

    PUT类型请求

    根据成功的请求次数计算请求费用。

    存储费用

    根据Object的存储类型、大小和时长收取存储费用。

    API

    计费项

    说明

    API

    计费项

    说明

    HeadObject

    GET 类型请求

    根据成功的请求次数计算请求费用。

  • IMM 侧: 将产生以下计费项,详细定价请参见IMM计费项

    API

    计费项

    说明

    API

    计费项

    说明

    CreateMediaConvertTask

    媒体处理费用

    根据视频实际时长计算媒体处理费用(以秒为单位)。

注意事项

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

  • 不支持匿名访问。

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

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

  • 本页导读 (1)
  • 功能简介
  • 使用场景
  • 如何使用
  • 前提条件
  • 视频拼接
  • 参数说明
  • 相关API
  • 视频拼接为mp4
  • 权限说明
  • 计费说明
  • 注意事项
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等