クリップ範囲
video-clip-ranges
1回のリクエストで動画の複数の非連続セグメントを選択して連結します。
video-clip-ranges はセミコロン区切りの start-end ペアのリストを受け取ります。各ペアが出力に含めるセグメントを定義し、指定した順序で結合されます。境界値は秒単位または動画の総尺に対するパーセンテージで指定できます。
| 形式 | 値の例 | 動作 |
|---|---|---|
| 秒単位 | 0-5;10-15;18-22 | 0〜5秒、10〜15秒、18〜22秒の3つのセグメント |
| パーセンテージ | 0-25%25;50%25-75%25 | 総尺の0%〜25%と50%〜75%の2つのセグメント |
| 混在 | 0-25%25 | 0秒から総尺の25%の位置まで |
% 文字のエンコードについて
パーセンテージ値には % サフィックスを使用しますが、% は URL の予約文字です。クエリ文字列内では %25 にパーセントエンコードする必要があります。たとえば 25% は URL 上では 25%25 と記述します。秒数とパーセンテージは、同一の範囲ペア内またはペアをまたいで混在させることができます。
個別のクリップパラメータとの比較
video-clip-start、video-clip-end、video-clip-duration は単一の連続セグメントを抽出します。1回の操作で複数の非連続セグメントを抽出して結合する場合は video-clip-ranges を使用してください。
video-clip-ranges は video-clip-start、video-clip-end、video-clip-duration と組み合わせることはできません。