文档

图片叠加

本文为您介绍通过OpenAPI进行视频剪辑时图片叠加场景的Timeline常用配置示例,包括全程叠加图片、指定区域叠加图片等示例。

相关API

参数说明

参数

说明

图片出现的坐标

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Timeline示例

全程叠加图片

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

  • 单视频叠加

    {
      "VideoTracks": [
          {
              "VideoTrackClips": [
                  {
                      "MediaId": "222d9296e8864746a0b6f32dad6e****"
                  }
              ]
          }
      ],
      "ImageTracks": [
          {
              "ImageTrackClips": [
                  {
                      "ImageId": "001d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.1234,
                      "Y": 0.1234
                  },
                  {
                      "ImageId": "002d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.7234,
                      "Y": 0.7234
                  }
              ]
          }
      ]
    }
  • 多视频叠加

    {
      "VideoTracks": [
          {
              "VideoTrackClips": [
                  {
                      "MediaId": "222d9296e8864746a0b6f32dad6e****"
                  },
                  {
                      "MediaId": "333d9296e8864746a0b6f32dad6e****"
                  }
              ]
          }
      ],
      "ImageTracks": [
          {
              "ImageTrackClips": [
                  {
                      "ImageId": "001d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.1234,
                      "Y": 0.1234
                  },
                  {
                      "ImageId": "002d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.7234,
                      "Y": 0.7234
                  }
              ]
          }
      ]
    }

指定区域叠加图片

指定区域叠加图片指图片叠加在视频的指定时间区间。图片在输出视频中出现的位置由XY设定,在输出视频中的宽高由WidthHeight设定。在一个视频的第2秒~100秒叠加2张图片,示例如下:

说明

输出视频指最终合成的成片视频。

  • 单视频叠加

    • TimelineIn不设置时,默认从0开始。

    • TimelineOut不设置时,默认到视频的尾部。

    • TimelineOut超过视频尾部(对单视频来说,即视频时长)时,超过的时间区间自动被忽略,仍以视频轨的尾部为准。

    {
      "VideoTracks": [
          {
              "VideoTrackClips": [
                  {
                      "MediaId": "222d9296e8864746a0b6f32dad6e****"
                  }
              ]
          }
      ],
      "ImageTracks": [
          {
              "ImageTrackClips": [
                  {
                      "ImageId": "001d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.1234,
                      "Y": 0.1234,
                      "TimelineIn":2,
                      "TimelineOut":100
                  },
                  {
                      "ImageId": "002d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.7234,
                      "Y": 0.7234,
                      "TimelineIn":2,
                      "TimelineOut":100
                  }
              ]
          }
      ]
    }
  • 多视频叠加图片

    • TimelineIn不设置时,默认从0开始。

    • TimelineOut不设置时,默认到视频的尾部。

    • TimelineOut超过视频尾部(对多个视频来说,即视频轨总体时长)时,超过的时间区间,视频画面为黑场。

    如果视频轨有多个不同分辨率的源视频,那么:

    • 输出视频的宽取多个源视频宽的最大值。

    • 输出视频的高取多个源视频高的最大值。

    • 画面采用pad+scale的方式,先加黑边保证实际画面比例不变形,再等比例放大到输出视频的宽高。

    • 输出视频的时长为视频轨的时长。

    {
      "VideoTracks": [
          {
              "VideoTrackClips": [
                  {
                      "MediaId": "222d9296e8864746a0b6f32dad6e****"
                  },
                  {
                      "MediaId": "333d9296e8864746a0b6f32dad6e****"
                  }
              ]
          }
      ],
      "ImageTracks": [
          {
              "ImageTrackClips": [
                  {
                      "ImageId": "001d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.1234,
                      "Y": 0.1234,
                      "TimelineIn":2,
                      "TimelineOut":100
                  },
                  {
                      "ImageId": "002d9296e8864746a0b6f32dad6e****",
                      "Width": 0.1345,
                      "Height": 0.1678,
                      "X": 0.7234,
                      "Y": 0.7234,
                      "TimelineIn":2,
                      "TimelineOut":100
                  }
              ]
          }
      ]
    }
  • 本页导读 (1)
文档反馈