kmp_rtmp_out_notif_url

kmp_rtmp_out_notif_url 指令指定了一个通知 URL,Kaltura Media Framework 组件将在流媒体事件发生后调用该 URL。

语法kmp_rtmp_out_notif_url URL;
默认值none
上下文stream, stream server
参数1

说明

kmp_rtmp_out_notif_url 指令用于将 Kaltura Media Framework 与 RTMP 流媒体服务集成,允许指定一个通知 URL。当发生流媒体事件时,NGINX 会向所提供的 URL 发送包含相关事件详情的 HTTP POST 请求。这在需要通知外部服务媒体状态变化(例如流开始、停止或出现问题)的流媒体工作流编排中尤其有用。该通知可以触发进一步动作,例如扩缩资源或通知用户界面。

该指令可以在 NGINX 配置的 streamstream server 上下文中使用,允许为该 server block 处理的所有流指定统一的通知 URL。通过提供单一 URL,来自指定上下文的所有 RTMP 输出将使用相同的通知端点,从而在管理多个流时简化配置。请确保通知服务已准备好处理来自 NGINX 的响应,以避免工作流中断。

在配置此指令时,应提供单个参数:通知应发送到的 URL。所指定的 URL 必须可访问且能够处理传入请求,才能有效使用此指令。如果该 URL 无法访问或返回错误,则通知功能可能失败,影响整体流媒体编排。

配置示例

stream {
    server {
        listen 1935;
        kmp_rtmp_out_notif_url http://example.com/notify;

        application live {
            live on;
        }
    }
}

确保通知 URL 可从运行 NGINX 的服务器访问。

验证接收服务能够无错误地处理 HTTP POST 请求。

注意网络超时,可能会导致通知无法发送。

← 返回所有指令