動画の連結
🤖/video/concat は、複数の動画を連結します。

入力動画のサイズやストリームが異なっていても、この Robot で問題なく処理できます。必要に応じて、連結前に入力動画をトランスコードします。追加料金はかかりません。
🤖/video/concat を使用すると、実質的に無制限の数の動画ファイルを連結できます。
使用例
ファイル入力フィールドが 3 個あるフォームで、アップロードされた動画を特定の順序で連結するには、各入力フィールドの name 属性を使って Transloadit に指示します。この属性を JSON の fields キーの値に使用し、as を video_[[index]] に設定してください。Transloadit はインデックスの昇順でファイルを連結します:
{
"steps": {
"concatenated": {
"robot": "/video/concat",
"use": {
"steps": [
{
"as": "video_1",
"fields": "first_video_file",
"name": ":original"
},
{
"as": "video_2",
"fields": "second_video_file",
"name": ":original"
},
{
"as": "video_3",
"fields": "third_video_file",
"name": ":original"
}
]
}
}
}
}パラメーター
interpolateboolean | Record<string, boolean>処理設定の各フィールドで Assembly Variables を展開するかどうかを制御します。
デフォルトでは、Robot の処理設定のほとんどのフィールドで Assembly Variables が展開されます。すべての設定フィールドをリテラルテキストとして扱うには、このパラメーターを
falseに設定してください。特定のフィールドだけをリテラルテキストとして扱うには、そのフィールドのパスをfalseに設定してください。デフォルトでリテラルとして扱われる Robot 固有のフィールドで展開を有効にするには、このパラメーターをtrueに設定するか、そのフィールドのパスをtrueに設定してください。pathのようなフィールド名を使用してください。ネストされたオブジェクトには、ffmpeg.vfのようなドット区切りのパスを使用してください。output_metaRecord<string, boolean> | boolean | Array<string>算出に多くの CPU リソースを要するメタデータを指定できます。Assembly の処理速度を維持するため、これらはデフォルトで無効になっています。
画像の場合、このオブジェクトに
"has_transparency": trueを追加すると、画像に透明な部分が含まれるかどうかを抽出できます。"dominant_colors": trueを追加すると、画像から 16 進数のカラーコードの配列を抽出できます。画像の場合、
"blurhash": trueを追加すると、画像のプレースホルダーをコンパクトに表す BlurHash 文字列も抽出できます。画像全体の読み込み中に、ぼかしたプレビューを表示するのに役立ちます。画像の場合、代わりに
"thumbhash": trueを使用すると、base64 エンコードされた ThumbHash をmeta.thumbhashに抽出し、meta.has_alpha(完全に不透明な場合も含め、アルファチャンネルが存在するかどうか)も抽出します。ThumbHash は EXIF の向きを反映したピクセルを表し、アニメーション画像では最初のフレームを使用します。抽出はベストエフォートです。40 メガピクセルを超える画像、非対応の形式、デコードの失敗やデコード処理の上限への到達があった場合、プレースホルダーは生成されません。抽出に成功すると、そのファイルのバイト数の 20% に相当するメタデータ料金が加算されます。無効な場合やハッシュが生成されない場合、ThumbHash の追加料金は発生しません。このオプションは画像を生成する Step に設定してください。たとえば、アップロードされた元画像では
/upload/handle、処理済みの出力では/image/resizeに設定します。/transloadit/storeにのみ設定しても、抽出は要求されません。ストレージは生成元のメタデータを保持します。Transloadit Storage は生成されたハッシュをその不変のバージョンとともに永続化し、保存済みの結果やネイティブのアセット読み取り時に返します。S3 への直接アップロードではプレースホルダーは生成されません。プレースホルダーには画像情報が含まれるため、画像全体と同じアクセス制御で保護してください。動画の場合、
"colorspace": trueパラメーターを追加すると、出力動画の色空間を抽出できます。動画の場合、
"interlaced": trueを追加すると、インターレース動画かどうかも検出できます。これは、低コストの ffprobe のfield_orderフラグと、ソースの先頭フレームに対する処理範囲を制限したidetサンプリング処理を組み合わせ、file.metaの下にinterlaced、field_order、診断用のinterlace_detectionオブジェクトを出力します。この処理は計算コストが高く、それに応じて課金されます。音声の場合、
"mean_volume": trueを追加すると、音声ファイルの平均音量を表す単一の値を取得できます。また、
falseに設定すると、メタデータの抽出をスキップしてトランスコードを高速化できます。user_metaRecord<string, any>(デフォルト:{})出力される各ファイルに、ファイルの内容を変更せずにカスタム JSON メタデータを追加します。ネストしたオブジェクトと配列に対応しています。
継承の動作は Robot によって異なります。値は出力ファイルの既存の
user_metaとマージされ、一致するトップレベルのキーは現在の Step によって置き換えられます。Robot が新しい出力を作成する場合は、必要なキーを明示的に割り当ててください。処理 Step では、
${file.*}は最初の入力を、${result.*}は出力されるファイルを参照します。値は Robot の実行後、後続のメタデータ抽出と一時保存の前に、出力ごとに評価されます。:originalでは、メタデータ抽出の前にアップロードごとに値が評価されます。後続の Step は
${file.user_meta.key}を読み取ります。完全な例と継承ルールについては、カスタムメタデータ を参照してください。resultboolean(デフォルト:false)この Step の結果を Assembly Status JSON に含めるかどうか
queuebatchqueue を 'batch' に設定すると、このステップのジョブの優先度を手動で下げ、キューの待ち時間がゼロである必要のないジョブが優先ジョブスロットを消費しないようにします。
force_acceptboolean(デフォルト:false)通常は無視するファイルタイプを Robot に強制的に受け入れさせます。
デフォルトでは、Robot は認識できないファイルを無視します。たとえば、🤖/video/encodeは入力画像を無視します。
force_acceptパラメーターをtrueに設定すると、Robot に渡されたすべてのファイルを強制的に受け入れさせることができます。通常、この設定はエラーにつながるため、デバッグやエッジケースへの対処にのみ使用してください。ignore_errorsboolean | Array<meta | execute>(デフォルト:[])処理の特定のフェーズでエラーを無視します。
このパラメーターを
["meta"]に設定すると、Robot はメタデータ抽出中のエラーを無視します。このパラメーターを
["execute"]に設定すると、Robot はメイン実行フェーズ中のエラーを無視します。このパラメーターを
trueに設定すると、["meta", "execute"]と同じ動作になり、両方のフェーズでエラーを無視します。usestring | Array<string> | Array<object> | object入力として使用する Step を指定します。
- Step には任意の名前を付けられます。ただし、
":original"は Transloadit が処理するユーザーアップロード用に予約されています。 - 配列を使用して、複数の Step を入力として指定できます。
{ "use": [ ":original", "encoded", "resized" ] } - 入力 Step に
asでタグを付けて、意味上の用途を Robot に伝えることもできます。{ "use": [ { "name": ":original", "as": "image" }, { "name": ":original", "as": "mask" } ] }
ヒントuseについては、通常ここまでの内容で十分ですが、高度な使用例 も参照できます。- Step には任意の名前を付けられます。ただし、
ffmpegobjectFFmpeg に渡すパラメーターオブジェクトです。プリセットを使用する場合、ここで指定したオプションがプリセットのオプションに上書きマージされます。利用可能なオプションは、FFmpeg ドキュメントを参照してください。ここで指定したオプションは、プリセットのオプションよりも優先されます。
ffmpeg_stackv6 | v7 | v8 | string(デフォルト:"v6.0.0")エンコードに使用する FFmpeg スタックのバージョンを選択します。現在は「v7」の使用を推奨しています。「v6.0.0」、「v7.0.0」、「v8.0.0」という正確なバージョン指定は、後方互換性のために引き続き受け付けられるレガシー値です。非推奨の「v5.x」の値も受け付けられます。
widthstring | number | null新しい動画の幅(ピクセル単位)です。
値が指定されておらず、
presetパラメーターが利用できる場合は、presetで指定されている幅 が適用されます。heightstring | number | null新しい動画の高さ(ピクセル単位)です。
値が指定されておらず、
presetパラメーターが利用できる場合は、presetで指定されている高さ が適用されます。presetandroid | android-high | android-low | android_high | android_low | dash-1080p-video | dash-1080p_video |事前設定済みの設定 に従って動画を変換します。
Robot を使用して独自の FFmpeg パラメーターを指定する場合や、Transloadit にエンコード設定を一切行わせたくない場合は、ここで
'empty'を使用できます。video_fade_secondsstring | number(デフォルト:0)少なくとも二つのファイルを連結する場合、正の値を指定すると各入力の映像がフェードアウトし、最初の入力を除くすべての入力がフェードインします。出力の冒頭ではフェードインしませんが、最後の入力にもフェードアウトが適用されます。
値は秒単位の時間です。たとえば、
0.5は 500 ミリ秒を意味します。入力ごとのフェードを無効にするには、このパラメーターを省略するか、0に設定してください。これらのフェードでは、クリップを重ね合わせたり、クリップ間に時間を追加したりしません。映像のフェード時間はフレーム単位で切り捨てられ、各入力の長さが上限となります。
このパラメーターは、
transitionが"none"の場合にのみ適用されます。transitionが"crossfade"または"fade_to_black"の場合は無視されます。これらの効果にはtransition_durationを使用してください。音声のフェードはaudio_fade_secondsで個別に制御します。出力の冒頭にフェードインを追加するには、動画エンコード Stepを追加し、
ffmpegパラメーターを使用してください。具体例は映像フェードのデモ (English)で確認できます。audio_fade_secondsstring | number(デフォルト:0)二つ以上のファイルを連結する場合、正の値を指定すると、各入力の音声がフェードアウトし、最初の入力を除くすべての入力がフェードインします。出力の冒頭ではフェードインしませんが、最後の入力にもフェードアウトは適用されます。
値は秒単位の時間です。たとえば、
0.5は 500 ミリ秒を意味します。入力ごとのフェードを無効にするには、このパラメーターを省略するか、0に設定してください。これらのフェードでは、クリップを重ね合わせたり、クリップ間に時間を追加したりしません。音声のフェードアウトは秒単位の境界から始まり、入力の終わりより前に終了する場合があります。
このパラメーターは、
transitionが"none"の場合にのみ適用されます。transitionが"crossfade"または"fade_to_black"の場合は無視されます。これらの効果にはtransition_durationを使用してください。映像のフェードはvideo_fade_secondsで個別に制御します。出力の冒頭に音声のフェードインを追加するには、動画エンコード Stepを追加し、
ffmpegパラメーターを使用してください。音声フェードのデモ (English)では、対応する FFmpeg 音声フィルターを示しています。chapter_markersboolean(デフォルト:false)trueに設定すると、連結した動画の出力内で各入力動画が始まる位置にチャプターマーカーが追加されます。各チャプターのタイトルには、対応する入力動画ファイルのベース名が使われます。transitionが有効な場合、クリップ間の重なりを考慮し、後続クリップのチャプターはそのトランジションの開始位置から始まります。チャプター単位のシークに対応する動画プレーヤーでの移動に便利です。
MP4 出力では、チャプターマーカーによってチャプター情報を含む
bin_dataトラックが追加されます。これは正常な動作で、映像や音声の再生には影響しません。sort_byauto | basename | import_order(デフォルト:"basename")入力タイプに対して番号付きエイリアスを明示的に使用しない場合に、まとめられた入力の並び順を制御します。番号付きエイリアスは、
_1のように数値の接尾辞で終わります。デフォルトの
"basename"は、ベース名を自然順でソートする従来の動作を維持します。すべての入力ファイルに完全なインポート順序のメタデータが含まれる場合、
"import_order"に設定すると、配列ベースのインポートステップの順序を維持できます。"auto"も同様にインポート順序を優先し、フォールバックとしてベース名の自然順ソートを使用します。transitionnone | crossfade | fade_to_black(デフォルト:"none")連結する動画クリップ間に適用するトランジション効果を指定します。
"none"(デフォルト):トランジション効果なし。動画をそのまま順につなぎます。"crossfade":前のクリップの終わりが次のクリップの始まりに徐々に溶け込むクロスフェードを適用します。映像と音声の両方がクロスフェードします。"fade_to_black":各クリップが黒画面へフェードアウトしてから、次のクリップが黒画面からフェードインするトランジションを適用します。
"crossfade"または"fade_to_black"を使用する場合、transition_durationパラメーターでトランジションの長さを制御します。どちらの効果でも隣接するクリップが重なり、つなぎ目ごとに適用されたトランジション時間の分だけ出力全体の長さが短くなります。適用される時間の上限は、各ペアの短い方のクリップの長さの半分です。transition_durationstring | number(デフォルト:1)トランジション効果の秒単位の長さです。
transitionが"crossfade"または"fade_to_black"に設定されている場合にのみ適用されます。たとえば、
1.0を指定すると、クリップ間に 1 秒のトランジションが作成されます。秒未満の精度を指定するために浮動小数点数を使用できます(例:0.5は 500 ミリ秒)。トランジションを有効にする場合は、必ず0より大きい値を指定する必要があります。クロスフェードでは、両方のクリップが表示される重なりの時間を指定します。
"fade_to_black"の場合、トランジションの最初の約 20% で映像がフェードアウトし、残りの 80% でフェードインします(1 秒のトランジションでは、フェードアウトが約 0.2 秒、フェードインが約 0.8 秒)。どちらの効果でも、音声はトランジション全体を通してクロスフェードします。適用されるトランジション時間の上限は、各トランジションペアの短い方のクリップの長さの半分です。どちらの効果でも、つなぎ目ごとにこの適用時間の分だけ出力が短くなります。