hls_fragment_naming
Задает схему именования файлов фрагментов HLS, создаваемых модулем NGINX RTMP.
Описание
Директива hls_fragment_naming используется для определения способа формирования имен фрагментов HLS в модуле NGINX RTMP. По умолчанию файлы фрагментов генерируются на основе меток времени и номеров последовательности. В зависимости от переданного аргумента она может применять пользовательскую схему именования, которая может включать метки времени или номера последовательности в соответствии с потребностями пользователя. Это особенно полезно в сценариях, где клиенты или внешние системы зависят от определённой структуры имён файлов для корректной идентификации и доступа к этим фрагментам.
Спецификация аргумента в директиве допускает один параметр, обозначающий формат именования. Распространённые форматы могут включать плейсхолдеры для имени потока, метки времени и номера последовательности. Поведение этой директивы допускает либо назначение уникальных идентификаторов каждому фрагменту для упрощённого доступа и управления, либо традиционную схему, которая может быть более удобна для устоявшихся систем. Кроме того, при выборе схемы именования важно учитывать возможность коллизий и обеспечивать лёгкий доступ к файлам и их управление на стороне сервера.
При настройке hls_fragment_naming важно проверить, что указанная шаблонизация имён соответствует сценариям воспроизведения, которые рассматриваются. Также понимание того, как это вписывается в общий процесс управления файлами, их очистки и доставки, поможет настроить её эффективно.
Пример конфига
hls_fragment_naming 'fragment-$seq-$timestamp.ts';
Убедитесь, что формат имен уникален, чтобы избежать перезаписи файлов.
Использование неправильных заполнителей может привести к ошибкам при генерации фрагментов.
Отсутствие проверки путей к файлам может привести к ошибкам во время выполнения.