vod_media_set_map_uri

Директива `vod_media_set_map_uri` настраивает сопоставление URI для медиафайлов в модуле VOD Packager на базе NGINX.

Синтаксисvod_media_set_map_uri uri;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1

Описание

Директива vod_media_set_map_uri используется в контексте блоков http, server или location для определения того, как медиа-ресурсы должны сопоставляться с их соответствующими URI для служб видео по запросу (VOD). Обычно она применяется при настройке модуля VOD Packager на базе NGINX, который позволяет выполнять динамическую перепаковку мультимедиа-файлов, обеспечивая отдачу форматов потоковой передачи с адаптивным битрейтом, таких как HLS, DASH и других. Сопоставление, определяемое этой директивой, помогает серверу корректно разрешать пути к файлам различных медиапотоков на основании входящих HTTP-запросов.

Директива принимает один аргумент — конкретный путь URI, к которому будут сопоставляться медиафайлы. Этот URI необходим для указания модулю VOD, откуда извлекать или где отдавать видеоконтент. Настройка этой директивы позволяет эффективно управлять обработкой медиа-ресурсов и обеспечивать корректную обработку запросов клиентов. Она играет важную роль в сценариях с несколькими форматами медиа и адаптивной потоковой передачей, поскольку облегчает организацию и получение необходимых ресурсов, указанных в JSON-конфигурации или через локальные пути к файлам.

При использовании vod_media_set_map_uri крайне важно убедиться, что указанный URI действительно соответствует реальному расположению файлов. Правильная настройка этой директивы позволяет серверу NGINX отдавать соответствующий медиа-контент, используя range-запросы для эффективной передачи и улучшения общей доставки видео для клиентов.

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

location /vod {
    vod_media_set_map_uri /media/myvideos/;
}

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

Неправильное сопоставление может привести к ухудшению производительности из-за некорректного разрешения URI.

Проверьте наличие завершающих слешей в сопоставлении URI, так как они могут повлиять на разрешение путей.

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