処理結果ファイルの保存
Assembly Status JSON の例
はじめてのアプリで画像をリサイズすると、crop_thumbed Step が 1500x500 画像を生成します。次の Assembly Status JSON の抜粋は、その結果の識別と保存に必要なフィールドを示した例です。ほかのステータスフィールドは省略しています。実際のレスポンスでは、ID や URL は例と異なります。
{
"assembly_id": "7828446e5acd4aa996dce3455ec914e9",
"ok": "ASSEMBLY_COMPLETED",
"uploads": [
{
"id": "a30bd0776e7f4ac3817b056d102e8219",
"name": "joe-gardner-149699.jpg",
"ssl_url": "https://temporary-files.example/upload.jpg"
}
],
"results": {
"crop_thumbed": [
{
"id": "b8d12f6c517541ca86bf50c537cedb27",
"original_id": "a30bd0776e7f4ac3817b056d102e8219",
"name": "joe-gardner-149699.jpg",
"ssl_url": "https://temporary-files.example/resized.jpg",
"meta": {
"width": 1500,
"height": 500
}
}
]
}
}
このように、Transloadit は次のファイルの最終的な保存先とメタデータを提供します。
- アップロードされたすべてのファイル:
uploadsキー内 - 生成されたすべての処理結果ファイル:
resultsキー内
各ファイルオブジェクトには、メタデータと、結果を指す ssl_url が含まれます。エクスポート用 Robot を使用した場合、これらの保存先は S3 バケットなどの指定したストレージになります。それ以外の場合は一時 URL となり、24 時間後に削除されます。
一時 URL は、自分のストレージにファイルを一度ダウンロードするためだけに使用してください。エンドユーザーと共有したり、本番環境で使用したりしないでください。重要な利用制限については、一時ストレージの制限事項を参照してください。
組み込み方に応じて、次のいずれかの方法を選べます。
- リクエストの発行元で、ローカルに結果を処理する
- 結果をフォームに追加してバックエンドに送信する
- (Async Mode の場合)Transloadit から
Assembly Status JSON を
notify_urlに送信し、それを使ってデータベースにエントリを保存する
設定と署名検証については、Webhooks API ドキュメントを参照してください。アプリでペイロードを使用する前に、各 Notification を検証してください。
エンドユーザーへの処理結果ファイルの表示
ファイルを永続ストレージに保存し、アプリで役立つメタデータをデータベースに保存したら、ユーザーにファイルを配信できます。切り抜いた画像を表示するには、以下のプレースホルダー URL を、自分のストレージ内の URL に置き換えてください。
<img
alt="Resized uploaded image"
src="https://your-storage.example/resized.jpg"
/>
動画を扱う場合は、HLS.js、Plyr、indigo-player などのプレーヤーを検討できます。これらは HTTP ライブストリーミングと MPEG-DASH にも対応しています。
ファイル処理結果の保存時に順序に依存しないこと
エンコードが完了し、Transloadit が結果の URL または Assembly Notification URL に POST する際、結果が期待どおりの順序で並んでいるとは限りません。結果の順序に依存しないでください。
たとえば、🤖/image/resize を使う
Step が
Template 内に 2 つあり、どちらも use で :original ステップを参照しているとします。設定は次のようになります。
{
"steps": {
"high": {
"use": ":original",
"robot": "/image/resize",
"width": 500,
"height": 500
},
"low": {
"use": ":original",
"robot": "/image/resize",
"width": 200,
"height": 200
}
}
}
この Template で写真を 30 枚アップロードすると、生成される Assembly JSON には、"results" -> "high" と "results" -> "low" という
2 つの結果配列が含まれます。ただし、配列内の画像の順序は同じではありません。"high" の最初の結果が、15 番目にアップロードした写真から生成されたものである一方、"low" 配列の最初の結果は、10 番目にアップロードした写真から生成されたものかもしれません。
エンコード結果を元のアップロードに対応付ける必要がある場合(おそらく必要になるはずです)は、id プロパティ("uploads" 配列の各エントリ内)と、各結果配列のエントリにある original_id プロパティを照合してください。
アップロードされた元ファイルの保存
エンコード後の処理結果ファイルだけでなく、ユーザーがアップロードした元ファイルも保存しておくと、要件の変更に合わせて、後から別の形式に再エンコードできます。保存しなければ、元ファイルは永久に失われます。ユーザーに再アップロードを依頼するのは、現実的でない場合が多いためです。
メタデータの保存
上記に加え、Assembly は一時的なものである点にも注意してください。Transloadit は 90 日後にレコードを削除します。含まれるメタデータを保持したい場合は、自分のデータストアにインポートしてください。