record_append

Директива `record_append` управляет тем, добавлять ли данные к существующему файлу записанного потока в модуле NGINX RTMP.

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

Описание

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

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

В сочетании с директивой record, которая указывает, что записывать (например, all для всех потоков), и record_path, указывающей директорию для хранения записей, директива record_append играет ключевую роль в управлении файлами записанных потоков. Важно убедиться, что права на запись для указанной директории настроены правильно, чтобы избежать ошибок во время выполнения, особенно при одновременной записи нескольких потоков или сессий.

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

application myapp {
    live on;
    record all;
    record_path /tmp/av;
    record_append on;
}

Убедитесь, что путь к файлу записи имеет соответствующие права на запись для процесса NGINX.

Обратите внимание на возможные ограничения размера файла при дозаписи; проверьте ограничения файловой системы.

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

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