dash_playlist_length

Директива `dash_playlist_length` задаёт максимальную длину DASH-плейлиста в миллисекундах.

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

Описание

Директива dash_playlist_length является частью NGINX RTMP модуля и используется для настройки Dynamic Adaptive Streaming over HTTP (DASH). Устанавливая эту директиву, администратор задаёт длительность DASH-плейлиста, который будет сгенерирован для медиаконтента, передаваемого в поток. Эта длительность важна для того, чтобы медиаплееры знали, как долго они могут ожидать поток, и позволяет эффективно осуществлять буферизацию и воспроизведение без лишних задержек.

Данная директива принимает один аргумент, задающий длину в миллисекундах. Значение, установленное для dash_playlist_length, напрямую влияет на то, как клиенты будут потреблять контент DASH. Если значение слишком короткое, это может привести к частым прерываниям или к тому, что клиент не сможет получить полный поток. Напротив, установка очень большой длительности может увеличить задержку. Поэтому следует подобрать обоснованное значение, исходя из сценария использования приложения для трансляции. В целом необходимо найти баланс, учитывая содержимое потока и возможности клиентов, его потребляющих.

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

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

rtmp {
    server {
        listen 1935;
        application live {
            live on;
            dash_playlist_length 30000;
        }
    }
}

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

Использование этой директивы в неправильном контексте может привести к ошибкам конфигурации.

Установка слишком большой длины плейлиста может привести к нежелательному поведению при буферизации на стороне клиентов.

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