Динамический контент через RSS ленту (пользовательская версия)

Материал из SmartPlayer

Описание ситуации

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

Для чего это можно использовать

Такой контент хорошо подходит для нескольких форматов:

  • Вывода статичного текстового контента на устройства
  • Вывода динамического контента (бегущих дорожек) на устройства
  • Создание "контента", схожего с информационным табло и последующим вывод его на устройства

Логика работы

  1. Сначала системный администратор настраивает работу приложения пользователя через RSS.
  2. Далее необходимо чтобы пользователь в личном кабинете создал подходящий вид контента, описанного выше.
  3. Следующим этапом будет идти "Создание трансляции"
  4. Предпоследний действием будет создание расписания для трансляции
  5. Вывод нужного контента на устройства
Логика работы функционала

Принцип действия

Для начала необходимо чтобы системный администратор со стороны клиента настроил правильную работу сервера с RSS и возможность подключаться к нашему серверу через API.

После того, как, системный администратор клиента настроил работу приложения клиента с RSS, пользователь может начинать готовить контент для выведения на устройство.
Для этого в личном кабинете ему необходимо необходимо перейти в раздел "Контент" и просмотреть доступные варианты контента. Ему необходимо выбрать текстовый контент.
Кликнув на кнопку "Добавить новый текст", откроется новая страница с параметрами, которые необходимо настроить.

Путь до текстового контента

Настройка контента "Текст"

Подготовка

Расположение ID - Company

Для начала системный администратор со стороны пользователя уже должен настроить работу с помощью RSS - запроса и отправить URL, для подключения по API.
URL будет выглядеть примерно так:
https://rc-api.smartplayer.org/v2/company-rss/feed/54
В данном случае заместо последний цифры (54) в запросе идёт - Company ID. Его можно просмотреть в личном кабинете на иконку пользователя.

Работа с контентом типа "Текст"

Для начала необходимо найти раздел "Контент" и выбрать в нём подходящий тип контента. В нашем случае это текст.

Блок "Контент" в личном кабинете

Следующим шагом - пользователь должен создать новый текстовый контент по кнопке.

Текстовый контент

После нажатия кнопки "Добавить новый текст" откроется окно настроек.

Окно настроек текста

Внутри окна первое на что нужно обратить внимание, строка - "Выбрать тип источника". В этой строке выбираем вариант "URL-источник". После проведённых манипуляций вставляем URL нашего сваггера в раздел "RSS - источника" и нажимаем иконку просмотра.

Варианты источников
Swagger/сваггер (или OpenAPI) - это инструмент для создания, документирования и тестирования веб-API. Он помогает разработчикам легко понимать и работать с API, предоставляя визуальное представление и автоматически создаваемую документацию.

Далее сервер SmartPlayer распарсивает URL. Данные по распаршенной ссылку будут выглядеть примерно так:

Пример распаршенного URL


Следующим этапом необходимо выбрать нужную строку для создания из нее шаблона запроса.

Пример нужной строки для шаблона


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

  • Редактирование текста
  • Шрифт
  • Размер шрифта
  • Частота обновления информации (как часто клиентское приложение SmartPlayer будет обращаться на сервер за новыми данными)

Последний шаг - нажимаем на кнопку "Сохранить"

Создание трансляции

Следующим этапом идёт создание трансляции.
Пользователь переходит в раздел "Трансляции" и делит окно трансляции на зоны, как ему нужно. Подставляет нужный ему контент в определённому зону. Кроме текстового контента, остальной контент может быть любой.
Далее пользователь переименовывает трансляцию и сохраняет настройки.

Создание расписания

Заходим в раздел "Расписание".