kmp_rtmp_out_write_meta_timeout
为在 Kaltura RTMP 输出流中写入元数据设置超时。
Kaltura Media Framework Common NGINX Module
·
streamstream server
语法kmp_rtmp_out_write_meta_timeout value;
默认值none
上下文stream, stream server
参数1
说明
指令 kmp_rtmp_out_write_meta_timeout 定义了 NGINX 在 Kaltura RTMP 输出流中等待元数据写入的时间（以秒为单位）。通过调整此超时，管理员可以控制服务器在将写入操作视为失败之前应等待的时长，这在应对网络波动或下游服务器响应缓慢时尤其有用。较短的超时有助于防止直播流出现长时间阻塞，而较长的超时则能更稳健地处理延迟，最终影响流媒体应用的响应性和性能。
该指令可以在 stream 和 stream server 两个上下文中设置，使其在不同部署场景中具有灵活性。它接受一个数值参数，用于指定以秒为单位的超时时长。当在指定的超时时间内没有写入任何元数据时，NGINX 可以根据模块的实现采取相应操作，例如记录错误或终止连接。正确配置该指令对于维护直播操作的质量和可靠性至关重要，尤其是在对延迟和数据一致性要求极高的环境中。
配置示例
stream {
server {
kmp_rtmp_out_write_meta_timeout 30;
}
}⚠
将超时时间设置得过低可能导致频繁的写入操作失败，尤其在高延迟网络中。
⚠
并非所有 RTMP 客户端或后端都能优雅地处理超时错误，这可能导致流中断。