ApsaraVideo VOD は、トランスコーディング、スナップショット撮影、自動レビューなど、さまざまなメディア処理機能を提供します。メディア処理を簡素化するために、ApsaraVideo VOD は、コンソールでメディア処理フローをカスタマイズできるワークフロー機能を提供します。このトピックでは、ワークフローの使用方法について説明します。
ワークフローとは
ワークフローは、ほとんどのメディア処理機能を合理化し、モジュール化します。事前にカスタム処理フローを構築し、特定の動画に適用できます。これにより、反復的で複雑な API 呼び出しが削減され、ワンストップのメディア処理サービスが提供されます。
新機能
ApsaraVideo VOD ワークフローの新しいバージョンには、ApsaraVideo VOD の機能ノードだけでなく、動画翻訳、字幕抽出、字幕除去、ロゴ除去のための Intelligent Media Services (IMS) ノードも含まれています。また、タスククエリとワークフロータスクのコールバックもサポートしています。多様なビジネスニーズに応えるため、今後もさらに多くの機能ノードが追加される予定です。
機能比較
✔️ と ❌ は、それぞれサポートされている機能とサポートされていない機能を示します。— は、その機能が適用できないか、不要であることを意味します。
機能 | 二次機能 | 元のワークフロー | 新しいワークフロー |
ApsaraVideo VOD 機能ノード | メディアトランスコーディング | ✔️ | ✔️ |
動画スナップショット | ✔️ | ✔️ | |
動画からの GIF アニメーション作成 | ✔️ | ✔️ | |
メディア自動レビュー / メディア自動重複排除 | ✔️ | ❌ | |
IMS 機能ノード | 動画翻訳 | ❌ | ✔️ |
字幕抽出 | ❌ | ✔️ | |
字幕除去 | ❌ | ✔️ | |
ロゴ除去 | ❌ | ✔️ | |
ワークフロータスクのクエリ | — | ❌ | ✔️ |
ワークフローのコールバック | ワークフロータスクのコールバックイベント | ❌ | ✔️ |
独立したワークフローのコールバック設定 | ❌ | ✔️ | |
独立したノードタスクのコールバック | ✔️ | ❌ | |
メディア ID レベルのコールバック (userdata) | ✔️ | ❌ |
制限事項
動画翻訳、字幕抽出、字幕除去ノードは、中国 (上海)、中国 (北京)、中国 (深セン)、シンガポールのリージョンでのみ利用可能です。ロゴ除去ノードは、中国 (上海)、中国 (北京)、シンガポールのリージョンでのみ利用可能です。ApsaraVideo VOD 機能ノードはすべてのリージョンでサポートされています。
それぞれの機能ノードを使用するには、ApsaraVideo VOD と Intelligent Media Services を個別に有効化する必要があります。
一般的なワークフローシナリオ
直列処理：翻訳 + トランスコーディング
このフローでは、動画が ApsaraVideo VOD にアップロードされた後、まず翻訳されます。次に、翻訳された出力がトランスコーディングされ、直列処理が可能になります。翻訳後のトランスコーディングの設定方法の詳細については、「ワークフロー設定例」をご参照ください。
並列処理：字幕除去 + トランスコーディング
この操作では、動画が ApsaraVideo VOD にアップロードされた後、字幕除去とトランスコーディングが同時に実行されます。
並列処理：ソースファイルの配信 + トランスコーディング
このフローでは、ソースファイルが 1 つの再生ストリームとして使用され、設定されたトランスコーディングノードに基づいて他のストリームが生成されます。
ワークフローの処理フロー
開始する前に、コンソールでワークフローが設定されていることを確認してください。
アップロード認証情報を取得し、ワークフローを指定します。ApsaraVideo VOD サービスはアップロード認証情報を返します。
動画のアップロードを開始します。
アップロードが完了すると、ワークフローが自動的にトリガーされます。
ApsaraVideo VOD ワークフローエンジンは、ワークフロー設定に基づいて、メディア処理、動画 AI、その他の操作を自動的に実行します。
ワークフローエンジンが処理を終了すると、ワークフローは終了し、コールバックを送信します。
利用方法
ワークフローの作成
ワークフローは ApsaraVideo VOD コンソールでのみ作成できます。
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、[設定管理] > [メディア処理] > [ワークフロー] を選択します。
[ワークフローテンプレートの追加] をクリックし、ワークフロー名を入力します。
開始ノードの横にある [+] ボタンをクリックし、ワークフロートポロジーを編集してから、[確認] をクリックします。
ワークフローが作成されると、その ID が ワークフロー管理 ページに表示されます。この ID は、後でワークフロー処理タスクを開始するために使用します。
ワークフロー処理タスクの開始
前のステップで作成したワークフローを使用して動画を処理できます。ワークフロータスクは、動画のアップロード中またはアップロード後に開始できます。
コンソールでのワークフロー処理の開始
動画アップロード時の開始
ApsaraVideo VOD コンソールにログインします。
ApsaraVideo VOD コンソールの左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択し、[オーディオ/ビデオのアップロード] をクリックします。
[オーディオ/ビデオの追加] をクリックし、アップロード方法やストレージの場所などのパラメーターを選択し、ワークフローでの処理 を選択してから、前のステップで作成したワークフローを指定します。
サポートされているアップロードフォーマットとパラメーターの説明については、「コンソールでのアップロード」をご参照ください。
アップロードするオーディオまたはビデオファイルを追加した後、アップロード をクリックします。
アップロード済み動画の開始
ApsaraVideo VOD コンソールにログインします。
ApsaraVideo VOD コンソールの左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択します。
[オーディオ/ビデオ] ページで、処理するメディアファイルを見つけ、[操作] 列の 処理 をクリックします。
ワークフローでの処理 を選択し、前のステップで作成したワークフローを指定します。
OK をクリックします。
OpenAPI を使用したワークフロー処理の開始
動画アップロード時の開始
説明「アップロード URL と認証情報の取得」 API 操作は、アップロード URL、認証情報、および基本的なメディアアセット情報のみを返します。ファイルはアップロードされません。アップロードロジックを実装する必要があります。API を使用してファイルをアップロードする方法の完全な例については、「ApsaraVideo VOD API を使用したメディアファイルのアップロード」をご参照ください。
「アップロード URL と認証情報の取得」または「URL による一括プルアップロード」 API 操作を呼び出してオーディオまたはビデオファイルをアップロードする際に、
WorkflowIdパラメーターを前のステップで作成したワークフローの ID に設定します。アップロードが完了すると、ApsaraVideo VOD システムは指定されたワークフローに基づいてファイルを自動的に処理します。
動画アップロード後のワークフローの開始
「ApsaraVideo VOD ワークフロータスクの送信」 API 操作を呼び出し、
WorkflowIdパラメーターを前のステップで作成したワークフローの ID に設定します。これにより、オーディオまたはビデオファイルに対するワークフロー処理が直ちに開始されます。
ワークフロー設定例
直列処理：翻訳 + トランスコーディング
次の例では、コンテンツが最初に翻訳され、次にトランスコーディングされる、翻訳 + トランスコーディングモードの手順について説明します：
ワークフロー編集ページで、開始ノードの右側にある [+] ボタンをクリックして動画翻訳ノードを追加します。次に、右側のパネルでそのパラメーターを設定します。
翻訳ノードの右側にある [+] ボタンをクリックしてトランスコーディングノードを追加します。次に、右側のパネルでトランスコーディングテンプレートグループを選択します。
説明トランスコーディングテンプレートグループの設定方法の詳細については、「トランスコーディングテンプレート」をご参照ください。
ワークフロートポロジーが完成したら、[確認] をクリックします。システムはワークフロー ID を生成します。今後のアップロードでワークフローを指定できるように、この ID を記録しておきます。
並列処理：字幕抽出 + トランスコーディング
字幕抽出とトランスコーディングを並列で実行するには、開始ノードの右側に 2 つの子ノード (1 つは字幕抽出用、もう 1 つはビデオトランスコーディング用) を追加します。結果のワークフローは次のようになります。