hls_fragment_naming

Задает схему именования файлов фрагментов HLS, создаваемых модулем NGINX RTMP.

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

Описание

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

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

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

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

hls_fragment_naming 'fragment-$seq-$timestamp.ts';

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

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

Отсутствие проверки путей к файлам может привести к ошибкам во время выполнения.

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