アセットライブラリとは何ですか?

アセットライブラリは、メディアファイルと、それに関連するメタデータ、バージョン、権限、関連情報を一元管理する、検索可能なコレクションです。管理ルールに沿った保存、検索、再利用を支援します。

アセットライブラリの仕組み

アセットライブラリは、バイナリデータのストレージと、所有者、権利、レンディション、バージョン、関連性を記述したインデックス付きレコードを組み合わせたものです。検索やフィルタリングはこれらのレコードを対象に実行され、一部のリポジトリではドキュメントの全文も対象になります。一方、アクセス制御によって各項目を閲覧・変更できるユーザーを決めます。パスでファイルを参照する単純な共有フォルダーとは異なり、ライブラリでは、論理的に単一のアセットを一連のバージョンとして扱い、プレビューなどの代替レンディションを持たせられます。公開ワークフローでは、承認済みメディアを選択して配信するための、管理ルールに従った供給元となります。

要点

  1. アプリケーション側のレコードには、パスや表示名ではなく、ライブラリの不変のアセット ID を保存し、その ID が何を識別するかを確認してください。CMIS リポジトリ標準では、各バージョンは固有のオブジェクト ID を持つ別個のオブジェクトです。バージョン間で変わらないのはバージョンシリーズ ID だけなので、参照は最新バージョンに追従するか、特定のバージョンに固定する必要があります。
  2. 不変の ID があるだけでは、配信 URL が変わらないとは限りません。たとえば Cloudinary は不変のアセット ID を割り当てますが、この ID はアセットの配信には使えません。配信 URL に含まれるのは公開 ID であり、アセットの名前を変更すると公開 ID も変わります。URL を公開する前に、どの識別子が含まれているか、名前の変更や移動が URL にどう影響するかを確認してください。
  3. ファイル全体から計算した SHA-256 などの暗号学的チェックサムが一致すれば、ファイル名に関係なく、バイト単位で同一のファイルを非常に高い確率で識別できます。リサイズや再エンコードしたコピーはバイト列が異なるため、チェックサムでは検出できません。その検出には知覚ハッシュなどの類似性比較が必要です。類似ファイルからは同一ではなく近い値が得られるため、どの程度近ければ重複とみなすかを決めます。ライブラリが自動で確認してくれると考えたり、ストレージの ETag をチェックサムの代わりに使えると考えたりしないでください。Adobe Experience Manager 6.5 では、SHA-1 による重複検出は初期状態で無効です。また、マルチパートアップロードや、SSE-C または SSE-KMS で暗号化したオブジェクトの Amazon S3 ETag は、MD5 ダイジェストではありません。
  4. 権利メタデータは制限を記録するものであり、制限を強制するものではありません。IPTC Photo Metadata Standard では、Rights Usage Terms は自由記述テキストで、公開解禁前の制限も自由記述の Instructions フィールドに記載されます。そのため、どちらもソフトウェアで比較できる日付ではありません。配信時に公開解禁日時やライセンスの有効期限を守る必要がある場合は、ライブラリのアセットレコードかアプリケーション側のデータベースに、構造化した日付や状態として保持し、公開時に確認してください。ファイルを見つけられることは、公開の許可を意味しません。公開時の確認だけでは、その後に到来する有効期限には対応できません。アセットの配信を継続する権利が特定の日付で失効する場合は、その時点で配信も停止するようにしてください。たとえば、予定した日時に公開を取り消すか、リクエストごとに日付を確認します。

アセットライブラリが重要になる場面

チームが重複を作成せずに承認済みメディアを見つけて再利用する必要がある場合、アプリケーションではアセットライブラリを使用します。権限管理とバージョン管理は、古くなったファイルや利用制限のあるファイルの公開を防ぐのに役立ちます。

Transloadit によるアセットライブラリの支援

現在ベータ版の Transloadit Storage は、アセットライブラリの保存、識別、バージョン管理を担います。Robot の /transloadit/store は Assembly のファイルを非公開で保存し、asset_id、version_id、最終パスを返します。続いて Robot の /transloadit/import が、path(変更可能な現在の保存場所)、asset_id(名前の変更や移動後も現在のバージョン)、または asset_id と version_id の組み合わせ(保存された特定のバイト列)でファイルを選択します。Robot の /file/hash は Assembly の実行中にチェックサムを計算し、file.meta.hash として公開します。アプリケーション側では、これらのハッシュを比較して重複を検出し、Transloadit が返す情報を基にカタログ、検索、権限管理を構築します。

Robot のドキュメントで推奨されているとおり、保存結果の Workspace、asset_id、version_id、返されたパスをアプリケーション側のレコードとともに保存してください。インポートでは Workspace のストレージから読み取り、ID にも Workspace のアクセス権限とバージョン保持の制約が適用されます。既存ファイルがあるパスへの保存は、デフォルトでは失敗します。競合時の処理方針に overwrite を指定すると、代わりに既存アセットの新しいバージョンを作成します。固定した version_id が現在のバージョンにフォールバックすることはありません。アセットを削除したり、保持されているそのバージョンを削除したりすると、その参照は利用できなくなります。

Transloadit のメディア管理機能を見る

出典

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

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

Transloadit を無料で試す