pckg_m3u8_subtitle_format
指令 `pckg_m3u8_subtitle_format` 指定在 NGINX 服务器上由 Kaltura Media Framework 生成的 HLS 播放列表中字幕的格式。
Kaltura Media Framework Common NGINX Module
·
httpserverlocation
语法pckg_m3u8_subtitle_format format;
默认值none
上下文http, server, location
参数1
说明
指令 pckg_m3u8_subtitle_format 用于 Kaltura Media Framework Common NGINX Module 中，用以确定在 HLS 流媒体传输期间所提供的母播放列表（.m3u8 文件）中字幕的格式。该指令接受一个参数，用于定义字幕格式。支持的格式通常可能包括 WebVTT 或其他为 HLS 优化的字幕格式。
当在 NGINX 上下文（http、server 或 location）中定义此指令时，指定的字幕格式将应用于 Kaltura 框架生成的播放列表中引用的任何流。这使得可以根据客户端需求或兼容性以不同格式传递字幕。例如，使用 WebVTT 格式可以更好地与现代网页播放器集成，而对于旧有系统可能更偏好其他格式。
在指定字幕格式时必须小心；如果声明了不受支持的格式，NGINX 很可能回退到默认行为，可能导致播放期间字幕呈现问题。应与其他相关的 Kaltura 指令一起配置此指令，以确保 NGINX 提供的所有媒体内容表现一致。
配置示例
pckg_m3u8_subtitle_format WebVTT;
⚠
确保所指定的字幕格式既被媒体客户端支持，也被 NGINX 服务器配置支持。
⚠
避免在格式名称中出现拼写错误，以防回退到默认行为，而默认行为可能不支持所需的字幕显示。