pckg_mpd_subtitle_format

The `pckg_mpd_subtitle_format` directive specifies the format for subtitles when packaging MPEG-DASH outputs.

Syntaxpckg_mpd_subtitle_format format_string;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The pckg_mpd_subtitle_format directive in the Kaltura Media Framework allows users to define the format of subtitles to be packaged in MPEG-DASH outputs. This directive can be utilized in contexts such as http, server, and location, thus providing flexibility in configuring subtitle outputs as per the specific requirements of the media application. By setting this directive, you can ensure compatibility with various subtitle rendering systems utilized by clients, enhancing the accessibility and user experience of video content.

When this directive is set, it requires a single argument that indicates the desired subtitle format. The processing of media packaging respects this format, allowing MPEG-DASH manifest files to include appropriate references to subtitle tracks. This function is crucial when working with multiple subtitle formats, enabling seamless switching and proper rendering of text subtitles across different playback environments. Correct usage of this directive etches out a clear strategy for media operators who need to provide multilingual or diverse subtitle support for their viewers.

It is important to note that when changing the subtitle format, developers should be aware of the compatibility of that format with video players. Many players support WebVTT, while others might embrace alternatives like TTML or SRT. Therefore, the chosen format should also cater to the playback capabilities of the intended audience's devices. Misconfigurations or unsupported format selections could lead to content accessibility issues or player errors in subtitle processing.

Config Example

location /stream {
    pckg_mpd_subtitle_format "webvtt";
}

Ensure that the specified subtitle format is supported by the media player's rendering capabilities.

Using an unsupported subtitle format may lead to playback failures or unsatisfactory user experience.

Changing the subtitle format might require media repackaging to ensure compatibility. Be cautious with existing streams.

← Back to all directives