on_connect
NGINX RTMP 模块中的 'on_connect' 指令允许指定在客户端连接到流媒体服务器时要执行的回调函数。
NGINX RTMP module
语法on_connect handler_function;
默认值none
上下文
参数1
说明
NGINX RTMP 模块中使用 'on_connect' 指令来定义每当新的客户端与 RTMP 应用建立连接时要执行的自定义行为或操作。这对于管理连接状态、记录连接详情或在连接时实现任何自定义认证机制特别有用。该指令接受单个参数,通常是将要执行的处理函数的名称。\n\n当客户端连接时,NGINX 会调用 'on_connect' 中指定的函数,允许开发者扩展其 RTMP 应用的功能。定义的函数可以利用 NGINX 的 APIs 访问连接客户端的信息、操作流并执行必要的操作,例如检查客户端权限或发送通知。必须确保回调函数被设计为高效地处理连接,以维持服务器的性能和响应性。\n\n因为该指令在连接层面上运行,它在任何流会话开始之前被调用,因此适合用于初步的连接检查。开发者应注意如果函数涉及繁重的处理或长时间运行的任务可能带来的性能影响,因为这可能会阻塞新连接的接受。
配置示例
application live {
on_connect my_connect_handler;
}⚠
确保在你的 NGINX 配置中正确实现回调函数,以避免连接失败。
⚠
注意回调函数中资源密集型的任务;繁重的处理可能会降低连接性能。
⚠
始终彻底测试处理函数,以避免在客户端连接时出现意外行为。