M3U8 とは?

M3U8 は、マルチメディアプレイリスト形式 M3U の UTF-8 版で、HTTP Live Streaming のマニフェストに広く使用されています。テキストの各エントリーには、ビットレート別のバリアント、セグメント、鍵、日付範囲のメタデータを記述できます。

マルチバリアントプレイリスト:バリアントストリームとレンディション
URI で取得するメディアセグメントと鍵
HLS クライアントは、マルチバリアントプレイリスト内の URI をたどり、 映像と別音声など、再生用に選択した各レンディションのメディアプレイリストを取得してから、 それぞれのメディアセグメントを取得します。

M3U8 の仕組み

M3U8 ドキュメントは、行単位で構成される UTF-8 テキストファイルです。各行は URI、空行、または # で始まる行のいずれかです。#EXT で始まる行はタグで、それ以外の # 行はコメントです。HLS では、マルチバリアントプレイリストがビットレート別のバリアントストリームと代替の音声・字幕などのレンディションを提示し、メディアプレイリストが一つのレンディションのメディアセグメントを列挙します。クライアントはネットワークの状態に応じてバリアントを切り替えます。また、後述のようにプレイリストが変更されないと宣言している場合を除き、メディアプレイリストを定期的に再読み込みします。パッケージャーは、メディアのエンコードとセグメント分割を終えてから、これらのプレイリストを書き出します。

要点

  1. すべての HLS プレイリストでは、最初の行を #EXTM3U にする必要があります。#EXT-X-VERSION や #EXT-X-TARGETDURATION などのタグはプレイリスト全体に適用されますが、メディアセグメントタグは、その後に続く内容に適用されます。#EXTINF は各メディアセグメントに必須で、直後のセグメント URI にのみ適用されます。ほかの一部のタグは、同じタグが再び現れるまで、後続のすべてのセグメントに適用されます。したがって、タグや URI の行を移動、削除、挿入すると、結果が依然として有効なテキストであっても、意味が変わる場合があります。
  2. プレイリストは二種類のいずれかに属し、両方を兼ねることはありません。マルチバリアントプレイリストは、RFC 8216 ではマスタープレイリストと呼ばれ、バリアントストリームを記述してほかのプレイリストを参照します。メディアプレイリストは、一つのレンディションのセグメントを再生順に列挙します。RFC 8216 は、メディアセグメントタグとマスタープレイリストタグが混在するプレイリストについて、クライアントが解析に失敗することを要求しています。
  3. 相対 URI は、それを含むプレイリストの URI を基準に解決されるため、プレイリストを移動すると解決先が変わることがあります。参照先ファイルの相対的な配置を維持するか、URI を更新してください。標準の URI 解決では、独自のパスを持つ相対参照はベース URI のクエリ文字列を継承しません。そのため、プレイリスト URL のクエリに含まれるトークンや署名は、セグメント、鍵、子プレイリストへのリクエストには引き継がれません。署名付き URL を使う方式では、参照先の各 URI に署名するか、別の方法でこれらのリクエストを認可する必要があります。
  4. クライアントが受け入れるように、プレイリストの名前や配信方法を設定してください。RFC 8216 は、HLS プレイリストを、末尾が .m3u8 または .m3u の URI パス、あるいは HTTP Content-Type の application/vnd.apple.mpegurl または audio/mpegurl で識別できることを要求しています。どちらでも識別できないプレイリストは、クライアントが拒否すべきとしています。テキストはバイトオーダーマークなしの UTF-8 でなければなりません。バイトオーダーマークがある場合、クライアントはプレイリストの解析に失敗すべきとしています。

M3U8 が重要になる場面

HLS の生成、ホスティング、取り込みでは、いずれも M3U8 が重要です。生成側は、プレイリストが有効になるように、タグの順序、時間、URI を正しく設定する必要があります。ホスト側は、プレイリストの配信元がどこであっても、含まれるすべての URI にアクセスできる状態を維持する必要があります。信頼できないソースのプレイリストは、取得指示の一覧として扱ってください。RFC 8216 は、クライアントが URI の指す任意の宛先にネットワークリクエストを送信すると指摘しています。FFmpeg の HLS デマルチプレクサーは、デフォルトでプレイリストが参照できるファイル拡張子を制限します。

M3U8 の扱い方

RFC 8216 は、メディアプレイリストが #EXT-X-PLAYLIST-TYPE:VOD、または #EXT-X-PLAYLIST-TYPE:EVENT と #EXT-X-ENDLIST の組み合わせを宣言していない限り、クライアントが定期的に再読み込みすることを要求しています。メディアプレイリストに #EXT-X-ENDLIST がない間は、サーバーは前のバージョンの公開からターゲット時間の 0.5 倍から 1.5 倍の間に、少なくとも一つの新しいセグメントを含む新バージョンを公開する必要があります。最後のセグメントを列挙したら #EXT-X-ENDLIST を追加し、プレイリストが変更されないことを宣言するには #EXT-X-PLAYLIST-TYPE:VOD を使ってください。追記されるプレイリストは同じ URL で内容が変わる一方、セグメントは変わりません。この性質を踏まえてキャッシュを設計します。

Transloadit による M3U8 処理の支援

Transloadit の Robot /video/adaptive は、technique が hls の場合、メディアセグメントとともに M3U8 プレイリストファイルを生成します。cmaf の場合は、MPEG-DASH マニフェストとともに HLS プレイリストを生成します。

この Robot のドキュメントでは、結果ファイルに relative_path メタデータプロパティがあり、プレイリストファイルが引き続き機能するように、このプロパティから保存先パスを構築すべきと説明しています。これは、前述の相対 URI のルールを実践したものです。また、別オリジンからプレイリストとセグメントを取得するブラウザープレーヤー向けに、設定すべき CORS レスポンスヘッダーも列挙しています。

Transloadit のファイル形式・圧縮機能を見る

出典

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

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

Transloadit を無料で試す