ApsaraVideo VOD は、動画トランスコード、動画スナップショット、自動レビューなど、一連のメディア処理機能を提供します。メディア処理を簡素化するため、ApsaraVideo VOD はコンソールでカスタム処理パイプラインを作成できるワークフローを提供します。このトピックでは、ワークフローの使用方法について説明します。
ワークフローとは
ワークフローは、メディア処理タスクを合理化およびモジュール化するものです。カスタム処理パイプラインを事前に設定し、動画に適用できます。このアプローチにより、反復的で複雑な API コールが不要になり、統一されたメディア処理サービスが提供されます。
新機能
新しいバージョンのワークフローには、ApsaraVideo VOD のコア機能のノードが含まれているだけでなく、Intelligent Media Services (IMS) の動画翻訳、字幕抽出、字幕除去、ロゴ除去のノードも追加されています。このアップデートでは、タスククエリとワークフロータスクのコールバックもサポートされるようになりました。進化するビジネスニーズに対応するため、今後もさらに多くの機能ノードを追加していく予定です。
機能比較
✔️ は機能がサポートされていることを、❌ はサポートされていないことを、— は機能が適用できないことを示します。
|
カテゴリ |
機能 |
旧バージョン |
新バージョン |
|
ApsaraVideo VOD ノード |
動画トランスコード |
✔️ |
✔️ |
|
動画スナップショット |
✔️ |
✔️ |
|
|
動画アニメーション |
✔️ |
✔️ |
|
|
自動レビュー / 重複排除 |
✔️ |
❌ |
|
|
Intelligent Media Services ノード |
動画翻訳 |
❌ |
✔️ |
|
字幕抽出 |
❌ |
✔️ |
|
|
字幕除去 |
❌ |
✔️ |
|
|
ロゴ除去 |
❌ |
✔️ |
|
|
ワークフロータスククエリ |
— |
❌ |
✔️ |
|
ワークフローコールバック |
ワークフロータスクのコールバックイベント |
❌ |
✔️ |
|
個別のワークフローコールバック設定 |
❌ |
✔️ |
|
|
個別のノードタスクコールバック |
✔️ |
❌ |
|
|
メディア ID レベルのコールバック (userdata) |
✔️ |
❌ |
制限事項
-
動画翻訳、字幕抽出、字幕除去のノードは、China (上海)、China (北京)、China (深圳)、Singapore リージョンでのみ利用可能です。ロゴ除去ノードは、China (上海)、China (北京)、Singapore リージョンでのみ利用可能です。ApsaraVideo VOD ノードは、すべてのリージョンで利用可能です。
-
ApsaraVideo VOD および Intelligent Media Services のノードを使用するには、ApsaraVideo VOD と Intelligent Media Services を個別に有効化する必要があります。
ユースケース
-
直列：翻訳とトランスコード
このワークフローは、まず動画を翻訳し、次に翻訳された出力をトランスコードします。設定の詳細については、本トピック内の「設定例」セクションをご参照ください。このワークフローのノード設定は、[開始] → [動画翻訳] → [動画トランスコード] → [終了] です。動画データはノード間で渡されます。
-
並列：字幕除去とトランスコード
このワークフローは、字幕除去と動画トランスコードを同時に実行します。ワークフローは [開始] ノードから [字幕除去] と [動画トランスコード] の 2 つの並列パスに分岐します。タスクが完了すると、両方のパスは [終了] ノードで合流します。
-
並列：ソースファイルの配信とトランスコード
このワークフローは、ソースファイルを 1 つの再生ストリームとして配信すると同時に、指定されたトランスコードテンプレートに基づいてトランスコードし、他のレンディションを作成します。
このワークフローでは、2 つの [動画トランスコード] ノードを使用します。上部のノードは、ソースファイルを配信するために [非トランスコードテンプレートグループ ID] を設定する必要があります。下部のノードは、他のレンディションを出力するために [トランスコードテンプレートグループ ID] を設定する必要があります。
仕組み
開始する前に、コンソールでワークフローを設定する必要があります。
-
アップロード URL と認証情報をリクエストする際に、ワークフロー ID を指定します。ApsaraVideo VOD は URL と認証情報を返します。
-
動画をアップロードします。
-
アップロードが完了すると、ワークフローが自動的にトリガーされます。
-
ApsaraVideo VOD のワークフローエンジンは、ワークフローの設定に従って、メディア処理と動画 AI タスクを自動的に実行します。
-
すべてのタスクが完了するとワークフローは終了し、サービスからコールバック通知が送信されます。
使用方法
-
ワークフローを作成します。
現在、ワークフローは ApsaraVideo VOD コンソールでのみ作成できます。
-
ワークフロータスクを開始します。
ワークフロータスクは、動画のアップロード中またはアップロード後に開始できます。
コンソールでの操作
アップロード中
-
ApsaraVideo VOD コンソールにログインします。
-
左側のナビゲーションペインで、メディアファイル > [オーディオ/ビデオ] の順に選択し、[オーディオ/ビデオのアップロード] をクリックします。
-
[オーディオ/ビデオの追加] をクリックし、アップロード方法やバケットなどのパラメーターを設定し、ワークフローでの処理 を選択してから、ワークフローを選択します。
サポートされているアップロード形式とパラメーターの説明については、「コンソールでのファイルアップロード」をご参照ください。
-
アップロードするメディアファイルを追加した後、アップロード をクリックします。
アップロード後
-
ApsaraVideo VOD コンソールにログインします。
-
左側のナビゲーションペインで、メディアファイル > [オーディオ/ビデオ] を選択します。
-
音声/動画リストで、処理するメディアファイルを見つけ、操作列の 処理 をクリックします。
-
[メディア処理] ダイアログボックスで、処理タイプとして ワークフローでの処理 を選択します。 [ワークフローを使用] ドロップダウンリストで、test などの目的のワークフローを選択します。
-
OK をクリックします。
API の使用
アップロード中
説明CreateUploadVideo API は、アップロード URL、認証情報、および基本的なメディアアセット情報のみを返します。メディアファイルはアップロードしません。アップロードロジックは、お客様側で実装する必要があります。API を使用してファイルをアップロードする完全な例については、「ApsaraVideo VOD API を呼び出してメディアファイルをアップロード」をご参照ください。
-
CreateUploadVideo API または UploadMediaByURL API を呼び出してメディアファイルをアップロードする際に、
WorkflowIdパラメーターをワークフローの ID に設定します。アップロードが完了すると、指定されたワークフローに基づいてファイルが自動的に処理されます。
アップロード後
-
すでにアップロードされているメディアファイルを処理するには、SubmitWorkflowJob API を呼び出します。
WorkflowIdパラメーターをワークフロー ID に設定すると、処理タスクが直ちに開始されます。
-
設定例
直列での翻訳とトランスコード
この例では、最初に動画を翻訳し、次にトランスコードする直列ワークフローの設定方法を示します。
-
ワークフロー編集ページで、開始ノードの右側にある [+] アイコンをクリックして、動画翻訳ノードを追加します。右側に表示されるパネルでパラメーターを設定します。
-
翻訳ノードの右側にある [+] アイコンをクリックして、動画トランスコードノードを追加します。右側のパネルで、トランスコードテンプレートグループを選択します。
説明トランスコードテンプレートグループの設定方法については、「トランスコードテンプレート」をご参照ください。
-
ワークフローのトポロジ設定が完了したら、[OK] をクリックします。システムによってワークフロー ID が生成されます。この ID を保存して、今後のアップロードにワークフローを適用します。ワークフローを作成すると、ワークフローリストで名前、ID、作成時刻とともに表示されます。[操作] 列で [詳細] をクリックしてワークフロー設定を表示するか、[削除] をクリックして削除します。
並列での字幕抽出とトランスコード
字幕抽出とトランスコードを並列で実行するには、開始ノードの後に 2 つの子ノード (字幕抽出と動画トランスコード) を追加します。ワークフローエディターでは、[開始] ノードが [ビデオ] ラインで接続された 2 つの並列パスに分岐します。上のパスには [字幕抽出] ノード (VodCaptionExtraction) が、下のパスには [動画トランスコード] ノード (VodTranscode) が含まれます。その後、2 つのパスは、それぞれ [字幕] ラインと [ビデオ] ラインで接続され、[終了] ノードで合流します。