hls_sync

Директива `hls_sync` настраивает параметры синхронизации для выходных HLS-потоков в модуле NGINX RTMP.

Синтаксисhls_sync on | off;
По умолчаниюoff
Контекст
Аргументы1

Описание

Директива hls_sync в модуле NGINX RTMP предназначена для управления тем, как сегменты HLS (HTTP Live Streaming) синхронизируются между потоками. При включении эта директива помогает обеспечить воспроизведение на HLS-клиентах без рассинхронизации по времени, что критично для сценариев прямых трансляций. Директива работает путём корректировки временных меток входящих HLS-сегментов для поддержания согласованности при распределённом воспроизведении, что особенно полезно для мультибитрейтовых потоков или ситуаций, когда сегменты агрегируются из нескольких источников.

Параметр для hls_sync имеет булево значение: установка в 'on' активирует стратегии синхронизации для HLS-потоков. Если оставлен 'off' или не указан, NGINX не будет выполнять синхронизацию между HLS-сегментами, что может привести к рассинхронизированному воспроизведению, особенно при изменяющихся условиях сети или ограничениях клиента. Следовательно, по умолчанию синхронизация не выполняется, пока директива явно не включена.

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

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

hls {
    hls_sync on;
    hls_fragment 5s;
    hls_playlist_length 60s;
}

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

Неправильная конфигурация hls_sync может привести к проблемам с воспроизведением, если другие настройки HLS несовместимы с требованиями синхронизации.

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