模块 ngx_http_hls_module

该模块提供 HTTP Live Streaming （HLS） 对 MP4 和 MOV 媒体文件的服务器端支持。 此类文件通常具有 、 或文件扩展名。 该模块支持 H.264 视频编解码器、AAC 和 MP3 音频编解码器。ngx_http_hls_module.mp4.m4v.m4a.mov.qt

对于每个媒体文件，支持两个 URI：

• 文件扩展名为 “” 的播放列表 URI。 URI 可以接受可选参数：.m3u8
  • “” 和 “” 以秒为单位定义播放列表边界 （1.9.0）。startend
  • “” 移动初始播放位置 设置为以秒为单位的时间偏移量 （1.9.0）。 正值设置与播放列表开头的时间偏移量。 负值设置时间偏移量 从播放列表中最后一个片段的末尾开始。offset
  • “” 定义片段长度（以秒为单位）。len
• 文件扩展名为 “” 的片段 URI。 URI 可以接受可选参数：.ts
  • “” 和 “” 定义 Fragment 边界（以秒为单位）。startend

此模块作为我们商业订阅的一部分提供。

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;

设置缓冲区的最大值 和 用于读取和写入数据帧。numbersize

hls_forward_args off;

将播放列表请求中的参数添加到片段的 URI。 这对于在 请求片段，或者在使用 ngx_http_secure_link_module 模块保护 HLS 流时。

例如，如果客户端请求播放列表 ， 参数 和 将添加到片段的 URI 中，位于参数和 ：http://example.com/hls/test.mp4.m3u8?a=1&b=2a=1b=2startend

#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;

定义请求的播放列表 URI 的默认片段长度，而不使用 “” 参数。len

hls_mp4_buffer_size 512k;

设置用于 处理 MP4 和 MOV 文件。size

hls_mp4_max_buffer_size 10m;

在元数据处理期间，可能需要更大的缓冲区。 其大小不能超过指定的 ， 否则 nginx 将返回服务器错误 500（internal服务器错误）、 并记录以下消息：size

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