on_play
NGINX RTMP 模块中的 `on_play` 指令定义了在流被播放时调用的回调函数。
NGINX RTMP module
语法on_play "callback_function";
默认值none
上下文
参数1
说明
on_play 指令用于在 RTMP 服务器的流播放事件期间设置特定的处理程序。该指令允许管理员在客户端成功开始播放流时，针对该事件运行自定义脚本或命令。定义后，该回调可用于各种用途，例如记录日志、授权，或在将流发送给客户端之前修改流参数。回调函数可以定义为接受 stream name、client ID 以及其他环境信息，从而在事件管理上提供灵活性。
on_play 指令的调用可以增强使用 NGINX 进行媒体流的应用的交互性和响应性。这意味着开发者可以基于客户端行为实现额外功能，例如分析或条件访问。但建议开发者确保在该指令中执行的任何外部命令都经过优化，因为如果处理程序执行耗时较长，可能会产生性能影响，从而导致客户端出现流延迟。
配置示例
application live {
live on;
on_play "play_callback";
}⚠
确保 callback 函数在预期的上下文中已被正确定义并可访问。
⚠
避免在 callback 中执行阻塞操作，以防止流媒体播放延迟。
⚠
检查任何身份验证或日志记录机制是否会引入显著延迟。