Smarty

  1. Домой
  2. Документы
  3. Smarty
  4. Руководство по панели управления Smarty
  5. Виджеты шаблона Futuristic

Виджеты шаблона Futuristic

Отображение виджетов на главном экране

Для того, чтобы виджеты появились на главном экране шаблона Futuristic, необходимо в основных параметрах виджета установить галочку напротив пункта «Показывать приложение в главном меню». В противном случае виджет будет доступен в разделе «Сервисы», либо вовсе отсутствовать.

Блок «Основные параметры виджета». Пункт, отвечающий за отображение виджета на главном экране находится в конце списка параметров.

Список виджетов, которые будут доступны в разделе «Сервисы», если параметр «Показывать приложение в главном меню» отключен:

  • Тест скорости
  • Новости
  • Оплата по QR
  • Поиск

Виджет «Тест скорости»

Измерение скорости основано на данных о скачивании изображения с удаленного сервера, поэтому алгоритм настройки этого виджета включает в себя следующие шаги:

  1. На все серверы, до которых необходимо измерять скорость, нужно положить данное изображение.
  2. В панели администрирования Smarty в разделе «Каталог приложений» создать новое приложение с полями:
    Название: любое, оно будет отображаться в интерфейсе
    Системное название: SpeedTestWidget
    Тип: Виджет
    URL / Название / ID приложения: /templates/futuristic/default/apps/speedtest-widget/speedtest.widget.js
  3. Для каждого сервера в блоке «Дополнительные атрибуты» нужно прописать следующие параметры:
  • server__0__name: название сервера для отображения в шаблоне
  • server__0__url: адрес до картинки на этом сервере, например: http://example.com/microimpuls.png (мы подобрали оптимальный размер изображения для измерения скорости)
  • server__0__size: размер картинки в байтах, для предоставляемой нами картинки это 16115141.

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

Дополнительные атрибуты виджета «Тест скорости»

Для показа виджета в мобильном приложении необходимо добавить опцию show_speed_test со значением true на странице «Настройки STB и приложений» в секции «Конфигурация портала и приложений».

Виджет «Телеканал»

Виджет «Телеканал» на главном экране виджета

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

  1. В панели администрирования Smarty в разделе «Каталог приложений» создать новое приложение с полями:
    Название: любое
    Системное название: TVChannelWidget
    Тип: Виджет
    URL / Название / ID приложения: /templates/futuristic/default/apps/tvchannel-widget/tvchannel.widget.js
  2. Для каждого виджета в блоке «Дополнительные атрибуты» нужно прописать следующие параметры:
  • number: номер канала по порядку в Smarty
  • id: id канала в Smarty
  • image_url: URL картинки, которая будет отображаться вместо превью канала (необязательный параметр)

Примечание: у параметров виджета действуют следующие приоритеты:
* если задан id канала, то будет отображаться канал, соответствующий данному id, даже если задан параметр number;
* если задан number, то будет отображаться канал, соответствующий номеру канала.

Виджет «Прогноз погоды»

Виджет «Прогноз погоды» на главном экране

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

Меню «Выбор города» доступное по нажатию на виджет

Алгоритм создания виджета:

  1. Настроить конфиг-файл Smarty:
    Для того, чтобы виджет «Прогноз погоды» заработал, необходимо указать источник информации о погоде с помощью параметра WEATHER_DEFAULT_BACKEND. Подробнее об этом параметре (а также других параметрах виджета «Прогноз погоды») можно узнать в разделе документации «Конфигурация и обслуживание Smarty» — «Системные параметры» — блок «Настройка виджетов и внешних приложений».
  2. Перезагрузить uwsgi, чтобы настройки вступили в силу;
  3. В панели администрирования Smarty в разделе «Каталог приложений» создать новое приложение с полями:
    Название: любое
    Системное название: WeatherWidget
    Тип: Виджет
    URL / Название / ID приложения: /templates/futuristic/default/apps/weather-widget/weather.widget.js
  4. Прописать параметры в блоке «Дополнительные атрибуты»:
  • city__NUM__name: имя города
  • city__NUM__id: идентификатор города в Smarty
  • city__NUM__ext_id: идентификатор города в источнике погоды (может быть задан вместо city__NUM__id)
  • show_current_city_name: 1 — показать название города, 0 — не показывать название города
  • auto_detect_current_city_name: 1 — для устройства будет автоматически определяться город (с помощью геолокации), 0 — прогноз погоды будет отображаться для города по умолчанию

Внимание! Значение параметра NUM должно начинаться с «0».

Дополнительные атрибуты виджета «Прогноз погоды»

Виджет «Курс валюты»

виджет «Курс валюты» на главном экране

Виджет «Курс валюты» добавляет на главный экран информацию об актуальном курсе валюты по отношению к двум другим валютам. Для того, чтобы настроить данный виджет, нужно выполнить следующий алгоритм действий:

  1. Настроить конфиг-файл Smarty:
    Прежде чем перейти к конфигурации виджета, необходимо определить, какие валюты будут использоваться для отображения курса в виджете. Для этого в конфиг-файле Smarty используются следующие параметры:
    TVMIDDLEWARE_EXCHANGE_WIDGET_COUNTRY_CODE — код страны, в зависимости от которого будет выбран источник данных для курса валют;
    TVMIDDLEWARE_EXCHANGE_WIDGET_FIRST_CURRENCY — первая валюта в курсе валют;
    TVMIDDLEWARE_EXCHANGE_WIDGET_SECOND_CURRENCY — вторая валюта в курсе валют.
    Внимание! Подробнее о параметрах виджета «Курс валюты» можно узнать в разделе документации «Конфигурация и обслуживание Smarty» — «Системные параметры» — блок «Настройка виджетов и внешних приложений».
  2. Перезагрузить uwsgi, чтобы настройки конфигурации Smarty вступили в силу;
  3. В панели администрирования Smarty в разделе «Каталог приложений» создать новое приложение с полями:
    Название: любое
    Системное название: ExchangeWidget
    Тип: Виджет
    URL / Название / ID приложения: /templates/futuristic/default/apps/exchange-widget/exchange.widget.js

Виджет «Новости»

Виджет «Новости» на главном экране

Виджет «Новости» добавляет на главный экран новостную RSS-ленту из источника, указанного в настройках виджета. По нажатию на виджет открывается список новостей, доступных на данный момент в ленте:

Список заголовков, доступных по нажатию на виджет «Новости»

По нажатию на какой-либо заголовок, можно ознакомиться с полным текстом новости. При желании, можно переключиться на следующую, либо предыдущую новость, не покидая данного экрана (кнопки «Предыдущая новость» и «Следующая новость»):

Полный текст новости

Алгоритм настройки виджета:

  1. Настроить конфиг-файл Smarty (опционально):
    TVMIDDLEWARE_RSS_WIDGET_CACHE_TIMEOUT — время в секундах, на которое необходимо кешировать результат запроса RSS-ленты;
    TVMIDDLEWARE_RSS_WIDGET_REQUEST_TIMEOUT — время в секундах, в течение которого ожидается ответ от внешнего сервиса новостей;
    Внимание! Подробнее о параметрах виджета «Новости» можно узнать в разделе документации «Конфигурация и обслуживание Smarty» — «Системные параметры» — блок «Настройка виджетов и внешних приложений».
  2. Если менялась конфигурация Smarty — перезагрузить uwsgi, чтобы настройки конфигурации вступили в силу;
  3. В панели администрирования Smarty в разделе «Каталог приложений» создать новое приложение с полями:
    Название: любое
    Системное название: NewsWidget
    Тип: Виджет
    URL / Название / ID приложения: /templates/futuristic/default/apps/news-widget/news.widget.js
  4. Прописать в блоке «Дополнительные атрибуты» следующий параметр:
    rss_url — адрес RSS-ленты

Виджет «Оплата по QR-коду»

Виджет «Оплата по QR-коду» на главном экране

Виджет «Оплата по QR» добавляет на главный экран портала кнопку оплаты. По нажатию на кнопку открывается меню, где можно выбрать способ оплаты:

Меню «Варианты оплаты»
  1. Оплатить с экрана телевизора — стандартный вариант оплаты, доступный также в меню «Мой профиль» — «Оплата». При нажатии на него открывается форма платежной системы, заданной в Smarty;
  2. Оплатить по QR-коду со смартфона — открывается экран «Оплата по QR-коду», где будет сформирован QR-код:
экран «Оплата по QR-коду»

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

Параметры виджета:
Название: любое
Системное название: PaymentWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/payment-widget/payment.widget.js

Виджет «Поиск»

Виджет «Поиск» на главном экране

Виджет «Поиск» добавляет кнопку поиска на главный экран шаблона. Данный виджет упрощает доступ к кнопке поиска — при наличии этой кнопки можно осуществить поиск канала/телепередачи/фильма не открывая экран «Телевидение» или экран «Видеотека».

Параметры виджета:
Название: любое
Системное название: SearchWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/search-widget/search.widget.js

Виджет «Баннер»

Виджет «Баннер» на главном экране

Виджет «Баннер» добавляет кнопку с изображением, ссылка на которое указана в блоке «Дополнительные атрибуты». По нажатию на кнопку на экране появляется баннер, ссылка на который также указывается в настройках виджета.

Баннер, открывающийся по нажатию на кнопку виджета

Параметры виджета:
Название: любое
Системное название: PromoImageWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/promo-image-widget/promo.image.widget.js

Дополнительные атрибуты виджета:

  • image_url: ссылка на изображение виджета (именно это изображение будет отображаться на кнопке виджета в главном меню). Изображение должно соответствовать размеру кнопки виджета (по умолчанию 258х168);
  • big_image_url: баннер, который будет появляться при нажатии на кнопку виджета. Изображение должно соответствовать размеру экрана портала (по умолчанию 1280х720).

Внимание! Данный виджет поддерживает работу только с абсолютным типом ссылок.

Виджет «Баннер-ссылка»

Виджет «Баннер-ссылка» по принципу работы похож на виджет «Баннер». Единственное его различие заключается в том, что вместо баннера, который появляется на экране по нажатию на кнопку виджета, будет осуществляться переход по ссылке, которая будет указана в блоке «Дополнительные атрибуты» виджета.

Параметры виджета:
Название: любое
Системное название: LinkImageWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/link-image-widget/link.image.widget.js

Дополнительные атрибуты виджета:

  • image_url: ссылка на изображение виджета (именно это изображение будет отображаться на кнопке виджета в главном меню). Изображение должно соответствовать размеру кнопки виджета (по умолчанию 258х168);
  • link_url: адрес ссылки, которая будет открываться по нажатию на кнопку виджета.

Внимание! Данный виджет поддерживает работу только с абсолютным типом ссылок.

Виджет «ТВ премьеры»

Виджет «ТВ премьеры» на главном экране

Данный виджет предоставляет доступ к списку ТВ премьер. По нажатию на виджет открывается список актуальных ТВ премьер.

Список премьер, открывающийся по нажатию на виджет «ТВ премьеры»

Внимание! Чтобы список был не пустым, в Smarty должны быть доступны ТВ-премьеры.

Параметры виджета:
Название: любое (будет отображаться как название виджета в портале)
Системное название: PremieresWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/premieres-widget/premieres.widget.js

Виджет «Промо канала»

Виджет «Промо канала» на главном экране

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

Параметры виджета:
Название: любое
Системное название: PromoStreamWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/promo-stream-widget/promo.stream.widget.js

Дополнительные атрибуты виджета:

  • items__0__preview_url: ссылка на изображение виджета (именно это изображение будет отображаться на кнопке виджета в главном меню). Изображение должно соответствовать размеру кнопки виджета (по умолчанию 258х168);
  • items__0__trailer_url: ссылка на поток, который будет запускаться при нажатии на кнопку виджета.

Внимание! Данный виджет поддерживает работу только с абсолютным типом ссылок.

Виджет «Промо фильма»

Виджет «Промо фильма» на главном экране

Виджет промо фильма добавляет на главный экран кнопку с превью-изображением фильма. При нажатии на данный виджет воспроизводится трейлер фильма. Если в момент просмотра трейлера нажать кнопку «ОК» (или Enter) еще раз, то осуществляется переход к описанию фильма.

Описание фильма

Параметры виджета:
Название: любое
Системное название: PromoVodWidget
Тип: Виджет
URL / Название / ID приложения: /templates/futuristic/default/apps/promo-vod-widget/promo.vod.widget.js

Дополнительные атрибуты виджета:

  • items__NUM__id: идентификатор фильма в Smarty;
  • items__NUM__trailer_url: ссылка на поток, который будет запускаться при нажатии на кнопку виджета;
  • items__NUM__preview_url: ссылка на превью-изображение, которое будет отображаться на кнопке виджета. Изображение должно соответствовать размеру кнопки виджета (по умолчанию 258х168);
  • NUM — номер объекта, который будет отображаться в портале (нумерация идет по порядку, начиная с 0. Пример: 0,1,2,3…..15).
  • timer — количество секунд для ротации фильмов

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

Внимание! Для того, чтобы при просмотре трейлера по нажатию кнопки «ОК» открывалось окно с описанием фильма, необходимо, чтобы у абонента был доступ к данному контенту (либо с помощью тарифа «Доступ к контенту», либо с помощью тарифа «Отображение контента без возможности запуска»). В противном случае клиент получит ошибку.