kmp_rtmp_out_notif_add_header
Настраивает добавление пользовательских заголовков к уведомлениям RTMP-выхода в Kaltura Media Framework.
Описание
Директива kmp_rtmp_out_notif_add_header предназначена для расширения функциональности RTMP (Real-Time Messaging Protocol) вывода, позволяя пользователям добавлять пользовательские заголовки к уведомлениям, отправляемым во время сеансов трансляции. Она принимает два аргумента: первый — имя добавляемого заголовка, второй — соответствующее значение. Эта возможность особенно полезна для внедрения дополнительной метадаты или управления поведением клиентов, например токенами авторизации или конкретными инструкциями, которые могут определять, как принимающие системы должны обрабатывать или интерпретировать поток.
Когда эта директива указана в контексте stream или stream server, NGINX захватывает определённые заголовки и включает их в уведомления, отправляемые подключённым клиентам. Эта операция критична в сценариях с динамической доставкой контента, так как позволяет вышестоящим сервисам или клиентам динамически реагировать на полученные заголовки. Для эффективного использования убедитесь, что заголовки не конфликтуют со стандартными заголовками протокола RTMP и логически структурированы для облегчения разбора на стороне клиента.
Неправильная конфигурация может привести к пустым заголовкам или отказу в соединении, особенно если вовлечены значения, чувствительные к безопасности. Поэтому всегда рекомендуется проводить тестирование и валидацию в контролируемой среде перед развёртыванием в продуктивную среду.
Пример конфига
stream {
server {
listen 1935;
kmp_rtmp_out_notif_add_header X-Custom-Header "SomeValue";
}
}Убедитесь, что имя заголовка совместимо со спецификациями RTMP, чтобы избежать возможных проблем.
Дважды проверьте, что вы находитесь в правильном контексте (stream или stream server) при использовании этой директивы.
Учитывайте ограничения размера заголовков, налагаемые протоколом RTMP. Чрезмерно большие заголовки могут быть усечены.