動画サムネイル
video-thumbnail
動画からサムネイルを生成します。次のいずれかの値を受け付けます:
- サムネイルを生成する動画の時間(秒)を表す整数
auto(デフォルト):動画の最初の非黒フレームを使用してサムネイルを生成
video-thumbnail が指定されている場合、fm パラメータの挙動が変更されます。このとき、fm はサムネイルの出力形式を決定するための必須パラメータになります。
さらに、auto=compress,format、w、h、fit、crop などを含む 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...