Transloadit の専門用語を読み解く総合ガイド
Transloadit を使い始めたばかりで、専門用語の多さに戸惑っていませんか?ご安心ください。この記事では Transloadit 独自の用語を解説し、次に Transloadit のドキュメントを読むときに、迷わず読み進められるようにします。

Robot と Job
Transloadit の内部では、FFmpeg などのツールをファイルに対して実行しています。こうしたツールの実行によって Job が作成されます。これは、ほかのすべての処理の基礎となる最小の論理単位です。
ただし、Job は単独では実行できません。そこで登場するのが Robot です。ラインナップにある各 Robot は、それぞれ固有のタスクに特化しています。Robot の組み合わせは無限にあり、音楽カードジェネレーターのような複雑な機能を作れます。
Template、Assembly、Assembly Instructions

Robot は単独でも優れた処理を行えますが、複数の Robot を生産ラインのようにつなぎ合わせると、さらに優れた処理を実現できます。この処理の流れを Assembly Instructions と呼んでいます。各 Robot が処理の中で単一の Step を実行し、最終的には個々の部分を足し合わせる以上の機能を実現します。
Transloadit のサーバーは、指定された Assembly Instructions を解析し、必要なバックエンドツールを実行して、トランスコードされたファイルを出力します。Assembly とは、Assembly Instructions の 1 回の実行を指す用語です。
もちろん、Assembly Instructions を毎回新たに渡して Assembly を作成する方法が、常に最適とは限りません。そこで用意したのが Template です。Template を使えば、Transloadit に Template の名前を指定するだけで、あらかじめ作り込んだ JSON の処理設定に従って実行されます。Template を使うメリットの一部は、最近のブログ記事 Transloadit を最大限に活用する 5 つの方法で紹介しています。
同期と非同期
デフォルトでは、Transloadit は Assembly の現在の状態を Assembly Status JSON の一部として返します。これを購読してポーリングすることで、Assembly の完了を確認できます。これが、Transloadit を同期的に、つまり Sync Mode で使う方法です。
一方、Transloadit を非同期的に利用する方法も用意しています。notify_url を指定し、waitForEncoding を
false に設定すると、Assembly のエンコードが完了した時点で、バックエンドに POST リクエストを送信します。この方法なら、サーバーがトランスコードの完了を待つ間も、ユーザーの操作を妨げません。Async Mode の設定方法と通知の署名の検証方法については、Webhook ガイドを参照してください。
同期モードでも非同期モードでも利用できる、もうひとつの便利な機能が Assembly Replay です。Assembly の実行中に問題が発生しても、ファイルのアップロードがすでに正常に完了していれば、Transloadit は 24 時間以内に Assembly を再実行できます。サーバーの不具合が原因の場合は自動的に再実行されますが、Transloadit のコンソールから手動で開始することもできます。
おわりに
以上、Transloadit の用語を駆け足で紹介しました。
この記事が疑問の解消に役立てば幸いです。Transloadit の機能についてサポートが必要な場合は、いつでもお気軽にお問い合わせください。
