すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Media Processing:マージとクリッピングの設定

最終更新日:Jan 12, 2025

ビデオに開始部分と終了部分を追加する場合、録画されたライブストリームのクリップをマージする場合、またはビデオからクリップを抽出する場合は、ApsaraVideo Media Processing(MPS)で提供されるビデオのマージ機能とクリッピング機能を使用できます。ビデオのマージ機能を使用すると、異なる形式、エンコード形式、解像度の複数のビデオを、特定の形式、エンコード形式、解像度の新しいビデオにマージできます。ビデオのクリッピング機能を使用すると、ビデオからクリップを抽出し、クリップを新しいビデオとして保存できます。このトピックでは、MPS でマージとクリッピングを設定する方法について説明します。

ビデオのマージ

ビデオをマージするには、次のパラメーターに注意してください。

  • 入力

    マージされる開始部分と、開始部分が格納されているオブジェクトストレージサービス(OSS)バケット。

    説明

    Location パラメーターは、入力ファイルが格納されている OSS バケットが存在するリージョンを指定します。 Location パラメーターの値は、MPS をアクティブ化するリージョンと一致する必要があります。たとえば、MPS サービスのエンドポイントが mts.cn-hangzhou.aliyuncs.com の場合、Location パラメーターを oss-cn-hangzhou に設定する必要があります。

  • 出力

    ジョブ出力を構成する場合は、次のパラメーターに注意してください。

    • ビデオ

      ビデオのマージ後の出力ファイルに関する情報(幅、高さ、ビットレートなど)。開始部分と終了部分を含む、マージされるビデオのアスペクト比が出力アスペクト比と異なる場合、システムは出力ビデオの画像に自動的に黒帯を追加します。出力ファイルがさまざまなシナリオでの解像度の要件を満たすように、開始部分と終了部分に対して異なるアスペクト比のバージョンを準備することをお勧めします。

    • MergeList

      マージするビデオのリスト。ビデオは、リストで指定されたのと同じ順序でマージされます。リストの最後のビデオは終了部分です。開始部分と終了部分を含め、最大 5 つのビデオを指定できます。 5 つを超えるビデオをマージするには、MergeConfigUrl パラメーターを指定します。

      説明

      MergeList パラメーターと MergeConfigUrl パラメーターのいずれか 1 つだけを指定できます。

      マージされるビデオごとに、次の 3 つのパラメーターを指定します。

      • MergeURL

        マージされるビデオの OSS パス。

        説明

        出力ファイルにマージされるすべてのビデオは、開始部分と同じ OSS リージョンに存在する必要があります。リージョンをまたいでビデオをマージすることはできません。

      • Start

        マージされるビデオクリップの開始時点。ビデオの一部のみを出力ファイルにマージする場合は、このパラメーターを指定します。デフォルト値:0。

      • Duration

        マージされるビデオクリップの長さ。長さは、Start パラメーターで指定された開始時点からの相対値です。ビデオの一部のみを出力ファイルにマージする場合は、このパラメーターを指定します。デフォルトでは、長さは Start パラメーターで指定された開始時点からビデオの終わりまでの期間です。

    • MergeConfigUrl

      ビデオマージジョブの構成ファイルの OSS URL。構成ファイルの内容は JSON 形式です。ファイルの内容は、MergeList パラメーターの値と同じです。

      説明

      ビデオは、構成ファイルで指定されたのと同じ順序でマージされます。構成ファイルで指定された最後のビデオは終了部分です。開始部分と終了部分を含め、最大 100 個のビデオを指定できます。

ビデオのクリッピング

ビデオクリップを抽出するには、次のパラメーターに注意してください。

  • 入力

    クリップが抽出されるビデオと、ビデオが格納されている OSS バケット。

    説明

    Location パラメーターは、入力ファイルが格納されている OSS バケットが存在するリージョンを指定します。 Location パラメーターの値は、MPS をアクティブ化するリージョンと一致する必要があります。たとえば、MPS サービスのエンドポイントが mts.cn-hangzhou.aliyuncs.com の場合、Location パラメーターを oss-cn-hangzhou に設定する必要があります。

  • 出力

    ジョブ出力を構成する場合は、次のパラメーターに注意してください。

    • TimeSpan

      元のビデオから抽出されるクリップの時間範囲。ビデオクリップの開始時点と長さを指定できます。

      時間範囲ごとに、次の 3 つのパラメーターを指定します。

      • Seek

        ビデオクリップが開始される時点。

      • Duration

        ビデオクリップの長さ。

      • End

        元のビデオの切り取られる終了部分の長さ。

        説明

        このパラメーターを指定すると、Duration パラメーターは無効になります。

    • ConfigToClipFirstPart

      マージされるビデオの最初の部分を切り取るかどかを指定します。 true の値は、ビデオのマージ前にビデオの最初の部分が切り取られることを示します。 false の値は、ビデオが出力ファイルにマージされ、その後切り取られることを示します。デフォルト値:false。

解像度が 640 × 480 ピクセル の開始部分と終了部分を、解像度が 1280 × 720 ピクセル のビデオに追加して、解像度が 1280 × 720 ピクセル の MP4 ビデオを作成します。出力ビデオでは、開始部分と終了部分の左右に黒帯が追加されます。主要部分は通常どおり表示されます。

さまざまなプログラミング言語の MPS SDK を使用してマージとクリッピングを設定するサンプルコードについては、以下のトピックを参照してください。