publish_notify

`publish_notify` 指令用于配置在 RTMP 上下文中当有新流发布时发送的通知。

语法publish_notify URL;
默认值none
上下文
参数1

说明

publish_notify 指令(位于 NGINX RTMP 模块中)允许用户指定在有新流发布时需要通知的 URL。 这对于将流事件与外部系统或服务集成特别有用,可实现诸如更新数据库、触发自动化工作流程或向已连接客户端广播通知等操作。该指令接受一个参数,即在每次流发布时要通知的 URL。

当有新的 RTMP 流发布时,NGINX 服务器会向指定的 URL 发送一个 HTTP POST 请求。该请求可以携带有关流的信息,例如流名称、应用名称及其他相关元数据,从而使接收服务器能够适当地处理该事件。在需要实时更新流生命周期信息的场景中(例如为大量用户服务或与跟踪直播流的内容管理系统交互时),这很有帮助。

要有效使用此指令,应确保目标 URL 可到达并已正确配置以接收和处理传入的 POST 请求。此外,由于每次流发布都会发送通知,端点在处理这些请求时应高效,以避免在流管理中产生瓶颈。

配置示例

application myapp {
    live on;
    publish_notify http://example.com/notify;
}

确保 notify URL 可访问;如果请求失败,可能不会重试。

确保在 notify URL 处对传入请求进行正确处理,以避免性能问题。

请注意您的应用将收到多少通知,因为这会影响服务器负载。

← 返回所有指令