meta

Директива 'meta' в модуле NGINX RTMP позволяет добавлять метаданные к мультимедийным потокам.

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

Описание

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

Для реализации этой директивы обычно требуется один аргумент — строка, представляющая тип метаданных или конкретную информацию, которую вы хотите прикрепить к потоку. Эти метаданные могут включать информацию, такую как title, artist, album, description и прочее, в зависимости от требований стримингового приложения и возможностей клиентов, получающих поток. Директива может быть размещена внутри конкретных application blocks, чтобы применяться к определённым потокам, обеспечивая тонкий контроль над тем, какие метаданные распространяются.

Важно отметить, что эффективное использование метаданных в RTMP-потоках требует, чтобы клиенты также корректно обрабатывали и отображали эти метаданные. Некоторые клиенты могут не поддерживать все типы метаданных, поэтому рекомендуется проводить тестирование на различных платформах, чтобы обеспечить совместимость и работоспособность добавленных метаданных.

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

application live {
    meta "title=My Stream";
    meta "artist=John Doe";
}

Убедитесь, что строка метаданных правильно отформатирована, поскольку у клиентов могут быть строгие правила разбора.

Не все RTMP-клиенты могут поддерживать отображение метаданных, поэтому протестируйте на разных клиентах, чтобы проверить совместимость.

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