vod_media_set_override_json

Директива `vod_media_set_override_json` позволяет переопределять настройки медиа в модуле Видео по запросу (VOD) на базе NGINX с помощью данных в формате JSON.

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

Описание

Директива vod_media_set_override_json используется в модуле Видео по запросу (VOD) на базе NGINX для включения динамической конфигурации медиа. При указании эта директива позволяет пользователям передавать в качестве аргумента строку в формате JSON, которая определяет различные параметры медиа, такие как настройки битрейта, кодеки и пользовательские параметры стриминга. Это особенно полезно при обработке медиафайлов, требующих разных конфигураций без необходимости прямого изменения статических конфигураций сервера.

Директива принимает один аргумент, который должен быть валидной JSON-строкой. Формат этого JSON варьируется и позволяет тонко управлять такими параметрами, как адаптивная трансляция по битрейту или установка специфических характеристик медиафайлов, которые будут обслуживаться. При обработке JSON-данные парсятся, и указанные медиа-параметры имеют приоритет над ранее заданными настройками для VOD-запросов, соответствующих контексту (http, server, location). Это хорошо работает в сценариях, где поведение медиа изменяется в зависимости от запроса или источника, обеспечивая гибкое и эффективное управление медиаконтентом.

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

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

server {
    listen 80;
    location /media {
        vod_media_set_override_json "{ \"bitrate\": \"1500kbps\", \"codec\": \"H264\" }";
        # Other configurations...
    }
}

Убедитесь, что формат JSON корректен; синтаксические ошибки приведут к сбою конфигурации.

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

Тщательно тестируйте изменения, так как это может привести к непредвиденному поведению мультимедиа, если JSON не будет соответствовать ожидаемым значениям.

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