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 模块，应将其禁用。

ngx_http_flv_module 模块为 FLV 文件提供了类似的伪流媒体支持。

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

在所属的 location 中开启模块处理。

mp4_buffer_size 512K;

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

mp4_max_buffer_size 10M;

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

"/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 部分支持。