ngx_http_mp4_module模块

ngx_http_mp4_module模块提供了对MP4文件的伪流式服务器端支持。这样的文件通常具有.mp4、.m4v或.m4a扩展名。

伪流式与兼容的媒体播放器配合使用。播放器向服务器发送带有查询字符串参数中指定的开始时间的HTTP请求（简称为start，以秒为单位指定），服务器响应的流使其起始位置对应于请求的时间，例如：

http://example.com/elephants_dream.mp4?start=238.88

这允许在任何时间进行随机搜索，或者在时间线中间开始播放。

为了支持搜索，基于H.264的格式将元数据存储在所谓的“moov原子”中。这是文件的一部分，它保存了整个文件的索引信息。

为了开始播放，播放器首先需要读取元数据。这通过发送带有start=0参数的特殊请求来完成。许多编码软件会在文件末尾插入元数据。这对于伪流式来说并不理想，因为播放器必须在开始播放之前下载整个文件。如果元数据位于文件开头，对于nginx来说，只需开始发送文件内容即可。如果元数据位于文件末尾，nginx必须读取整个文件，并准备一个新的流，使得元数据在媒体数据之前。这涉及到一些CPU、内存和磁盘I/O开销，因此最好是提前为伪流式准备原始文件，而不是让nginx在每次此类请求时都这样做。

该模块还支持HTTP请求的end参数（1.5.13），它设置播放结束点。可以将end参数与start参数一起或分开指定：

http://example.com/elephants_dream.mp4?start=238.88&end=555.55

对于具有非零start或end参数的匹配请求，nginx将从文件中读取元数据，准备带有请求的时间范围的流，并将其发送到客户端。这与上面描述的开销相同。

如果start参数指向非关键视频帧，则该视频的开头将会中断。为了解决这个问题，可以在start点之前以及它们之间的所有中间帧之前附加关键帧。使用编辑列表（1.21.4）将这些帧隐藏起来，以供播放。

如果匹配请求不包括start和end参数，则没有开销，文件将简单地作为静态资源发送。一些播放器还支持字节范围请求，因此不需要此模块。

此模块默认未构建，应使用--with-http_mp4_module配置参数启用它。

如果先前使用了第三方mp4模块，则应将其禁用。

类似的 FLV 文件的伪流支持由 ngx_http_flv_module 模块提供。

location /video/ {
    mp4;
    mp4_buffer_size       1m;
    mp4_max_buffer_size   5m;
    mp4_limit_rate        on;
    mp4_limit_rate_after  30s;
}

在周围位置开启模块处理。

mp4_buffer_size 512K;

设置用于处理 MP4 文件的缓冲区的初始大小。

mp4_max_buffer_size 10M;

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

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

mp4_limit_rate off;

限制向客户端的响应传输速率。速率基于所服务的 MP4 文件的平均比特率进行限制。为计算速率，将比特率乘以指定的 factor。特殊值“on”对应于因子 1.1。特殊值“off”禁用速率限制。限制设置为每个请求，因此如果客户端同时打开两个连接，则总速率将是指定限制的两倍。

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

mp4_limit_rate_after 60s;

设置媒体数据的初始量（以播放时间度量），在此之后将对向客户端的响应进一步传输进行速率限制。

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

mp4_start_key_frame off;

强制输出视频始终以关键视频帧开头。如果 start 参数不指向关键帧，则使用 mp4 编辑列表隐藏初始帧。编辑列表受到主要播放器和浏览器的支持，如 Chrome、Safari、QuickTime 和 ffmpeg，部分支持 Firefox。