M3U8 とは?
M3U8 は、マルチメディアプレイリスト形式 M3U の UTF-8 版で、HTTP Live Streaming のマニフェストに広く使用されています。テキストの各エントリーには、ビットレート別のバリアント、セグメント、鍵、日付範囲のメタデータを記述できます。
M3U8 の仕組み
M3U8 ドキュメントは、行単位で構成される UTF-8 テキストファイルです。各行は URI、空行、または # で始まる行のいずれかです。#EXT で始まる行はタグで、それ以外の # 行はコメントです。HLS では、マルチバリアントプレイリストがビットレート別のバリアントストリームと代替の音声・字幕などのレンディションを提示し、メディアプレイリストが一つのレンディションのメディアセグメントを列挙します。クライアントはネットワークの状態に応じてバリアントを切り替えます。また、後述のようにプレイリストが変更されないと宣言している場合を除き、メディアプレイリストを定期的に再読み込みします。パッケージャーは、メディアのエンコードとセグメント分割を終えてから、これらのプレイリストを書き出します。
要点
- すべての HLS プレイリストでは、最初の行を
#EXTM3Uにする必要があります。#EXT-X-VERSIONや#EXT-X-TARGETDURATIONなどのタグはプレイリスト全体に適用されますが、メディアセグメントタグは、その後に続く内容に適用されます。#EXTINFは各メディアセグメントに必須で、直後のセグメント URI にのみ適用されます。ほかの一部のタグは、同じタグが再び現れるまで、後続のすべてのセグメントに適用されます。したがって、タグや URI の行を移動、削除、挿入すると、結果が依然として有効なテキストであっても、意味が変わる場合があります。 - プレイリストは二種類のいずれかに属し、両方を兼ねることはありません。マルチバリアントプレイリストは、RFC 8216 ではマスタープレイリストと呼ばれ、バリアントストリームを記述してほかのプレイリストを参照します。メディアプレイリストは、一つのレンディションのセグメントを再生順に列挙します。RFC 8216 は、メディアセグメントタグとマスタープレイリストタグが混在するプレイリストについて、クライアントが解析に失敗することを要求しています。
- 相対 URI は、それを含むプレイリストの URI を基準に解決されるため、プレイリストを移動すると解決先が変わることがあります。参照先ファイルの相対的な配置を維持するか、URI を更新してください。標準の URI 解決では、独自のパスを持つ相対参照はベース URI のクエリ文字列を継承しません。そのため、プレイリスト URL のクエリに含まれるトークンや署名は、セグメント、鍵、子プレイリストへのリクエストには引き継がれません。署名付き URL を使う方式では、参照先の各 URI に署名するか、別の方法でこれらのリクエストを認可する必要があります。
- クライアントが受け入れるように、プレイリストの名前や配信方法を設定してください。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 レスポンスヘッダーも列挙しています。
出典
- RFC 8216:HTTP Live Streaming、第 4 節(プレイリスト)、第 4.1 節(プレイリストの定義)、第 4.3 節(プレイリストタグ)、第 6.2.1 節、第 6.3.1 節、第 6.3.2 節、第 6.3.4 節、第 10 節(セキュリティ上の考慮事項)
- IETF Internet-Draft:HTTP Live Streaming 第 2 版(draft-pantos-hls-rfc8216bis)、マスタープレイリストをマルチバリアントプレイリストに改称する策定中の草案
- RFC 3986:統一資源識別子(URI):汎用構文、第 5.2.2 節(参照の変換)
- FFmpeg フォーマットドキュメント:hls デマルチプレクサーのオプション(allowed_extensions、extension_picky)