on_update
'on_update' 指令允许定义一个回调 URL，当流更新发生时触发该回调。
NGINX RTMP module
语法on_update URL;
默认值none
上下文
参数1
说明
'on_update' 指令是 NGINX RTMP 模块的一部分，用作一个可配置参数，用来指定在某些流事件（例如流开始或停止）发生时会被通知的 HTTP 回调。它期待一个参数：回调将发送到的 URL。这可以便于与需要实时跟踪流处理状态的外部系统集成，从而实现通知、日志记录或对流会话的远程管理等功能。
启用后，每当与 RTMP 流相关的更新事件发生时，NGINX 服务器会向指定的 URL 发出 HTTP 请求。使用的 HTTP 方法通常是 POST，并且请求中可以包含关于事件的各种上下文信息。这使得外部应用（例如内容管理系统或监控工具）能够动态地对流状态的变化作出响应。请求中发送的数据格式可根据实现而异，但通常包含与流相关的标识符和状态信息。
该指令在涉及自动化或需要对系统状态变化进行实时感知的场景中特别有用，可提高媒体流环境的控制性和灵活性。
配置示例
rtmp {
server {
listen 1935;
application live {
live on;
on_update http://example.com/stream/update;
}
}
}⚠
确保该 URL 可被 NGINX 服务器访问，并能正确处理传入请求。
⚠
注意网络延迟，因为它可能影响流的响应性，尤其是在 callback 涉及外部服务器时。