vod_max_metadata_size
The 'vod_max_metadata_size' directive sets the maximum allowed size for metadata in the NGINX-based VOD Packager module.
Description
The 'vod_max_metadata_size' directive is an essential configuration option in the NGINX-based VOD Packager module that helps manage video-on-demand (VOD) functionalities. It defines an upper limit on the size of metadata that can be processed during video streaming, ensuring that excessively large metadata does not disrupt the VOD packaging and delivery process. This is particularly crucial when handling various video formats and related metadata, such as codec information, subtitles, and alternate audio tracks.
When this directive is set, any metadata exceeding the specified size will be rejected, leading to potential errors or dropped metadata during streaming. This helps maintain optimal performance and prevents overload on the server handling the video requests. The size can be specified in bytes and should be tuned according to the expected metadata sizes of the video files being streamed. A well-optimized 'vod_max_metadata_size' can improve the efficiency of metadata handling and enhance the overall user experience when accessing video content.
To implement this directive correctly, an administrator must be aware of the common metadata sizes in their specific application context. Monitoring and adjusting this value may be required to align with evolving video formats or new features being integrated into the VOD infrastructure.
Config Example
http {
vod_max_metadata_size 1048576; # Set the maximum metadata size to 1MB
}Setting the value too low may lead to metadata being truncated or left out entirely, affecting playback and media quality.
If metadata is not being processed as expected, check server logs for errors that may indicate exceeded metadata size limits.