M3U8動画は、右クリックして[名前を付けて保存]するだけでは取得できません。MP4とは異なり、M3U8は数十〜数百の小さなメディアセグメントを参照するテキスト形式のプレイリストです。セグメントは通常、.ts(MPEG-2 Transport Stream)またはfMP4の.m4sです。動画を保存するにはプレイリストを解析し、各セグメントを順に取得して、音ずれやフレーム欠落を起こさずに結合します。
このガイドでは、ブラウザーのツールとFFmpegによるM3U8動画のダウンロード・結合方法を説明します。マスター/メディアプレイリストの違い、暗号化やCORSで生じる問題も取り上げます。
M3U8の構造を理解する
ツールを使う前に、取得対象の構造を確認しましょう。M3U8の内容をテキストエディターで開くと、一連のHLSタグが見えます。通常、プレイリストには次の2種類があります。
- マスタープレイリスト:1080p、720p、480pなどの画質や音声トラックを列挙します。ダウンローダーはこれを解析して対象の画質を選びます。
- メディアプレイリスト:
segment_001.tsやsegment_002.tsなど、実際のセグメントURLを列挙します。この一覧に沿ってデータを取得します。
マスタープレイリストの見分け方
#EXT-X-STREAM-INFがあればマスタープレイリストです。タグの次の行にあるURLをたどり、実際のメディアセグメントを探します。
セグメントの長さ
#EXTINF:4.000,などのタグは各断片の長さを示し、総再生時間や結合の進捗の推定に使えます。
ブラウザーのオンラインダウンローダーを使う
fetch()、File System Access API、メモリ上のBlobなどを使えば、ブラウザー内でM3U8の取得と結合ができます。コマンドラインツールをインストールしたくない場合に便利です。
[ツール]メニューのM3U8無料プレーヤーのオンラインダウンローダーは、この処理を自動化します。ブラウザー内では次の順に動きます。
- 解析:JavaScriptがM3U8のURLを取得します。マスタープレイリストなら、最も帯域幅の大きい
#EXT-X-STREAM-INFのURLを選びます。 - 取得:並列または順次のHTTPリクエストで
.tsセグメントをダウンロードします。 - 結合:動画のバイナリーデータをメモリ上の配列バッファーで連結します。
- 書き出し:結合したバッファーから
Blobを作り、1つの.tsまたは.mp4ファイルとしてダウンロードします。
注意:ブラウザーのダウンローダーはCORS(オリジン間リソース共有)の制約を受けます。セグメントの配信サーバーがAccess-Control-Allow-Origin: *ヘッダーを返さない場合、ブラウザーは取得をブロックします。
定番の方法:FFmpeg
開発者や運用担当者にとって、FFmpegはHTTP Live Streaming(HLS)を処理する定番ツールです。1つのコマンドでプレイリストの解析、セグメントの取得・結合、コンテナの再多重化を行えます。
基本的なダウンロード・結合コマンド
再エンコードせずにM3U8を取得してMP4へ再多重化するには、-c copyを使います。元の画質を保てて、処理も速くなります。
ffmpeg -i "https://example.com/stream/master.m3u8" -c copy -bsf:a aac_adtstoasc output.mp4
このコマンドの各指定は次のとおりです。
-i: 入力URLを指定します。FFmpegはマスター/メディアプレイリストを自動解析します。-c copy: 映像と音声をデコード・エンコードせず、そのままコピーします。-bsf:a aac_adtstoasc: MPEG-TS内のAAC音声をMP4に再多重化する際に使うビットストリームフィルターです。
特定の画質を選ぶ
マスタープレイリストを渡すと、FFmpegは通常、解像度またはビットレートの最も高いストリームを選びます。利用可能なストリームを調べて指定したい場合は-mapを使います。
# First, probe the stream to see available mappings
ffprobe -i "https://example.com/stream/master.m3u8"
# Assuming the 720p video is stream 0:2 and audio is 0:3
ffmpeg -i "https://example.com/stream/master.m3u8" -map 0:2 -map 0:3 -c copy output.mp4
暗号化されたHLSを扱う
商用のM3U8配信にはAES-128で暗号化されたものがあります。M3U8内に#EXT-X-KEY:METHOD=AES-128,URI="https://example.com/key.bin"のようなタグがあれば、セグメントは暗号化されています。
標準のAES-128
URIの鍵ファイルに特別な認証ヘッダーなしでアクセスできるなら、FFmpegは鍵を自動取得してメモリ上で復号し、MP4を書き出します。追加のコマンドは不要です。
トークン付きの鍵
鍵のURLにセッションCookie、Bearerトークン、特定のUser-Agentが必要なら、FFmpegは403 Forbiddenエラーになることがあります。
鍵のリクエストに必要なHTTPヘッダーをFFmpegへ渡すには、-headersを使います。
ffmpeg -headers "Authorization: Bearer YOUR_TOKEN
User-Agent: Mozilla/5.0
" -i "https://example.com/encrypted.m3u8" -c copy decrypted_output.mp4
注意:Widevine、PlayReady、FairPlayなどのDRM(METHOD=SAMPLE-AESとKEYFORMATタグで示されることがあります)は、FFmpegではダウンロード・復号できません。
ダウンロード失敗を調べる
HLSの取得はネットワークの中断やサーバー設定の影響を受けます。主な問題と対処法は次のとおりです。
1. 403 Forbiddenエラー
サーバーが特定のブラウザーや有効な参照元を要求することがあります。アクセスが許可されている場合は、FFmpegの-user_agentと-headersで再生時に必要なHTTPヘッダーを指定できます。
2. 途切れた・未完了のライブ配信
ライブ配信のM3U8は継続的に更新されます。FFmpegは#EXT-X-ENDLISTが現れるまで取得を続けます。1時間だけ録画したい場合は、コマンドに-t 3600を追加します。
3. 映像と音声の同期ずれ
#EXT-X-DISCONTINUITYで示されるタイムスタンプの不連続があると、結合後のMP4で口の動きと音声がずれる場合があります。再多重化時に-async 1や-f mp4 -movflags +faststartを指定すると、PTS(表示時刻)の調整に役立つ場合があります。
まとめ
社内配信の保存、VODのバックアップ、配信処理の構築のいずれでも、M3U8を正しく取得するにはプレイリストを解析し、TSセグメントを安全に結合する必要があります。認証不要でCORSが許可された配信にはブラウザーのツールが便利です。認証や暗号化を含む複雑なHLSにはFFmpegを利用できます。