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

概要

ビデオの特定の時点にビデオ スナップショットを撮って、イメージ ファイルを生成できます。この機能を使いやすくするために、ApsaraVideo VOD は、関連パラメーターを指定することで作成できるスナップショット テンプレートを提供しています。スナップショット テンプレートの ID を指定することで、スナップショットを撮ることができます。

スナップショットの種類

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

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

• 通常のスナップショット (NormalSnapshot)

  API オペレーションを呼び出して、特定のビデオのスナップショットを撮ることができます。スナップショットを撮る開始時間と間隔、スナップショットの総数、スナップショットの幅と高さを設定できます。 API オペレーションを呼び出すことでビデオのスナップショットを繰り返し撮る場合、ApsaraVideo VOD は最後のオペレーションによって返されたスナップショット データのみを保持します。詳細については、「SubmitSnapshotJob」をご参照ください。

• スプライト スナップショット (SpriteSnapshot)

  ビデオのスプライト スナップショットを撮るために、ApsaraVideo VOD は通常のスナップショットを撮ってから、特定の配置ルールに基づいてそれらを結合します。これらの通常のスナップショットは、スプライト ソース スナップショットと呼ばれます。スプライト スナップショットを使用すると、スナップショット リクエストの数を減らすことができるため、1 回のスプライト スナップショット リクエストで複数のスナップショットの情報を取得できます。これにより、クライアントのパフォーマンスが向上します。

  たとえば、スプライト スナップショットで通常のスナップショットを 10 行 10 列に配置する場合、スプライト スナップショットから最大 100 個の通常のスナップショットを取得できます。通常のスナップショットの数が 100 未満の場合、100 未満の通常のスナップショットを含むスプライト スナップショットが生成されます。通常のスナップショットの数が 100 を超える場合、超過分の通常のスナップショットを格納するために 2 番目のスプライト スナップショットが生成されます。このプロセスは、すべてのスナップショットが取得されるまで繰り返されます。次の図は、スプライト スナップショットの例を示しています。

  説明

  前の図では、通常のスナップショットの総数は 50 です。通常のスナップショットは、スプライト スナップショットで 10 行 3 列に配置されています。最初のスプライト スナップショットには 30 個の通常のスナップショットが含まれ、2 番目のスプライト スナップショットには 20 個の通常のスナップショットが含まれています。

• スプライト ソース スナップショット (SpriteOriginSnapshot)

  スプライト ソース スナップショットは、スプライト スナップショットの作成に使用される通常のスナップショットです。スプライト ソース スナップショットは削除または保持できます。スプライト ソース スナップショットが保持されている場合、API オペレーションを呼び出すことでそれらをクエリできます。詳細については、「ListSnapshots」をご参照ください。

• WebVTT スクリーンショット

  WebVTT スクリーンショットは、時間や URL など、すべてのスクリーンショットの基本情報を含む VTT ファイルです。 VTT ファイルの情報は、プログレスバーのプレビュー サムネイルに使用するために取得および解析できます。

WebVTT スナップショットの保存方法

• 個別保存

  スナップショットは個別に保存され、次の図に示すように、それらの相対位置と時間が VTT ファイルに保存されます。

• 一括保存

  すべてのスナップショットは単一のイメージとして保存されます。システムが特定のスナップショットにアクセスすると、次の図に示すように、VTT ファイルの内容に基づいてスナップショットが特定されます。

使用上の注意

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

  ビデオがアップロードされると、ApsaraVideo VOD はビデオ メザニン ファイルのサムネイル スナップショットを推奨ビデオ サムネイルとして撮ります。このプロセス中は課金されません。

• API オペレーションを呼び出すことによって撮られたスナップショット

  API オペレーションを呼び出すことで、特定のビデオの通常のスナップショットとスプライト スナップショットを撮ることができます。詳細については、「SubmitSnapshotJob」をご参照ください。この方法を使用して、通常のスナップショットとスプライト スナップショットを撮ることができます。

• スナップショットをクエリする方法

  ApsaraVideo VOD では、次の方法を使用してビデオ スナップショットをクエリできます。

  • SnapshotComplete イベント通知を受信することで、スナップショット情報を取得できます。詳細については、「SnapshotComplete」をご参照ください。

  • GetVideoInfo オペレーションを呼び出すことで、デフォルトのスナップショット情報を取得できます。詳細については、「GetVideoInfo」をご参照ください。

  • ListSnapshots オペレーションを呼び出すことで、スナップショットをクエリできます。詳細については、「ListSnapshots」をご参照ください。

• スナップショットを削除する方法

  ApsaraVideo VOD では、スナップショットを個別に管理することはできません。ビデオと一緒に管理する必要があります。ビデオを削除すると、そのすべてのスナップショットが削除され、回復することはできません。

スナップショット テンプレートの管理

スナップショットを撮るときには、多くのパラメーターが関係します。スナップショット撮影タスクを送信するときに、これらのパラメーターをすべて指定するのは非効率的です。そのため、ApsaraVideo VOD は、関連パラメーターを指定することで作成できるスナップショット テンプレートを提供しています。スナップショット テンプレートの ID を指定することで、スナップショットを撮ることができます。

ApsaraVideo VOD コンソールを使用するか、API オペレーションを呼び出すことで、スナップショット テンプレートを管理できます。

• コンソールを使用してスナップショット テンプレートを管理する

  ApsaraVideo VOD コンソールで、スナップショット テンプレートの作成、変更、削除ができます。

• API オペレーションを呼び出してスナップショット テンプレートを管理する

  詳細については、「AddVodTemplate」をご参照ください。

スナップショット パラメーター

• 通常のスナップショットのパラメーター

  説明

  次の表に、通常のスナップショットのパラメーターの一部のみを示します。詳細については、「メディア処理パラメーター」の SnapshotConfig セクションをご参照ください。

  API パラメーター	コンソール パラメーター	説明
  FrameType	フレーム タイプ	スナップショットのフレーム タイプ。有効値：intra および normal。 intra はキーフレームを、normal はフレームを示します。 同じスナップショット ルールが適用される場合、フレームよりもキーフレームをキャプチャする方が高速です。
  SpecifiedOffsetTime	開始時間	スナップショットを撮る開始時間。値は正の整数です。単位：ミリ秒。 スナップショットが 1 つだけ撮られる場合、SpecifiedOffsetTime はスナップショットが撮られる時間を指定します。
  Count	スナップショット数	撮るスナップショットの総数。
  Interval	スナップショット間隔	複数のスナップショットを撮る場合のスナップショット間隔。 Count 値が 1 より大きく、Interval 値が 0 でない場合、システムは指定された間隔で指定された数のスナップショットを撮ります。 Count 値が 1 より大きく、Interval 値が 0 の場合、システムはビデオの再生時間内に指定された数のスナップショットを撮ります。 FrameType パラメーターが intra に設定されていて、キーフレームの数が Count 値よりも小さい場合、撮られるスナップショットの数は Count の値よりも小さくなります。 Count 値が 1 の場合、システムは 1 つのスタップショットを撮ります。
  Width	幅	スナップショットの幅。単位：ピクセル。有効値：8 ～ 4096。 説明 Width パラメーターと Height パラメーターの説明： Width パラメーターと Height パラメーターのどちらも指定されていない場合、スナップショットの幅と高さはビデオ メザニン ファイルの幅と高さと同じになります。 Width パラメーターと Height パラメーターのいずれか一方のみが指定されている場合、もう一方のパラメーターは入力ビデオの縦横比に基づいて自動的に設定され、スナップショットが歪まないようにします。
  Height	高さ	スナップショットの高さ。単位：ピクセル。有効値：8 ～ 4096。

• WebVTT スナップショットのパラメーター

  WebVTT スナップショットを撮る場合は、次の表に示すように、通常のスナップショットのパラメーターに加えて、Format パラメーターと SubOut パラメーターを指定する必要があります。

  API パラメーター	コンソール パラメーター	説明
  Format	フォーマット	スナップショットのインデックス情報を収集するフォーマット。値を VTT に設定します。 説明 このパラメーターは、WebVTT スナップショットを撮る場合にのみ必要です。
  SubOut		WebVTT スナップショットの保存方法を指定します。有効値： false：スナップショットを個別に保存します。 true：スナップショットを単一のイメージとして保存します。 このパラメーターは、WebVTT スナップショットを撮る場合にのみ必要です。 例： { "IsSptFrag":"true" // スプライトフラグメントかどうかの設定 }

• スプライト スナップショットのパラメーター

  説明

  次の表に、スプライト スナップショットを撮るときに指定する必要があるパラメーターの一部のみを示します。詳細については、「メディア処理パラメーター」の SpriteSnapshotConfig セクションをご参照ください。

  API パラメーター	コンソール パラメーター	説明
  CellWidth	幅	スプライト スナップショットの小さなイメージの幅と高さ。 CellWidth パラメーターと CellHeight パラメーターのどちらも指定されていない場合、小さなイメージの幅と高さは通常のスナップショットの幅と高さと同じになります。 CellWidth パラメーターと CellHeight パラメーターのいずれか一方のみが指定されている場合、もう一方のパラメーターは入力ビデオの縦横比に基づいて自動的に設定されます。
  CellHeight	高さ
  KeepCellPic	スナップショットを保持	スプライト スナップショットが生成された後に、スプライト ソース スナップショットを保持するかどうかを指定します。有効値：delete および keep。 説明 特に必要がない限り、スプライト ソース スナップショットを削除することをお勧めします。
  Color	背景色	スプライト スナップショットの背景色。詳細については、「色の設定パラメーター」をご参照ください。 説明 RGB 値はサポートされていません。 次の図は、スプライト スナップショット パラメーターの概略図を示しています。