FFmpegで動画をHLSに分けて配信する方法
FFmpeg の -f hls を使うと、1本の MP4 を数秒ずつの小さな動画ファイル(.ts)と、その並びを書いたプレイリスト(.m3u8)に分けられます。Webサイトで動画をストリーミング配信したいときの方法の1つです。検証では、画質を2段階にして配信すると、ブラウザ(hls.js)は .ts を1本ずつ順に読み、回線の速さに合わせて画質を切り替えました。
-c copy で分けると、分かれ目はキーフレームの位置で決まりました。-hls_list_size を初期設定のままにすると、プレイリストには最後の5本しか残りませんでした。画質を2段階にしたときは、マスタープレイリストの並び順で、再生が始まるまでの時間が変わりました。
検証環境は Ubuntu 24.04.5、FFmpeg 6.1.1(Ubuntu のパッケージ 6.1.1-3ubuntu5)、Node.js 22.23.4、Playwright 1.63.0 に付属の Chromium(153.0.8010.12)、hls.js 1.6.15、CPU 4コアの仮想マシンです。動画は FFmpeg のテスト用の映像と音から作った30秒の動画(1280×720 30fps の H.264 約2Mbps、AAC 128kbps)です。配信は、同じ仮想マシンの中で動かした Node.js の検証用サーバーで、回線の遅さはサーバーが送る速さを絞って再現しました。Chromium 以外のブラウザ(Safari、Firefox、スマホのブラウザなど)、CDN を使った配信、ライブ配信、暗号化(AES-128)、fMP4 の分割は試していません。
まずは1つの画質で HLS に分ける
いちばん簡単なのは、映像と音声をエンコードし直さずに -c copy で分ける書き方です。書き出し先のフォルダは先に作っておきます。
mkdir out1
ffmpeg -i src.mp4 -c copy -f hls -hls_time 6 -hls_playlist_type vod \
-hls_segment_filename "out1/seg_%03d.ts" out1/index.m3u8
それぞれの指定の意味は次のとおりです。説明は FFmpeg の公式ドキュメントにある hls muxer の節によります。
| 指定 | 意味 |
|---|---|
-f hls |
HLS の形で書き出す |
-hls_time 6 |
1本の .ts の長さの目安(秒)。初期設定は2秒 |
-hls_playlist_type vod |
あとから変わらない動画として書き出す。プレイリストに全部の .ts が載る |
-hls_segment_filename |
.ts のファイル名。%03d に 000 から始まる番号が入る |
検証では、out1 フォルダに index.m3u8 と .ts が4本できました。ところが、中身を見ると1本の長さが6秒ではありません。
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-PLAYLIST-TYPE:VOD
#EXTINF:8.333333,
seg_000.ts
#EXTINF:8.333333,
seg_001.ts
#EXTINF:8.333333,
seg_002.ts
#EXTINF:5.000000,
seg_003.ts
#EXT-X-ENDLIST
#EXTINF が1本ずつの長さです。6秒を指定したのに、8.333333 秒ずつになりました。
.ts の長さはキーフレームの間隔で決まる
元の MP4 のキーフレームの位置を、ffprobe で調べました。
ffprobe -v error -select_streams v -skip_frame nokey \
-show_entries frame=pts_time -of csv=p=0 src.mp4
0.000000,
8.333333
16.666667
25.000000
キーフレームは 8.33 秒ごと(30fps で250フレームごと)にしかありませんでした。ドキュメントには、hls_time の時間が過ぎたあとの次のキーフレームで分ける、と書かれています。-c copy ではキーフレームの位置を変えられないので、6秒を過ぎた次のキーフレームである 8.33 秒で分かれたわけです。
6秒ちょうどで分けたいときは、エンコードし直して、キーフレームを決まった間隔で入れます。次の例では、30fps の動画に60フレーム(2秒)ごとにキーフレームを入れています。-g と -keyint_min はキーフレームの間隔(GOP の長さ)の最大と最小、-sc_threshold は場面の切り替わりを見つけるしきい値です(FFmpeg の libx264 の説明では、それぞれ x264 の keyint、min-keyint、scenecut に当たります)。
mkdir out2
ffmpeg -i src.mp4 -c:v libx264 -preset veryfast -b:v 2M \
-g 60 -keyint_min 60 -sc_threshold 0 -c:a aac -b:a 128k \
-f hls -hls_time 6 -hls_playlist_type vod \
-hls_segment_filename "out2/seg_%03d.ts" out2/index.m3u8
今度は、5本とも #EXTINF:6.000000 になりました。分けた .ts のキーフレームを ffprobe で調べると、ちょうど2秒おきに並んでいました。hls_time(6秒)をキーフレームの間隔(2秒)の倍数にしたので、分かれ目がそろいました。
-hls_playlist_type を付けないと、最後の5本しか載らなかった
-hls_playlist_type vod を付けずに、-hls_time 2 で30秒の動画を分けてみました。
mkdir out4
ffmpeg -i src.mp4 -c:v libx264 -preset veryfast -b:v 2M \
-g 60 -keyint_min 60 -sc_threshold 0 -c:a aac -b:a 128k \
-f hls -hls_time 2 -hls_segment_filename "out4/seg_%03d.ts" out4/index.m3u8
.ts は15本できましたが、プレイリストに載ったのは最後の5本だけでした。
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:2
#EXT-X-MEDIA-SEQUENCE:10
#EXTINF:2.000000,
seg_010.ts
(中略)
#EXTINF:2.000000,
seg_014.ts
#EXT-X-ENDLIST
ドキュメントによると、プレイリストに載せる数の上限 hls_list_size の初期設定は5です。このプレイリストには、動画の最初の20秒ぶんの .ts が載っていません。
録画済みの動画を配るときは、-hls_playlist_type vod か -hls_list_size 0 を付けます。ドキュメントには、vod を指定すると hls_list_size が0(すべて載せる)になると書かれています。-hls_list_size 0 を付けて分け直すと、15本すべてがプレイリストに載りました。
画質を2段階にして、マスタープレイリストを作る
回線の速さに合わせて画質を切り替えられるようにするには、画質ごとにプレイリストを作り、それをまとめるマスタープレイリストを置きます。

FFmpeg では、1回の実行で次のように作れます。
mkdir out6
ffmpeg -i src.mp4 \
-filter_complex "[0:v]split=2[v1][v2];[v2]scale=640:360[v2s]" \
-map "[v1]" -map "[v2s]" -map 0:a -map 0:a \
-c:v libx264 -preset veryfast -g 60 -keyint_min 60 -sc_threshold 0 \
-b:v:0 2500k -maxrate:v:0 2500k -bufsize:v:0 5000k \
-b:v:1 800k -maxrate:v:1 800k -bufsize:v:1 1600k \
-c:a aac -b:a 128k \
-f hls -hls_time 6 -hls_playlist_type vod \
-var_stream_map "v:0,a:0,name:720p v:1,a:1,name:360p" \
-master_pl_name master.m3u8 \
-hls_segment_filename "out6/%v/seg_%03d.ts" out6/%v/index.m3u8
split で映像を2つに分け、片方を 640×360 に縮めています。-var_stream_map は、どの映像とどの音声を組にして1つの画質にするかの指定です。空白で区切った1組が1つの画質になり、name: で付けた名前が %v に入ります。ドキュメントにあるとおり、%v をフォルダ名に入れると、画質ごとのフォルダが作られました。
できた master.m3u8 は次のとおりです。
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:BANDWIDTH=2890800,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1020800,RESOLUTION=640x360,CODECS="avc1.64001e,mp4a.40.2"
360p/index.m3u8
BANDWIDTH は、指定した映像と音声のビットレートの合計の 1.1 倍でした(720p なら (2,500k + 128k) × 1.1 = 2,890,800)。30秒分の .ts の合計は、720p が 10,430,428 バイト、360p が 3,757,368 バイトでした。
ブラウザで再生する
プレイリストと .ts をWebサーバーに置き、hls.js で再生しました。hls.js の README にあるとおり、hls.js はブラウザの MediaSource Extensions を使って再生するライブラリです。hls.min.js は、npm i hls.js@1.6.15 で入れたものをページと同じフォルダに置きました。ページは次のとおりです(測定のための記録のコードは省いています)。
<video id="v" muted playsinline controls></video>
<script src="hls.min.js"></script>
<script>
const v = document.getElementById('v');
const hls = new Hls();
hls.loadSource('master.m3u8');
hls.attachMedia(v);
</script>
検証用のサーバーは、.m3u8 を application/vnd.apple.mpegurl、.ts を video/mp2t の Content-Type で返すようにしました。再生は、ページを読み込んだあとに v.play() を呼んで始めました。送る速さを絞らないときは、720p の .ts を順に読み、ページを開いてから 0.26 秒で再生が始まりました。
検証した Chromium 153 では、<video> の canPlayType('application/vnd.apple.mpegurl') が "maybe" を返し、hls.js を使わずに <video src="master.m3u8"> としても再生できました。
回線が遅いと、マスタープレイリストの並び順で再生が始まるまでの時間が変わった
サーバーが .ts を送る速さを毎秒 160,000 バイト(1.28Mbps)に絞り、hls.js で再生しました。720p の BANDWIDTH(約2.9Mbps)には足りず、360p(約1.0Mbps)なら間に合う速さです。
上の master.m3u8 のように 720p が先に書かれていると、hls.js は最初に 720p の1本目(2,168,956 バイト)を読みにいきました。これを受け取るまでに時間がかかり、再生が始まったのはページを開いてから 13.82 秒後でした。そのあと 360p に切り替わりましたが、動画の 5.92 秒の位置で読み込みが追いつかずに止まり、再び動くまで 3.5 秒かかりました。
hls.js の API ドキュメントには、startLevel を指定しないときは、マニフェスト(マスタープレイリスト)の最初に書かれた画質から始めると書かれています。そこで -var_stream_map の順を入れ替えて、360p を先に書いたマスタープレイリストを作りました。
-var_stream_map "v:1,a:1,name:360p v:0,a:0,name:720p" \
同じ速さで再生すると、360p の1本目から読み、5.03 秒で再生が始まりました。そのあとも 360p のまま、止まらずに再生が続きました。

速さを絞らないときは、360p を先にしても 0.23 秒で再生が始まり、2本目からは 720p の .ts を読みました。画面に出る映像は、動画の6秒の位置で 1280×720 に変わりました。この場合は最初の6秒が 360p になりますが、遅い回線では再生が始まるまでの待ちを短くできました。
なお、hls.js を使わずに、Chromium に組み込まれた HLS の再生機能で同じ条件(720p が先、毎秒 160,000 バイト)を試すと、最初から 360p を読み、4.89 秒で再生が始まりました。どの画質から始めるかは、プレイヤーによって違いました。





