多视频混剪TimeLine配置示例

本文向您介绍基于多个视频整段、任意区间片段的的剪辑合成TimeLine示例。

整段合成示例

整段合成指多段视频直接合成。将两个及以上视频完整顺序相接,整段合成,此时不用指定视频的入出点,示例如下:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "****9b4d7cf14dc7b83b0e801cbe****"
                },
                {
                    "MediaId": "****9b4d7cf14dc7b83b0e801cbe****"
                },
                {
                    "MediaId": "****1656bca4474999c961a6d2a2****"
                }
            ]
        }
    ]
}

多段视频任意区间合成示例

多段视频任意区间合成可以指定多个视频的多段区间进行剪切合成。合成的顺序按照数组的先后顺序首尾相接,示例如下:

说明

注意 如果设置的Out超过了视频时长,则实际的Out以视频时长为准。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "****9b4d7cf14dc7b83b0e801cbe****",
                    "In": 10,
                    "Out": 16
                },{
                    "MediaId": "****9b4d7cf14dc7b83b0e801cbe****",
                    "In": 4,
                    "Out": 8
                },{
                    "MediaId": "****9b4d7cf14dc7b83b0e801cbe****",
                    "In": 12,
                    "Out": 20
                },{
                    "MediaId": "****1656bca4474999c961a6d2a2****"
                }
            ]
        }
    ]
}

多视频混剪及图片叠加示例

多视频混剪及图片叠加是指多个视频的多段区间进行剪切合成并且可以在特定的位置、特定的时间点叠加任意大小的图片,示例如下:

{
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "****8f5cdf044b059b3adc7967ba****",
                  "In": 5,
                  "Out": 10
              },
              {
                  "MediaId": "****2b6cce6a4872a49a733b91dc****"
              },
              {
                  "MediaId": "****8f5cdf044b059b3adc7967ba****",
                  "In": 10,
                  "Out": 15
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "****756620ed48c9af022c66ee2e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.1234,
                  "Y": 0.1234
              },
              {
                  "ImageId": "****509ed2c045d09deb9aabda99****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.7234,
                  "Y": 0.7234
              }
          ]
      }
  ]
}

参数说明:

参数

说明

图片出现的坐标

  • X:图片左上角距离输出视频左上角的横向距离。

  • Y:图片左上角距离输出视频左上角的纵向距离。

支持百分比和像素两种形式:

  • 当取值为[0~0.9999]时,表示相对输出视频宽/高的占比(X相对宽,Y相对高)。

  • 当取值为≥8的整数时,表示绝对像素。

图片在输出视频中所占的大小

  • Width:图片在输出视频中的宽度。

  • Height:图片在输出视频中的高度。

支持百分比和像素两种形式:

  • 当取值为[0~0.9999]时,表示相对输出视频宽/高的占比(Width相对宽,Height相对高)。

  • 当取值为≥8的整数时,表示绝对像素。

图片在输出视频叠加的时间区间

  • TimelineIn:图片相对于时间线的入点。

  • TimelineOut:图片相对于时间线的出点。

全程叠加示例

全程叠加指从片头到片尾叠加,即视频全程叠加文字不需要指定TimelineInTimelineOut,文字在输出视频中出现的位置由XY设定。示例如下:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ce638f5cdf044b059b3adc7967ba1da0",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 33,
                            "Y": 34,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 66,
                            "Y": 66,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2, 
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.7123,
                            "Y": 0.7896,
                            "TimelineIn": 15,
                            "TimelineOut": 20,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字测试文字",
                            "FontSize": 26,
                            "FontColor": "#000000"
                        }
                    ]
                }
            ]
        }
    ]
}

参数说明:

参数

说明

文字出现的坐标

  • X:文字左上角距离输出视频左上角的横向距离。

  • Y:文字左上角距离输出视频左上角的纵向距离。

支持百分比和像素两种形式:

  • 当取值为[0~0.9999]时,表示相对输出视频宽/高的占比(X相对宽,Y相对高)。

  • 当取值为≥8的整数时,表示绝对像素。

文字本身属性

  • Content:文本内容。

  • Font:字体,该字体不填则默认为宋体。目前支持的字体种类有:

    • SimSun:宋体。

    • WenQuanYi Zen Hei:文泉驿正黑。

    • WenQuanYi Zen Hei Mono:文泉驿等宽正黑。

    • WenQuanYi Zen Hei Sharp:文泉驿点阵正黑。

    • Yuanti SC Bold:圆体-简 粗体。

    • Yuanti SC Light:圆体-简 细体。

    • Yuanti SC Regular:圆体-简 常规体。

  • FontSize:字体大小,以像素为单位。该字段不填则默认为20。

  • FontColor:字体颜色,形式为16进制颜色值,以#开头,如:#FFFFFF。该字段不填则默认为#FFFFFFFont。

  • FontColorOpacity:字体颜色的透明度,取值[0~1],1为完全不透明,0为完全透明。该字段不填则默认为1。

  • FontFace:文字的样式:

    • Bold:是否加粗。该字段不填则默认为false。

    • Italic:是否斜体。该字段不填则默认为false。

    • Underline:是否加下划线。该字段不填则默认为false。

文字在输出视频叠加的时间区间

  • TimelineIn:文字相对于时间线的入点。

  • TimelineOut:文字相对于时间线的出点。

视频添加居中字幕

可以通过设置 "Alignment": "TopCenter" 来顶部居中, 同时设置 字幕的Y值指定跟屏幕上侧的距离。

Alignment取值:BottomLeft,BottomCenter,BottomRight,CenterLeft,CenterCenter,CenterRight,TopLeft,TopCenter,TopRight。

当指定了Alignment时,x,y 值被当做 margin。

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId3",
          "Effects": [
            {
              "Type": "Text",
              "X": 20,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Top Center 时间线是将素材按照视频创意进行编排和特效设计的产物",
              "Alignment": "TopCenter",
              "FontSize": 26,
              "FontColorOpacity": 1,
              "FontColor": "#ff0000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 100,
              "Y": 200,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Center Center -时间线主要包含轨道、素材、效果3种对象",
              "Alignment": "CenterCenter",
              "FontSize": 26,
              "FontColorOpacity": 0.8,
              "FontColor": "#ff0000"
            },
            {
              "Type": "Text",
              "X": 0.10,
              "Y": 0.1,
              "TimelineIn": 2,
              "TimelineOut": 15,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Bottom Center - 时间线是将素材按照视频创意进行编排和特效设计的产物。时间线主要包含轨道、素材、效果3种对象",
              "Alignment": "BottomCenter",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

视频加水印1:指定水印位置、开始结束时间

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Type":"Video",
                    "TimelineIn":0,
                    "TimelineOut":140,
                    "Duration":140
                }
            ]
        },
        {
            "VideoTrackClips":[
                {
                    "Effects":[
                        {
                            "Type":"Scale",
                            "TimelineIn":0,
                            "TimelineOut":100,
                            "Width":0.416,
                            "Height":0.2347
                        }
                    ],
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Type":"Image",
                    "TimelineIn":0,
                    "TimelineOut":100,
                    "Duration":100,
                    "X":0.584,
                    "Y":0
                }
            ]
        }
    ]
}

视频加水印2:无需设置Duration,水印时长自适应

用ImageTracks的方式设置水印,无需设置Duration,免去计算视频时长的麻烦
{
    "VideoTracks":[
        {
            "Count":3,
            "VideoTrackClips":[
                {
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Type":"Image",
                    "Duration":5
                },
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Type":"Image",
                    "Duration":5
                },
                {
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Type":"Image",
                    "Duration":5
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "****756620ed48c9af022c66ee2e****",
                    "Width" : 200,
                    "Height" : 100,
                    "X" : 100,
                    "Y" : 100
                }
            ]
        }
    ]
}

视频画中画

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Type":"Video"
                }
            ]
        },
        {
            "VideoTrackClips":[
                {
                    "Effects":[
                        {
                            "Type":"Scale",
                            "TimelineIn":0,
                            "TimelineOut":100,
                            "Width":0.3,
                            "Height":0.4
                        }
                    ],
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Type":"Video",
                    "Duration":100,
                    "X":0.5,
                    "Y":0
                }
            ]
        }
    ]
}

多视频串联加转场,加背景音乐

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Effects":[
                        {
                            "Type":"Transition",
                            "SubType":"directional",
                            "Duration":2
                        }
                    ]
                },
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Effects":[
                        {
                            "Type":"Transition",
                            "SubType":"waterdrop",
                            "Duration":1
                        }
                    ]
                },
                {
                    "MediaId":"****8f5cdf044b059b3adc7967ba****"
                }
            ]
        }
    ],
    "AudioTracks":[
        {
            "AudioTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****"
                }
            ]
        }
    ]
}

图片相册,叠加两个音频,音频同时播放

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "Type":"Image",
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"****8f5cdf044b059b3adc7967ba****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "Duration":10
                }
            ]
        }
    ],
    "AudioTracks":[
        {
            "AudioTrackClips":[
                {
                    "MediaId":"****8f5cdf044b059b3adc7967ba****"
                }
            ]
        },
        {
            "AudioTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****"
                }
            ]
        }
    ]
}

外挂字幕

目前支持srt、ass字幕

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****"
                }
            ]
        }
    ],
    "SubtitleTracks":[
        {
            "SubtitleTrackClips":[
                {
                    "Type":"Subtitle",
                    "SubType":"srt",
                    "FileURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.srt"
                }
            ]
        }
    ]
}

视频裁剪-去掉电影上下黑边

将1920 * 1080视频剪掉上下黑边(黑边高130),并叠加字幕。

注意需要指定输出尺寸。

OutputConfig:

{
    "MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.mp4",
    "Width":1920,
    "Height":820
}

Timeline

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****",
                    "X":0,
                    "Y":0,
                    "Effects":[
                        {
                            "Type":"Crop",
                            "X":0,
                            "Width":1920,
                            "Height":820,
                            "Y":130
                        }
                    ]
                }
            ]
        }
    ],
    "SubtitleTracks":[
        {
            "SubtitleTrackClips":[
                {
                    "Type":"Subtitle",
                    "SubType":"srt",
                    "FileURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.srt"
                }
            ]
        }
    ]
}

使用OSS地址作为输入素材

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaURL":"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object1.mp4"
                },
                {
                    "MediaURL":"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object2.mp4"
                },
                {
                    "MediaURL":"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object3.mp4"
                }
            ]
        }
    ]
}