A media workflow in ApsaraVideo Media Processing (MPS) contains multiple activities to implement the automatic processing of an input file. このトピックでは、MPSの理解と使用に役立つ、MPSのメディアワークフローの基本概念と実行ルールを紹介します。
基本的な概念
- Media asset
メディアアセットには、ビデオファイルやオーディオファイルなどの1つの入力ファイルと、トランスコードされたファイル、スナップショット、メディア情報、AIタグなどの関連するすべての出力ファイルが含まれます。 入力ファイルは、1つのメディアアセットのみに対応し、メディアアセットのIDによって一意に識別される。
- メディアライブラリ
メディアライブラリは、すべてのメディアアセットのコレクションです。 メディアアセットは、メディアライブラリ内の最小の管理単位です。
- メディアワークフロー
A media workflow automatically generates media files based on your requirements and is uniquely identified by the ID of the media workflow.
- アクティビティ
メディアワークフローは、複数のノードを含む。 各ノードはアクティビティと呼ばれます。 Multiple activities can be run in parallel or one by one. An activity can be an input activity, a notification activity, or a type of job, such as a transcoding job and a video snapshot job.注 MPSの特徴は地域によって異なります。 メディアワークフローによってサポートされるアクティビティも、リージョンによって異なります。 For more information about features supported in different regions, see Regions and endpoints.
- Input activity
ワークフローの入力パスを指定すると、オーディオファイルやビデオファイルなどのメディアファイルを指定した入力パスにアップロードすると、ワークフローが自動的にトリガーされます。
- 通知アクティビティ
ワークフローが完了すると、ワークフローの実行結果を含む通知が、指定されたMessage Service (MNS) キューまたはトピックに送信されます。 実行結果には、メディアIDとメディアファイルの絶対アドレスが含まれます。 次に、どのメディアファイルが処理されるかを判断できます。
- 仕事の活動
ジョブでサポートされるすべてのパラメーターは、ジョブアクティビティで設定できます。
- Input activity
- パスマッチングルール
アップロードされたファイルのパスがワークフローに指定された入力パスと一致する場合、ワークフローは自動的にトリガーされます。 If the prefix of the path of an uploaded file is the same as an input path, the file path matches the input path. たとえば、アップロードされたファイルのパスはhttp:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A/B/C/video_01.flvです。 次の表に、複数のObject Storage Service (OSS) 入力パスの照合結果を示します。
OSS入力パス 一致 http:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A/B/C/ 必須 http:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A/B/C2/ 任意 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B 必須 http:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A/B2/ 任意 http:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A/ 必須 http:// exampleBucket **** .oss-cn-hangzhou.aliyuncs.com/A2/B/C/ 任意 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/video 必須 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/video_01 任意 - ファイル名拡張子のマッチングルール
ファイルをアップロードした後、自動トリガーメカニズムはファイル名拡張子をチェックして、無効なファイルがアップロードされないようにします。 例えば、PDFファイルおよびWordファイルは、自動トリガ機構によって無効と見なされる。注 API操作を呼び出してワークフローを手動でトリガーする場合、ファイル名の拡張子はチェックされません。ファイルにファイル名拡張子がない場合、またはファイル名拡張子が次のリストの拡張子と一致する場合、ファイルは有効と見なされます。 ファイル名拡張子がないファイルには、ファイル名に区切りドットがありません。
- ビデオファイルでサポートされているファイル名拡張子
. 3gp, . asf、。avi、。dat、。dv、。flv、。f4v, . gif、。m2t, . m3u8, . m4v、。mj2, . mjpeg、。mkv、。モフ、。mp4, . mpe、。mpg、。mpeg、。mts, . オッグ、。qt, . rm, . rmvb, 。swf, . ts, . ボブ、。wmv、および。webm
- オーディオファイルでサポートされているファイル名拡張子
. aac、。ac3, . acm、。amr、。猿、。カーフ、。flac、。m4a, . mp3、。ra、。wav、。wma、そして。aiff
- ビデオファイルでサポートされているファイル名拡張子
- ワークフローの実行
ワークフローは、API操作を呼び出すことによって自動的にトリガーまたは手動でトリガーできます。
- 自動トリガーメカニズム: アップロードされたメディアファイルのパスがワークフローに指定された入力パスと一致するたびに、ワークフローが自動的にトリガーされます。 同じファイルを複数回アップロードすると、ワークフローは自動的に複数回トリガーされます。 IDは、ワークフローの実行ごとに生成される。
- 手動トリガーメカニズム: API操作を呼び出すたびにワークフローがトリガーされます。 手動トリガーメカニズムは、OSSバケットにアップロードされているが処理されていない既存のビデオファイルに適用されます。
- ユーザーデータ
If you set custom parameters of user data, such as the ID of a commodity, when you trigger a workflow, the custom parameters are returned in a notification. これにより、メディアIDやメディアファイルの絶対パスを記録することなく、カスタムパラメーターに基づいてユーザーデータをビジネスに関連付けることができます。
- アクティビティ