使用例子：
on_connect http://example.com/my_auth;
重定向例子：
location /on_connect {
if ($arg_flashver != "my_secret_flashver") {
rewrite ^.*$ fallback? permanent;
}
return 200;
}
on_play
语法： on_play url
上下文： rtmp, server, application
描述：设置 HTTP 播放回调。每次一个客户分发播放命令时，一个 HTTP 请求异步发送，命令处理会挂起 - 直到它返回结果码。之后再解析 HTTP 结果码。
* HTTP 2XX 返回码的话继续 RTMP 会话。
* HTTP 3XX 返回码的话 重定向 RTMP 到另一个流，这个流的名字在 HTTP 返回头的 Location 获取。如果新流的名字起始于 rtmp:// 然后远程 relay 会被创建。relay 要求 IP 地址是指定的而不是域名，并且只工作在 1.3.10 版本以上的 nginx。另请参考 notify_relay_redirect。
* 其他返回码的话 RTMP 连接丢弃。
重定向例子：
http {
...
location /local_redirect {
rewrite ^.*$ newname? permanent;
}
location /remote_redirect {
# no domain name here, only ip
rewrite ^.*$ rtmp://192.168.1.123/someapp/somename? permanent;
}
...
}


rtmp {
...
application myapp1 {
live on;
# stream will be redirected to 'newname'
on_play http://localhost:8080/local_redirect;
}
application myapp2 {
live on;
# stream will be pulled from remote location
# requires nginx >= 1.3.10
on_play http://localhost:8080/remote_redirect;
}
...
}
HTTP 请求接收到一些个参数。在 application/x-www-form-urlencoded MIME 类型下使用 POST 方法。以下参数会被传送给调用者：
* call=play。
* addr - 客户端 IP 地址。
* app - application 名。
* flashVer - 客户端 flash 版本。
* swfUrl - 客户端 swf url。
* tcUrl - tcUrl。
* pageUrl - 客户端页面 url。
* name - 流名。
出了上述参数之外其他所有播放命令参数显式地发送回调。例如如果一个流由 url rtmp://localhost/app/movie?a=100&b=face&foo=bar 访问，然后呢 a,b 和 foo 发送回调。
on_play http://example.com/my_callback;
on_publish
语法： on_publish url
上下文： rtmp, server, application
描述：同上面提到的 on_play 一样，唯一的不同点在于这个指令在发布命令设置回调。不同于远程 pull，push 在这里是可以的。
on_done
语法： on_done url
上下文： rtmp, server, application
描述：设置播放/发布禁止回调。上述所有适用于此。但这个回调并不检查 HTTP 状态码。
on_play_done
语法： on_publish_done url
上下文： rtmp, server, application
描述：等同于 on_done 的表现，但只适用于播放结束事件。
on_publish_done
语法： on_publish_done url
上下文： rtmp, server, application
描述：等同于 on_done 的表现，但只适用于发布结束事件。
on_record_done
语法： on_record_done url
上下文： rtmp, server, application, recorder
描述：设置 record_done 回调。除了普通 HTTP 回调参数它接受录制文件路径。
on_record_done http://example.com/recorded;
on_update
语法： on_update url
上下文： rtmp, server, application
描述：设置 update 回调。这个回调会在 notify_update_timeout 期间调用。如果一个请求返回结果不是 2XX，连接禁止。这可以用来同步过期的会话。追加 time 参数即播放/发布调用后的秒数会被发送给处理程序。
on_update http://example.com/update;
notify_update_timeout
语法： notify_update_timeout timeout
上下文： rtmp, server, application
描述：在 on_update 回调之间的超时设置。默认为 30 秒。
notify_update_timeout 10s;
on_update http://example.com/update;
notify_update_strict
语法： notify_update_strict on|off
上下文： rtmp, server, application
描述：切换 on_update 回调严格模式。默认为 off。当设置为 on 时，所有连接错误，超时以及 HTTP 解析错误和空返回会被视为更新失败并导致连接终止。当设置为 off 时只有 HTTP 返回码不同于 2XX 时导致失败。
notify_update_strict on;
on_update http://example.com/update;
notify_relay_redirect
语法： notify_relay_redirect on|off
上下文： rtmp, server, application
描述：使本地流可以重定向为 on_play 和 on_publish 远程重定向。新的流名字是 RTMP URL 用于远程重定向。默认为 off。
notify_relay_redirect on;
notify_method
语法： notify_method get|post
上下文： rtmp, server, application, recorder
描述：设置 HTTP 方法通知。默认是带有 application/x-www-form-urlencoded 的 POST 内容类型。在一些情况下 GET 更好，例如如果你打算在 nginx 的 http{} 部分处理调用。在这种情况下你可以使用 arg_* 变量去访问参数。
notify_method get;
在 http{} 部分使用 GET 方法处理通知可以使用这种方法：
location /on_play {
if ($arg_pageUrl ~* localhost) {
return 200;
}
return 500;
}
HLS
hls
语法： hls on|off
上下文： rtmp, server, application
描述：在 application 切换 HLS。
hls on;
hls_path /tmp/hls;
hls_fragment 15s;
在 http{} 段为客户端播放 HLS 设置在以下位置设置：
http {
...
server {
...
location /hls {
types {
application/vnd.apple.mpegurl m3u8;
}
alias /tmp/hls;
}
}
}
hls_path
语法： hls_path path
上下文： rtmp, server, application
描述：设置 HLS 播放列表和分段目录。这一目录必须在 NGINX 启动前就已存在。
hls_fragment
语法： hls_fragment time
上下文： rtmp, server, application
描述：设置 HLS 分段长度。默认为 5 秒钟。
hls_playlist_length
语法： hls_playlist_length time
上下文： rtmp, server, application
描述：设置 HLS 播放列表长度。默认为 30 秒钟。
hls_playlist_length 10m;
hls_sync
语法： hls_sync time
上下文： rtmp, server, application
描述：设置 HLS 时间戳同步阈值。默认为 2 ms。这一功能可以防止由低分辨率 RTMP (1KHz) 转换到高分辨率 MPEG-TS (90KHz) 之后出现噪音。
hls_sync 100ms;
hls_continuous
语法： hls_continuous on|off
上下文： rtmp, server, application
描述：切换 HLS 连续模式。这一模式下 HLS 序列号由其上次停止的最后时间开始。老的分段保留下来。默认为 off。
hls_continuous on;
hls_nested
语法： hls_nested on|off
上下文： rtmp, server, application
描述：切换 HLS 嵌套模式。这一模式下为每个流创建了一个 hls_path 的子目录。播放列表和分段在那个子目录中创建。默认为 off。
hls_nested on;
hls_cleanup
语法： hls_cleanup on|off
上下文： rtmp, server, application
描述：切换 HLS 清理。这一功能默认为开启的。在这一模式下 nginx 缓存管理进程将老的 HLS 片段和播放列表由 HLS 清理掉。
hls_cleanup off;
Access log
access_log
语法： access_log off|path [format_name]
上下文： rtmp, server, application
描述：设置访问日志参数。日志默认是开启的。关闭日志可以使用 access_log off 指令。默认情况下访问日志和 HTTP 访问日志 logs/access.log 放到同一文件。你也可以使用 access_log 指令将其定义到其他日志文件。第二个参数是可选的。可以根据名字来定义日志格式。请参考 log_format 指令来获取更多关于格式的详细信息。
log_format new '$remote_addr';
access_log logs/rtmp_access.log new;
access_log logs/rtmp_access.log;
access_log off;
log_format
语法： log_format format_name format
上下文： rtmp
描述：创建指定的日志格式。日志格式看起来很像 nginx HTTP 日志格式。日志格式里支持的几个变量有：
* connection - 连接数。
* remote_addr - 客户端地址。
* app - application 名。
* name - 上一个流名。
* args - 上一个流播放/发布参数。
* flashver - 客户端 flash 版本。
* swfurl - 客户端 swf url。
* tcurl - 客户端 tcUrl。
* pageurl - 客户端页面 url。
* command - 客户端发送的播放/发布命令：NONE、PLAY、PUBLISH、PLAY+PUBLISH。
* bytes_sent - 发送到客户端的字节数。
* bytes_received - 从客户端接收到的字节数。
* time_local - 客户端连接结束的本地时间。
* session_time - 持续连接的秒数。
* session_readable_time - 在可读格式下的持续时间。
默认的日志格式叫做 combined。这里是这一格式的定义：
$remote_addr [$time_local] $command "$app" "$name" "$args" -
$bytes_received $bytes_sent "$pageurl" "$flashver" ($session_readable_time)
Limits
max_connections
语法： max_connections number
上下文： rtmp, server, application
描述：为 rtmp 引擎设置最大连接数。默认为 off。
max_connections 100;
Statistics
statistics 模块不同于本文列举的其他模块，它是 NGINX HTTP 模块。因此 statistics 指令应该位于 http{} 块内部。
rtmp_stat
语法： rtmp_stat all
上下文： http, server, location
描述：为当前 HTTP location 设置 RTMP statistics 处理程序。RTMP statistics 是一个静态的 XML 文档。可以使用 rtmp_stat_stylesheet 指令在浏览器中作为 XHTML 页面查看这个文档。
http {
server {
location /stat {
rtmp_stat all;
rtmp_stat_stylesheet stat.xsl;
}
location /stat.xsl {
root /path/to/stat/xsl/file;
}
}
}
rtmp_stat_stylesheet
语法： rtmp_stat_stylesheet path
上下文： http, server, location
描述：添加 XML 样式表引用到 statistics XML 使其可以在浏览器中可视。更多信息请参考 rtmp_stat 描述和例子。
Multi-worker live streaming
多 worker 直播流是通过推送流到剩余的 nginx worker 实现的。
rtmp_auto_push
语法： rtmp_auto_push on|off
上下文： root
描述：切换自动推送(多 worker 直播流)模式。默认为 off。
rtmp_auto_push_reconnect
语法： rtmp_auto_push_reconnect timeout
上下文： root
描述：当 worker 被干掉时设置自动推送连接超时时间。默认为 100 毫秒。
rtmp_socket_dir
语法： rtmp_socket_dir dir
上下文： root
描述：设置用于流推送的 UNIX 域套接字目录。默认为 /tmp。
rtmp_auto_push on;
rtmp_auto_push_reconnect 1s;
rtmp_socket_dir /var/sock;


rtmp {
server {
listen 1935;
application myapp {
live on;
}
}
}
Control
control 模块是 NGINX HTTP 模块，应该放在 http{} 块之内。
rtmp_control
语法： rtmp_control all
上下文： http, server, location
描述：为当前 HTTP location 设置 RTMP 控制程序。
http {
server {
location /control {
rtmp_control all;
}
}
}