ワークフローは、ApsaraVideo Media Processing（MPS）の自動処理プロセスです。音声またはビデオファイルがアップロードされた後、MPS はクラウドでワークフローを自動的に実行します。このトピックでは、ワークフローに関連する基本的な概念について説明し、ワークフローの使用方法を示します。
機能の説明
基本概念
概念 | 説明 |
メディアワークフロー | メディアワークフローは、一連の事前設定されたジョブです。特定のオブジェクトストレージサービス（OSS）バケットにファイルをアップロードすると、ジョブは事前設定された手順と条件に基づいて自動または手動でトリガーされ、順次実行されます。各メディアワークフローは、ID によって一意に識別されます。 |
アクティビティ | メディアワークフローには複数のノードが含まれています。各ノードはアクティビティと呼ばれます。各ワークフローは入力ノードで開始し、公開ノードで終了する必要があります。中間ノードは自由に調整できます。ワークフローでは、分析、エンコード、スナップショット、パック、コンテンツモデレーション、ビデオ DNA、インテリジェントサムネイルノードなど、さまざまなタイプのノードを追加できます。詳細については、「ワークフローアクティビティ」をご参照ください。 |
トリガーモード | ワークフローは、自動または手動でトリガーできます。デフォルトでは、ワークフローは自動的にトリガーされます。 |
ワークフロー実行インスタンス | ワークフローが実行されるたびに、ワークフロー実行インスタンスが生成されます。各インスタンスは、ID によって一意に識別されます。 |
メディアアセット ID | メディアアセットには、入力ファイルと関連する出力ファイルが含まれます。たとえば、入力ファイルはビデオファイルまたはオーディオファイルであり、関連する出力ファイルは、トランスコードされたファイル、スナップショット、サムネイル、メディア情報、コンテンツモデレーションの結果、および AI タグです。入力ファイルは 1 つのメディアアセットのみに対応し、メディアアセットの ID によって一意に識別されます。このメディアアセット ID は、入力ファイルがトリガーするメディアワークフローによって生成されたすべての情報に関連付けられています。 |
シナリオ
複数のビットレート、複数のオーディオトラック、および複数の字幕ストリームを持つビデオを複数の形式で生成します。
アダプティブビットレートストリーミングビデオをパッケージ化します。
ユーザー生成コンテンツ（UGC）ビデオを処理します。 UGC ビデオがアップロードされた後、低品質のビデオはコンテンツモデレーションとビデオフィンガープリントアクティビティで除外されます。コンテンツモデレーションに合格し、メディアリポジトリ内のビデオとは異なるコンテンツを含むビデオのみがトランスコードされ、タグ付けされます。
制限
デフォルトでは、Alibaba Cloud アカウント内のリージョンに最大 10 個のワークフローを作成できます。
MPS の機能は、リージョンによって異なります。メディアワークフローでサポートされるアクティビティもリージョンによって異なります。詳細については、「リージョンとエンドポイント」をご参照ください。
ワークフローの使用
ワークフローの作成
MPS コンソールで、または API オペレーションを呼び出すことによって、ワークフローを作成できます。詳細については、「ワークフローの作成」をご参照ください。
ワークフローの管理
ワークフローを作成した後、ワークフローを管理できます。具体的には、ワークフローの変更、有効化、無効化、削除、および詳細の表示ができます。詳細については、「ワークフローの管理」をご参照ください。
ワークフローのトリガー
ファイルパスとワークフローを自動的にトリガーするかどうかによって、次のいずれかのモードでワークフローをトリガーできます。トリガー条件の詳細については、「ファイルのワークフロー トリガー ルール」をご参照ください。
トリガーモード | シナリオ |
自動モード | ファイルが指定されたパスにアップロードされた直後に、一連の手順でファイルを処理する場合。 |
手動モード。このモードでは、処理するファイルを特定のパスにアップロードする必要があります。 |
|
手動モード。このモードでは、処理するファイルを任意のパスにアップロードできます。 | ファイルは異なるパスにアップロードされますが、ファイルの処理手順は同じです。 |
処理結果の表示
コンソールで結果を表示できます。これを行うには、MPS コンソールにログオンします。左側のナビゲーションペインで、[ワークフロー] >[ワークフローインスタンス] を選択します。表示するインスタンスを見つけ、[アクション] 列の [詳細] をクリックします。詳細については、「実行インスタンスのクエリ」をご参照ください。
QueryMediaWorkflowExecutionList オペレーションを呼び出すことによって、結果を表示できます。 RunId パラメーターを指定して、ワークフローで実行されるアクティビティに関する情報をクエリできます。たとえば、アクティビティタイプ、アクティビティステータス、ジョブ ID、メッセージサービス（MNS）キューまたはトピックに送信される通知、ユーザー定義データ、メディア ID などです。
MNS キューまたはトピックを設定することで、結果を表示できます。これを行うには、ワークフローを作成するときに、入力ノードの構成で [通知] スイッチをオンにし、MNS キューまたはトピックをワークフローに関連付けます。ワークフローが開始または完了すると、MPS は関連付けられた MNS トピックまたはキューにメッセージを送信します。