publish_notify

Директива `publish_notify` настраивает отправку уведомлений при публикации нового потока в контексте RTMP.

Синтаксисpublish_notify URL;
По умолчаниюnone
Контекст
Аргументы1

Описание

Директива publish_notify в модуле NGINX RTMP позволяет указать URL для уведомлений при публикации нового потока. Это особенно полезно для интеграции событий стриминга с внешними системами или сервисами, позволяя выполнять такие действия, как обновление баз данных, запуск автоматических рабочих процессов или рассылка уведомлений подключённым клиентам. Директива принимает один аргумент, который является URL, на который будет отправляться уведомление при каждой публикации потока.

Когда публикуется новый RTMP-поток, сервер NGINX отправляет HTTP POST-запрос на указанный URL. В этом запросе может передаваться информация о потоке, такая как имя потока, имя приложения и другие соответствующие метаданные, что позволяет принимающему серверу корректно обработать событие. Это полезно в сценариях, где необходимы обновления в реальном времени о жизненном цикле потока, например при обслуживании большого числа пользователей или при взаимодействии с системами управления контентом, отслеживающими живые трансляции.

Для эффективного использования директивы важно убедиться, что целевой URL доступен и правильно настроен для приёма и обработки входящих POST-запросов. Кроме того, поскольку уведомления отправляются при каждой публикации потока, конечная точка должна эффективно обрабатывать эти запросы, чтобы избежать узких мест в управлении потоками.

Пример конфига

application myapp {
    live on;
    publish_notify http://example.com/notify;
}

Убедитесь, что notify URL доступен; если запрос не выполнится, он может не быть повторно отправлен.

Обеспечьте корректную обработку входящего запроса на notify URL, чтобы избежать проблем с производительностью.

Учтите, сколько уведомлений получит ваше приложение, поскольку это может повлиять на нагрузку на сервер.

← Ко всем директивам