Async Mode とは?

Async Mode では、クライアントのリクエストまたはアップロードが完了した後、Transloadit が Assembly を別途処理する間も、クライアントは処理を続行できます。Assembly に notify_url が指定されている場合は、後で Assembly Notification によって結果がクライアントのバックエンドに配信されます。

Async Mode の仕組み

Async Mode が変えるのは処理グラフではなく、リクエストのライフサイクルです。送信が完了するとクライアントは解放されますが、Assembly はサービスのインフラストラクチャ上で継続します。最終データは、ジョブ全体にわたって接続を維持する対話的なレスポンスではなく、設定した notify_url に送られる通知を通じて届きます。これにより、負荷の高いメディア処理でクライアントやプロキシのタイムアウトを回避します。通知を受信できないアプリケーションは、終了状態になるまで Assembly Status URL をポーリングできます。アプリケーション側で対応関係を永続的に保持し、ジョブの保留中、成功、失敗を示す独自の表示を提供する必要があります。

要点

  1. 最初のレスポンスは処理の引き渡しを確認するものであり、メディア出力の成功を確認するものではありません。そのため、ユーザー向けシステムには、送信の受理から最終的な完了までの間に、別の状態が必要です。
  2. Assembly Notification は、Assembly に notify_url が指定されている場合にのみ送信されます。受信には到達可能なサーバーエンドポイントが必要です。ブラウザーのタブやモバイルプロセスは信頼できる受信先ではありません。サーバーエンドポイントのないクライアントは、Assembly Status URL をポーリングして完了を確認してください。
  3. 再試行やアプリケーションイベントの順序の乱れは、分散システムで通常想定すべき問題です。そのため、受信側は Assembly の識別情報をキーにして更新し、古い状態への遷移を拒否する必要があります。

Async Mode が重要になる場面

処理が対話的なリクエストの時間を超える可能性がある場合や、クライアントをブロックすべきでない場合は、Async Mode を選び、結果がバックエンドに届くように notify_url を設定してください。受信エンドポイントは通知を認証し、再試行や重複配信を安全に処理する必要があります。サーバーエンドポイントのない連携では、代わりに Assembly Status をポーリングできます。

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

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

Transloadit を無料で試す