record_notify
'record_notify' 指令启用服务器对流录制事件的通知。
NGINX RTMP module
语法record_notify URL;
默认值none
上下文
参数1
说明
'record_notify' 指令在 NGINX RTMP 模块中指定了一个回调 URL,服务器在发生重要录制事件时应调用该 URL。调用时,该通知可针对与流录制相关的各种事件触发,例如开始、停止或更新录制会话状态。这对于触发外部进程或通知其他服务特别有用,无需用户手动检查录制状态。
在设置此指令时,您需要提供一个参数:接收通知的 URL。该 URL 可以包含指定录制详细信息的参数,从而实现高度自定义的事件处理。通知以 HTTP 请求的形式发送,配置正确时可以促进与媒体处理和管理相关工作流的自动化。此功能增强了流媒体服务的可用性,使用户更容易将录制通知集成到其应用或服务中。
需要注意的是,系统应适当配置以处理这些通知,确保指定的 URL 能接受传入的 HTTP 请求并高效处理。若没有准备好正确的端点来接收通知,此功能可能失效,导致录制流管理中的潜在疏漏。
配置示例
application myapp {
live on;
record all;
record_path /path/to/recordings;
record_notify http://example.com/notify;
}⚠
确保从 NGINX 服务器可以访问 notify URL,以避免通知失败。
⚠
接收通知的端点必须能够处理 HTTP 请求,并根据所提供的信息执行必要的操作。