pckg_m3u8_subtitle_format

The pckg_m3u8_subtitle_format directive is used in the Kaltura Media Framework Common NGINX Module to determine how subtitles are formatted in master playlists (.m3u8 files) served during HLS streaming. This directive accepts a single argument that defines the subtitle format. The supported formats may typically include WebVTT or other subtitle formats optimized for HLS.

When this directive is defined within an NGINX context (http, server, or location), the specified subtitle format will be applied to any streams referenced in the playlist generated by the Kaltura framework. This allows for the flexibility of delivering subtitles in different formats depending on client requirements or compatibility. For example, using WebVTT format can provide better integration with modern web players, while other formats may be preferred for legacy systems.

Care must be taken when specifying the subtitle format; if an unsupported format is declared, NGINX will likely revert to a default behavior, possibly causing subtitle rendering issues during playback. Configuration of this directive should be done alongside other related Kaltura directives to ensure consistent behavior across all media content served by NGINX.