on_disconnect
`on_disconnect` 指令允许指定在客户端从 RTMP 流断开连接时要执行的操作。
NGINX RTMP module
语法on_disconnect command;
默认值none
上下文
参数1
说明
on_disconnect 指令用于 NGINX RTMP 模块配置中的 application 块上下文中。它使服务器管理员能够定义在客户端从流断开时应执行的自定义操作。这在需要进行清理操作、发送通知或记录断开事件的场景中特别有用。
在实现 on_disconnect 时，您可以指定服务器在断开时调用的脚本或函数。这允许实现自定义行为，例如更新数据库、触发通知系统或执行一系列针对您的流媒体应用的命令。该行为通常通过提供一个作为字符串的单个参数来定义，该字符串表示要执行的命令。
与 NGINX 中的许多指令一样，务必确保所定义的操作不会引入过度开销，因为这些操作会在 RTMP 会话处理的上下文中执行。根据命令的定义方式，配置中的失误可能导致性能问题或未处理的异常，从而影响流媒体服务的整体响应性。
配置示例
application live {
on_disconnect notify_disconnect;
}
# Where 'notify_disconnect' is a defined command or function to handle disconnect events.⚠
确保为 on_disconnect 指定的命令在使用前已被正确定义。
⚠
长时间运行的脚本或命令如果不以异步方式处理，可能会对流媒体性能产生负面影响。
⚠
彻底测试已定义的断开连接行为，以避免在生产环境中出现意外后果或故障。