on_publish
NGINX RTMP 模块中的 `on_publish` 指令允许您指定一个在流发布时触发的回调函数。
NGINX RTMP module
语法on_publish ;
默认值none
上下文
参数1
说明
该 on_publish 指令旨在便于在用户向服务器发布内容时对 RTMP 流执行操作。该指令接受一个参数，指定在流发布时要执行的回调函数的名称。
当客户端向 NGINX 服务器发布流时，服务器会调用指定的回调函数，从而允许进行额外的处理、记录或安全检查。这对于执行身份验证、记录用户活动或根据流上线触发其他服务器端进程特别有用。该指令的使用上下文为服务器管理员提供了灵活性，以便将功能针对特定的流媒体应用或需求进行定制。
on_publish 指令在直播场景中尤为重要，在这些场景中管理流访问并在流开始时执行操作对于维护有序且安全的流媒体环境至关重要。如果指定的回调遇到错误，发布可能会被拒绝，这有助于保护流服务的完整性。
配置示例
rtmp {
server {
listen 1935;
application live {
live on;
on_publish my_callback;
}
}
}⚠
确保在配置或服务器代码中正确定义了指定的回调函数；否则，该指令将无法按预期工作。
⚠
如果回调函数在直播流发布期间执行大量处理，请注意其对性能的影响。