Robot Parameter とは?

Robot Parameter は、画像リサイズ用 Step の width のように、Transloadit の Robot の動作を設定します。Assembly Instructions では、use などの共通の Step パラメータも使用して、Step をそのワークフローの入力に接続します。

Robot Parameter の仕組み

Robot Parameter は、Assembly Step の処理設定のうち、操作に固有の部分を構成します。寸法、形式、コーデック、メタデータの扱い、出力先の設定などの動作を選択します。使用できるキーと値の型は選択した Robot によって定義されますが、use などの共通キーは入力の選択を記述し、すべての Robot で共有されます。パラメーターは Assembly の実行時に解決され、再現可能な処理設定の一部となります。

要点

  1. 同じパラメーター名が複数の Robot で使われていても、受け付ける値、デフォルト値、単位が同じとは限りません。検証には、対象の Robot のドキュメントを使用する必要があります。
  2. パラメーターを省略すると、Robot が定義したデフォルト値が適用されることがあります。これは、空文字列、ゼロ、false、その他の明示的な値を送信する場合とは、観測できる動作が異なります。
  3. Template に基づく Assembly ではパラメーターセットを一元管理でき、リクエスト時のフィールドを使えば、ワークフローグラフ全体を複製せずに、制御された範囲で変更を加えられます。

Robot Parameter が重要になる場面

Robot 固有のパラメーターで処理ステップの出力を制御し、共通のステップパラメーターでワークフロー内の接続方法を制御します。ある Robot で有効なパラメーターでも、別の Robot ではサポートされていなかったり、意味が異なったりする場合があります。

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す