メディア URL とは?
メディア URL は、ネットワークエンドポイントにある画像、動画、音声ファイル、マニフェスト、または生成された派生版を識別します。パスとクエリパラメーターで、ソースとなる素材、変換処理、配信ポリシーを選択する場合があります。
メディア URL の仕組み
メディア URL は、クライアントが元のファイル、派生版、セグメント、ストリーミングマニフェストを取得するためのアドレスです。各部分の意味はサーバーが決定します。通常、パスは素材を識別し、クエリパラメーターは変換設定や署名を伝えます。URL だけではレスポンスの形式は決まりません。HTTP の Content-Type ヘッダーがメディアタイプを示すため、パスのファイル拡張子がクライアントの受け取る内容を決めるわけではありません。ほかのレスポンスヘッダーは、キャッシュ、バイト範囲配信、クロスオリジンでの利用を制御します。ストリーミングマニフェストは、さらに別の URL を含むファイルなので、もう一段階の解決が必要です。HLS では、プレイリスト内の相対 URI は、その URI を含むプレイリストの URL を基準に解決されます。そのため、マニフェスト URL によって、プレーヤーがセグメントを探す場所が決まります。
要点
- クエリ文字列はキャッシュキーに含まれるのでしょうか。CDN とその設定によるため、変換パラメーターを入れる前に確認してください。HTTP では、キャッシュキーに少なくともリクエストメソッドと対象 URI を含めると定義しています。Cloudflare のデフォルトキーには、クエリ文字列を含む URL 全体が含まれます。Amazon CloudFront のデフォルトキーには、ディストリビューションのドメイン名と URL パスだけが含まれます。そのため、
?w=などのパラメーターだけが異なるふたつの URL は、キャッシュポリシーでそのパラメーターをキーに追加するまで、同じキャッシュ済みオブジェクトを返します。一方、レスポンスを変えないパラメーターを追加すると、別のコストが生じます。CloudFront は、オブジェクトが重複してキャッシュされ、キャッシュヒット率が低下する可能性があると警告しています。 - 動画や音声ファイルの URL には、バイト範囲をサポートするサーバーが必要でしょうか。iOS でシークするには必要です。アーカイブされた Apple の Safari ガイドでは、iOS 向けのメディアファイルをホストするサーバーは、バイト範囲リクエストをサポートする必要があるとしています。iOS は再生中のランダムアクセスにこれを使います。MDN は、より一般的に、範囲リクエストはランダムアクセス対応のメディアプレーヤーに有用だと説明しています。HTTP 自体では範囲リクエストへの対応は任意で、サーバーは
Rangeヘッダーを無視し、ファイル全体を 200 で返す場合があります。CDN が独自の条件を加えることもあります。CloudFront は、オリジンがTransfer-Encoding: chunkedで応答すると、要求された範囲ではなくオブジェクト全体を返します。オリジンだけでなく公開 URL にも範囲リクエストを送り、Content-Rangeヘッダーを伴う 206 レスポンスが返ることを確認してください。 - HLS マニフェストの URL に署名すると、セグメント URL はどうなるのでしょうか。マニフェストのクエリ文字列にある署名は、セグメント URL には引き継がれません。相対セグメント URI はプレイリスト URL を基準に解決されますが、標準の URI 参照解決では、基底 URL のクエリではなく、相対参照のクエリが保持されます。そのため、視聴者ごとにプレイリストを書き換えるか、別の方法でアクセスを許可しない限り、セグメントリクエストは署名なしで届きます。Amazon CloudFront のドキュメントでは、アクセス制限された複数のファイルへのアクセスを許可するには、署名付き URL ではなく署名付き Cookie を推奨しており、HLS 動画を構成するすべてのファイルを例に挙げています。
- URL が指すデータのバイト列は変わることがあるでしょうか。変わる場合、以前のレスポンスを保持するキャッシュは、その鮮度が保たれている間、以前のレスポンスを配信し続ける可能性があります。更新を速やかに反映する必要がある場合は、レスポンスの鮮度維持期間を短くするか、再検証を必須にしてください。バージョンごとに新しい URL で公開すれば、この問題を回避できます。RFC 8246 は、バージョン付き URL を、リソースの更新時期を予測せずに非常に長い鮮度維持期間を設定できるパターンとして説明しています。MDN も、バージョン番号やハッシュを含む URL には、長い
max-ageを推奨しています。
メディア URL が重要になる場面
クライアントがページ、プレーヤー、API レスポンスにアセットを埋め込む場合は、安定したメディア URL を返します。署名付き URL はアクセスを制限します。有効期限が設定されている場合、期限後のリクエストは拒否されるため、長期間使用する参照には適しません。また、クエリ文字列全体をキーに含むキャッシュでは、新しい署名が付くたびに別の URL として扱われます。
メディア URL に関する Transloadit の機能
Transloadit は、ふたつの方法でメディア URL を提供します。Assembly Status の各結果ファイルには、url と ssl_url が含まれます。/s3/store などのストレージ Robot で結果をエクスポートすると、Assembly Status はバケット内のファイルの URL を返します。この URL は保存されたオブジェクトの場所を示しますが、非公開オブジェクトを公開したり、読み取りアクセスを許可したりはしません。そのため、視聴者にオブジェクトの読み取りが許可されている場所でのみ公開してください。それ以外の場合は、そのオブジェクトへのアクセスが認可されたストレージまたは CDN の URL を公開してください。Transloadit の一時ストレージ上の URL は自動的に削除され、エンドユーザーへの配信用ではないと明記されています。Smart CDN の URL は https://[your-workspace].tlcdn.com/[template-name]/[file-path]?[parameters] という形式です。Template 名とファイルパスでワークフローと元のファイルを選択し、クエリパラメーターは変換設定として Template に渡されます。exp の有効期限と sig の署名を使って署名できます。署名付きレスポンスの実効キャッシュ有効期間は、署名の残りの有効期間を超えません。
Smart CDN のレスポンスについて、Robot /file/serve のドキュメントに記載されたデフォルトヘッダーには、Accept-Ranges: bytes と、ファイルから検出された MIME タイプに基づく Content-Type が含まれます。
出典
- RFC 9110:HTTP の意味論(Content-Type、8.3 節、範囲リクエスト、14 節)
- RFC 9111:HTTP キャッシュ(キャッシュキー、2 節)
- Cloudflare:キャッシュキーとデフォルトのキャッシュキー
- Amazon CloudFront:キャッシュキーの仕組み
- Amazon CloudFront:部分リクエスト(範囲 GET)の処理方法
- Apple Safari Web Content Guide(アーカイブ):バイト範囲リクエストに対応するサーバー設定
- MDN:HTTP 範囲リクエスト
- RFC 8216:HTTP Live Streaming(プレイリスト内の相対 URI、4.1 節)
- RFC 3986:URI の汎用構文(参照解決、5.2.2 節)
- Amazon CloudFront:署名付き URL と署名付き Cookie の選択
- RFC 8246:不変の HTTP レスポンス(バージョン付き URL)
- MDN:HTTP キャッシュ(バージョン付き URL によるキャッシュバスティング)