モジュールngx_http_hls_module

ngx_http_hls_moduleモジュールは、MP4およびMOVメディアファイルのHTTPライブストリーミング（HLS）サーバー側サポートを提供します。これらのファイルは通常、「.mp4」、「.m4v」、 「.m4a」、「.mov」、または「.qt」というファイル名の拡張子を持ちます。このモジュールは、H.264ビデオコーデック、AAC、MP3オーディオコーデックをサポートしています。

メディアファイルごとに2つのURIがサポートされます。

• 「.m3u8」というファイル名拡張子を持つプレイリストURI。このURIはオプションの引数を受け付けます。
  • 「start」と「end」は、プレイリストの境界を秒単位で定義します（1.9.0）。
  • 「offset」は、最初の再生位置を秒単位のタイムオフセットにシフトします（1.9.0）。正の値はプレイリストの開始からのタイムオフセットを設定します。負の値はプレイリストの最後のフラグメントの終了からのタイムオフセットを設定します。
  • 「len」は、フラグメントの長さを秒単位で定義します。
• 「.ts」というファイル名拡張子を持つフラグメントURI。このURIはオプションの引数を受け付けます。
  • 「start」と「end」は、フラグメントの境界を秒単位で定義します。

このモジュールは、商用サブスクリプションの一部として利用できます。

location / {
    hls;
    hls_fragment            5s;
    hls_buffers             10 10m;
    hls_mp4_buffer_size     1m;
    hls_mp4_max_buffer_size 5m;
    root /var/video/;
}

この構成では、次のURIが「/var/video/test.mp4」ファイルにサポートされます。

http://hls.example.com/test.mp4.m3u8?offset=1.000&start=1.000&end=2.200
http://hls.example.com/test.mp4.m3u8?len=8.000
http://hls.example.com/test.mp4.ts?start=1.000&end=2.200

周囲のロケーションでHLSストリーミングをオンにします。

hls_buffers 8 2m;

データフレームの読み書きに使用されるバッファの最大numberとsizeを設定します。

hls_forward_args off;

プレイリストリクエストからの引数をフラグメントのURIに追加します。これは、フラグメントを要求した時点でのクライアント認証を実行する場合や、ngx_http_secure_link_moduleモジュールでHLSストリームを保護する場合に役立ちます。

たとえば、クライアントがプレイリストhttp://example.com/hls/test.mp4.m3u8?a=1&b=2を要求する場合、引数a=1とb=2は引数startとendの後にフラグメントのURIに追加されます

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:15
#EXT-X-PLAYLIST-TYPE:VOD

#EXTINF:9.333,
test.mp4.ts?start=0.000&end=9.333&a=1&b=2
#EXTINF:7.167,
test.mp4.ts?start=9.333&end=16.500&a=1&b=2
#EXTINF:5.416,
test.mp4.ts?start=16.500&end=21.916&a=1&b=2
#EXTINF:5.500,
test.mp4.ts?start=21.916&end=27.416&a=1&b=2
#EXTINF:15.167,
test.mp4.ts?start=27.416&end=42.583&a=1&b=2
#EXTINF:9.626,
test.mp4.ts?start=42.583&end=52.209&a=1&b=2

#EXT-X-ENDLIST

HLSストリームがngx_http_secure_link_moduleモジュールで保護されている場合、secure_link_md5式で$uriは使用しないでください。フラグメントを要求するときにエラーが発生します。代わりに、$uriの代わりにベースURIを使用する必要があります（例では$hls_uri）

http {
    ...

    map $uri $hls_uri {
        ~^(?<base_uri>.*).m3u8$ $base_uri;
        ~^(?<base_uri>.*).ts$   $base_uri;
        default                 $uri;
    }

    server {
        ...

        location /hls/ {
            hls;
            hls_forward_args on;

            alias /var/videos/;

            secure_link $arg_md5,$arg_expires;
            secure_link_md5 "$secure_link_expires$hls_uri$remote_addr secret";

            if ($secure_link = "") {
                return 403;
            }

            if ($secure_link = "0") {
                return 410;
            }
        }
    }
}

hls_fragment 5s;

「len」引数なしで要求されたプレイリストURIのデフォルトフラグメント長を定義します。

hls_mp4_buffer_size 512k;

MP4およびMOVファイルを処理するために使用されるバッファの初期sizeを設定します。

hls_mp4_max_buffer_size 10m;

メタデータの処理中に、より大きなバッファが必要になる場合があります。そのサイズは指定されたsizeを超えることはできません。そうでない場合、nginxはサーバーエラー500（内部サーバーエラー）を返し、次のメッセージをログに記録します。

"/some/movie/file.mp4" mp4 moov atom is too large:
12583268, you may want to increase hls_mp4_max_buffer_size