Uppy とは?
Uppy は、Transloadit が開発・保守するオープンソースのファイルアップローダーです。モジュール式のブラウザーインターフェースで、ローカルファイル、カメラ、リモートソース、再開可能な転送、Transloadit の Assembly に対応します。
Uppy の仕組み
Uppy は、中央の状態マネージャーと、ソース、インターフェース、前処理、転送用のプラグイン群を中心に、ブラウザーでのアップロードを構成します。アプリケーションでは、組み合わせ済みの Dashboard を表示するか、同じファイル状態と進捗状態に基づく独自のインターフェースを構築できます。転送プラグインは、その状態を再開可能なエンドポイントやマネージド処理サービスに接続します。一方、リモートプロバイダーはサーバー側の Companion を使用します。Uppy は、バックエンドでの検証とメディア処理に先立つ、クライアント側の取り込み層を担います。
要点
- Uppy Core は、ファイル ID、制限、メタデータ、進捗、プラグインイベントを調整します。画面上の Dashboard を取り除いても、Core が保持するアップロード状態や転送動作は失われません。
- リモートソース用プラグインは、ユーザーのデバイスから直接選択したファイルとは異なり、Companion を介してプロバイダー API と通信するため、プロバイダーの認証情報をブラウザーに公開せずに済みます。
- tus と Transloadit の連携機能は、それぞれ異なる境界を担います。
@uppy/tusは、任意の tus エンドポイントに再開可能な形でバイト列を送信します。一方、@uppy/transloaditは Assembly を作成し、importFromUploadURLsが別のプラグインにアップロードを委ねる場合を除き、通常は内部で tus を使ってアップロードします。アップロードの完了は、処理の完了ではありません。Uppy が結果を待つのはwaitForEncodingを使用する場合のみです。それ以外の場合は、notify_urlまたは Assembly のステータス確認を使用してください。
Uppy が重要になる場面
ブラウザーで拡張可能なソース選択とアップロード状態の管理が必要なアプリケーションでは、Uppy を選択します。すべてのソースや再開可能なフローが同じ連携方式を使うわけではないため、プラグインとバックエンドの互換性を確認する必要があります。