kmp_rtmp_out_notif_url
kmp_rtmp_out_notif_url 指令指定了一个通知 URL,Kaltura Media Framework 组件将在流媒体事件发生后调用该 URL。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法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 配置的 stream 和 stream 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 请求。
⚠
注意网络超时,可能会导致通知无法发送。