on_done
NGINX RTMP 模块中的 'on_done' 指令用于指定在直播流发布完成后执行的回调函数。
NGINX RTMP module
语法on_done "command_or_script";
默认值none
上下文
参数1
说明
'on_done' 指令允许您定义一个在流完成时触发的回调，适用于实时广播应用。这对于执行自定义操作特别有用，例如通知外部服务、记录日志或在流结束后清理资源。关联的代码路径已集成到流的生命周期中，确保指定的回调仅在 RTMP 会话已干净结束其发布过程之后被执行。
当使用此指令时，您必须指定一个有效的参数，通常表示 URL 或 一个执行命令。该指令将此功能挂接到 RTMP 模块对流终止的处理，使得在流结束后的用户定义行为具有可扩展性。在基于流生命周期事件与外部系统交互时，认真管理任何依赖关系非常重要。
配置示例
rtmp {
server {
application live {
live on;
on_done "http://example.com/stream_done";
}
}
}⚠
确保用于回调的命令或 URL 可访问且格式正确，因为其中的任何错误都可能导致静默失败。
⚠
该指令与上下文相关；在错误的上下文中使用可能导致 NGINX 配置错误。
⚠
请记住，所指定的命令应能在没有直接交互式会话的情况下被调用并正常工作。