ngx_http_hls_module 模块为 MP4 和 MOV 媒体文件提供 HTTP Live Streaming (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/;
}通过此配置，“/var/video/test.mp4” 文件支持以下 URI：
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; 默认值：— 上下文：location
打开当前配置的 location 的 HLS 流支持
语 法：hls_buffers number size; 默认值：hls_buffers 8 2m; 上下文：http, server, location
设置用于读取和写入数据帧的缓冲区的最大数量和大小。
语 法：hls_forward_args on | off; 默认值：hls_forward_args off; 上下文：http, server, location
该指令出现在 1.5.12 版中。
将播放列表请求中的参数添加到片段的 URI。这对于在请求片段时执行客户端授权或在使用 ngx_http_secure_link_module 模块保护 HLS 流时可能很有用。
例如，如果客户端请求播放列表 http://example.com/hls/test.mp4.m3u8?a=1&b=2 ，则参数 a=1 和 b=2 将添加在片段的 URI 参数 “start” 和 “end” 之后：
#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 time; 默认值：hls_fragment 5s; 上下文：http, server, location
定义不带 “len” 参数请求的播放列表 URI 的默认片段长度。
语 法：hls_mp4_buffer_size size; 默认值：hls_mp4_buffer_size 512k; 上下文：http, server, location
设置用于处理 MP4 和 MOV 文件的缓冲区的初始大小。
语 法：hls_mp4_max_buffer_size size; 默认值：hls_mp4_max_buffer_size 10m; 上下文：http, server, location
在元数据处理期间，可能需要更大的缓冲区。其大小不能超过指定的大小，否则 nginx 会返回服务器错误 500 (Internal Server Error)，并记录如下消息：
"/some/movie/file.mp4" mp4 moov atom is too large: 12583268, you may want to increase hls_mp4_max_buffer_size
川公网安备51010802032098
