on_update
Директива 'on_update' позволяет задать URL обратного вызова, который срабатывает при каждом обновлении потока.
Описание
Директива 'on_update' является частью модуля NGINX RTMP и служит настраиваемым параметром для указания HTTP-обратного вызова, который будет уведомлён о некоторых событиях потоковой передачи, таких как запуск или остановка потока. Она принимает один аргумент: URL, на который будет отправлен обратный вызов. Это облегчает интеграцию с внешними системами, которым необходимо отслеживать состояние процесса потоковой передачи в реальном времени, обеспечивая такие функции, как уведомления, логирование или удалённое управление сеансом потоковой передачи.
Когда директива включена, сервер NGINX будет отправлять HTTP-запрос на указанный URL при каждом событии обновления, связанном с RTMP-трансляцией. Как правило, для этого используется метод HTTP POST, и запрос может включать различную контекстную информацию о событии. Это позволяет внешним приложениям, таким как системы управления контентом или инструменты мониторинга, динамически реагировать на изменения состояния потока. Формат данных, отправляемых в запросе, может различаться в зависимости от реализации, но обычно он содержит идентификаторы и информацию о состоянии, относящуюся к потоку.
Эта директива особенно полезна в сценариях, связанных с автоматизацией или требующих осведомлённости о изменениях состояния системы в реальном времени, что позволяет обеспечить лучший контроль и гибкость среды потоковой передачи медиа.
Пример конфига
rtmp {
server {
listen 1935;
application live {
live on;
on_update http://example.com/stream/update;
}
}
}Убедитесь, что URL доступен для сервера NGINX и корректно обрабатывает входящие запросы.
Будьте осторожны с сетевой задержкой, так как она может повлиять на отзывчивость потока, особенно если callback включает внешние серверы.