動画アセンブリ

メインアセットを中心に1つのタイムラインに組み立てる、順序付けられた動画・画像セグメントのリストを設定します。

video-assembly[N] は絶対・相対 URL、または予約トークン main を受け付けます。セグメントは 0 から 19 のインデックスで指定します (メイン動画を含めて最大 20 セグメント)。

main トークン。 main の値を持つセグメントがない場合、メイン動画が最初に再生され、インデックスされたすべてのセグメントがその後に追加されます。カスタム順序 (イントロ → メイン → アウトロ) を作るには video-assembly[0]=intro.mp4、video-assembly[1]=main、video-assembly[2]=outro.mp4 のように指定します。

静止画のセグメント。 PNG、JPEG、WebP、AVIF、HEIC、BMP、TIFF ファイルをセグメントとして使用できます。静止画が URL パスを担うことで、動画ファイルなしの純粋なスライドショーを作成できます。

Base64 ツイン。 video-assembly64[N] で Base64 エンコードされた URL を指定できます。

スコープ

アセンブリはすべての出力に適用されます: fm=mp4/webm、gif、hls/dash、サムネイル、スプライトシート、および音声のみ出力 m4a/mp3/wav (組み立てられたサウンドトラックを含む)。video-assembly[N] リスト単体ではレンダリングが実行されません — fm=mp4 などの出力フォーマットも指定してください。

長いアセンブリは標準的な長時間動画のしきい値 (423) で非同期キューに送られます — 同じ URL をポーリングしてレンダリング完了を待ちます。

セグメントの失敗

セグメント URL の取得・プローブができないか、デコードできない動画・画像の場合、レンダリングは 424 Failed Dependency で失敗します。アセンブリはコンテンツを暗黙的にドロップしません。

アセンブリを使ったレンダリングは X-Imgix-Video-Operations に video-assembly を報告します。