:ビデオスナップショット

スナップショットの種類

• サムネイルスナップショット (CoverSnapshot)

  ApsaraVideo VODは、各ビデオメザニンファイルのスナップショットを取得します。 これらのスナップショットは、サムネイルスナップショットと呼ばれます。 デフォルトでは、ApsaraVideo VODはビデオのキーフレームに基づいて最大8つのスナップショットを取得します。 最初のスナップショットは、ビデオの5ミリ秒後の最初のキーフレームで取得されます。 ApsaraVideo VODコンソールの動画詳細ページでサムネールスナップショットを表示し、動画サムネイルとして選択できます。

• 通常のスナップショット (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値はサポートされていません。 次の図に、スプライトスナップショットパラメーターの概略図を示します。