on_publish_done
`on_publish_done` 指令允许您指定一个回调函数,当发布操作在 NGINX RTMP 模块中完成时触发。
NGINX RTMP module
语法on_publish_done handler_name;
默认值none
上下文
参数1
说明
on_publish_done 指令是 NGINX RTMP 模块的一部分,该模块用于实现实时消息传输协议的流媒体传输。该指令在发布者完成向流的推送后被调用,适用于在流会话结束后执行额外操作,例如日志记录或清理任务。该指令接受一个参数,用于指定在发布操作完成后将被调用的处理程序。此功能为将自定义逻辑集成到流媒体工作流中提供了灵活性,增强了在 NGINX 服务器上下文中对发布事件的控制。
在实际使用中,此指令通常涉及绑定要执行的事件处理器、脚本或函数。用途可能包括通知其他服务或清理与流相关的资源。该指令的行为集中于流管理,确保任何必要的后处理可以无缝集成到直播设置中,从而显著改进使用实时广播的应用程序的工作流程,确保发布阶段之后的操作能够可靠执行。
配置示例
rtmp {
server {
application live {
live on;
on_publish_done log_publish_done;
}
}
}⚠
确保指定的 handler function 已正确实现且可被 NGINX 访问。
⚠
如果在 callback 中忘记处理错误,可能会中断流式工作流。