このトピックでは、イメージオーバーレイのパラメーターについて説明します。 このトピックでは、フルタイム間隔でのオーバーレイと指定された時間間隔でのオーバーレイの例も示します。 次の例は、画像オーバーレイ用にタイムラインデータを整理する方法を示しています。

概要

ビデオ編集と、メディア編集サービスの使用方法に関する2つの方法が、[概要] で紹介されています。 ProduceEditingProjectVideo操作を呼び出して、メディア編集サービスを開始および実装できます。 タイムラインは、メディア編集サービスによって処理される重要なデータであり、ビデオ編集のコアオブジェクトです。 タイムラインの内部パラメーターは、さまざまなビジネスシナリオの要件を満たすために複数の方法で整理できます。

Parameters

パラメーター 説明
出力ビデオにオーバーレイされた画像の座標
  • X: 画像の左上隅と出力ビデオの左上隅との間の水平距離。
  • Y: 画像の左上隅と出力ビデオの左上隅との間の垂直距離。
You can set the value to a percentage or the number of pixels.
  • 値が0〜0.9999以内の場合、出力ビデオの幅または高さに対する画像の水平または垂直オフセット距離の割合。 Xは幅の割合を示し、Yは高さの割合を示します。
  • If the value is an integer greater than or equal to 8, the value indicates the number of pixels.
出力ビデオにオーバーレイされた画像のサイズ
  • 幅: 出力ビデオにオーバーレイされた画像の幅。
  • 高さ: 出力ビデオにオーバーレイされた画像の高さ。
値をパーセンテージまたはピクセル数に設定できます。
  • 値が0〜0.9999以内の場合、出力ビデオの幅または高さに対する画像の幅または高さの割合。 Width indicates the percentage of the width, and Height indicates the percentage of the height.
  • 値が8以上の整数である場合、値はピクセルの数を示す。
Time interval when the image is overlaid on the output video
  • TimelineIn: タイムラインを基準とした画像の開始時刻。
  • TimelineOut: the end time of the image relative to the timeline.

フルタイム間隔でのオーバーレイの例

このアクションは、ビデオ全体の開始時間から終了時間までビデオに画像をオーバーレイします。 TimelineInまたはTimelineOutパラメーターを設定する必要はありません。 出力ビデオにおける画像の位置は、XおよびYによって指定される。出力ビデオの画像のサイズは、WidthとHeightで指定します。 例：

  • 単一のビデオにオーバーレイする
    {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e ****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.1234、
                  "Y": 0.1234
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.7234、
                  "Y": 0.7234
              }
          ]
      }
  ]
}
  • 複数のビデオにオーバーレイ
    {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e ****"
              },
              {
                  "MediaId": "333d9296e8864746a0b6f32dad6e ****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "Height": 0.1678,
                  "X": 0.1234、
                  "Y": 0.1234
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.7234、
                  "Y": 0.7234
              }
          ]
      }
  ]
}

指定した時間間隔でのオーバーレイの例

このアクションは、ビデオの指定された時間間隔で画像をビデオにオーバーレイします。 出力ビデオにおける画像の位置は、XおよびYによって指定される。出力ビデオの画像のサイズは、WidthとHeightで指定します。 次のコードは、2秒から100秒までのビデオに2つの画像をオーバーレイする方法の例を示しています。

注 出力ビデオは、最終的に生成されたビデオを指す。

  • 単一のビデオにオーバーレイする

    • デフォルトでは、TimelineInパラメーターが設定されていない場合、画像はビデオの開始時刻からオーバーレイされます。
    • デフォルトでは、TimelineOutパラメーターが設定されていない場合、ビデオが終了するまでイメージはオーバーレイされたままになります。
    • TimelineOut値が1つのビデオの合計期間を超える場合、超過時間間隔は自動的に除外され、ビデオの終了時間まで画像はオーバーレイされたままになります。 
    {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e ****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.1234、
                  "Y": 0.1234、
                  "TimelineIn":2、
                  "TimelineOut":100
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.7234、
                  "Y": 0.7234、
                  "TimelineIn":2、
                  "TimelineOut":100
              }
          ]
      }
  ]
}

  • 複数のビデオにオーバーレイ

    • デフォルトでは、TimelineInパラメーターが設定されていない場合、画像はビデオの開始時刻からオーバーレイされます。
    • デフォルトでは、TimelineOutパラメーターが設定されていない場合、ビデオが終了するまでイメージはオーバーレイされたままになります。
    • TimelineOut値が1つのビデオの合計期間を超える場合、超過時間間隔は自動的に除外され、ビデオの終了時間まで画像はオーバーレイされたままになります。

    ビデオトラックが異なる解像度の複数のビデオメザニンファイルで構成されている場合は、次の項目に注意してください。

    • 出力ビデオの幅は、ビデオメザニンファイルの最大幅です。
    • 出力ビデオの高さは、ビデオメザニンファイルの最大高さです。
    • ビデオ画像は、パディングおよびスケーリングモードで処理される。 第1に、アスペクト比が不変のままであることを保証するために、黒い境界線がビデオ画像に追加される。 次に、ビデオ画像は、出力ビデオの幅および高さにスケールアップされる。
    • 出力ビデオの持続時間は、ビデオトラックの持続時間に等しい。
    {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e ****"
              },
              {
                  "MediaId": "333d9296e8864746a0b6f32dad6e ****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.1234、
                  "Y": 0.1234、
                  "TimelineIn":2、
                  "TimelineOut":100
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e ****" 、
                  "幅": 0.1345、
                  "高さ": 0.1678、
                  "X": 0.7234、
                  "Y": 0.7234、
                  "TimelineIn":2、
                  "TimelineOut":100
              }
          ]
      }
  ]
}