タイムラインのイメージオーバーレイ構成例 - ApsaraVideo VOD

本トピックでは、OpenAPI を使用してビデオを編集する際の、イメージオーバーレイシナリオにおける一般的なタイムライン構成例について説明します。例として、全期間および指定領域のイメージオーバーレイが含まれます。

パラメーター

パラメーター	説明
イメージの座標	X：イメージの左上隅から出力ビデオの左上隅までの水平距離。 Y：イメージの左上隅から出力ビデオの左上隅までの垂直距離。値はパーセンテージまたは画素値で指定できます：値が 0～0.9999 の範囲内である場合、出力ビデオの幅または高さに対するパーセンテージを表します。X 値は出力ビデオの幅に、Y 値は出力ビデオの高さに相対的です。値が 8 以上の整数である場合、絶対画素値を表します。
出力ビデオにおけるイメージのサイズ	Width：出力ビデオにおけるイメージの幅。 Height：出力ビデオにおけるイメージの高さ。値はパーセンテージまたは画素値で指定できます：値が 0～0.9999 の範囲内である場合、出力ビデオのディメンションに対するパーセンテージを表します。Width 値は出力ビデオの幅に、Height 値は出力ビデオの高さに相対的です。値が 8 以上の整数である場合、絶対画素値を表します。
イメージオーバーレイの時間間隔	TimelineIn：タイムライン上でのイメージのイン点。 TimelineOut：タイムライン上でのイメージのアウト点。

タイムラインの例

全期間のイメージオーバーレイ

全期間のイメージオーバーレイは、ビデオの最初から最後まで表示されます。TimelineIn および TimelineOut パラメーターを指定する必要はありません。X および Y パラメーターで出力ビデオ内のイメージの位置を設定し、Width および Height パラメーターでそのサイズを設定します。以下に例を示します：

単一ビデオへのオーバーレイ

{
  "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
              }
          ]
      }
  ]
}

指定領域へのイメージオーバーレイ

指定した時間間隔でビデオにイメージをオーバーレイできます。X および Y パラメーターで出力ビデオ内のイメージの位置を設定し、Width および Height パラメーターでそのサイズを設定します。次の例では、ビデオの 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 の値がビデオトラックの合計デュレーションを超える場合、超過したデュレーション分は黒い画面が表示されます。
ビデオトラックに解像度の異なる複数のソースビデオが含まれている場合：
- 出力ビデオの幅は、ソースビデオの中で最大の幅になります。
- 出力ビデオの高さは、ソースビデオの中で最大の高さになります。
- フレームはパディングとスケーリングを使用して処理されます。縦横比を維持するために黒帯が追加され、その後、フレームは出力ビデオの幅と高さに比例してスケーリングされます。
- 出力ビデオのデュレーションは、ビデオトラックのデュレーションと同じになります。
```
{
  "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
              }
          ]
      }
  ]
}
```

ApsaraVideo VOD:イメージオーバーレイ

関連 API

パラメーター

タイムラインの例

全期間のイメージオーバーレイ

指定領域へのイメージオーバーレイ