模組 ngx_http_hls_module

ngx_http_hls_module 模組為 MP4 和 MOV 媒體檔案提供 HTTP 即時串流 (HLS) 伺服器端支援。這類檔案通常具有 .mp4、.m4v、.m4a、.mov 或 .qt 副檔名。此模組支援 H.264 視訊編解碼器、AAC 和 MP3 音訊編解碼器。

針對每個媒體檔案，支援兩個 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

在周圍的 location 中開啟 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

如果使用 ngx_http_secure_link_module 模組保護 HLS 串流，則不應在 secure_link_md5 表達式中使用 $uri，因為這會在請求片段時導致錯誤。應使用 Base 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