wait_key

Директива wait_key в модуле NGINX RTMP используется для указания времени ожидания, в течение которого клиенты устанавливают соединение перед началом трансляции.

Синтаксисwait_key time;
По умолчаниюnone
Контекст
Аргументы1

Описание

Директива wait_key управляет поведением клиентских подключений в стриминговых приложениях, управляемых модулем NGINX RTMP. Когда начинается поток, эта директива позволяет серверу отложить отправку данных потока до наступления указанного таймаута, что помогает убедиться, что все предполагаемые клиенты подключены перед трансляцией.

Директива принимает один аргумент — количество миллисекунд для ожидания. Если директива установлена, сервер задержит отправку потока, чтобы дать клиентам достаточно времени для подключения, что особенно полезно в сценариях, когда ожидается одновременное присоединение нескольких зрителей. Это предотвращает ситуации, когда зрители подключаются в середине трансляции и могут пропустить важный контент. Это особенно полезно при прямых трансляциях, где синхронность зрителей улучшает впечатление от просмотра.

Директива может использоваться только внутри блока приложения RTMP и непосредственно влияет на пользовательский опыт во время трансляций. Она обеспечивает синхронизацию всех клиентов перед началом потока, но установка слишком большого значения может заставить зрителей ждать дольше, чем необходимо, что потенциально снизит вовлечённость, если их оставят ждать продолжительное время.

Пример конфига

application live {
    live on;
    wait_key 5000;
}

Установка wait_key на большое значение может привести к недовольству зрителей, если их доступ к интерфейсу потока будет задержан.

Если в течение времени ожидания ни один клиент не подключится, поток всё равно начнётся, и опоздавшие могут пропустить часть содержимого.

← Ко всем директивам