ビデオ形式

Imgix Video 機能を起動し、動画形式を指定します。ほとんどの Imgix Video パラメータを使用するには fm=mp4、fm=hls、または fm=dash が必要です。

形式

対応形式

• mp4：MP4 ファイルを出力します。ほとんどのブラウザやデバイスで対応している、最も広くサポートされている動画形式です。
• json：動画メタデータを JSON 形式で出力します。
• spritesheet：スプライトシートのグリッド画像（フレームサムネイルをグリッド状に並べた単一画像）を直接返します。
• m4a：MPEG-4 コンテナに格納された AAC オーディオのみを抽出します。オーディオのみ出力を参照してください。
• mp3：MP3 形式でオーディオのみを抽出します。オーディオのみ出力を参照してください。
• wav：非圧縮 WAV 形式でオーディオのみを抽出します。オーディオのみ出力を参照してください。

ベータ形式

• hls：.m3u8 マニフェストとしてアダプティブ HLS ストリームを出力します。
• dash：.mpd マニフェストとしてアダプティブ DASH ストリームを出力します。
• vtt：パラメータの有無に応じて、スプライトシートメタデータファイルまたは字幕・キャプションのサイドカーとして WebVTT ファイルを返します。

MP4 (fm=mp4)

MP4 ファイルを出力します。ほとんどのブラウザやデバイスで対応している、最も広くサポートされている動画形式です。

video-thumbnail パラメータによって、受け入れられる値のリストが変更されます。詳細は video-thumbnail ドキュメントをご覧ください。

JSON (fm=json)

動画メタデータを JSON 形式で出力します。以下の例をご覧ください：

// https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=json
{
  "streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "height": 2160,
      "color_space": "bt709",
      "codec_type": "video",
      "bit_rate": "13259156",
      "duration": "22.080000",
      "width": 4096
    }
  ]
}

スプライトシート (fm=spritesheet)

スプライトシートのグリッド画像（フレームサムネイルをグリッド状に並べた単一画像）を直接返します。通常、ビデオプレイヤーが VTT ファイルを解析した後に自動的にリクエストされます。スプライトシートのいずれかの辺が 16,384 ピクセルを超える場合、Imgix は複数の画像にページ分割し、VTT ファイルが各ページを自動的に参照します。

HLS — ベータ (fm=hls)

.m3u8 マニフェストとしてアダプティブ HLS ストリームを出力します。Imgix はソースの解像度を上限として、360p から 4K までの標準アダプティブビットレートラダーを自動生成します。既存の音声トラックおよび字幕ストリームは自動的にマニフェストにバンドルされます。デフォルトのビットレートラダーを上書きするには video-renditions パラメータを、同一マニフェストに複数のコーデックバリアントを含めるには video-codecs パラメータを使用してください。

DASH — ベータ (fm=dash)

.mpd マニフェストとしてアダプティブ DASH ストリームを出力します。Imgix はソースの解像度を上限として、360p から 4K までの標準アダプティブビットレートラダーを自動生成します。既存の音声トラックおよび字幕ストリームは自動的にマニフェストにバンドルされます。デフォルトのビットレートラダーを上書きするには video-renditions パラメータを、同一マニフェストに複数のコーデックバリアントを含めるには video-codecs パラメータを使用してください。

VTT — ベータ (fm=vtt)

fm=vtt の動作は、video-spritesheet-* パラメータの有無によって異なります：

• video-spritesheet-* パラメータあり（例：fm=vtt&video-spritesheet-interval=auto）：スプライトシートメタデータファイルを返します。これはスプライトシート画像への Media Fragment URL（#xywh=）と各フレームサムネイルのピクセル座標を含む WebVTT ファイルです。詳細はスプライトシートを参照してください。
• video-spritesheet-* パラメータなし：動画エンコードを行わずに、動画の字幕またはキャプショントラックを WebVTT サイドカーファイルとして返します。ソースに字幕が埋め込まれていない場合は、video-generate-subtitles=true と組み合わせて AI 文字起こしトラックを生成できます。

マルチコーデックストリーミング

fm=hls および fm=dash では、video-codecs パラメータを使用することで、AV1、H.265、H.264 など複数のコーデックバリアントを含むマニフェストを生成できます。これにより、モダンなプレーヤーはより効率的なコーデックを選択しつつ、古いデバイスとの後方互換性も維持されます。サポートされる値は av1、h265、h264 です。

https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-codecs=av1,h265,h264

video-renditions と組み合わせて使用すると、Imgix はコーデックとレンディションのすべての組み合わせに対してバリアントを生成します。たとえば、video-codecs=av1,h265 と video-renditions=1080:6m,720:3m を組み合わせると、マスターマニフェストに合計 4 つのバリアント（1080p の AV1、1080p の H.265、720p の AV1、720p の H.265）が生成されます。