wait_video

Директива `wait_video` в модуле NGINX RTMP задаёт длительность ожидания, которой должны придерживаться клиенты перед доступом к видеопотоку.

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

Описание

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

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

Кроме того, значение этого параметра следует выбирать с осторожностью: слишком большое значение может раздражать пользователей, тогда как слишком маленькое может не обеспечить желаемый эффект синхронизации. Важно настраивать эту директиву с учётом характера транслируемого контента и ожидаемого поведения аудитории.

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

rtmp {
    server {
        listen 1935;
        application live {
            live on;
            wait_video 30;
        }
    }
}

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

Установка значения 0 может привести к немедленному доступу, что сведёт на нет назначение этой директивы.

Проверьте, затрагиваются ли связанные настройки потоковой передачи (например, с низкой задержкой) функциональностью этой директивы.

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