wait_key

在 NGINX RTMP 模块中,wait_key 指令用于指定客户端在开始流媒体传输前建立连接的等待时间。

语法wait_key time;
默认值none
上下文
参数1

说明

wait_key 指令控制由 NGINX RTMP 模块管理的流媒体应用中的客户端连接行为。当流开始时,该指令允许服务器在达到指定超时之前暂停发送流数据,这有助于确保所有预期的客户端在广播前完成连接。

该指令接受一个参数,表示要等待的 milliseconds。如果设置了该指令,服务器会延迟发送流以便客户端有足够时间连接,这在预计会有多个观众同时加入的场景中特别有用。它可以防止观众在流中途加入而错过重要内容。在直播场景中尤为有利,因为观众之间的同步能提升观看体验。

该指令只能在 RTMP 应用块中使用,并会直接影响广播活动中的用户体验。它确保在流开始前所有客户端同步,但将其设置为较高值可能会导致观众等待时间过长,进而可能降低参与度。

配置示例

application live {
    live on;
    wait_key 5000;
}

将 wait_key 设置为较高的值可能会导致观众不满,尤其是在他们被延迟访问流界面时。

如果在等待时间内没有客户端连接,流仍会启动,这可能导致迟到者错过内容。

← 返回所有指令