ApsaraVideo VOD は、ワークフローでビデオスナップショットを自動的にキャプチャするための、プリセットパラメーターを持つスナップショットテンプレートを提供します。このトピックでは、スナップショット方式の選択、テンプレートの作成と管理、およびワークフローでテンプレートを使用してスナップショットを自動化する方法について説明します。
スナップショット方式の比較
スナップショット方式には、通常のスクリーンショット、WebVTT、スプライトマップ があります。詳細については、「ビデオスナップショット」をご参照ください。
|
スナップショット方式 |
シナリオ |
長所と短所 |
|
通常スナップショット |
動画のサムネイル、コンテンツモデレーション、ハイライトの共有。 |
長所： 短所： |
|
WebVTT |
Web または H5 プレーヤーのプログレスバーにカーソルを合わせたときにサムネイルを表示します。 |
長所：Web および H5 プレーヤーのプログレスバーでのサムネイルプレビューと互換性があります。 短所： |
|
スプライト |
モバイルクライアントや高い読み込みパフォーマンスが要求されるプレーヤーでサムネイルプレビューが必要なシナリオ。 |
長所： 短所： |
スナップショットテンプレートの作成
-
ApsaraVideo VOD コンソールにログインします。
-
左側のナビゲーションウィンドウで、設定の管理 > ApsaraVideo Media Processing の設定 > スナップショットテンプレート を選択します。
-
スナップショットテンプレートの追加 をクリックします。[スナップショットテンプレートの追加] ページで、テンプレートのパラメーターを設定します。
重要テンプレートの作成後は、スナップショット方式 (通常スナップショット、WebVTT、またはスプライト) を変更できません。テンプレートを保存する前に、選択内容を確認してください。
一般的なパラメーター
次のパラメーターは、すべてのスナップショット方式に適用されます。
パラメーター
説明
テンプレート名
テンプレートのカスタム名です。ワークフローでの識別と参照に使用されます。
開始時刻
スナップショットプロセスが開始される時点 (HH:MM:SS) です。
スナップショット数
生成するスナップショットの総数です。
スナップショット間隔
複数のスナップショット間の時間間隔です。0 に設定するか、空のままにすると、動画の持続時間に基づいて等間隔でスナップショットが撮影されます。
サイズ (幅 × 高さ)
スナップショットの幅と高さをピクセル単位で指定します。
説明-
幅と高さを設定しない場合、スナップショットのサイズは入力ビデオと同じになります。
-
幅または高さのみを設定した場合、画像の歪みを防ぐために、もう一方のディメンションはビデオのアスペクト比に比例してスケーリングされます。
フレームタイプ
スナップショットとしてキャプチャするフレームのタイプです。オプションには、キーフレームと通常フレームがあります。
説明キーフレームを選択した場合、キーフレームのみがキャプチャされます。指定した時点にキーフレームが存在しない場合、最も近いキーフレームが自動的に選択されます。同じ条件下では、キーフレームのキャプチャは通常フレームのキャプチャよりも高速です。
WebVTT 固有のパラメーター
パラメーター
説明
大きな画像を生成
WebVTT に必要な複数のサムネイルを 1 つの大きな画像に結合して保存するかどうかを指定します。
スプライト固有のパラメーター
パラメーター
説明
レイアウト (行 × 列)
スプライト内の小さな画像の幅と高さを設定するためのパラメーターです。
説明設定しない場合、小さな画像の幅と高さは通常のスナップショットと同じになります。一方のディメンションのみを設定した場合、もう一方は比例してスケーリングされます。
行間隔
スプライト内の小さな画像の行間の垂直方向の間隔 (ピクセル単位) です。
列間隔
スプライト内の小さな画像の列間の水平方向の間隔 (ピクセル単位) です。
背景色
生成されるスプライトの背景色です。
個々の画像を保持
スプライトの生成後、スプライトを構成する元の画像を保持するかどうかを指定します。
-
-
設定が完了したら、保存 をクリックします。
ワークフローでのスナップショットテンプレートの使用
スナップショットテンプレートを作成した後、メディアのアップロードまたは処理中に使用するには、そのテンプレートをワークフローに追加する必要があります。
-
テンプレートをワークフローにアタッチします。
ApsaraVideo VOD コンソールにログインします。左側のナビゲーションウィンドウで、設定の管理 > ApsaraVideo Media Processing の設定 > ワークフロー管理 を選択します。ワークフローを追加または編集します。ワークフローに 動画スクリーンショット ノードを挿入します。右側のノード設定ペインで、作成したスナップショットテンプレートを選択します。
-
ワークフローをトリガーします。
テンプレートをアタッチした後、次のいずれかの方法でワークフローをトリガーできます。
-
自動トリガー：オーディオまたはビデオファイルをアップロードする際に、このワークフローを指定します。ファイルのアップロード後にワークフローが自動的に実行されます。詳細については、「ApsaraVideo VOD コンソールでのファイルのアップロード」をご参照ください。
-
手動トリガー：メディアファイル > [オーディオ/ビデオ] ページで、対象のメディアアセットを選択し、処理 をクリックし、ワークフローでの処理 を選択してから、このワークフローを指定します。
-
API トリガー：SubmitWorkflowJobs 操作を呼び出して、このワークフローを指定します。
-
-
スナップショット結果を取得します。
SnapshotComplete イベント通知からスナップショット結果を取得できます。ビデオスナップショットが正常にキャプチャされると、システムは設定された URL にコールバックメッセージを送信します。メッセージ本文には、スナップショットデータのリストが含まれています。
課金
ApsaraVideo VOD のスナップショット機能は無料です。
よくある質問
SnapshotComplete イベント通知が届かない場合はどうすればよいですか？
次の手順で問題をトラブルシューティングできます：
-
入力ビデオのステータスが「正常」であり、ビデオファイルが破損していないことを確認します。
-
スナップショットテンプレートのパラメーターが有効であることを確認します。たとえば、開始時刻が動画の持続時間を超えていないことなどです。
-
イベント通知のコールバックが正しく設定されていることを確認します。詳細については、「イベント通知」をご参照ください。
API を介してスナップショットテンプレートを直接使用するにはどうすればよいですか？
SubmitSnapshotJob 操作を呼び出して、スナップショットジョブを個別に開始できます。