kmp_rtmp_out_notif_add_header
配置在 Kaltura Media Framework 中向 RTMP 输出通知添加自定义头。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法kmp_rtmp_out_notif_add_header name value;
默认值none
上下文stream, stream server
参数2
说明
kmp_rtmp_out_notif_add_header 指令用于增强 RTMP（实时消息传输协议）输出功能，允许用户在流式传输会话期间向发送的通知中添加自定义头。它接受两个参数：第一个是要添加的头名称，第二个是对应的值。此功能特别适用于注入附加元数据或管理客户端行为，例如授权令牌或可能决定接收系统如何处理或解释流的特定指令。
当在 stream 或 stream server 上下文中指定此指令时，NGINX 会捕获所定义的头并将其合并到发送给已连接客户端的通知消息中。在涉及动态内容传递的场景中，此操作非常关键，因为它允许上游服务或客户端根据接收到的头动态响应。为高效使用，请确保这些头不会与标准 RTMP 协议头冲突，并且其结构应符合逻辑以便于客户端解析。
配置错误可能导致头为空或连接被拒，尤其当涉及安全敏感的值时。因此，建议在部署到生产环境之前在受控环境中进行测试和验证。
配置示例
stream {
server {
listen 1935;
kmp_rtmp_out_notif_add_header X-Custom-Header "SomeValue";
}
}⚠
确保头部名称与 RTMP 规范兼容，以避免潜在问题。
⚠
在使用此指令时，请再次确认您处于正确的上下文（stream 或 stream server）。
⚠
注意 RTMP 协议施加的头部大小限制。过大的头部可能会被截断。