Инструкция по работе с виджетом навигации: различия между версиями

Материал из SmartPlayer
← Предыдущая правкаСледующая правка →
Нет описания правки
Нет описания правки
Строка 1: Строка 1:
== '''Описание ситуации''' ==
== '''Описание ситуации''' ==
Данный виджет выводит на устройства информацию с расписанием занятий, при этом позволит виджету работать с необходимым фоновым контентом в рамках функционала личного кабинета SmartPlayer.
Данный виджет выводит на устройства (панели под управлением Windows OS и Linux OS) информацию о навигации внутри определенного здания. Виджет требует предварительной настройки, после которой он будет корректно работать на обозначенных выше панелях.
== '''Серверная логика''' ==
== '''Серверная логика''' ==
Серверная часть отсутствует. Данный виджет все данные для вывода получает через Excel-файл. После получения информации, обрабатывает данные и выводит их в трансляцию через функционал личного кабинета SmartPlayer.
Серверная часть отсутствует. Вся работа виджета проводится внутри личного кабинета SmartPlayer и информация выводится на устройства благодаря функционалу платформы и личного кабинета.
== '''Добавление виджета в личный кабинет''' ==
== '''Добавление виджета в личный кабинет''' ==
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip-архива.
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip-архива.
Строка 15: Строка 15:
На главной странице виджета пользователь может кликнуть по иконке в виде шестеренки, чтобы перейти в настройки виджета.
На главной странице виджета пользователь может кликнуть по иконке в виде шестеренки, чтобы перейти в настройки виджета.
[[File:Настройка_виджета_навигации.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
[[File:Настройка_виджета_навигации.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
Также, на главное странице виджета если он предварительно был настроен доступно превью настройки карты, которое включает в себя:
* карту помещения (с обозначением панели на ней) занимающая большую часть главной страницы;
[[File:Карта_помещений.png|thumb|center| Пример отображения карты помещений|800px]]
* переключатель с нумерацией этажей (если этажей больше 1), который расположен в правой верхней части главной страницы;
[[File:Переключатель_этажей.png|thumb|center| Пример отображения переключателя этажей |800px]]
* объекты фильтрации для быстрого построения маршрута (коворкинг, принтер, гардероб и прочие), которые при клике отрисуют маршрут до ближайшего объекта. Располагается под списком этажей.
[[File:Виджет_и_фильтрация.png|thumb|center| Пример отображения объектов фильтрации в виджете |800px]]
* клавиатура с ручным вводом, позволяющая искать необходимые на карте объекты. Работает на двух языках: русский и английский. Отображается в виде строки с иконкой лупы в правой нижней части экрана. По умолчанию находится в скрытом состоянии, по клику разворачивается на половину экрана настройки.
[[File:Клавиатура_виджета.png|thumb|center| Пример отображения иконки клавиатуры для поиска объектов|800px]]
== '''Кнопка «Настройки»''' ==
== '''Кнопка «Настройки»''' ==
Перейдя на страницу «Настройки» пользователь может настроить следующие параметры:
Перейдя на страницу «Настройки» пользователь может настроить следующие параметры:
Строка 28: Строка 37:
=== '''Редактора карт''' ===
=== '''Редактора карт''' ===
=== '''Редактора навигации''' ===
=== '''Редактора навигации''' ===
При нажатии на кнопку «Редактор навигации» открывается новая страница, в которой пользователь увидит:
* список этажей (если этажи были преднастроены) — отображаются добавленные этажи с описанием;
* кнопку «Добавить этаж» — кнопка, позволяющая добавить этаж в список. Заполнение параметров для этажа будет описано в следующем разделе;
* кнопка «Сохранить карты» — позволяет сохранить настроенные этажи и карты;
* кнопка «Выйти из редактора» — позволяет вернутся обратно к главному экрану без сохранения изменений.
[[File:Страница_редактора_навигации изм.png|thumb|center| Пример отображения управления этажами|800px]]
===='''Процесс настройки этажа в виджете''' ====
Если пользователь добавил новый этаж то в правой части экрана настроек виджета появится набор полей, который будут первым шагом настройки навигации. В список полей которые необходимо заполнить входят:
* название этажа — проставить числовое значение этажа;
* список кабинетов — поле для текстового ввода названия типов кабинетов доступных на этаже. Разделителем для поля является запятая (",");
* список категории комнат — поле для текстового ввода названия типов комнат доступных на этаже. Разделителем для поля является запятая (",");
* список общих категорий комнат — поле для текстового ввода названия категорий комнат доступных на этаже. Разделителем для поля является запятая (",");
{{Note|После заполнения всех полей необходимо нажать на кнопку «Далее» чтобы перейти к следующему шагу|warn}}
[[File:Поля_для_этажа.png|thumb|center| Пример отображения полей для создания этажа|800px]]
Следующим этапом будет добавление различных типов SVG-иконок отображающих помещения. При клике на любо
{{Note|После заполнения всех полей необходимо нажать на кнопку «Далее» чтобы перейти к следующему шагу. Если необходимо вернуться на предыдущий шаг нажмите на кнопку «Назад».|warn}}
[[File:Поля_для_этажа.png|thumb|center| Пример отображения страницы с загруженными SVG-иконками|800px]]
== '''Завершение настройки виджета''' ==
== '''Завершение настройки виджета''' ==
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.
Строка 33: Строка 59:
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
== '''Завершение настройки виджета''' ==
== '''Завершение настройки виджета''' ==
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» внизу экрана и еще ниже кликнуть на кнопку «Сохранить».
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» внизу экрана и еще ниже кликнуть на кнопку «Сохранить».

Версия от 16:37, 1 декабря 2025

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

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

Серверная логика

Серверная часть отсутствует. Вся работа виджета проводится внутри личного кабинета SmartPlayer и информация выводится на устройства благодаря функционалу платформы и личного кабинета.

Добавление виджета в личный кабинет

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

Пример виджета в формате .zip-архива

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

Пример отображения раздела «Контент» в личном кабинете

В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом.

Пример отображения переноса виджета в личном кабинете SmartPlayer

Главная страница виджета

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

Пример отображения главной страницы виджета

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

Пример отображения иконки для перехода в настройки виджета

Также, на главное странице виджета если он предварительно был настроен доступно превью настройки карты, которое включает в себя:

  • карту помещения (с обозначением панели на ней) занимающая большую часть главной страницы;
Пример отображения карты помещений
  • переключатель с нумерацией этажей (если этажей больше 1), который расположен в правой верхней части главной страницы;
Пример отображения переключателя этажей
  • объекты фильтрации для быстрого построения маршрута (коворкинг, принтер, гардероб и прочие), которые при клике отрисуют маршрут до ближайшего объекта. Располагается под списком этажей.
Пример отображения объектов фильтрации в виджете
  • клавиатура с ручным вводом, позволяющая искать необходимые на карте объекты. Работает на двух языках: русский и английский. Отображается в виде строки с иконкой лупы в правой нижней части экрана. По умолчанию находится в скрытом состоянии, по клику разворачивается на половину экрана настройки.
Пример отображения иконки клавиатуры для поиска объектов

Кнопка «Настройки»

Перейдя на страницу «Настройки» пользователь может настроить следующие параметры:

  • разрешение — можно выбрать разрешения для виджета. Доступно: Full HD (1920X1080) или 4K(3840X2160);
  • время сессии - прописать значение длительности рабочей сессии. Измеряется в секундах;
  • чекбокс (галочка) «Показывать навигацию прокладки маршрута» — активирует прокладку маршрута в виджете;
  • кнопка «Удалить» карту — позволяет удалить добавленную в виджет карту;
  • поле с объектами — прописать значение с для объекта. По умолчанию значение: [object Object];
Ниже будут описаны два отдельных блока настроек вынесенных в виде кнопок:
  1. Редактор карт.
  2. Редактора навигации.
Пример отображения настроек виджета навигации

Редактора карт

Редактора навигации

При нажатии на кнопку «Редактор навигации» открывается новая страница, в которой пользователь увидит:

  • список этажей (если этажи были преднастроены) — отображаются добавленные этажи с описанием;
  • кнопку «Добавить этаж» — кнопка, позволяющая добавить этаж в список. Заполнение параметров для этажа будет описано в следующем разделе;
  • кнопка «Сохранить карты» — позволяет сохранить настроенные этажи и карты;
  • кнопка «Выйти из редактора» — позволяет вернутся обратно к главному экрану без сохранения изменений.
Пример отображения управления этажами

Процесс настройки этажа в виджете

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

  • название этажа — проставить числовое значение этажа;
  • список кабинетов — поле для текстового ввода названия типов кабинетов доступных на этаже. Разделителем для поля является запятая (",");
  • список категории комнат — поле для текстового ввода названия типов комнат доступных на этаже. Разделителем для поля является запятая (",");
  • список общих категорий комнат — поле для текстового ввода названия категорий комнат доступных на этаже. Разделителем для поля является запятая (",");
После заполнения всех полей необходимо нажать на кнопку «Далее» чтобы перейти к следующему шагу
Пример отображения полей для создания этажа

Следующим этапом будет добавление различных типов SVG-иконок отображающих помещения. При клике на любо

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

Завершение настройки виджета

После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.

Пример отображения кнопки «Применить настройки»

Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.

Пример отображения кнопки «Сохранить»

Завершение настройки виджета

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

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

Загрузка и скачивание настроек

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

Пример отображения кнопок для загрузки и выгрузки настроек

Добавление настроенного виджета в трансляцию

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

Видеоинструкция

Инструкция по работе с виджетом навигации

Дополнительная информация

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

Пример отображения вкладки «Обсуждения» на wiki-странице

Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения"

Источник — https://wiki.smartplayer.org/index.php?title=Инструкция_по_работе_с_виджетом_навигации&oldid=18325