on_publish_done

`on_publish_done` 指令允许您指定一个回调函数,当发布操作在 NGINX RTMP 模块中完成时触发。

语法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 中忘记处理错误,可能会中断流式工作流。

← 返回所有指令