NetUP Stream Processor является многофункциональным программно-аппаратным комплексом, предназначенным для решения задач видео-стримминга. Общий функционал можно разделить на несколько частей:

Перед тем как начать работу с NetUP Stream Processor:

1) Подключите Ethernet-кабель к порту №1 на передней панели;

2) Включите устройство в сеть электропитания.

После включения устройства подождите несколько минут, пока оно загрузится. Сейчас вам необходимо попасть в веб-интерфейс управления.

Для этого надо:

1) Иметь в этой же локальной сети персональный компьютер или мобильное устройство с веб-браузером;

2) Настроить сетевое подключение на головной станции с помощью LCD-панели;

3) Убедиться, что из данной сети доступны какие-либо источники IP-потоков для взаимодействия.

Войдите в веб-интерфейс и откройте модуль Stream Processor, с помощью которого и осуществляется приём, обработка и вещание IP-потоков. Для быстрой настройки Вам будут полезны следующие статьи:

Stream Processor снабжён LCD-панелью и кнопками управления. Вы можете использовать их для первоначальной настройки устройства, просмотра загруженности LAN-интерфейсов и процессора, изменения IP-адреса для сетевых интерфейсов.

При наличии соответствующей лицензии модуль Stream Processor позволяет загружать произвольные видео файлы и собирать из них плейлисты. Каждый плейлист вещается отдельным потоком.

Чтобы начать вещание из одного или нескольких файлов нужно:

1) Открыть вкладку Приём, в правом нижнем углу нажать Начать приём.

2) В открывшемся меню выбрать Тип источника ⇒ Media file, а также заполнить поле Имя узла (произвольно).

3) Кликните по надписи Медиа файлы, тем самым раскрыв меню загрузки и настройки.

4) Загрузите необходимые для вещания файлы поочерёдно. Они будут появляться там же в списке Загруженные медиа файлы. Для добавления файла в список воспроизведения кликните по нему и он переместится в Текущий список воспроизведения.

5) Если файл один, то вы можете нажать кнопку Сохранить. Если файлов несколько, то вы можете выполнить их сортировку с помощью перетаскивания мышью или стрелками. Так же вы можете активировать опцию воспроизводить в цикле.

6) После того, как вы сформировали и сохранили плейлист необходимо настроить его вещание.

Данная функция позволяет создавать мозаику из произвольных входных потоков:

1) Зайдите в Обработка, в правом нижнем углу нажмите кнопку Начать обработку > Мозаика.

2) Поле Разрешение определяет данный параметр для конечного выходного мозаики.

Предельное разрешение при ручной настройке зависит от выбранного кодека.

3) Выберете оптимальный размер сетки. Сетка предназначена исключительно для удобного перемещения элементов с помощью мыши. Сами элементы мозаики могут иметь произвольный размер и положение. Точные параметры размера и положения элементов можно точно задать при их добавлении с помощью полей X, Y, ширина, высота.

4) Выберете необходимый поток, затем разместите его на экране. Добавляйте потоки до тех пор, пока не достигните желаемого результата.

5) Задайте желаемые настройки обработки.

6) Нажмите кнопку Сохранить. С этого момента операция начинает выполняться и можно создать выходной поток.

Для наложения бегущей строки выполните следующие действия:

1) Откройте вкладку Обработка, выполните операцию транскодирования с потоком, на который планируете накладывать бегущую строку.

2) В верхней части окна настроек транскодирования доступна кнопка Запустить бегущую строку, нажмите её.

3) Заполните текст и выберите необходимые настройки наложения. Операция будет выполнена сразу же после нажатия кнопки Запустить.

Список опций наложения текста:

Данная функция позволяет накладывать на любой поток произвольную картинку. Наложение происходит "на лету" без подрывов или артефактов в трансляции. Применение:

1) Откройте вкладку Обработка, выполните операцию транскодирования с потоком, на который планируете накладывать графику.

2) После выполнения настройки транскодирования необходимо раскрыть меню Наложение графики, которое находится ниже.

3) Выберите оптимальный размер сетки. Она предназначена исключительно для более удобного быстрого перемещения объектов по рабочему полю с помощью мыши. Более точно редактировать размер картинки и её положение можно с помощью полей правее её превью при загрузке.

4) Выполните загрузку нужного изображения. Допускается использование нескольких изображений.

5) Разместите изображения, затем нажмите кнопку Сохранить. С этого момента операция наложения начинает работать.

Оперативно контролировать результат вы можете запустив поток из вкладки Вещание в какоим либо плеере или нажав на иконку быстрого предпросмотра:

Для наложения анимации можно использовать любые популярные видеокодеки и контейнеры, в том числе с применением альфа-канала.

Общий принцип настройки приёма потоков смотрите в разделе Быстрый старт — Как принять поток?

Данная функция предназначена для оперативного отслеживания состояния всех записываемых HLS потоков, а также оценки занимаемого ими места и просмотра временных шкал. Для запуска менеджера записи нажмите на соответствующую иконку в левом верхнем углу интерфейса.

Как только вы создаёте во вкладке Вещание любой HLS-поток (с длительностью хранения = 0 по-умолчанию), он сразу же попадает на экран менеджера записи и классифицируется как не записываемый поток. Если при создании установлена ненулевая длительность хранения, то поток классифицируется как записываемый.

Устанавливать длительность хранения уже созданных потоков можно непосредственно со страницы менеджера потоков. Для этого в правом нижнем углу нажмите кнопку Управлять записью. Открывшееся окно имеет свою внутреннюю быструю справку:

Опция применить к существующим записям позволяет задать новое время хранения для всех старых фрагментов потока. Отсчёт времени производится с даты создания конкретного фрагмента.

На странице есть две вкладки: Модули и Службы.

Модуль содержит определённый набор функций, которые обеспечивают работу одного из компонентов NetUP.tv, например, dvb-gw отвечает за работу NetUP DVB IP Streamer.
Служба – это утилита, которая отвечает за запуск или остановку модуля.

На вкладке Модули Вы можете:

После загрузки и установки нового модуля перейдите на вкладку Службы, чтобы запустить его. Нажмите соответствующую кнопку напротив службы, отвечающей за работу модуля, и подтвердите действие в открывшемся окне. Аналогичным образом Вы можете остановите работу службы, если не планируете использовать какой-то из модулей.

Перейдите на страницу, чтобы загрузить, установить или удалить прошивку.

Прошивки разных версий системы NetUP.tv могут быть не совместимы между собой.

Если необходимо вернуться к использованию прошивки, относящейся к предыдущим релизам, обратитесь за консультацией в отдел технической поддержки компании НетАП

В системе NetUP.tv предусмотрено автоматическое резервное копирование с периодичностью один раз в сутки.

Резервные копии – это архивы с настройками системы в формате tar.bz2.

Последняя автоматическая резервная копия доступна для скачивания по ссылке. Вы можете открыть или закрыть доступ к архиву, а также копировать или сбросить ссылку.

Чтобы создать или загрузить резервную копию вручную, кликните в нижнем правом углу страницы и выберите необходимое действие.

Чтобы восстановить настройки системы, выберите один из архивов, нажмите и подтвердите действие в открывшемся окне.

Перейдите на страницу, чтобы получить информацию о загруженных лицензиях (компоненты, номера, сроки действия и ограничения) и загрузить новые лицензии.

Чтобы обновить лицензию, внизу страницы кликните
В открывшемся окне укажите путь к файлам или перетащите их в окно, дождитесь окончания загрузки, и закройте окно.

Перейдите на страницу, чтобы увидеть все системы NetUP.tv. Для каждой из систем отведен отдельный блок, содержащий список служб, с которыми возможно взаимодействие. Адреса взаимодействующих служб являются ссылками.

Разверните один из блоков и кликните по иконке-карандашу напротив службы, адрес которой хотите изменить. В открывшемся окне введите адрес вручную или выберите опцию Auto detect, чтобы определить адрес автоматически, а затем нажмите Сохранить.

Перейдите на страницу, если Вы хотите:

Для каждого интерфейса, DNS и тоннеля отведена отдельная панель – разверните её, чтобы перейти к настройкам.

Страница содержит два списка правил маршрутизации: Системные и Пользовательские. Вы можете редактировать, добавлять или удалять пользовательские правила. Системные правила маршрутизации необходимы для корректной работы всей системы, поэтому их нельзя редактировать или удалить.

На странице есть две вкладки: Пользователи и Роли.

На вкладке Пользователи Вы можете:

Чтобы создать и настроить роль, перейдите на вкладку Роли.

Откройте страницу, чтобы настроить дату и время для сервера, а также выбрать часовой пояс.

В веб-интерфейсе предусмотрена возможность включить синхронизацию времени с сервером точного времени по Вашему выбору. По умолчанию дата и время синхронизируются с debian.pool.ntp.org

Если Вам необходимо предоставить сотрудникам технической поддержки компании НетАП доступ к Вашему серверу, выполните следующие действия:

Если Вы не можете подключиться к серверу NetUP по сети, используйте для подключения отладочный кабель, входящий в комплект поставки. Соедините порт на лицевой панели сервера с COM-портом компьютера с помощью отладочного кабеля, и работайте с сервером с помощью программы-терминала. В окне терминала открывается консоль Linux.

Для соединения используйте следующие параметры:

NetUP Stream Processor предназначен для обработки мультимедийных потоков и состоит из трёх узлов: входа , узла обработки и выхода.

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

Роль входа – принимать поток (INPUT), роль узла обработки – преобразовывать его (PROCESSING), роль выхода – вещать (OUTPUT).

Один вход может быть источником для нескольких узлов обработки или подключен к нескольким выходам. Один узел обработки может получать потоки из нескольких входов (например, узел типа MOSAIC) или дублировать данные в несколько выходов (например, узел типа TRANSCODER). Таким образом достигается эффективное использование ресурсов.

Все узлы имеют единый набор параметров:

Чтобы подключить узел укажите в запросе источник – feed и его параметры: id: number, node: string, select?: string, где id – номер источника (нумерация с нуля), node – идентификатор узла источника, select – правило для выбора программы в случае MPTS, по умолчанию – первая программа в порядке их объявления в PAT.

Каждый узел после старта анонсирует свой набор элементарных потоков: видео, аудио, субтитры. В случае с MPEG-TS в одном потоке может быть доступно много программ, в каждой из которых несколько элементарных потоков, таким образом, число элементарных потоков может исчисляться десятками или сотнями.

Информация об элементарных потоках динамическая — постоянно обновляется. Например, в формате MPEG-TS может меняться набор программ или набор элементарных потоков каждой программы может изменяться из-за врезки рекламы. При каждом изменении набора элементарных потоков узел анонсирует новый список, и последующие узлы реагируют на изменения.

Каждый элементарный поток имеет набор обязательных параметров:

Кроме того, доступны необязательные параметры: program, program_name, provider, provider_name, pid, codec, codec_profile, bitrate, resolution, language, frame_rate, которые в общем случае могут быть недоступны. Например, program_name и pid — это специфичные параметры MPEG-TS. При работе с другими потоками они не доступны.

Если Вы уже работали с нашим API или с аналогичными сервисами других платформ, Вы можете пропустить этот раздел.

Используйте Playground для составления и тестирования запросов. На вкладке SCHEMA Вы найдёте список операторов и относящихся к ним параметров, а на вкладке DOCS – их детальное описание.

Запросы к API делятся на три типа:

Чтобы передать входные данные с запросом, впишите их в QUERY VARIABLES в формате JSON-объекта. Объекты состоят из пар ключ: значение, где ключ является строкой, а значение является допустимым типом данных JSON (строка, число, объект, массив, логический или нулевой).

Ответы на запросы приходят в формате JSON.

Работать с API могут только авторизированные пользователи.

Если Вы используете HTTP Basic Authentication, то каждый запрос должен содержать Ваши логин, пароль и хедер
Content-Type: application/json. Например,

POST-запрос для авторизации нужно отправлять на http://<IP-адрес>/system/api/login
Запрос должен содержать:

Например,

В результате успешного выполнения POST-запроса, API вернёт JSON-объект, содержащий логин пользователя и cookies (session и session.sig).

В случае ошибки, ответ API будет содержать JSON-объект с сообщением AUTH_LOGIN_OR_PASSOWRD_INCORRECT

Впишите в запрос параметры, которые должны быть указаны в ответе для каждого потока, например:

В ответ Вы получите список всех имеющихся узлов, которые соответствуют Вашему запросу, например:

Используйте тип запроса mutation и впишите в QUERY VARIABLES значения параметров потока, например:

Пример ответа сервера:

Используйте тип запроса mutation и впишите в QUERY VARIABLES значения параметров для транскодирования, например:

Пример ответа сервера:

Используйте тип запроса mutation и впишите в QUERY VARIABLES идентификаторы потоков, которые хотите включить в мозаику, например:

Пример ответа сервера:

Чтобы добавить адаптивный поток, сначала добавьте узел типа Transcoder c вариантами потоков, которые хотите объединить в адаптивный, а затем используйте тип запроса mutation и впишите в QUERY VARIABLES данные нужных Вам потоков, например:

Пример ответа сервера: