ts_kmp_ctrl_add_header
'ts_kmp_ctrl_add_header' 指令用于在 NGINX 中向 Kaltura Media Protocol (KMP) 请求添加自定义头。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法ts_kmp_ctrl_add_header name value;
默认值none
上下文stream, stream server
参数2
说明
'ts_kmp_ctrl_add_header' 指令允许用户指定将包含在由 Kaltura Media Framework 处理的请求中的额外头信息。该功能在需要随 KMP 请求传递特定元数据的媒体流设置中尤其有用。该指令接受且仅接受两个参数：头名称及其对应的值。这些头对于确保 Kaltura 的媒体处理组件正确解释并响应嵌入在 KMP 请求中的数据（例如授权令牌或其他元数据）至关重要。
配置后，每当在指定的上下文（stream or server）中处理请求时，指定的头和其值会被添加到外发的 KMP 请求中。需要注意的是，该指令只能在适当的上下文中使用（either stream or stream server），错误使用将导致 NGINX 在配置解析时返回错误。正确管理这些头可以大大增强 Kaltura Media Framework 中媒体处理的互操作性和功能性。
配置示例
stream {
...
ts_kmp_ctrl_add_header X-Auth-Token auth_token;
ts_kmp_ctrl_add_header X-Custom-Header custom_value;
}⚠
如果头部名称和值包含空格或特殊字符，请确保为它们正确加引号。
⚠
在 'stream' 或 'stream server' 上下文之外使用此指令会导致配置错误。