結合とは、フォーマット、エンコード、解像度などの異なる複数の動画を結合し、フォーマット、エンコード方法、解像度を同じくした一つの動画を生成する処理のことです。 この機能は、固定タイトルやクレジットを追加したり、生放送のビデオをつなぎ合わせるためによく使用されます。

切り出しとは、ビデオの中から特定のクリップを抽出し、新しいビデオとして出力する処理のことです。 この機能は、ビデオのハイライトや主要なコンテンツを抽出するのによく使用されます。

パラメーターの説明

ビデオを結合するときは、次のパラメーターに注意する必要があります。

Input

タイトルとなる OSS 入力ファイルを指定します。
注 OSS の場所は、MPS のリージョンと対応している必要があります。 例えば、OSS の場所 "oss-cn-hangzhou" は MPS のリージョン "cn-hangzhou" に対応しています。

Output には次のパラメーターを設定します。

  • Video

    最終的なアウトプットとなるビデオの幅、高さ、ビットレートを指定します。 複数クリップ (タイトルやクレジットを含む) の幅や高さが最終ビデオのものと一致しない場合、自動的に黒の余白で埋められます。 よりよいビデオを作成するため、各作業の実際の解像度に基づき、さまざまな幅や高さのタイトルやクレジットを用意しておくことを推奨します。

  • MergeList

    リストの順序は結合の順序です。 リストの最後の項目はクレジットです。 最大で 5 つ (タイトルやクレジットを含む) の動画を一つにまとめることができます。 MergeConfigUrl パラメーターを使用すると、それ以上のビデオを一つに結合することができます。
    注 MergeLsit と MergeConfigUrl は相互に排他的です。 どちらか一方のみ指定できます。

    各結合ビデオには、3 つのパラメーターがあります。

    • MergeURL

      結合ビデオの OSS URL を指定します。
      注 結合するビデオの OSS のリージョンは、タイトルのリージョンと同一である必要があります。 異なるリージョンのビデオは結合できません。

    • Start

      ビデオを結合する際に、最終ビデオに抽出したいクリップの開始時点を指定できます。 デフォルト値は 0 です。

    • Duration

      ビデオを結合する際、最終ビデオに抽出したいクリップの長さ (開始時点は Start の値) を指定できます。 デフォルトの長さは、 Start の時点からビデオの終了までです。

  • MergeConfigUrl

    結合したいビデオの設定ファイルの OSS URL を指定します。 設定ファイルの内容は JSON オブジェクトで、 MergeList の値と同じです。

    リストの順序は結合の順序です。 リストの最後の項目はクレジットです。 最大で 100 (タイトルやクレジットを含む) のビデオを一つにまとめることができます。

コード例

MP4 形式の 720 P (1280 x 720) のビデオと、 480 P (640 x 480) のタイトルとクレジットを結合します。 出力ビデオの解像度は 1280 x 720 です。 出力ビデオを再生すると、タイトルとクレジットの左右に黒い枠が表示されます。 ただし、ビデオは正常に表示されます。

コード例の詳細