ApsaraVideo VODでは、事前に設定されたスナップショットテンプレートを使用してビデオスナップショットを作成できます。 ApsaraVideo VODコンソールを使用するか、API操作を呼び出すことで、スナップショットテンプレートを管理できます。 このトピックでは、スナップショットタイプ、使用状況のメモ、スナップショットテンプレート、スナップショットパラメータ、スナップショットテンプレートの管理など、ビデオスナップショット機能について説明します。
概要
ビデオ内の特定の時点でビデオスナップショットを作成して、画像ファイルを生成できます。 この機能を使いやすくするために、ApsaraVideo VODには、関連パラメーターを指定して作成できるスナップショットテンプレートが用意されています。 スナップショットテンプレートのIDを指定することで、スナップショットを作成できます。
A snapshot may fail to be created if a media file is an audio file without any image information, if the mezzanine file is damaged, or if the mezzanine file encapsulation is abnormal.
スナップショットは非同期的に取得されます。 スクリーンショット要求が送信され、APIを使用して結果が返された場合、タスクはまだキューに入れられ、完了していない可能性があります。 SnapshotCompleteイベント通知を受信すると、スナップショットリクエストの結果を取得できます。 詳細については、「SnapshotComplete」をご参照ください。
スナップショットの作成に必要な時間は、スナップショットの作成に使用されるファイルサイズ、期間、およびフレームタイプによって異なります。
スナップショットの種類
サムネイルスナップショット (CoverSnapshot)
ApsaraVideo VODは、各ビデオメザニンファイルのスナップショットを取得します。 これらのスナップショットは、サムネイルスナップショットと呼ばれます。 デフォルトでは、ApsaraVideo VODはビデオのキーフレームに基づいて最大8つのスナップショットを取得します。 最初のスナップショットは、ビデオの5ミリ秒後の最初のキーフレームで取得されます。 ApsaraVideo VODコンソールの動画詳細ページでサムネールスナップショットを表示し、動画サムネイルとして選択できます。
ビデオに含まれるキーフレームが8つ未満の場合、サムネイルスナップショットの数は8つ未満です。
スナップショットをサムネイルとして指定しない場合、ApsaraVideo VODはサムネイルスナップショットの1つをサムネイルとして選択します。
通常のスナップショット (NormalSnapshot)
API操作を呼び出して、特定のビデオのスナップショットを取得できます。 スナップショットの取得の開始時間と間隔、スナップショットの総数、スナップショットの幅と高さを設定できます。 API操作を呼び出してビデオのスナップショットを繰り返し取得する場合、ApsaraVideo VODは最後の操作で返されたスナップショットデータのみを保持します。 詳細については、「SubmitSnapshotJob」をご参照ください。
Sprite snapshot (SpriteSnapshot)
ビデオのスプライトスナップショットを取得するには、ApsaraVideo VODは通常のスナップショットを取得し、特定の配置ルールに基づいてそれらを結合します。 これらの通常のスナップショットは、スプライトソーススナップショットと呼ばれます。 スプライトスナップショットは、スナップショット要求の数を減らすことができるので、単一のスプライトスナップショット要求によって複数のスナップショットの情報を取得することができる。 これにより、クライアントのパフォーマンスが向上します。
たとえば、通常のスナップショットをスプライトスナップショットで10行10列に並べた場合、スプライトスナップショットから最大100個の通常のスナップショットを取得できます。 通常のスナップショットの数が100未満の場合、100未満の通常のスナップショットを含むスプライトスナップショットが生成されます。 通常のスナップショットの数が100を超える場合、2番目のスプライトスナップショットが生成され、過剰な通常のスナップショットに対応します。 このプロセスは、すべてのスナップショットが取得されるまで繰り返される。 次の図は、スプライトスナップショットの例を示しています。
説明上記の図では、通常のスナップショットの総数は50です。 通常のスナップショットは、スプライトスナップショットで10行3列に配置されます。 最初のスプライトスナップショットには30個の通常スナップショットが含まれ、2番目のスプライトスナップショットには20個の通常スナップショットが含まれます。
スプライトソーススナップショット (SpriteOriginSnapshot)
スプライトソーススナップショットは、スプライトスナップショットの作成に使用される通常のスナップショットです。 スプライトソースのスナップショットを削除または保持できます。 If sprite source snapshots are retained, you can query them by calling an API operation. 詳細については、「ListSnapshots」をご参照ください。
WebVTTスクリーンショット
WebVTTスクリーンショットは、時間やURLなど、すべてのスクリーンショットの基本情報を含むVTTファイルです。 The information in the VTT files can be obtained and parsed for using preview thumbnails on the progress bar.
WebVTTスナップショットの保存方法
分離ストレージ
次の図に示すように、スナップショットは個別に保存され、相対的な位置と時間はVTTファイルに保存されます。
集合ストレージ
すべてのスナップショットは単一のイメージとして保存されます。 次の図に示すように、システムが特定のスナップショットにアクセスすると、VTTファイルの内容に基づいてスナップショットが検索されます。
使用上の注意
サムネイルスナップショット
ビデオがアップロードされると、ApsaraVideo VODはビデオメザニンファイルのサムネイルスナップショットを推奨ビデオサムネイルとして取得します。 このプロセス中は課金されません。
API操作の呼び出しによるスナップショット
API操作を呼び出すことで、特定のビデオの通常のスナップショットとスプライトスナップショットを作成できます。 詳細については、「SubmitSnapshotJob」をご参照ください。 You can use this method to take normal snapshots and sprite snapshots.
スナップショットの照会方法
ApsaraVideo VODでは、次の方法を使用してビデオスナップショットをクエリできます。
You can obtain snapshot information by receiving the SnapshotComplete event notification. 詳細については、「SnapshotComplete」をご参照ください。
GetVideoInfo操作を呼び出して、デフォルトのスナップショット情報を取得できます。 詳細については、「GetVideoInfo」をご参照ください。
ListSnapshots操作を呼び出して、スナップショットをクエリできます。 For more information, see ListSnapshots.
スナップショットを削除する方法
ApsaraVideo VODでは、スナップショットを個別に管理することはできません。 ビデオと一緒に管理する必要があります。 ビデオを削除すると、そのスナップショットはすべて削除され、復元できません。
スナップショットテンプレートの管理
スナップショットの取得時には多くのパラメータが含まれます。 スナップショット作成タスクを送信するときに、これらすべてのパラメーターを指定するのは非効率的です。 したがって、ApsaraVideo VODは、関連パラメーターを指定して作成できるスナップショットテンプレートを提供します。 スナップショットテンプレートのIDを指定することで、スナップショットを作成できます。
ApsaraVideo VODコンソールを使用するか、API操作を呼び出すことで、スナップショットテンプレートを管理できます。
コンソールを使用したスナップショットテンプレートの管理
ApsaraVideo VODコンソールでスナップショットテンプレートを作成、変更、削除できます。
APIの呼び出しによるスナップショットテンプレートの管理
詳細については、「AddVodTemplate」をご参照ください。
スナップショットパラメータ
通常のスナップショットのパラメーター
説明次の表に、通常のスナップショットの一部のパラメーターのみを示します。 詳細については、「メディア処理パラメーター」のSnapshotConfigセクションをご参照ください。
API パラメーター
コンソールパラメーター
説明
FrameType
フレームタイプ
スナップショットのフレームタイプ。 有効な値: intraとnormal。 intraはキーフレームを示し、normalはフレームを示します。
同じスナップショットルールが適用されている場合、キーフレームのキャプチャはフレームよりも高速です。
SpecifiedOffsetTime
開始時間
スナップショットの開始時刻。 値は正の整数です。 単位：ミリ秒。
スナップショットが1つだけ取得される場合、
SpecifiedOffsetTimeはスナップショットが取得される時刻を指定します。Count
スナップショット数
取得するスナップショットの総数。
間隔
スナップショット間隔
複数のスナップショットが取得された場合のスナップショット間の間隔。
Count値が1より大きく、Interval値が0でない場合、システムは指定された間隔で指定された数のスナップショットを取得します。
Count値が1より大きく、Interval値が0の場合、システムはビデオ期間内に指定された数のスナップショットを取得します。 FrameTypeパラメーターがintraに設定されていて、キーフレームの数がCount値より小さい場合、取得されるスナップショットの数はCountの値より小さくなります。
Count値が1の場合、システムは1つのスナップショットを取得します。
幅
幅
スナップショットの幅。 単位: ピクセル。 有効値: 8 ~ 4096
説明幅および高さパラメータの説明:
WidthパラメーターとHeightパラメーターのどちらも指定されていない場合、スナップショットの幅と高さはビデオメザニンファイルと同じになります。
WidthパラメーターとHeightパラメーターのいずれか一方のみが指定されている場合、スナップショットが歪まないように、もう一方のパラメーターは入力ビデオのアスペクト比に基づいて自動的に設定されます。
Height
Height
スナップショットの高さ。 単位: ピクセル。 有効値: 8 ~ 4096
WebVTTスナップショットのパラメーター
WebVTTスナップショットを作成するときは、通常のスナップショットに加えて、次の表に示すように
FormatおよびSubOutパラメーターを指定する必要があります。API パラメーター
コンソールパラメーター
説明
形式
形式
スナップショットのインデックス情報を収集する形式。 値をVTTに設定します。
説明このパラメーターは、WebVTTスナップショットを取得する場合にのみ必要です。
サブアウト
WebVTTスナップショットの保存方法を指定します。 設定可能な値は以下のとおりです。
false: スナップショットを個別に保存します。
true: スナップショットを単一のイメージとして保存します。
このパラメーターは、WebVTTスナップショットを取得する場合にのみ必要です。
例：
{ "IsSptFrag":"true" }スプライトスナップショットのパラメーター
説明次の表に、スプライトスナップショットを作成するときに指定する必要があるパラメーターの一部のみを示します。 詳細については、「メディア処理パラメーター」のSpriteSnapshotConfigセクションをご参照ください。
API パラメーター
コンソールパラメーター
説明
CellWidth
幅
スプライトスナップショット内の小さなイメージの幅と高さ。 CellWidthパラメーターとCellHeightパラメーターのどちらも指定しない場合、小さなイメージの幅と高さは通常のスナップショットの幅と高さと同じになります。 CellWidthパラメーターとCellHeightパラメーターのいずれか一方のみを指定した場合、もう一方のパラメーターは入力ビデオのアスペクト比に基づいて自動的に設定されます。
CellHeight
Height
KeepCellPic
スナップショットを保持
スプライトスナップショットの生成後にスプライトソーススナップショットを保持するかどうかを指定します。 有効な値: delete and keep。
説明特に必要がない限り、スプライトソーススナップショットを削除することを推奨します。
色
Background Color
スプライトスナップショットの背景色。 詳細については、「カラー設定パラメーター」をご参照ください。
説明RGB値はサポートされていません。
次の図に、スプライトスナップショットパラメーターの概略図を示します。