ApsaraVideo VOD は、トランスコーディング、スナップショット作成、自動レビューなど、さまざまなメディア処理機能を提供します。メディア処理を簡素化するために、ApsaraVideo VOD はコンソールで処理フローをカスタマイズできるワークフローを提供します。このトピックでは、ワークフローの使用方法について説明します。
ワークフローとは
ワークフローは、ほとんどのメディア処理機能を合理化し、インスタンス化するために設計されています。事前にカスタム処理フローを作成し、特定の動画に適用できます。これにより、反復的で複雑な API 呼び出しを回避し、ワンストップのメディア処理サービスを提供します。ワークフローは、堅牢な条件付きロジックメカニズムも提供します。後続の各ノードのトリガー条件をカスタマイズできるため、シナリオベースの処理フローを柔軟に作成できます。
一般的なワークフローシナリオ
逐次レビューとトランスコーディング
このフローでは、動画が ApsaraVideo VOD に取り込まれた後、まずレビューされ、次にトランスコーディングされます。詳細については、「ワークフロー設定例」をご参照ください。
並列レビューとトランスコーディング
このフローでは、動画が ApsaraVideo VOD に取り込まれた後、動画のレビューとトランスコーディングが並列で実行されます。
ソースファイルの並列配信とトランスコーディング
このフローでは、ソースファイルを再生ストリームとして使用し、設定されたトランスコーディングノードに基づいて他のストリームを出力します。
ワークフローのプロセス
準備：コンソールでワークフローを設定します。
ユーザーはアップロード認証情報をリクエストし、ワークフローを指定します。その後、ApsaraVideo VOD サービスはアップロード認証情報を返します。
ユーザーは動画のアップロードを開始します。
アップロードが完了すると、ワークフローが自動的にトリガーされます。
ApsaraVideo VOD ワークフローエンジンは、ワークフロー設定に基づいて、メディア処理や動画 AI などの操作を自動的に実行します。
使用方法
ワークフローの作成
ワークフローは ApsaraVideo VOD コンソールでのみ作成できます。
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、[設定管理] > [メディア処理] > [ワークフロー] を選択します。
ワークフローの追加 をクリックし、ワークフロー名を入力します。
[開始] の横にある + ボタンをクリックしてワークフローのトポロジーを編集し、確認 をクリックします。
ワークフローを作成すると、その ID が ワークフロー管理 ページに表示されます。この ID は、ワークフロータスクを送信する際に必要になります。
ワークフロータスクの送信
ワークフローを作成した後、それを使用して動画の処理タスクを送信できます。タスクは、動画のアップロード中またはアップロード後に送信できます。
コンソールでのワークフロー処理タスクの送信
動画アップロード時のワークフロータスクの送信
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択し、[オーディオ/ビデオのアップロード] をクリックします。
[オーディオ/ビデオの追加] をクリックします。アップロード方法やストレージの場所など、必須パラメーターを設定します。次に、ワークフローでの処理 を選択し、作成したワークフローを指定します。
サポートされているアップロード形式とパラメーターの説明については、「コンソールでのメディアファイルのアップロード」をご参照ください。
オーディオまたはビデオファイルを追加し、アップロード をクリックします。
動画アップロード後のワークフロータスクの送信
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択します。
[オーディオ/ビデオ] リストページで、管理したいオーディオまたはビデオファイルを見つけ、[操作] 列の 処理 をクリックします。
ワークフローでの処理 を選択し、前の手順で作成したワークフローを選択します。
OK をクリックします。
OpenAPI を使用したワークフロー処理タスクの送信
動画アップロード時のワークフロータスクの送信
説明Obtain A/V Upload URL and Credential API 操作は、アップロード URL と認証情報を取得し、メディアアセットの基本情報を作成します。この操作はファイルをアップロードしないため、アップロードロジックはご自身で実装する必要があります。API ベースのアップロードの完全な例については、「ApsaraVideo VOD API を使用したメディアアセットのアップロード」をご参照ください。
CreateUploadVideo または UploadMediaByURL 操作を呼び出してオーディオまたはビデオファイルをアップロードする際に、
WorkflowIdパラメーターをターゲットワークフローの ID に設定します。ファイルのアップロード後、ApsaraVideo VOD は指定されたワークフローを使用して自動的にファイルを処理します。
動画アップロード後のワークフロータスクの送信
SubmitWorkflowJob 操作を呼び出し、
WorkflowIdパラメーターをターゲットワークフローの ID に設定します。これにより、指定されたワークフローを使用してオーディオまたはビデオファイルの処理が直ちに開始されます。
ワークフロー設定例
逐次レビューとトランスコーディング
この例では、逐次レビューとトランスコーディングのワークフローを設定する方法を示します。このワークフローでは、動画はまずレビューされます。動画がレビューに合格した場合、次にトランスコーディングされます。次の手順に従ってください：
ワークフロー編集ページで、[開始] ノードの右側にある + ボタンをクリックします。この例では、自動レビューノードを追加します。
ノードを追加した後、[編集] ボタンをクリックしてレビューテンプレートを選択します。
レビューノードの右側にある + ボタンをクリックして、トランスコーディングノードを追加します。
ノードを追加した後、[編集] ボタンをクリックして実行条件を設定します。
重要[実行条件] オプションが表示されます。この条件は、現在のノードをトリガーするために必要な親ノードのステータスを指定します。要件に基づいてトリガー条件を選択できます。
レビューに合格した後にのみ動画をトランスコーディングするには、トリガー条件を「親ノードのレビューが成功」に設定します。これにより、レビューが成功した後にのみトランスコーディングが開始されるようになります。また、使用するトランスコーディングテンプレートグループも選択する必要があります。
次の表に、その他の実行条件を示します。
シナリオの説明
実行条件
条件の説明
親ノードがレビューの場合
任意の条件
ノードは任意の条件下で実行できます。
親ノードの審査に合格
親ノードのレビューが成功した場合にのみ、ノードを実行できます。
親ノードのレビュー操作が失敗
親ノードのレビューが失敗した場合にのみ、ノードを実行できます。これは、ソースファイルに問題がある場合に発生する可能性がありますが、一般的なシナリオではありません。
親ノードの動画が違反によりブロックされた
親ノードのレビューが完了し、動画が非準拠であることが確認され、自動的にブロックされました。これは、非準拠の動画を手動レビューのために低ビットレートの解像度にトランスコーディングするなどのシナリオでよく使用されます。
親ノードは Transcode です
任意の条件
ノードは任意の条件下で実行できます。
親ノードのトランスコーディングが成功
このノードは、親ノードのトランスコーディングが成功した後にのみ実行できます。
親ノードのトランスコーディングが失敗
このノードは、親ノードのトランスコーディングが失敗した場合にのみ実行できます。これは一般的には使用されません。
ワークフローのトポロジーを設定した後、[確認] をクリックします。ワークフロー ID が生成されます。この ID はアップロード時にワークフローを指定するために必要になるため、記録しておいてください。
並列レビューとトランスコーディング
レビューとトランスコーディングを並列で実行するには、次の図に示すように、[開始] ノードの子ノードとしてレビューノードとトランスコードノードを追加します。
各ノードを編集して、レビューテンプレートやトランスコーディングテンプレートグループなど、必要なテンプレートを選択する必要があります。