Инструкция для настройки виджета навигации (ver. 2.0): различия между версиями

Материал из SmartPlayer
Нет описания правки
Нет описания правки
Строка 13: Строка 13:
После добавления виджета в личный кабинет, пользователь может открыть его, дважды кликнув на иконку виджета. После данного действия откроется главная страница виджета.  
После добавления виджета в личный кабинет, пользователь может открыть его, дважды кликнув на иконку виджета. После данного действия откроется главная страница виджета.  
[[File:Главная_страница_виджета_навигации лк.png|thumb|center| Пример отображения главной страницы виджета навигации|800px]]
[[File:Главная_страница_виджета_навигации лк.png|thumb|center| Пример отображения главной страницы виджета навигации|800px]]
На главной страни
На главной странице виджета пользователю будет показано множество настроек, но на текущем этапе начала настройки его интересует область для управления виджетом. В эту область входит:
* кнопка «Настройки», которая позволит произвести общую настройку виджета;
* иконка позволяющая растянуть виджет на весь экран;
* иконка в виде «?» позволяющая ознакомиться с первоначальной инструкцией по настройке и работе виджета.
[[File:Обдасть_управления_виджетом.png|thumb|center| Пример отображения области управления виджетом|800px]]
== '''Настройки виджета''' ==
== '''Настройки виджета''' ==
<div class="mw-collapsible mw-collapsed">
<div class="mw-collapsible-content">
Чтобы перейти в общие настройки для всего виджета пользователю необходимо кликнуть на кнопку «Настройки» в левом верхнем углу.
Чтобы перейти в общие настройки для всего виджета пользователю необходимо кликнуть на кнопку «Настройки» в левом верхнем углу.
[[File:Кнопка_настройки_в_виджете.png|thumb|center| Пример отображения кнопки «Настройки» в виджете навигации |800px]]
[[File:Кнопка_настройки_в_виджете.png|thumb|center| Пример отображения кнопки «Настройки» в виджете навигации |800px]]
<div class="mw-collapsible mw-collapsed">
После нажатия кнопки откроется страница со списком настроек виджета.
'''Показать спойлер'''
[[File:Страница_настройки_виджета.png|thumb|center| Пример отображения страницы настроек виджета |800px]]
<div class="mw-collapsible-content">
Список состоит из следующих параметров для настройки:
Здесь находится скрытый текст.
* выбор языка — позволяет пользователю выбрать необходимый язык для работы виджета. Доступно пять языков: русский, английский, португальский, испанский, казахский;
* время сессии пользователя — указать значения, которое будет использоваться для перехода в режим ожидания виджета. Указанное значение измеряется в секундах;
* поле «Ключе тега для этажа» — параметр для взаимодействия с устройством и его тегом в личном кабинете SmartPlayer. Прописать значение этажа, на котором будет установлен терминал и указать номер нужного этажа;
* поле «Ключе тега для терминала» — параметр для взаимодействия с устройством и его тегом в личном кабинете SmartPlayer. Данные параметр необходимо настраивать только в случае если на этаже больше одного терминала. Если терминал один на этаже, то этот параметр можно не указывать (оставить пустым);
* цвет фона виджета —  позволяет выбрать цвет фона для виджета;
* цвет UI панелей навигации — позволяет выбрать цвет для UI панелей навигации;
* цвет отображаемого маршрута — позволяет выбрать цвет для отображения маршрута;
* цвет фона названия помещения на карте — позволяет выбрать цвет фона для наименования помещений;
* цвет текста названия помещения на карте — позволяет выбрать цвет для названий помещений;
* цвет фона активного помещения на карте — позволяет выбрать цвет фона для активного (выделенного) помещения;
* цвет текста активного помещения на карте — позволяет выбрать цвет текста для выделенного помещения;
{{Note|Во всех параметрах где используется палитра цвет можно указать с помощью HEX-кода. Значения всех кодов доступны в сети.|warn}}
* кнопка «Логотип» — по кнопке можно добавить изображение в качестве логотипа, которое будет изображено на карте из личного кабинета. Логотип необходимо предварительно загрузить в личный кабинет SmartPlayer;
* позиция логотипа — выбрать вариант для расположения логотипа из списка: по центру, слева, справа;
* карты этажей — позволяет загрузить из папки в личном кабинете карты этажей. Карты необходимо предварительно загрузить в личный кабинет SmartPlayer;
* иконки категорий — позволяет загрузить из папки в личном кабинете иконки категорий для обозначения категорий помещений на картах в виджете. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer;
* иконки помещений — позволяет загрузить из папки в личном кабинете иконки помещений для обозначения категорий помещений на картах в виджете. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer;
* чекбокс (галочка) «Показывать текстовое описание маршрута» — активирует или деактивирует отображения описания в дополнении к отрисованному маршруту.
=== '''Загрузка и скачивание настроек''' ===
В процессе взаимодействия с настройками виджета пользователь может загрузить и выгрузить настройки виджета. Каждое из указанных действий можно сделать по отдельным иконкам в интерфейсе виджета. Иконки расположены в виджете внизу с правой стороны, под картой.
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок загрузить и выгрузить настройки виджета |800px]]
Завершив все настройки параметров виджета пользователю необходимо сначала нажать на кнопку внизу справа «Применить настройки». Если указанные настройки не соответствуют требованиями пользователя, он может их сбросить до настроек по умолчанию нажав на расположенную по соседству кнопку «Сбросить».
[[File:Сброссить_и_применить.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить» в виджете|800px]]
После нажатия на кнопку применить настройку пользователю необходимо нажать на кнопку «Сохранить» расположенную внизу по центру экрана.
[[File:Кнопка_сэйв.png|thumb|center| Пример отображения кнопки «Сохранить» в виджете |800px]]
</div>
</div>
</div>
</div>

Версия от 13:14, 24 июня 2026

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

Один из важных и технически сложных продуктов реализованных компанией SmartPlayer — виджет работающей с навигацией в помещениях. Услышав пожелания заказчиков компания SmartPlayer решила переработать и улучшить данный виджет. Виджет был кардинально переработан и стал простым, понятным, быстрым и стабильным в своей работе. На этой странице будет описано как правильно настраивать и взаимодействовать с новой версией виджета навигации.

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

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

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

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

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

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

Пример отображения переноса виджета с помощью drag-n-drop
Если у пользователя много различного контента в личном кабинете, то он может воспользоваться функцией сортировки и выбрать нужный тип контента «Виджет». Воспользовавшись данной функциональностью, он сможет просмотреть все добавленные в личный кабинет виджеты.
Пример отображения виджета и режима правильной сортировки, для более удобного поиска виджета

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

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

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

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

  • кнопка «Настройки», которая позволит произвести общую настройку виджета;
  • иконка позволяющая растянуть виджет на весь экран;
  • иконка в виде «?» позволяющая ознакомиться с первоначальной инструкцией по настройке и работе виджета.
Пример отображения области управления виджетом

Настройки виджета

Чтобы перейти в общие настройки для всего виджета пользователю необходимо кликнуть на кнопку «Настройки» в левом верхнем углу.

Пример отображения кнопки «Настройки» в виджете навигации

После нажатия кнопки откроется страница со списком настроек виджета.

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

Список состоит из следующих параметров для настройки:

  • выбор языка — позволяет пользователю выбрать необходимый язык для работы виджета. Доступно пять языков: русский, английский, португальский, испанский, казахский;
  • время сессии пользователя — указать значения, которое будет использоваться для перехода в режим ожидания виджета. Указанное значение измеряется в секундах;
  • поле «Ключе тега для этажа» — параметр для взаимодействия с устройством и его тегом в личном кабинете SmartPlayer. Прописать значение этажа, на котором будет установлен терминал и указать номер нужного этажа;
  • поле «Ключе тега для терминала» — параметр для взаимодействия с устройством и его тегом в личном кабинете SmartPlayer. Данные параметр необходимо настраивать только в случае если на этаже больше одного терминала. Если терминал один на этаже, то этот параметр можно не указывать (оставить пустым);
  • цвет фона виджета — позволяет выбрать цвет фона для виджета;
  • цвет UI панелей навигации — позволяет выбрать цвет для UI панелей навигации;
  • цвет отображаемого маршрута — позволяет выбрать цвет для отображения маршрута;
  • цвет фона названия помещения на карте — позволяет выбрать цвет фона для наименования помещений;
  • цвет текста названия помещения на карте — позволяет выбрать цвет для названий помещений;
  • цвет фона активного помещения на карте — позволяет выбрать цвет фона для активного (выделенного) помещения;
  • цвет текста активного помещения на карте — позволяет выбрать цвет текста для выделенного помещения;
Во всех параметрах где используется палитра цвет можно указать с помощью HEX-кода. Значения всех кодов доступны в сети.
  • кнопка «Логотип» — по кнопке можно добавить изображение в качестве логотипа, которое будет изображено на карте из личного кабинета. Логотип необходимо предварительно загрузить в личный кабинет SmartPlayer;
  • позиция логотипа — выбрать вариант для расположения логотипа из списка: по центру, слева, справа;
  • карты этажей — позволяет загрузить из папки в личном кабинете карты этажей. Карты необходимо предварительно загрузить в личный кабинет SmartPlayer;
  • иконки категорий — позволяет загрузить из папки в личном кабинете иконки категорий для обозначения категорий помещений на картах в виджете. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer;
  • иконки помещений — позволяет загрузить из папки в личном кабинете иконки помещений для обозначения категорий помещений на картах в виджете. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer;
  • чекбокс (галочка) «Показывать текстовое описание маршрута» — активирует или деактивирует отображения описания в дополнении к отрисованному маршруту.

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

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

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

Завершив все настройки параметров виджета пользователю необходимо сначала нажать на кнопку внизу справа «Применить настройки». Если указанные настройки не соответствуют требованиями пользователя, он может их сбросить до настроек по умолчанию нажав на расположенную по соседству кнопку «Сбросить».

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

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

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

Интеграция в трансляцию

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

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

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

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

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