kmp_cc_out_ctrl_add_header
在 NGINX 流媒体配置中，`kmp_cc_out_ctrl_add_header` 指令用于向 Kaltura Media Framework 的控制消息添加自定义头。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法kmp_cc_out_ctrl_add_header name value;
默认值none
上下文stream, stream server
参数2
说明
kmp_cc_out_ctrl_add_header 指令允许您为由 Kaltura Media Framework Common NGINX Module 处理的外发控制消息指定自定义头。该指令接受两个参数：头的名称和要分配给它的值，从而使您能够灵活修改流媒体服务器与客户端或媒体管道中其他组件的通信方式。通过使用此指令，您可以根据具体需求定制流媒体配置，例如需要包含在控制消息中的身份验证、元数据或服务标识等。\n\n当在 stream 或 stream server 上下文中包含此指令时，指定的头将附加到通过 Kaltura Media Protocol 发送的任何外发控制消息中。它在需要发送可帮助客户端更有效处理媒体流的附加信息的场景中尤其有用。此指令便于实现动态配置，并增强了依赖自定义头以正常运行的各类媒体组件的互操作性。
配置示例
stream {
server {
kmp_cc_out_ctrl_add_header "X-Kaltura-Auth" "Bearer my_token";
}
}⚠
确保头部名称有效且不会与现有头部冲突。
⚠
使用不正确的参数数量将导致配置错误。
⚠
添加的头部可能会影响客户端或下游系统处理控制消息的方式。