Инструкция по работе с виджетом «Цены для АЗС»: различия между версиями
Материал из SmartPlayer
Нет описания правки |
|||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
<languages/> | |||
<translate> | |||
<!--T:1--> | |||
== '''Описание ситуации''' == | == '''Описание ситуации''' == | ||
Данный виджет | Данный виджет позволяет пользователям выводить на устройства информацию о стоимости определенных типов топлива. Приведенная ниже инструкция объясняет как, работает виджет и помогает настроить его работу внутри платформы SmartPlayer. | ||
== '''Серверная логика''' == | == '''Серверная логика''' == | ||
Данный виджет все данные получает напрямую от сервера заказчика. После получения обрабатывает и выводит | Данный виджет, все данные получает напрямую от сервера заказчика. После получения обрабатывает данные и выводит их в трансляцию с помощью личного кабинета SmartPlayer. | ||
== '''Добавление виджета в личный кабинет''' == | == '''Добавление виджета в личный кабинет''' == | ||
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip-архива. | Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip-архива. | ||
| Строка 9: | Строка 11: | ||
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент». | После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент». | ||
[[File:Раздел_контент_личного_кабиента.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]] | [[File:Раздел_контент_личного_кабиента.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]] | ||
В разделе «Контент» необходимо | В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом. | ||
[[File:Цены_на_топливо.png|thumb|center| Пример отображения переноса виджета в личном кабинете SmartPlayer|800px]] | [[File:Цены_на_топливо.png|thumb|center| Пример отображения переноса виджета в личном кабинете SmartPlayer|800px]] | ||
== '''Настройка виджета''' == | == '''Настройка виджета''' == | ||
| Строка 19: | Строка 21: | ||
[[File:Кнопки_настроек_топливо.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]] | [[File:Кнопки_настроек_топливо.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]] | ||
== '''Кнопка "API"''' == | == '''Кнопка "API"''' == | ||
Кликнув на кнопку "API" пользователю откроется модальное окно с информацией о ресурсах, которые позволяют стабильно работать | Кликнув на кнопку "API" пользователю откроется модальное окно с информацией о ресурсах, которые позволяют виджету стабильно работать. В разделе также есть общее описание о его необходимости и принципах работы. | ||
[[File:Данные_в_модальном_окне.png|thumb|center| Пример отображения информации в модальном окне |800px]] | [[File:Данные_в_модальном_окне.png|thumb|center| Пример отображения информации в модальном окне |800px]] | ||
Основными параметрами для ресурсов являются: | Основными параметрами для ресурсов являются: | ||
| Строка 26: | Строка 28: | ||
* требует авторизации — информация об обязательности авторизации; | * требует авторизации — информация об обязательности авторизации; | ||
* адрес сервера — URL-адрес сервера, с которого берутся данные; | * адрес сервера — URL-адрес сервера, с которого берутся данные; | ||
* адрес API — отображается название JSON-файла | * адрес API — отображается название JSON-файла в котором присутствует информация об API и ценах; | ||
* кнопка «Проверить соединение» — при нажатии проводит проверку соединения и отображает вывод с указанием числового статуса. | * кнопка «Проверить соединение» — при нажатии проводит проверку соединения и отображает вывод с указанием числового статуса. | ||
Закрыть данное окно можно по стандартной иконке в правом верхнем углу. | Закрыть данное окно можно по стандартной иконке в правом верхнем углу. | ||
== '''Кнопка «Настройки»''' == | == '''Кнопка «Настройки»''' == | ||
После открытия страницы с настройками пользователю откроется страница которую можно разделить на два блока параметров: | После открытия страницы с настройками пользователю откроется страница, которую можно разделить на два блока параметров: | ||
# Общие настройки виджета. | # Общие настройки виджета. | ||
# Настройки анимации для виджета. | # Настройки анимации для виджета. | ||
| Строка 36: | Строка 38: | ||
=== '''Общие настройки виджета''' === | === '''Общие настройки виджета''' === | ||
К общим настройкам виджета можно отнести следующие параметры: | К общим настройкам виджета можно отнести следующие параметры: | ||
* выбор языка — | * выбор языка — выбрать доступный вариант из списка: русский, английский, испанский, португальский; | ||
* поворот виджета — выбрать из списка значение для поворота виджета при отображении (90 и 270 градусов); | * поворот виджета — выбрать из списка значение для поворота виджета при отображении (90 и 270 градусов); | ||
* адрес прокси-сервера | * адрес прокси-сервера — указать URL-ссылку для прокси-сервера; | ||
* чекбокс «Использовать прокси» — включает/отключает использование прокси сервера для виджета; | * чекбокс «Использовать прокси» — включает/отключает использование прокси сервера для виджета; | ||
* для каких позиций ДТ отображать 'экто - зима' — введите значения | * для каких позиций ДТ отображать 'экто-зима' — введите значения позиций (начинайте с 0 и ставьте разделителем ","); | ||
* размер шрифта типа топлива — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка; | * размер шрифта типа топлива — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка; | ||
* размер иконок — прописать значение размера иконок (в пикселях) или настроить с помощью ползунка; | * размер иконок — прописать значение размера иконок (в пикселях) или настроить с помощью ползунка; | ||
* размер шрифта цен — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка; | * размер шрифта цен — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка; | ||
* отступы между строками — прописать значение для отступа (считается в пикселях); | * отступы между строками — прописать значение для отступа (считается в пикселях); | ||
* цвет шрифта — палитра позволяющая создать индивидуальный цвет для шрифта; | * цвет шрифта — палитра, позволяющая создать индивидуальный цвет для шрифта; | ||
* насыщенность шрифта — выберите один вариант начертания из списка: тонкое, нормальное, полужирное, жирное; | * насыщенность шрифта — выберите один вариант начертания из списка: тонкое, нормальное, полужирное, жирное; | ||
* чекбокс «Форматировать значения без нуля на конце» — включает/отключает форматирование нецелых значений с нулём на конце; | * чекбокс «Форматировать значения без нуля на конце» — включает/отключает форматирование нецелых значений с нулём на конце; | ||
| Строка 55: | Строка 57: | ||
* частота обновления данных — указать значения для промежутка обновления данных (в секундах); | * частота обновления данных — указать значения для промежутка обновления данных (в секундах); | ||
* использовать хранилище клиентского приложения — включает/отключает использование клиентского приложения (применимо только к устройствам на ОС Windows, Linux, Raspberry); | * использовать хранилище клиентского приложения — включает/отключает использование клиентского приложения (применимо только к устройствам на ОС Windows, Linux, Raspberry); | ||
* видео — позволяет выбрать видео из личного | * видео — позволяет выбрать видео из личного кабинета, которое будет проигрываться на фоне цен; | ||
* идентификатор видео — поле, которое нельзя настроить. Автоматически определяет идентификатор выбранного видео из личного кабинета. | * идентификатор видео — поле, которое нельзя настроить. Автоматически определяет идентификатор выбранного видео из личного кабинета. | ||
[[File:Общие_настройки_топлива.png|thumb|center| Пример отображения списка с общими настройками виджета|800px]] | [[File:Общие_настройки_топлива.png|thumb|center| Пример отображения списка с общими настройками виджета|800px]] | ||
=== '''Настройки анимации для виджета''' === | === '''Настройки анимации для виджета''' === | ||
Настройки анимации виджета идут отдельным блоком и расположены в правой части экрана. Все анимации разделены на шаги (максимальное количество - 6). Каждый шаг включает в себя следующие параметры: | Настройки анимации виджета идут отдельным блоком и расположены в правой части экрана. Все анимации разделены на шаги (максимальное количество - 6). Каждый шаг включает в себя следующие параметры: | ||
* направление анимации — выбрать один из доступных вариантов из списка: слева направо, справа налево, снизу вверх, сверху вниз; | * направление анимации — выбрать один из доступных вариантов из списка: слева направо, справа налево, снизу вверх, сверху вниз; | ||
* скорость анимации — прописать скорость анимации (в секундах); | * скорость анимации — прописать скорость анимации (в секундах); | ||
* время срабатывания анимации — прописать | * время срабатывания анимации — прописать интервал, через который должна сработать анимация (в секундах). | ||
[[File:Блок_настроек_анимации.png|thumb|center| Пример отображения списка с настройками для анимаций|800px]] | [[File:Блок_настроек_анимации.png|thumb|center| Пример отображения списка с настройками для анимаций|800px]] | ||
== '''Завершение настройки виджета''' == | == '''Завершение настройки виджета''' == | ||
| Строка 72: | Строка 73: | ||
[[File:Скачать_и_загрузить_настройки_топлива.png|thumb|center| Пример отображения кнопок для загрузки и выгрузки настроек|800px]] | [[File:Скачать_и_загрузить_настройки_топлива.png|thumb|center| Пример отображения кнопок для загрузки и выгрузки настроек|800px]] | ||
== '''Добавление настроенного виджета в трансляцию''' == | == '''Добавление настроенного виджета в трансляцию''' == | ||
Чтобы создать трансляцию с виджетом необходимо перейти в раздел «Трансляция» личного кабинета и найти категорию «Создать». | Чтобы создать трансляцию с виджетом, необходимо перейти в раздел «Трансляция» личного кабинета и найти категорию «Создать». | ||
[[File:Создание_транлсяций.png|thumb|center| Пример отображения раздела «Трансляция» и категории «Создать» в личном кабинете.|800px]] | [[File:Создание_транлсяций.png|thumb|center| Пример отображения раздела «Трансляция» и категории «Создать» в личном кабинете.|800px]] | ||
На открывшейся странице необходимо найти иконку «Добавить зону» и | На открывшейся странице необходимо найти иконку «Добавить зону» и определить подходящую зону. По клику на этой зоне откроются настройки в которых необходимо указать требуемые размеры — ширину и высоту. Оба параметра необходимо указать в пикселях и нажать на кнопку «Сохранить». | ||
{{Note|Если виджет используется для | {{Note|Если виджет используется для двухсторонней стелы АЗС необходимо указать общую ширину для двух экранов.|warn}} | ||
[[File:Параметры_для_настрйоки.png|thumb|center| Пример отображения настроек зоны|800px]] | [[File:Параметры_для_настрйоки.png|thumb|center| Пример отображения настроек зоны|800px]] | ||
Выбрать | Выбрать нужный контент (например видео) и перенести в необходимую зону и также перенести в эту же зону виджет. В нижней части экрана отобразится плейлист для зоны. | ||
[[File:Контент_в_плейлисте.png|thumb|center| Пример отображения контента в плейлисте|800px]] | [[File:Контент_в_плейлисте.png|thumb|center| Пример отображения контента в плейлисте|800px]] | ||
В | В этом листе необходимо перетянуть контент/виджет так, чтобы они стартовали одинаково. | ||
[[File:Выравнивание старта.png|thumb|center| Пример отображения настройки контента для равного старта|800px]] | [[File:Выравнивание старта.png|thumb|center| Пример отображения настройки контента для равного старта|800px]] | ||
Далее с помощью клика по контенту копируем продолжительность и вставляем скопированное значение в параметр продолжительности в виджете, тем самым уравнивая длительность проигрывания его с контентом. | Далее с помощью клика по контенту копируем продолжительность и вставляем скопированное значение в параметр продолжительности в виджете, тем самым уравнивая длительность проигрывания его с контентом. | ||
[[File:Настройка_продолжительности.png|thumb|center| Пример отображения параметра | [[File:Настройка_продолжительности.png|thumb|center| Пример отображения параметра продолжительностьв|800px]] | ||
== '''Добавление настроенного виджета в трансляцию''' == | == '''Добавление настроенного виджета в трансляцию''' == | ||
Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить в качестве контента данный виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wiki SmartPlayer: | Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить в качестве контента данный виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wiki SmartPlayer: | ||
| Строка 90: | Строка 91: | ||
* [[Раздел "Расписание"]] | * [[Раздел "Расписание"]] | ||
== '''Видеоинструкция''' == | == '''Видеоинструкция''' == | ||
[https://vk.com/video- | [https://vk.com/video-227547238_456239101 Инструкция по работе с виджетом «Цены для АЗС»] | ||
== '''Дополнительная информация''' == | == '''Дополнительная информация''' == | ||
Если данная статья не помогает использовать функционал по назначению или после её прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы. | Если данная статья не помогает использовать функционал по назначению или после её прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы. | ||
[[File:Обсуждение_цены_топлива.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]] | [[File:Обсуждение_цены_топлива.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]] | ||
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | ||
</translate> | |||
Текущая версия от 10:18, 13 ноября 2025
Описание ситуации
Данный виджет позволяет пользователям выводить на устройства информацию о стоимости определенных типов топлива. Приведенная ниже инструкция объясняет как, работает виджет и помогает настроить его работу внутри платформы SmartPlayer.
Серверная логика
Данный виджет, все данные получает напрямую от сервера заказчика. После получения обрабатывает данные и выводит их в трансляцию с помощью личного кабинета SmartPlayer.
Добавление виджета в личный кабинет
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip-архива.
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент».
В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом.
Настройка виджета
После переноса виджета для первичной настройки пользователю необходимо дважды кликнуть по иконке виджета. Данное действие перенесет его на главную страницу.
На главной странице виджета пользователю доступно две кнопки:
- Кнопка "API".
- Кнопка «Настройки»
Кнопка "API"
Кликнув на кнопку "API" пользователю откроется модальное окно с информацией о ресурсах, которые позволяют виджету стабильно работать. В разделе также есть общее описание о его необходимости и принципах работы.
Основными параметрами для ресурсов являются:
- имя — указано имя ресурса;
- метод — используемый тип метода (GET);
- требует авторизации — информация об обязательности авторизации;
- адрес сервера — URL-адрес сервера, с которого берутся данные;
- адрес API — отображается название JSON-файла в котором присутствует информация об API и ценах;
- кнопка «Проверить соединение» — при нажатии проводит проверку соединения и отображает вывод с указанием числового статуса.
Закрыть данное окно можно по стандартной иконке в правом верхнем углу.
Кнопка «Настройки»
После открытия страницы с настройками пользователю откроется страница, которую можно разделить на два блока параметров:
- Общие настройки виджета.
- Настройки анимации для виджета.
Общие настройки виджета
К общим настройкам виджета можно отнести следующие параметры:
- выбор языка — выбрать доступный вариант из списка: русский, английский, испанский, португальский;
- поворот виджета — выбрать из списка значение для поворота виджета при отображении (90 и 270 градусов);
- адрес прокси-сервера — указать URL-ссылку для прокси-сервера;
- чекбокс «Использовать прокси» — включает/отключает использование прокси сервера для виджета;
- для каких позиций ДТ отображать 'экто-зима' — введите значения позиций (начинайте с 0 и ставьте разделителем ",");
- размер шрифта типа топлива — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка;
- размер иконок — прописать значение размера иконок (в пикселях) или настроить с помощью ползунка;
- размер шрифта цен — прописать значение для шрифта (в пикселях) или настроить с помощью ползунка;
- отступы между строками — прописать значение для отступа (считается в пикселях);
- цвет шрифта — палитра, позволяющая создать индивидуальный цвет для шрифта;
- насыщенность шрифта — выберите один вариант начертания из списка: тонкое, нормальное, полужирное, жирное;
- чекбокс «Форматировать значения без нуля на конце» — включает/отключает форматирование нецелых значений с нулём на конце;
- чекбокс «Дублировать цены» — включает/отключает дублирование цен;
- чекбокс «Фильтровать одинаковые значения» — включает/отключает фильтрацию по идентичным значениям;
- цвет отображаемых иконок — выбрать один из доступных цветов для иконок: белый или чёрный;
- полный путь в API получения цен — прописывается полноценная URL-ссылка со значением идентификатора (идентификатор последнее числовое значение);
- частота обновления данных — указать значения для промежутка обновления данных (в секундах);
- использовать хранилище клиентского приложения — включает/отключает использование клиентского приложения (применимо только к устройствам на ОС Windows, Linux, Raspberry);
- видео — позволяет выбрать видео из личного кабинета, которое будет проигрываться на фоне цен;
- идентификатор видео — поле, которое нельзя настроить. Автоматически определяет идентификатор выбранного видео из личного кабинета.
Настройки анимации для виджета
Настройки анимации виджета идут отдельным блоком и расположены в правой части экрана. Все анимации разделены на шаги (максимальное количество - 6). Каждый шаг включает в себя следующие параметры:
- направление анимации — выбрать один из доступных вариантов из списка: слева направо, справа налево, снизу вверх, сверху вниз;
- скорость анимации — прописать скорость анимации (в секундах);
- время срабатывания анимации — прописать интервал, через который должна сработать анимация (в секундах).
Завершение настройки виджета
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» внизу экрана и еще ниже кликнуть на кнопку «Сохранить».
Загрузка и скачивание настроек
В процессе взаимодействия с настройками виджета пользователь может загрузить или выгрузить настройки виджета. Каждое из указанных действий работает с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в виджете снизу по центру.
Добавление настроенного виджета в трансляцию
Чтобы создать трансляцию с виджетом, необходимо перейти в раздел «Трансляция» личного кабинета и найти категорию «Создать».
На открывшейся странице необходимо найти иконку «Добавить зону» и определить подходящую зону. По клику на этой зоне откроются настройки в которых необходимо указать требуемые размеры — ширину и высоту. Оба параметра необходимо указать в пикселях и нажать на кнопку «Сохранить».
Если виджет используется для двухсторонней стелы АЗС необходимо указать общую ширину для двух экранов.
Выбрать нужный контент (например видео) и перенести в необходимую зону и также перенести в эту же зону виджет. В нижней части экрана отобразится плейлист для зоны.
В этом листе необходимо перетянуть контент/виджет так, чтобы они стартовали одинаково.
Далее с помощью клика по контенту копируем продолжительность и вставляем скопированное значение в параметр продолжительности в виджете, тем самым уравнивая длительность проигрывания его с контентом.
Добавление настроенного виджета в трансляцию
Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить в качестве контента данный виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wiki SmartPlayer:
Видеоинструкция
Инструкция по работе с виджетом «Цены для АЗС»
Дополнительная информация
Если данная статья не помогает использовать функционал по назначению или после её прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы.
Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения"
