動画サムネイル

video-thumbnail

動画からサムネイルを生成します。次のいずれかの値を受け付けます:

  • サムネイルを生成する動画の時間(秒)を表す整数
  • auto (デフォルト):動画の最初の非黒フレームを使用してサムネイルを生成

video-thumbnail が指定されている場合、fm パラメータの挙動が変更されます。このとき、fm はサムネイルの出力形式を決定するための必須パラメータになります。

さらに、auto=compress,formatwhfitcrop などを含む Rendering API の任意のパラメータを使用して、サムネイルを変換・最適化できます。

サムネイルと動画は別々のリクエストです

video-thumbnail を含む URL は画像を返します。動画ではありません。動画用(fm=mp4)とサムネイル用(fm=jpg&video-thumbnail=N)の2つの別々の URL が必要です。1つの URL で両方を返すことはできません。

video-thumbnail を HTML で使用する

<video> 要素の poster 属性にサムネイル URL を、src に動画 URL を指定します:

<video
  controls
  poster="https://myhost.imgix.net/myvideo.mp4?fm=jpg&video-thumbnail=3"
  src="https://myhost.imgix.net/myvideo.mp4?fm=mp4"
>
  Your browser does not support the video tag.
</video>

以下の「動画サムネイルピッカー」デモを使用して、video-thumbnail パラメータをテストできます。

Loading storyboard data...