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