dash

Директива 'dash' включает поддержку MPEG-DASH в приложении NGINX RTMP.

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

Описание

Директива 'dash' является неотъемлемой частью модуля NGINX RTMP, позволяя администраторам сервера настроить свои RTMP-приложения для поддержки стриминга MPEG-DASH. Когда эта директива установлена в 'on', она обеспечивает сегментированную передачу медиаконтента через динамическую адаптивную потоковую передачу по HTTP (MPEG-DASH), что важно для динамической подстройки качества видео в зависимости от условий сети. Директива принимает один аргумент: 'on' или 'off', где 'on' включает обработку MPEG-DASH, а 'off' отключает её. Процесс MPEG-DASH включает создание медиасегментов вместе с сопутствующим файлом манифеста, который подсказывает совместимым клиентам, как получать эти сегменты.

Директива обычно размещается в блоке application конфигурации NGINX RTMP, и при её включении становятся актуальными дополнительные параметры, такие как 'dash_fragment', 'dash_path' и 'dash_playlist_length'. Эти параметры позволяют дополнительную настройку, например указать длину каждого фрагмента, задать путь хранения DASH-файлов и управлять длиной плейлиста. При запуске стрима сервер отвечает за создание и управление как видео-, так и аудиодорожками, обеспечивая плавное переключение клиентов между разными уровнями качества в зависимости от пропускной способности их соединения. Процесс NGINX создаёт соответствующие файлы и метаданные в соответствии с конфигурацией, обеспечивая корректную работу стриминга.

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

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

application live {
    dash on;
    dash_path /tmp/dash;
    dash_fragment 1000;
    dash_playlist_length 60000;
}

Убедитесь, что необходимые параметры для DASH правильно настроены; если не задать 'dash_path', это может привести к ошибкам при генерации файлов.

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

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

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