on_publish
Директива `on_publish` в модуле NGINX RTMP позволяет указать функцию обратного вызова, которая вызывается при публикации потока.
Описание
Директива on_publish предназначена для упрощения выполнения действий над RTMP-потоком, когда пользователь публикует свой контент на сервер. Эта директива принимает один аргумент, который указывает имя функции обратного вызова, выполняемой при публикации потока.
Когда клиент публикует поток на сервер NGINX, сервер вызывает указанную функцию обратного вызова, что позволяет выполнять дополнительную обработку, логирование или проверки безопасности. Это особенно полезно для обеспечения аутентификации, логирования активности пользователей или запуска других серверных процессов в ответ на запуск потоков в эфир. Контекст использования этой директивы даёт администраторам сервера гибкость для адаптации функциональности под конкретные приложения для трансляции или требования.
Директива on_publish особенно важна в сценариях живой трансляции, где управление доступом к потокам и выполнение действий при запуске потока критически важны для поддержания упорядоченной и безопасной среды трансляции. Если в указанной функции обратного вызова произойдёт ошибка, публикация может быть отклонена, что защищает целостность службы трансляции.
Пример конфига
rtmp {
server {
listen 1935;
application live {
live on;
on_publish my_callback;
}
}
}Убедитесь, что указанная функция обратного вызова корректно определена в конфигурации или в коде сервера; в противном случае директива не будет работать как задумано.
Будьте осторожны с последствиями для производительности, если функция обратного вызова выполняет тяжёлую обработку во время публикации потока в реальном времени.