vod_apply_dynamic_mapping

The `vod_apply_dynamic_mapping` directive enables dynamic mapping of video segments for adaptive streaming.

Syntaxvod_apply_dynamic_mapping on | off;
Defaultoff
Contexthttp, server, location
Arguments1

Description

The vod_apply_dynamic_mapping directive is a configuration option used within the NGINX-based VOD Packager module that facilitates the dynamic mapping of video segments. When enabled, it allows the server to apply real-time mapping configurations that can adjust how video content is delivered based on the client's requests or the server's conditions. This is particularly useful for adaptive streaming scenarios where the content may need to change dynamically based on parameters such as bandwidth or request type.

To use this directive, only one argument is needed, which typically indicates whether dynamic mapping should be enabled or disabled (for example, 'on' or 'off'). When activated, the server begins to evaluate incoming HTTP requests for video content and, based on the specified mapping relationships in the video-on-demand (VOD) setup, delivers the requested segments accordingly. This enhances the server's flexibility, allowing it to respond to varying content delivery needs without requiring static mappings to be defined in advance.

The behavior of this directive is notably influenced by other configurations in the VOD module, such as client behaviors and the presence of adaptive bitrate streaming requirements. As such, it can be part of a broader configuration strategy aimed at optimizing performance, managing load, and improving end-user experiences. Properly integrating this directive into the server configuration ensures that video streaming is efficient and tailored to the individual client's experiences, depending on their specific needs.

Config Example

vod_apply_dynamic_mapping on;

Ensure that the mapping configuration is correctly defined; otherwise, unexpected behavior may occur.

Avoid using this directive in contexts where static mappings are expected, as this can lead to conflicts.

The directive should be used in conjunction with other VOD settings to achieve the desired results.

← Back to all directives