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

ApsaraVideo Media Processing:標準トランスコーディングジョブまたはワークフローの作成

最終更新日:Jan 12, 2025

ApsaraVideo Media Processing(MPS)をトランスコーディングに使用する場合、MPSコンソールで、またはAPIオペレーションを呼び出すことによって、トランスコーディングジョブまたはワークフローを作成できます。このトピックでは、MPSで標準トランスコーディングジョブまたはワークフローを作成する方法について説明します。

始める前に

次の操作が実行されていることを確認してください。

  • MPSキューを有効にします。詳細については、「MPSキューの作成」をご参照ください。標準トランスコーディングジョブまたはワークフローには、標準MPSキューを使用できます

  • 処理するビデオをOSSにアップロードします。

    • ジョブを作成する場合は、ビデオをOSSに直接アップロードします。詳細については、「ビデオのアップロード」をご参照ください。

    • ワークフローを作成し、ワークフローを自動的にトリガーする場合は、ビデオをアップロードする前に、メディアバケットを追加し、ワークフローを作成する必要があります。入力メディアバケットと出力メディアバケットを指定し、メディアファイルを入力メディアバケットにアップロードすると、MPSはアップロードに関するメッセージを受信し、関連付けられたワークフローをトリガーします。ワークフローが完了すると、処理されたメディアファイルが出力メディアバケットにアップロードされます。詳細については、「メディアバケットの追加」をご参照ください。

  • トランスコーディングテンプレートを設定します。

  • オプション。ウォーターマークテンプレートを設定します。ビデオにウォーターマークを追加する場合は、ウォーターマークテンプレートを使用してプロセスを簡素化することをお勧めします。詳細については、「ウォーターマークテンプレートの管理」をご参照ください。

  • オプション。通知機能を有効にします。ジョブとワークフローに関する通知をMPSからMNSトピックまたはキューに送信する場合は、必要に応じてMNSキューまたはトピックを設定します。詳細については、「MPSジョブまたはワークフローの通知機能の有効化」をご参照ください。

コンソールで標準トランスコーディングジョブまたはワークフローを作成する

標準トランスコーディングジョブの作成

  1. MPSコンソールにログオンします。

  2. 上部のナビゲーションバーで、ドロップダウンリストからリージョンを選択します。地域

  3. 左側のナビゲーションペインで、[ジョブ管理] をクリックします。

  4. [エンコード] タブで、[タスクの作成] をクリックします。

  5. 次の表に示すパラメータを設定します。

    パラメータ

    説明

    入力ファイルURL

    Object Storage Service(OSS)バケットに保存されている入力ファイルのURLを指定します。[選択] をクリックします。[ファイルの選択] ダイアログボックスで、[バケット] ドロップダウンリストからOSSバケットを選択します。次に、OSSバケット内のフォルダが [パス] セクションに自動的に表示されます。フォルダからファイルを入力ファイルとして選択します。

    説明
    • [バケット] ドロップダウンリストにバケットが表示されない場合は、OSSコンソールに移動し、指定したリージョンにバケットを作成します。詳細については、「メディアバケットの追加」をご参照ください。

    • OSSバケットを選択した後にファイルが表示されない場合は、OSSコンソールに移動し、ファイルを指定のバケットにアップロードします。

    • OSSのアクティブ化を求めるメッセージが表示された場合は、OSSコンソール に移動してOSSをアクティブ化します。

    • 現在のResource Access Management(RAM)ロールが無効であるか、必要な権限がないことを示すエラーメッセージが表示された場合は、RAMコンソールに移動し、RAMユーザーにOSSにアクセスするための権限を付与します。AliyunOSSFullAccessポリシーをRAMユーザーにアタッチして、RAMユーザーにOSSに対するフルアクセス許可を付与するか、ビジネス要件に基づいて権限をカスタマイズできます。詳細については、「RAMユーザーの作成とRAMユーザーへの権限の付与」をご参照ください。

    エンコーディングパイプライン

    ドロップダウンリストから、トランスコーディング用のMPSキューを選択します。

    説明
    • [エンコーディングパイプライン] ドロップダウンリストにMPSキューが表示されない場合は、トランスコーディング用のMPSキューを有効にします。詳細については、「MPSキューの作成」をご参照ください。

    • トランスコーディング用のMPSキューが同時に処理できるジョブの最大数は保証されません。これは、同時処理能力が使用可能なリソースに依存するためです。デフォルトでは、トランスコーディング用のMPSキューは最大 200 ジョブを同時に処理できます。

    出力ファイル名

    [出力ファイル名] フィールドに名前を入力します。M3U8ファイル以外のすべてのファイルタイプのファイル名拡張子を含める必要があります。例:example_video01.mp4。

    出力パス

    OSSバケットに保存される出力ファイルのURLを指定します。[選択] をクリックします。[出力パスの選択] ダイアログボックスで、[バケット] ドロップダウンリストからOSSバケットを選択します。次に、OSSバケット内のフォルダが [パス] セクションに自動的に表示されます。フォルダを出力パスとして選択します。

    説明
    • 出力パスが入力パスと同じ場合は、入力ファイル名とは異なる出力ファイル名を指定します。これにより、入力ファイルが上書きされません。入力ファイルと出力ファイルの名前が同じ場合、関連するOSS設定によって、出力ファイルが入力ファイルを上書きするかどうかが決まります。ファイルの上書きを無効にする方法については、「同じ名前のオブジェクトによるオブジェクトの上書きを防ぐ」をご参照ください。ファイルの上書きを無効にすると、入力ファイルと同じ名前のトランスコードされた出力ファイルをOSSバケットに書き込むことができなくなります。入力ファイルと出力ファイルに同じ名前を指定しないことをお勧めします。

    • よくある質問への回答については、[入力ファイルURL] パラメータの説明をご参照ください。

  6. [次へ] をクリックします。

  7. 次の表に示すパラメータを設定します。

    パラメータ

    説明

    テンプレートタイプ

    トランスコーディングテンプレートのタイプを選択します。プリセットテンプレートの詳細については、「トランスコーディングテンプレート」トピックの「プリセットテンプレート」セクションをご参照ください。カスタムトランスコーディングテンプレートの作成方法については、「トランスコーディングテンプレート」をご参照ください。

    出力フォーマット

    ドロップダウンリストから出力フォーマットを選択します。デフォルト値: mp4

    テンプレート

    リストからトランスコーディングテンプレートを選択します。デフォルト値: MP4-4K

    ウォーターマークテンプレート

    オプション。このスイッチをオンにする場合は、次の操作も実行する必要があります:

    1. [ウォーターマークテンプレート] ドロップダウンリストからウォーターマークテンプレートを選択します。ドロップダウンリストにウォーターマークテンプレートが表示されない場合は、作成します。詳細については、「ウォーターマークテンプレートの管理」をご参照ください。

    2. [選択][透かし画像] フィールドの横にあるクリックします。[ファイルの選択] ダイアログボックスで、[バケット] ドロップダウンリストからバケットを選択します。すると、バケット内のフォルダーが [パス] セクションに自動的に表示されます。透かしとしてファイルを選択します。

      説明

      PNG画像、アニメーションPNG画像、またはMOVビデオを選択できます。

    クリップ出力

    オプション。このスイッチをオンにすると、ビデオ編集の開始時間とトリミングする長さを設定して、ビデオクリップの長さを指定できます。

    1. [開始時刻] タイムピッカーで、ビデオ編集を開始する時刻の時、分、秒を選択します。

      説明

      開始時刻は、ビデオの合計時間よりも長くすることはできません。それ以外の場合は、トランスコーディングジョブは失敗します。

    2. [クリップの長さ] タイムピッカーで、ビデオクリップの長さの時、分、秒を選択します。

      説明

      指定されたビデオクリップの長さがビデオの残りの部分の長さを超える場合、開始時刻からビデオの終了部分までのビデオクリップが保持されます。

    回転角度

    オプション。[回転角度] フィールドに値を入力します。ビデオは時計回りに回転します。有効な値:0~360。単位:度。

  8. [送信] をクリックします。トランスコーディングジョブが作成され、送信されます。

    トランスコーディングジョブが送信されると、ジョブの実行ステータスと設定を表示できます。また、ジョブの名前をクリックして、入力パスや出力パスなどの他の情報を表示することもできます。

    説明

    ジョブの送信後にトランスコーディングジョブの [エンコードステータス] 列に [失敗] と表示されても、失敗の詳細が提供されない場合は、ネットワークの状態を確認し、ネットワークの状態が正常に戻った後にジョブを再送信してください。

標準トランスコーディングワークフローの作成

  1. MPSコンソール にログオンします。

  2. 上部のナビゲーションバーで、ドロップダウンリストからリージョンを選択します。

  3. 左側のナビゲーションペインで、[ワークフロー] > ワークフローオーケストレーション を選択します。

  4. [ワークフローの作成] をクリックします。

  5. ビジネス要件に基づいて、次のパラメータを設定します。

    1. ワークフロー名:フィールドに名前を入力します。

    2. 設定プラン:ドロップダウンリストからワークフロータイプを選択します。

      説明

      MPSは、さまざまなシナリオでのビジネス要件を満たすために、複数のプリセットワークフローを提供しています。クイック編集用にプリセットワークフローを選択するか、ビジネス要件に基づいてワークフローをカスタマイズできます。

  6. ワークフローのトポロジを編集します。

    1. 必要なノードの右側にあるプラスアイコンをクリックし、[エンコード] を選択します。节点

    2. [エンコード] ノードの右側にあるペンアイコンをクリックします。[エンコーディング] ダイアログボックスが表示されます。节点

    3. [エンコーディング] ダイアログボックスで、次の表に示すパラメータを設定します。

      パラメータ

      説明

      名前

      [エンコード] ノードの名前。

      トランスコーディングテンプレート

      [選択] をクリックします。[エンコーディングテンプレート] ダイアログボックスで、次の操作を実行します。

      1. [テンプレートタイプ] パラメータを設定します。

      2. [出力フォーマット] ドロップダウンリストから出力フォーマットを選択します。

      3. [テンプレート] リストからテンプレートを選択します。

      4. [OK] をクリックします。

      説明

      プリセットテンプレートの詳細については、「トランスコーディングテンプレート」トピックの「プリセットテンプレート」セクションをご参照ください。カスタムトランスコーディングテンプレートの作成方法については、「トランスコーディングテンプレート」をご参照ください。

      出力パス

      [選択] をクリックします。[出力パスの選択] ダイアログボックスで、[バケット] ドロップダウンリストからバケットを選択します。次に、バケット内のフォルダが [パス] セクションに自動的に表示されます。フォルダを出力パスとして選択します。

      説明
      • 出力パスと入力パスが同じ場合、次の2つの状況が発生する可能性があります。

        • 入力ファイルと出力ファイルの名前が異なる場合、出力ファイルは入力ファイルを上書きしません。

        • 入力ファイルと出力ファイルの名前が同じ場合、関連するOSS設定によって、出力ファイルが入力ファイルを上書きするかどうかが決まります。ファイルの上書きを無効にする方法については、「同じ名前のオブジェクトによるオブジェクトの上書きを防ぐ」をご参照ください。ファイルの上書きを無効にすると、入力ファイルと同じ名前のトランスコードされた出力ファイルをOSSバケットに書き込むことができなくなります。入力ファイルと出力ファイルに同じ名前を指定しないことをお勧めします。

      • ワークフローを複数回実行するときに出力ファイルが上書きされないようにするには、次の組み込みUC変数を組み合わせて使用して出力パスを指定できます。

        • {RunId}:ワークフロー実行インスタンスのID。

        • {ObjectPrefix}:バケット情報を含まない元のファイルパス。

        • {FileName}:ファイル名拡張子を含む元のファイル名。拡張子は、トランスコーディングテンプレートのフォーマットによって異なります。

        • {ExtName}:元のファイルのファイル名拡張子。

      ウォーターマーク

      オプション。スイッチをオンにする場合は、次の操作を実行します。

      1. [ウォーターマークテンプレート] ドロップダウンリストからウォーターマークテンプレートを選択します。

        説明

        ドロップダウンリストにウォーターマークテンプレートが表示されない場合は、作成します。詳細については、「ウォーターマークテンプレートの管理」をご参照ください。

      2. [選択] をクリックし、[透かし画像] フィールドの横にある [選択] をクリックします。[パスの選択] ダイアログボックスで、透かし画像のパスを選択します。

        説明

        PNG画像、アニメーションPNG画像、またはMOVビデオを選択できます。

      暗号化

      オプション。スイッチをオンにする場合は、次の操作を実行します。

      [暗号化方法] パラメータを [alibaba Cloudプライベート暗号化] または [HLS標準暗号化] に設定します。ビデオ暗号化の詳細については、ビデオ暗号化 をご参照ください。

      クリップ

      オプション。スイッチをオンにする場合は、次の操作を実行します。

      1. [クリップ方法] パラメータを [ビデオクリップ] または [ビデオ終了クリップ] に設定します。

      2. [開始時刻] パラメータを、ビデオクリップの開始時刻に設定します。

      3. [長さ] パラメータをクリップの長さに設定します。

        説明
        • 開始時刻は、ビデオの合計時間よりも長くすることはできません。それ以外の場合は、トランスコーディングジョブは失敗します。

        • 指定されたビデオクリップの長さがビデオの残りの部分の長さを超える場合、開始時刻からビデオの終了部分までのビデオクリップが保持されます。

      クレジットの追加

      オプション。スイッチをオンにする場合は、次の操作を実行します。[選択] をクリックし、[ファイルパス] フィールドの横にある終了部分のパスを選択します。

      回転角度

      オプション。[回転角度] フィールドに値を入力します。ビデオは時計回りに回転します。有効な値:0~360。単位:度。

    4. [OK] をクリックします。[エンコード] ノードが設定されます。

  7. [保存] をクリックします。ワークフローが作成されます。

APIオペレーションを呼び出して標準トランスコーディングジョブを作成する

MPSコンソールで作成されたトランスコーディングジョブとワークフローがビジネス要件を満たしていない場合は、SubmitJobsオペレーションを呼び出してトランスコーディングジョブを送信し、ビジネスロジックに基づいてトランスコーディングパラメータを設定できます。

  1. SubmitJobsオペレーションを呼び出して、トランスコーディングジョブを送信します。

    詳細については、「SubmitJobs」をご参照ください。次の手順に基づいてリクエストパラメータを設定します。

    1. PipelineId:MPSキューのID。このパラメータを標準MPSキューのIDに設定します。

    2. TemplateId:トランスコーディングテンプレートのID。ビジネス要件に基づいて、このパラメータをプリセットテンプレートまたはカスタムテンプレートのIDに設定します。カスタムトランスコーディングテンプレートの作成方法については、「AddTemplate」をご参照ください。

    3. オプション。出力ファイルを暗号化する場合は、ビジネス要件に基づいて、OutputパラメータのEncryptionパラメータを設定します。

      説明

      暗号化されたファイルはM3U8形式で生成されます。Base64アルゴリズムまたはKey Management Service(KMS)を使用してファイルを暗号化するために、APIオペレーションを呼び出します。詳細については、「パラメータの詳細」をご参照ください。

  2. コールバック通知を受信します。

    Simple Message Queue(SMQ)キューまたはトピックを設定して通知を受信するように設定した場合、MPSはトランスコーディングジョブの完了後にSMQキューまたはトピックに通知を送信します。詳細については、「通知の受信」をご参照ください。

  3. トランスコーディングジョブの結果をクエリします。

    1. QueryJobList オペレーションを呼び出して、トランスコーディングジョブの結果と出力ファイルのURLをクエリできます。

    2. ListJob オペレーションを呼び出して、MPSキューID、ジョブステータス、および作成時間間隔に基づいて、一度に複数のトランスコーディングジョブをクエリできます。