pckg_m3u8_enc_key_format
指令 `pckg_m3u8_enc_key_format` 指定 HLS 播放列表文件中加密密钥的编码格式。
Kaltura Media Framework Common NGINX Module
·
httpserverlocation
语法pckg_m3u8_enc_key_format format;
默认值none
上下文http, server, location
参数1
说明
在 Kaltura Media Framework 的 NGINX 模块中使用 pckg_m3u8_enc_key_format 指令来定义生成的 HLS (.m3u8) 播放列表文件中加密密钥的格式。该指令允许用户设置一个特定的格式,用于决定这些密钥如何表示,从而确保与各种播放环境和媒体播放器的兼容性。默认情况下,可能会根据流媒体的标准做法假定某些值,但此指令可覆盖这些默认值以满足特定用例需求。
设置此指令会影响 NGINX 生成的播放列表文件的输出,尤其是在媒体流被加密的场景中。该指令的预期值通常是描述编码格式的字符串,例如用于 AES 加密的 'aes-128'。这使用户能够根据其内容分发策略和播放兼容性实施定制的安全措施,因为 HLS 根据播放器和运行环境支持不同的加密方案。
正确使用 pckg_m3u8_enc_key_format 指令需将其放在适当的上下文中——在 NGINX 配置的 http、server 或 location 指令中。必须注意确保所选格式与将消费媒体的客户端所支持的编码方法相一致。此处配置错误可能导致启动失败或最终用户出现播放问题。
配置示例
location /videos {
pckg_m3u8_enc_key_format aes-128;
}⚠
确保指定的编码格式被将要使用 HLS playlists 的媒体播放器所支持。
⚠
使用不正确的格式可能导致播放失败或产生安全漏洞。
⚠
此指令必须在正确的上下文 (http, server, location) 中设置,才能生效。