Инструкция для настройки виджета навигации (ver. 2.0): различия между версиями
Нет описания правки |
|||
| (не показано 5 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
<languages/> | |||
<translate> | |||
<!--T:1--> | |||
== '''Описание ситуации''' == | == '''Описание ситуации''' == | ||
Одним из важных и технически сложных продуктов, реализованных компанией SmartPlayer, является виджет, предназначенный для навигации внутри помещений. Учитывая пожелания заказчиков, команда SmartPlayer решила переработать и улучшить данный виджет. Виджет был полностью переработан и стал более простым, понятным, быстрым и стабильным в работе. На этой странице описано, как правильно настроить новую версию виджета навигации и работать с ней. | |||
== '''Последовательность настройки виджета''' == | == '''Последовательность настройки виджета''' == | ||
В новой | В новой версии виджета предусмотрена последовательная настройка, включающая следующие этапы: | ||
# | # Перейдите в общие настройки виджета, нажав на иконку в виде шестерёнки. После завершения настройки нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру. | ||
# | # Нажмите на кнопку «Категории», чтобы открыть страницу создания категорий помещений. На этой странице также можно отредактировать существующие категории. | ||
# | # Добавьте этаж с помощью одноимённой иконки и нажмите на кнопку «Выбрать карту», расположенную справа. Карта должна быть предварительно добавлена в отдельную папку личного кабинета. | ||
# | # Нажмите на кнопку «Настроить клики» и выделите нужные помещения на карте. | ||
# | # Добавьте терминал с помощью одноимённой кнопки на панели справа. | ||
# | # Добавьте остальные объекты здания: лифты, лестницы и помещения. | ||
# | # Настройте стены на карте и точки входа в помещения. | ||
# | # Повторяйте шаги 2–7, пока не будет добавлено нужное количество этажей. | ||
# После настройки всех этажей | # После настройки всех этажей нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру. | ||
# | # Повторно откройте виджет и нажмите на кнопку «Перейти в навигацию» в левом нижнем углу, чтобы проверить его работоспособность. Если все параметры настроены правильно, можно будет построить маршрут до нужного помещения. | ||
# | # Чтобы изменить настройки виджета, нажмите на кнопку «Вернуться в конструктор» в левом нижнем углу. | ||
# Если маршрут до определённого местоположения строится не | # Если маршрут до определённого местоположения строится не по прямой, а зигзагами, его можно сгладить. Для этого откройте страницу настроек с помощью кнопки «Точки сглаживания». | ||
# | # Установите точки сглаживания маршрута и нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру. | ||
== '''Добавление виджета в личный кабинет''' == | == '''Добавление виджета в личный кабинет''' == | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
Чтобы добавить данный виджет в личный кабинет пользователю необходимо запросить у специалиста технической поддержки | Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить его у специалиста технической поддержки. Виджет будет предоставлен в формате ZIP-архива. | ||
[[File:Архив_вижэет_навигации.png|thumb|center| Пример виджета в формате | [[File:Архив_вижэет_навигации.png|thumb|center| Пример отображения виджета в формате ZIP-архива|800px]] | ||
После пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент». | После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент». | ||
[[File:Лк_контент.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]] | [[File:Лк_контент.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете|800px]] | ||
В разделе | В разделе «Контент» необходимо перетащить виджет из локального хранилища. После переноса в личный кабинет виджет отобразится в списке контента. | ||
[[File:Перенос_виджета rss.png|thumb|center| Пример отображения переноса виджета с помощью drag- | [[File:Перенос_виджета rss.png|thumb|center| Пример отображения переноса виджета с помощью drag-and-drop|800px]] | ||
{{Note|Если | {{Note|Если в личном кабинете пользователя хранится много различного контента, он может воспользоваться функцией сортировки и выбрать тип контента «Виджет». После этого в личном кабинете будут отображаться все добавленные виджеты. | ||
[[File:ВИджет_навигации_в_лк.png|thumb|center| Пример отображения виджета и режима | [[File:ВИджет_навигации_в_лк.png|thumb|center| Пример отображения виджета и выбранного режима сортировки для упрощения его поиска|800px]]|warn}} | ||
</div> | </div> | ||
</div> | </div> | ||
== '''Главная страница виджета''' == | == '''Главная страница виджета''' == | ||
После добавления виджета в личный кабинет | После добавления виджета в личный кабинет пользователь может открыть его, дважды нажав на иконку. После этого откроется главная страница виджета. | ||
[[File:Основная_страница.png|thumb|center| Пример отображения главной страницы виджета навигации|800px]] | [[File:Основная_страница.png|thumb|center| Пример отображения главной страницы виджета навигации|800px]] | ||
На главной странице виджета пользователю | На главной странице виджета пользователю доступно множество настроек. На начальном этапе его интересует область управления виджетом. В эту область входят: | ||
* кнопка «Настройки», | * кнопка «Настройки», позволяющая выполнить общую настройку виджета; | ||
* иконка позволяющая | * иконка, позволяющая развернуть виджет на весь экран; | ||
* иконка в виде «?» позволяющая ознакомиться с первоначальной инструкцией по настройке и работе | * иконка в виде знака «?», позволяющая ознакомиться с первоначальной инструкцией по настройке виджета и работе с ним. | ||
[[File:Нужная_область.png|thumb|center| Пример отображения области управления виджетом|800px]] | [[File:Нужная_область.png|thumb|center| Пример отображения области управления виджетом|800px]] | ||
== '''Порядок настройки элементов виджета''' == | == '''Порядок настройки элементов виджета''' == | ||
В этом разделе будет | В этом разделе будет последовательно описан порядок настройки элементов виджета, необходимый для его корректной работы: | ||
</translate> | |||
<translate> | |||
<!--T:2--> | |||
== '''Общие настройки виджета''' == | == '''Общие настройки виджета''' == | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
Чтобы перейти | Чтобы перейти к общим настройкам виджета, пользователю необходимо нажать на кнопку «Настройки» в левом верхнем углу. | ||
[[File:Переход_к_настройкам_виджета.png|thumb|center| Пример отображения кнопки «Настройки» в виджете навигации |800px]] | [[File:Переход_к_настройкам_виджета.png|thumb|center| Пример отображения кнопки «Настройки» в виджете навигации|800px]] | ||
После нажатия | После нажатия на кнопку откроется страница со списком настроек виджета. | ||
[[File:Параметры_виджета_навигаци.png|thumb|center| Пример отображения страницы настроек виджета |800px]] | [[File:Параметры_виджета_навигаци.png|thumb|center| Пример отображения страницы настроек виджета|800px]] | ||
Для настройки доступны следующие параметры: | |||
* выбор языка — позволяет | * выбор языка — позволяет выбрать язык интерфейса виджета. Доступны пять языков: русский, английский, португальский, испанский и казахский; | ||
* время сессии пользователя — указать | * время сессии пользователя — позволяет указать время, по истечении которого виджет перейдёт в режим ожидания. Значение указывается в секундах; | ||
* поле «Ключ тега для здания» — | * поле «Ключ тега для здания» — позволяет указать ключ тега устройства, в значении которого содержится наименование здания, где установлен терминал; | ||
* поле «Ключ тега для этажа» — | * поле «Ключ тега для этажа» — позволяет указать ключ тега устройства, в значении которого содержится номер этажа, где установлен терминал; | ||
* поле «Ключ тега для терминала» — | * поле «Ключ тега для терминала» — позволяет указать ключ тега устройства, используемый для идентификации терминала. Данный параметр необходимо настраивать только в том случае, если на одном этаже установлено несколько терминалов. Если на этаже установлен один терминал, поле можно оставить пустым; | ||
* поле «Этаж с которого начинается отсчёт в здании» — | * поле «Этаж, с которого начинается отсчёт в здании» — позволяет указать номер этажа, с которого начинается нумерация этажей в здании; | ||
* элементы отображаемые | * элементы, отображаемые на панели навигации, — позволяют выбрать, что будет отображаться в области справа во время навигации: список категорий или список помещений. Также пользователь может отключить отображение списков; | ||
* количество | * количество отображаемых элементов в ряду — позволяет выбрать количество элементов списка, отображаемых в одном ряду: два или три; | ||
* | * флажок «Отображать стартовую страницу» — включает или отключает отображение стартовой страницы; | ||
* цвет фона стартовой страницы — позволяет выбрать цвет фона | * цвет фона стартовой страницы — позволяет выбрать цвет фона стартовой страницы виджета; | ||
* | * кнопка «Фоновое изображение стартовой страницы» — позволяет выбрать в личном кабинете SmartPlayer изображение для стартовой страницы; | ||
* позиция кнопки начала навигации — | * позиция кнопки начала навигации — позволяет указать числовое значение для смещения кнопки по оси Y; | ||
* поле «Текст кнопки начала навигации» — | * поле «Текст кнопки начала навигации» — позволяет указать текст, который будет отображаться на кнопке запуска навигации; | ||
* цвет кнопки | * цвет кнопки начала навигации — позволяет выбрать цвет кнопки запуска навигации; | ||
* | * флажок «Отображать кнопку инструкции» — включает или отключает отображение кнопки для просмотра инструкции в виджете; | ||
* кнопка «Файл инструкции» — позволяет | * кнопка «Файл инструкции» — позволяет выбрать в личном кабинете SmartPlayer документ, который будет использоваться в качестве инструкции; | ||
* позиция кнопки инструкции — | * позиция кнопки инструкции — позволяет указать числовое значение для смещения кнопки по оси Y; | ||
* цвет фона виджета — | * цвет фона виджета — позволяет выбрать цвет фона виджета; | ||
* цвет UI панелей навигации — позволяет выбрать цвет | * цвет UI-панелей навигации — позволяет выбрать цвет панелей навигации; | ||
* цвет отображаемого маршрута — позволяет выбрать цвет | * цвет отображаемого маршрута — позволяет выбрать цвет построенного маршрута; | ||
* цвет фона названия помещения на карте — позволяет выбрать цвет фона | * цвет фона названия помещения на карте — позволяет выбрать цвет фона области с названием помещения; | ||
* цвет текста названия помещения на карте — позволяет выбрать цвет | * цвет текста названия помещения на карте — позволяет выбрать цвет текста названия помещения; | ||
* цвет фона активного помещения на карте — позволяет выбрать цвет фона | * цвет фона активного помещения на карте — позволяет выбрать цвет фона выбранного помещения; | ||
* цвет текста активного помещения на карте — позволяет выбрать цвет текста | * цвет текста активного помещения на карте — позволяет выбрать цвет текста названия выбранного помещения; | ||
{{Note|Во всех параметрах | {{Note|Во всех параметрах, в которых используется цветовая палитра, цвет можно указать с помощью HEX-кода. Подобрать нужный HEX-код можно с помощью общедоступных цветовых палитр.|warn}} | ||
* кнопка «Логотип» — | * кнопка «Логотип» — позволяет выбрать в личном кабинете SmartPlayer изображение, которое будет использоваться в качестве логотипа и отображаться на карте. Изображение необходимо предварительно загрузить в личный кабинет SmartPlayer; | ||
* позиция логотипа — выбрать | * позиция логотипа — позволяет выбрать расположение логотипа: по центру, слева или справа; | ||
* расположение клавиатуры поиска — позволяет | * расположение клавиатуры поиска — позволяет выбрать расположение экранной клавиатуры, используемой для ручного поиска. Доступны два варианта: сверху и снизу; | ||
* карты этажей — | * карты этажей — позволяют выбрать в папке личного кабинета SmartPlayer карты этажей. Карты необходимо предварительно загрузить в личный кабинет SmartPlayer; | ||
* иконки категорий — | * иконки категорий — позволяют выбрать в папке личного кабинета SmartPlayer иконки категорий для отображения на картах виджета. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer; | ||
* иконки помещений — | * иконки помещений — позволяют выбрать в папке личного кабинета SmartPlayer иконки помещений для отображения на картах виджета. Иконки необходимо предварительно загрузить в личный кабинет SmartPlayer; | ||
* изображения помещений — | * изображения помещений — позволяют выбрать в папке личного кабинета SmartPlayer изображения помещений для отображения на картах виджета. Изображения необходимо предварительно загрузить в личный кабинет SmartPlayer; | ||
* | * флажок «Показывать текстовое описание маршрута» — включает или отключает отображение текстового описания в дополнение к построенному маршруту. | ||
=== '''Загрузка и скачивание настроек''' === | === '''Загрузка и скачивание настроек''' === | ||
При работе с настройками виджета пользователь может загрузить ранее сохранённые настройки или скачать текущие настройки. Для каждого действия предусмотрена отдельная иконка в интерфейсе виджета. Иконки расположены в правой нижней части виджета под картой. | |||
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок | [[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок загрузки и скачивания настроек виджета|800px]] | ||
После завершения настройки параметров виджета пользователю необходимо нажать на кнопку «Применить настройки», расположенную в правой нижней части экрана. Если указанные настройки не соответствуют требованиям пользователя, их можно сбросить до значений по умолчанию, нажав на расположенную рядом кнопку «Сбросить». | |||
[[File:Сброссить_и_применить.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить» в виджете|800px]] | [[File:Сброссить_и_применить.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить» в виджете|800px]] | ||
После нажатия на кнопку | После нажатия на кнопку «Применить настройки» пользователю необходимо нажать на кнопку «Сохранить», расположенную в нижней части экрана по центру. | ||
[[File:Кнопка_сэйв.png|thumb|center| Пример отображения кнопки «Сохранить» в | [[File:Кнопка_сэйв.png|thumb|center| Пример отображения кнопки «Сохранить» в виджете|800px]] | ||
</div> | </div> | ||
</div> | </div> | ||
| Строка 99: | Строка 98: | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
На главной странице в левой панели | На главной странице виджета в левой панели отображается блок настроек здания, в котором доступны следующие элементы: | ||
* выбор здания — | * выбор здания — позволяет выбрать здание из списка доступных вариантов; | ||
* название здания — | * название здания — позволяет указать наименование здания; | ||
* кнопка «Добавить здание» — открывает | * кнопка «Добавить здание» — создаёт новое здание и открывает страницу для настройки навигации; | ||
* кнопка «Удалить здание» — удаляет | * кнопка «Удалить здание» — удаляет выбранное здание из виджета. Перед удалением откроется модальное окно для подтверждения действия; | ||
[[File:Добавление_зданий.png|thumb|center| Пример отображения раздела «Здания» в виджете |800px]] | [[File:Добавление_зданий.png|thumb|center| Пример отображения раздела «Здания» в виджете|800px]] | ||
</div> | </div> | ||
</div> | </div> | ||
== '''Настройка этажей''' == | == '''Настройка этажей''' == | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
На левой панели также отображается отдельный блок настроек этажей, расположенный под блоком настроек здания. В него входят следующие элементы: | |||
* | * выбор этажа — позволяет выбрать один из ранее настроенных этажей; | ||
* кнопка «Добавить этаж» — позволяет добавить карту | * кнопка «Добавить этаж» — позволяет создать новый этаж и добавить для него карту из списка файлов, загруженных в личный кабинет SmartPlayer; | ||
* кнопка «Категории» — позволяет | * кнопка «Категории» — позволяет создать категории для последующей привязки к ним помещений; | ||
* кнопка «Точки сглаживания» — позволяет | * кнопка «Точки сглаживания» — позволяет добавить точки сглаживания маршрута и сделать его отображение более аккуратным; | ||
* кнопка «Параметры навигации» — открывает список | * кнопка «Параметры навигации» — открывает список параметров навигации. | ||
[[File:Настройка_этажей.png|thumb|center| Пример отображения раздела «Этажи» в виджете |800px]] | [[File:Настройка_этажей.png|thumb|center| Пример отображения раздела «Этажи» в виджете|800px]] | ||
=== '''Кнопка «Добавить этаж»''' === | === '''Кнопка «Добавить этаж»''' === | ||
После нажатия на кнопку «Добавить этаж» в виджете будет | После нажатия на кнопку «Добавить этаж» в виджете будет создан новый этаж. Чтобы выбрать для него карту, необходимо нажать на кнопку «Выбрать карту» на правой панели. | ||
[[File:Взаимодействие с этажом.png|thumb|center| Пример отображения | [[File:Взаимодействие с этажом.png|thumb|center| Пример отображения настроек этажа|800px]] | ||
{{Note|Подробнее о | {{Note|Подробнее о параметрах карты, расположенных на правой панели, рассказано в разделе «Настройки атрибутов этажа».|warn}} | ||
==== '''Установка границ на карте этажа''' ==== | |||
{{Note|Чтобы навигация в виджете работала правильно, пользователю необходимо обозначить границы всех помещений на этаже. Данное действие необходимо выполнить для карты каждого этажа.|warn}} | |||
После добавления этажа и его карты в виджет пользователю необходимо обозначить границы помещений. Виджет воспринимает данные границы как стены и учитывает их при построении маршрута.<br> | |||
Чтобы начать построение границы, пользователю необходимо зажать левую кнопку мыши (ЛКМ) и перемещать указатель в нужном направлении. Во время перемещения указателя на карте будет отображаться линия границы. | |||
[[File:Создание_границ.png|thumb|center| Пример отображения построения границ на карте этажа|800px]] | |||
При построении границ рекомендуется проводить линии не только вдоль стен помещений, но и немного продлевать их внутрь помещений в местах расположения входов. Это позволит системе навигации корректно строить и отображать маршрут до входа в выбранное помещение. | |||
[[File:Вход_в_помещение.png|thumb|center| Пример отображения построения границ с учётом входа в помещение|800px]] | |||
{{Note|Если пользователь неправильно нарисовал границу, ему необходимо зажать правую кнопку мыши (ПКМ) и провести указателем по неправильному участку, чтобы удалить его.|warn}} | |||
Если после завершения настройки маршрут на каком-либо участке карты отображается неправильно, вероятнее всего, пользователь перекрыл проход линией границы. В таком случае необходимо вернуться к настройке границ на карте этажа и удалить неправильный участок. | |||
</translate> | |||
<translate> | |||
<!--T:3--> | |||
=== '''Кнопка «Категории»''' === | === '''Кнопка «Категории»''' === | ||
После нажатия на данную кнопку содержимое правой панели изменится: на ней отобразятся настройки категорий. При нажатии на кнопку «Добавить категорию» интерфейс виджета снова изменится. | |||
[[File:Добавление_категории.png|thumb|center| Пример отображения кнопки «Добавить категорию» |800px]] | [[File:Добавление_категории.png|thumb|center| Пример отображения кнопки «Добавить категорию»|800px]] | ||
Появится строка с новой категорией, которую необходимо настроить. | Появится строка с новой категорией, которую необходимо настроить. Перейти к настройкам категории можно с помощью иконки в виде шестерёнки, расположенной справа от её названия. Также категорию можно удалить, нажав на иконку в виде крестика, расположенную рядом с иконкой настроек. | ||
[[File:Новая_категория.png|thumb|center| Пример отображения изменения | [[File:Новая_категория.png|thumb|center| Пример отображения изменения интерфейса и иконок для взаимодействия с категорией|800px]] | ||
При переходе | При переходе к настройкам категории пользователь может изменить следующие параметры: | ||
* имя — | * имя — позволяет указать название категории; | ||
* кнопка «Добавить иконку» — выбрать иконку | * кнопка «Добавить иконку» — позволяет выбрать иконку категории из файлов, загруженных в личный кабинет SmartPlayer. | ||
[[File:Настройки категории в виджета.png|thumb|center| Пример отображения параметров | [[File:Настройки категории в виджета.png|thumb|center| Пример отображения параметров настройки категории|800px]] | ||
Для завершения настройки категории необходимо нажать на кнопку «Применить» в нижней части панели. Если пользователь | Для завершения настройки категории необходимо нажать на кнопку «Применить» в нижней части панели. Если пользователь решил не сохранять изменения, необходимо нажать на расположенную рядом кнопку «Отменить». | ||
[[File:Применение_категорий.png|thumb|center| Пример отображения кнопок «Применить» и «Отменить» | [[File:Применение_категорий.png|thumb|center| Пример отображения кнопок «Применить» и «Отменить» на панели настроек|800px]] | ||
=== '''Кнопка «Точки сглаживания»''' === | === '''Кнопка «Точки сглаживания»''' === | ||
При переходе | При переходе к настройке точек сглаживания маршрута пользователю сразу отображается краткая инструкция по работе с данной функциональностью. После ознакомления с инструкцией необходимо нажать на кнопку «Добавить точки». | ||
[[File:Точка_сглаживания.png|thumb|center| Пример отображения | [[File:Точка_сглаживания.png|thumb|center| Пример отображения инструкции по работе с точками сглаживания и кнопки «Добавить точки»|800px]] | ||
После нажатия на кнопку «Добавить точки» появится новая строка с набором точек сглаживания. Перейти к настройкам точек можно с помощью иконки в виде шестерёнки, расположенной справа от названия. Также набор точек сглаживания можно удалить, нажав на иконку в виде крестика, расположенную рядом с иконкой настроек. | |||
[[File:Добавлени еточек.png|thumb|center| Пример отображения изменения | [[File:Добавлени еточек.png|thumb|center| Пример отображения изменения интерфейса и иконок для взаимодействия с точками сглаживания|800px]] | ||
После нажатия на иконку настроек пользователю откроется страница с картой и панелью слева, на которой можно настроить следующие параметры: | |||
[[File:Параметры_точек_сглаживания.png|thumb|center| Пример отображения параметров | [[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]] | ||
=== '''Кнопка «Параметры навигации»''' === | === '''Кнопка «Параметры навигации»''' === | ||
После нажатия на данную кнопку интерфейс изменится: вместо параметров этажей и здания отобразится список настроек навигации. В списке доступны следующие параметры: | |||
* ширина клетки координат — | * ширина клетки координат — позволяет указать ширину клетки координатной сетки в пикселях; | ||
* высота клетки координат — | * высота клетки координат — позволяет указать высоту клетки координатной сетки в пикселях; | ||
* качество отрисовки проложенного пути (DPI) — | * качество отрисовки проложенного пути (DPI) — позволяет указать значение DPI для отрисовки проложенного пути; | ||
* перемещение между этажами — выбрать | * перемещение между этажами — позволяет выбрать способ перемещения между этажами, который будет учитываться при построении маршрута. Доступны два варианта: «По лестнице» и «На лифте»; | ||
* отображать путь как — параметр влияющий на отображение | * отображать путь как — параметр, влияющий на отображение линии маршрута на карте. Доступны два варианта: точками или прерывистыми линиями; | ||
* | * флажок «Разрешить прокладывать путь по диагонали» — разрешает или запрещает построение маршрута по диагонали; | ||
* | * флажок «Автозум маршрута при построении» — включает или отключает автоматическое масштабирование карты при построении маршрута. | ||
[[File:Применить_и_изменить.png|thumb|center| Пример отображения параметров | [[File:Применить_и_изменить.png|thumb|center| Пример отображения параметров навигации|800px]] | ||
Для завершения настройки параметров навигации необходимо нажать на кнопку «Применить» в нижней части панели. Если пользователь | Для завершения настройки параметров навигации необходимо нажать на кнопку «Применить» в нижней части панели. Если пользователь решил не сохранять изменения, необходимо нажать на расположенную рядом кнопку «Отменить». | ||
</div> | </div> | ||
</div> | </div> | ||
</translate> | |||
<translate> | |||
<!--T:4--> | |||
== '''Настройка атрибутов этажа''' == | == '''Настройка атрибутов этажа''' == | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
После завершения настройки здания и этажей на левой панели виджета пользователю необходимо настроить параметры текущего этажа на правой панели. В список настроек этажа входят: | |||
* кнопка «Заменить карту» — позволяет заменить выбранную карту этажа; | * кнопка «Заменить карту» — позволяет заменить выбранную карту этажа; | ||
* кнопка «Настроить клики» — позволяет добавить зону | * кнопка «Настроить клики» — позволяет добавить зону помещения; | ||
* кнопка «Добавить терминал» — позволяет добавить терминал на карту этажа; | * кнопка «Добавить терминал» — позволяет добавить терминал на карту этажа; | ||
* кнопка «Добавить лифт» — позволяет добавить на карту | * кнопка «Добавить лифт» — позволяет добавить обозначение лифта на карту этажа; | ||
* кнопка «Добавить лестницу» — позволяет добавить на карту | * кнопка «Добавить лестницу» — позволяет добавить обозначение лестницы на карту этажа; | ||
* кнопка «Добавить помещение» — позволяет добавить помещение на карту; | * кнопка «Добавить помещение» — позволяет добавить помещение на карту этажа; | ||
* кнопка «Удалить этаж» — позволяет удалить | * кнопка «Удалить этаж» — позволяет удалить текущий этаж. | ||
[[File:Настройка_этажа.png|thumb|center| Пример отображения | [[File:Настройка_этажа.png|thumb|center| Пример отображения функциональности настройки этажа|800px]] | ||
{{Note| | {{Note|После завершения настройки этажа пользователю необходимо нажать на кнопку «Применить» в нижней части панели, чтобы сохранить внесённые изменения. Если внесённые изменения не подходят пользователю, он может нажать на расположенную слева кнопку «Сбросить». | ||
[[File:Сбросить_и_применить.png|thumb|center| Пример отображения кнопок «Применить» и «Сбросить»|800px]]|warn}} | [[File:Сбросить_и_применить.png|thumb|center| Пример отображения кнопок «Применить» и «Сбросить»|800px]]|warn}} | ||
=== '''Кнопка «Выбрать/заменить карту»''' === | === '''Кнопка «Выбрать/заменить карту»''' === | ||
{{Note|Пользователю рекомендуется заранее подготовить карты этажей для виджета в формате SVG.|warn}} | {{Note|Пользователю рекомендуется заранее подготовить карты этажей для виджета в формате SVG.|warn}} | ||
После нажатия на кнопку «Выбрать/заменить карту» откроется модальное окно, в котором пользователь сможет выбрать карту из файлов, заранее загруженных в личный кабинет SmartPlayer. Чтобы выбрать новую карту, необходимо нажать на неё. | |||
[[File:Настройка_этажа.png|thumb|center| Пример отображения модального окна для замены карты этажа|800px]] | [[File:Настройка_этажа.png|thumb|center| Пример отображения модального окна для замены карты этажа|800px]] | ||
{{Note| | {{Note|Название кнопки зависит от выполняемого пользователем действия. Если пользователь добавляет карту к новому этажу, кнопка называется «Выбрать карту». Если карта уже была добавлена ранее, кнопка называется «Заменить карту».|warn}} | ||
=== '''Кнопка «Настроить клики»''' === | |||
=== '''Кнопка «Настроить клики» ''' === | После нажатия на кнопку изменится отображение виджета, и пользователю откроется список доступных зон, размещённых на карте, если виджет уже был настроен ранее. Ранее созданные зоны будут отображаться на карте. В правом верхнем углу пользователю будет показана текстовая подсказка. | ||
[[File:Подскака_и_зоны.png|thumb|center| Пример отображения изменений интерфейса и текстовой подсказки|800px]] | |||
[[File:Подскака_и_зоны.png|thumb|center| Пример отображения изменений | Если зоны не были настроены ранее, пользователю необходимо нажать на кнопку «Добавить зону». После нажатия в правом верхнем углу появится новая фигура для выделения зоны. | ||
Если зоны не были | |||
[[File:Добавление_зоны_на_карту.png|thumb|center| Пример отображения кнопки «Добавить зону» и фигуры для выделения зоны|800px]] | [[File:Добавление_зоны_на_карту.png|thumb|center| Пример отображения кнопки «Добавить зону» и фигуры для выделения зоны|800px]] | ||
{{Note|Если зоны были настроены | {{Note|Если зоны были настроены некорректно или изменилось их расположение, любую зону можно удалить с помощью специальной иконки, которая появляется при наведении указателя на строку с нужной зоной. | ||
[[File:Удаление_зоны.png|thumb|center| Пример отображения иконки для удаления зоны|800px]]|warn}} | [[File:Удаление_зоны.png|thumb|center| Пример отображения иконки для удаления зоны|800px]]|warn}} | ||
Чтобы переместить новую зону в нужное место на карте, необходимо зажать её левой кнопкой мыши и перетащить. Также размер зоны можно изменить, наведя указатель на её границу. При этом изменится отображение курсора. | |||
[[File:Изменение_размера_зоны.png|thumb|center| Пример отображения перемещения зоны и изменения её размера|800px]] | [[File:Изменение_размера_зоны.png|thumb|center| Пример отображения перемещения зоны и изменения её размера|800px]] | ||
После завершения настройки зон пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить». | |||
[[File:ПРименение_и_отмена.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | [[File:ПРименение_и_отмена.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | ||
</translate> | |||
<translate> | |||
<!--T:5--> | |||
=== '''Кнопка «Добавить терминал»''' === | === '''Кнопка «Добавить терминал»''' === | ||
После нажатия на кнопку «Добавить терминал» пользователь перейдёт в раздел настроек терминала, который отобразится на панели после изменения интерфейса. | |||
[[File:Настройки_терминала.png|thumb|center| Пример отображения настроек | [[File:Настройки_терминала.png|thumb|center| Пример отображения настроек на панели после нажатия на кнопку «Добавить терминал»|800px]] | ||
В список настроек терминала входят следующие параметры: | В список настроек терминала входят следующие параметры: | ||
* имя — | * имя — позволяет указать название нового терминала; | ||
* положение по оси X — | * положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить терминал; | ||
* положение по оси Y — | * положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить терминал. | ||
[[File:Настроенный_терминал.png|thumb|center|Пример отображения заполненных настроек | [[File:Настроенный_терминал.png|thumb|center|Пример отображения заполненных настроек нового терминала|800px]] | ||
После завершения настройки терминала пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить». | |||
[[File:ПРименение_и_отмена.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | [[File:ПРименение_и_отмена.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | ||
{{Note|По | {{Note|По окончании настройки пользователь увидит новый терминал в списке. Добавленные терминалы можно отредактировать или удалить с помощью специальных иконок на данной панели. | ||
[[File:Изменений_терминалов.png|thumb|center| Пример отображения настроенных терминалов и иконок для взаимодействия с ними|800px]]|warn}} | [[File:Изменений_терминалов.png|thumb|center| Пример отображения настроенных терминалов и иконок для взаимодействия с ними|800px]]|warn}} | ||
=== '''Кнопка «Добавить лифт»''' === | === '''Кнопка «Добавить лифт»''' === | ||
После нажатия на кнопку «Добавить лифт» пользователь перейдёт в раздел настроек лифта на карте, который отобразится на панели после изменения интерфейса. | |||
[[File:Добавление_лифта.png|thumb|center| Пример отображения настроек | [[File:Добавление_лифта.png|thumb|center| Пример отображения настроек на панели после нажатия на кнопку «Добавить лифт»|800px]] | ||
В список настроек | В список настроек лифта входят следующие параметры: | ||
* имя — | * имя — позволяет указать название нового лифта; | ||
* положение по оси X — | * положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лифт; | ||
* положение по оси Y — | * положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лифт; | ||
* чекбокс (галочка) «Лифт | * чекбокс (галочка) «Лифт включён» — включает или отключает использование лифта при построении маршрута. Если данный параметр активирован для лифтов на исходном и конечном этажах, маршрут будет строиться с учётом перемещения на лифте. | ||
[[File:Настройки_лифта.png|thumb|center| Пример отображения лифта на карте|800px]] | [[File:Настройки_лифта.png|thumb|center| Пример отображения лифта на карте|800px]] | ||
После завершения настройки лифта пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения в расположение лифта не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить». | |||
[[File:Кнопки_сохранить_и_отменить.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | [[File:Кнопки_сохранить_и_отменить.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | ||
{{Note|По | {{Note|По окончании настройки пользователь увидит добавленные лифты в списке. Лифты из списка можно отредактировать или удалить с помощью специальных иконок на данной панели. | ||
[[File:Взаимодействие_с_лифтами.png|thumb|center| Пример отображения настроенных лифтов и иконок для взаимодействия с ними|800px]]|warn}} | [[File:Взаимодействие_с_лифтами.png|thumb|center| Пример отображения настроенных лифтов и иконок для взаимодействия с ними|800px]]|warn}} | ||
=== '''Кнопка «Добавить лестницу»''' === | === '''Кнопка «Добавить лестницу»''' === | ||
После нажатия на кнопку «Добавить лестницу» пользователь перейдёт в раздел настроек лестницы на карте, который отобразится на панели после изменения интерфейса. | |||
[[File:Добавление_лестницы.png|thumb|center| Пример отображения настроек | [[File:Добавление_лестницы.png|thumb|center| Пример отображения настроек на панели после нажатия на кнопку «Добавить лестницу»|800px]] | ||
В список настроек | В список настроек лестницы входят следующие параметры: | ||
* имя — | * имя — позволяет указать название новой лестницы; | ||
* положение по оси X — | * положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лестницу; | ||
* положение по оси Y — | * положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лестницу; | ||
* чекбокс (галочка) «Лестница включена» — включает или отключает при построении маршрута | * чекбокс (галочка) «Лестница включена» — включает или отключает использование лестницы при построении маршрута. Если данный параметр активирован для лестниц на исходном и конечном этажах, маршрут будет строиться с учётом перемещения по лестнице. | ||
[[File:Настройка_лестницы.png|thumb|center| Пример отображения лестницы на карте|800px]] | [[File:Настройка_лестницы.png|thumb|center| Пример отображения лестницы на карте|800px]] | ||
После завершения настройки лестницы пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения в расположение лестницы не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить». | |||
[[File:Кнопки_изменений.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | [[File:Кнопки_изменений.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | ||
{{Note|По | {{Note|По окончании настройки пользователь увидит добавленные лестницы в списке. Добавленные лестницы можно отредактировать или удалить с помощью специальных иконок. | ||
[[File:Взаимодействие_с_лестницами.png|thumb|center| Пример отображения настроенных лестниц и иконок для взаимодействия с ними|800px]]|warn}} | [[File:Взаимодействие_с_лестницами.png|thumb|center| Пример отображения настроенных лестниц и иконок для взаимодействия с ними|800px]]|warn}} | ||
</translate> | |||
<translate> | |||
<!--T:6--> | |||
=== '''Кнопка «Добавить помещение»''' === | === '''Кнопка «Добавить помещение»''' === | ||
После нажатия на кнопку «Добавить помещение» пользователь перейдёт в раздел настроек помещения на карте, который отобразится на панели после изменения интерфейса. | |||
[[File:Настройка_помещений.png|thumb|center| Пример отображения настроек | [[File:Настройка_помещений.png|thumb|center| Пример отображения настроек на панели после нажатия на кнопку «Добавить помещение»|800px]] | ||
В список настроек | В список настроек помещения входят следующие параметры: | ||
* имя — | * имя — позволяет указать наименование помещения; | ||
* название в поиске — | * название в поиске — позволяет указать название, по которому помещение можно будет найти с помощью системы поиска; | ||
* кнопка «Добавить изображение» — | * кнопка «Добавить изображение» — позволяет выбрать для помещения одно из изображений, доступных в личном кабинете; | ||
* описание — | * описание — позволяет указать дополнительную информацию о помещении; | ||
* размер шрифта — выбрать доступный размер шрифта из списка; | * размер шрифта — позволяет выбрать доступный размер шрифта из списка; | ||
* отступ от левого края карты — | * отступ от левого края карты — позволяет указать числовое значение отступа от левого края карты; | ||
* отступ от верхнего края карты — | * отступ от верхнего края карты — позволяет указать числовое значение отступа от верхнего края карты; | ||
* точка входа в помещение по оси X — | * точка входа в помещение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить точку входа в помещение; | ||
* точка входа в помещение по оси Y — | * точка входа в помещение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить точку входа в помещение; | ||
* категории — выбрать | * категории — позволяет выбрать из списка категорию, к которой необходимо привязать помещение; | ||
* отображать помещение как — позволяет выбрать вариант отображения из списка. | * отображать помещение как — позволяет выбрать вариант отображения помещения из списка. Доступны два варианта: отображать название помещения или не отображать его; | ||
* кнопка «Добавить иконку» — | * кнопка «Добавить иконку» — позволяет выбрать для помещения одну из иконок, доступных в личном кабинете; | ||
* кнопка «Привязать к карте» — | * кнопка «Привязать к карте» — позволяет привязать к помещению зону, добавленную на карте этажа; | ||
* чекбокс (галочка) «Отображать в панели навигации» — | * чекбокс (галочка) «Отображать в панели навигации» — включает или отключает отображение помещения на панели навигации. | ||
После завершения настройки помещения пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить». | |||
[[File:Применение_помещений.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | [[File:Применение_помещений.png|thumb|center| Пример отображения кнопок «Применить» и «Отмена»|800px]] | ||
{{Note|По | {{Note|По окончании настройки пользователь увидит добавленные помещения в списке. Добавленные помещения можно отредактировать или удалить с помощью специальных иконок. Также для каждого помещения доступна отдельная иконка, позволяющая построить до него маршрут. Положение помещения в списке можно изменить, перетащив его при зажатой левой кнопке мыши. | ||
[[File:Взаимодействие_с_помещениями.png|thumb|center| Пример отображения настроенных помещений и иконок для взаимодействия с ними|800px]]|warn}} | [[File:Взаимодействие_с_помещениями.png|thumb|center| Пример отображения настроенных помещений и иконок для взаимодействия с ними|800px]]|warn}} | ||
</div> | </div> | ||
</div> | </div> | ||
== '''Переход в навигацию''' == | == '''Переход в навигацию''' == | ||
<div class="mw-collapsible mw-collapsed"> | <div class="mw-collapsible mw-collapsed"> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
После завершения предварительной настройки виджета, | После завершения предварительной настройки виджета, состоящей из описанных ранее этапов, пользователь может проверить работу настроенного виджета. Для этого ему необходимо нажать на кнопку «Перейти в навигацию» в левом нижнем углу виджета. | ||
[[File:Переход_навигацию.png|thumb|center| Пример отображения кнопки | [[File:Переход_навигацию.png|thumb|center| Пример отображения кнопки «Перейти в навигацию» на главной странице виджета |800px]] | ||
После нажатия | После нажатия на кнопку откроется страница предпросмотра виджета, на которой пользователь увидит: | ||
* карту с помещениями и точкой расположения терминала; | * карту с помещениями и точкой расположения терминала; | ||
* список категорий | * список категорий в правой части экрана; | ||
* список этажей | * список этажей над списком категорий. | ||
Также пользователь может воспользоваться экранной клавиатурой | Также пользователь может воспользоваться экранной клавиатурой и кнопкой выбора языка для поиска нужного объекта на карте. Эти элементы расположены в правой нижней части экрана под списком категорий. | ||
[[File:Поиск_и_язык.png|thumb|center| Пример отображения системы поиска в виджете и кнопки выбора языка |800px]] | [[File:Поиск_и_язык.png|thumb|center| Пример отображения системы поиска в виджете и кнопки выбора языка |800px]] | ||
{{Note| | {{Note|Чтобы вернуться к настройкам виджета, необходимо нажать на кнопку «Вернуться в конструктор» в левой нижней части экрана. | ||
[[File:Возвращение_к_конструктору.png|thumb|center| Пример отображения кнопки «Вернуться в конструктор» |800px]]|warn}} | [[File:Возвращение_к_конструктору.png|thumb|center| Пример отображения кнопки «Вернуться в конструктор» |800px]]|warn}} | ||
== '''Построение маршрута на странице предпросмотра''' == | == '''Построение маршрута на странице предпросмотра''' == | ||
Чтобы построить маршрут | Чтобы построить маршрут на странице предпросмотра виджета, пользователю необходимо нажатием выбрать нужный объект. После этого объект будет подсвечен, а в правой нижней части экрана рядом с системой поиска отобразится кнопка «Маршрут». | ||
[[File:Кнопки_и_выбор.png|thumb|center| Пример отображения | [[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]] | ||
</div> | </div> | ||
</div> | </div> | ||
== '''Интеграция в трансляцию''' == | == '''Интеграция в трансляцию''' == | ||
Чтобы | Чтобы проверить работу данного виджета на устройстве, пользователю необходимо создать трансляцию, добавить в неё настроенный ранее виджет в качестве контента, настроить расписание и назначить трансляцию на устройство. Подробнее об этих действиях можно узнать в следующих статьях базы знаний SmartPlayer: | ||
* [[Раздел "Устройства"]] | * [[Раздел "Устройства"]] | ||
* [[Раздел "Контент на устройства"]] | * [[Раздел "Контент на устройства"]] | ||
| Строка 285: | Строка 300: | ||
* [[Раздел "Расписание"]] | * [[Раздел "Расписание"]] | ||
== '''Дополнительная информация''' == | == '''Дополнительная информация''' == | ||
Если данная статья не помогает использовать | Если данная статья не помогает использовать функциональность по назначению или после её прочтения остаются вопросы, их можно задать в разделе «Обсуждения» вверху страницы. | ||
[[File:Обсуждение_инструкции_виджета_навигации.png|thumb|center| Пример отображения вкладки | [[File:Обсуждение_инструкции_виджета_навигации.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]] | ||
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]. | ||
</translate> | |||
Текущая версия от 23:13, 1 июля 2026
Описание ситуации
Одним из важных и технически сложных продуктов, реализованных компанией SmartPlayer, является виджет, предназначенный для навигации внутри помещений. Учитывая пожелания заказчиков, команда SmartPlayer решила переработать и улучшить данный виджет. Виджет был полностью переработан и стал более простым, понятным, быстрым и стабильным в работе. На этой странице описано, как правильно настроить новую версию виджета навигации и работать с ней.
Последовательность настройки виджета
В новой версии виджета предусмотрена последовательная настройка, включающая следующие этапы:
- Перейдите в общие настройки виджета, нажав на иконку в виде шестерёнки. После завершения настройки нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.
- Нажмите на кнопку «Категории», чтобы открыть страницу создания категорий помещений. На этой странице также можно отредактировать существующие категории.
- Добавьте этаж с помощью одноимённой иконки и нажмите на кнопку «Выбрать карту», расположенную справа. Карта должна быть предварительно добавлена в отдельную папку личного кабинета.
- Нажмите на кнопку «Настроить клики» и выделите нужные помещения на карте.
- Добавьте терминал с помощью одноимённой кнопки на панели справа.
- Добавьте остальные объекты здания: лифты, лестницы и помещения.
- Настройте стены на карте и точки входа в помещения.
- Повторяйте шаги 2–7, пока не будет добавлено нужное количество этажей.
- После настройки всех этажей нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.
- Повторно откройте виджет и нажмите на кнопку «Перейти в навигацию» в левом нижнем углу, чтобы проверить его работоспособность. Если все параметры настроены правильно, можно будет построить маршрут до нужного помещения.
- Чтобы изменить настройки виджета, нажмите на кнопку «Вернуться в конструктор» в левом нижнем углу.
- Если маршрут до определённого местоположения строится не по прямой, а зигзагами, его можно сгладить. Для этого откройте страницу настроек с помощью кнопки «Точки сглаживания».
- Установите точки сглаживания маршрута и нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.
Добавление виджета в личный кабинет
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить его у специалиста технической поддержки. Виджет будет предоставлен в формате ZIP-архива.

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

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


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

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

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

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

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

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

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

Настройка здания
На главной странице виджета в левой панели отображается блок настроек здания, в котором доступны следующие элементы:
- выбор здания — позволяет выбрать здание из списка доступных вариантов;
- название здания — позволяет указать наименование здания;
- кнопка «Добавить здание» — создаёт новое здание и открывает страницу для настройки навигации;
- кнопка «Удалить здание» — удаляет выбранное здание из виджета. Перед удалением откроется модальное окно для подтверждения действия;

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

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

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

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

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

Появится строка с новой категорией, которую необходимо настроить. Перейти к настройкам категории можно с помощью иконки в виде шестерёнки, расположенной справа от её названия. Также категорию можно удалить, нажав на иконку в виде крестика, расположенную рядом с иконкой настроек.

При переходе к настройкам категории пользователь может изменить следующие параметры:
- имя — позволяет указать название категории;
- кнопка «Добавить иконку» — позволяет выбрать иконку категории из файлов, загруженных в личный кабинет SmartPlayer.

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

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

После нажатия на кнопку «Добавить точки» появится новая строка с набором точек сглаживания. Перейти к настройкам точек можно с помощью иконки в виде шестерёнки, расположенной справа от названия. Также набор точек сглаживания можно удалить, нажав на иконку в виде крестика, расположенную рядом с иконкой настроек.

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

- наименование точек — позволяет указать название набора точек сглаживания;
- кнопка «Привязать помещения» — позволяет привязать помещения, выбрав их в открывшемся модальном окне. Одно или несколько помещений необходимо выделить с помощью флажков и нажать на кнопку «Выбрать».

Далее пользователю необходимо установить на карте две точки с помощью левой и правой кнопок мыши (ЛКМ и ПКМ соответственно): красную — с помощью ЛКМ, розовую — с помощью ПКМ. Точки рекомендуется располагать на одной прямой независимо от её направления. Условная линия между точками не должна пересекать стены, иначе данная функциональность не будет работать.

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

Кнопка «Параметры навигации»
После нажатия на данную кнопку интерфейс изменится: вместо параметров этажей и здания отобразится список настроек навигации. В списке доступны следующие параметры:
- ширина клетки координат — позволяет указать ширину клетки координатной сетки в пикселях;
- высота клетки координат — позволяет указать высоту клетки координатной сетки в пикселях;
- качество отрисовки проложенного пути (DPI) — позволяет указать значение DPI для отрисовки проложенного пути;
- перемещение между этажами — позволяет выбрать способ перемещения между этажами, который будет учитываться при построении маршрута. Доступны два варианта: «По лестнице» и «На лифте»;
- отображать путь как — параметр, влияющий на отображение линии маршрута на карте. Доступны два варианта: точками или прерывистыми линиями;
- флажок «Разрешить прокладывать путь по диагонали» — разрешает или запрещает построение маршрута по диагонали;
- флажок «Автозум маршрута при построении» — включает или отключает автоматическое масштабирование карты при построении маршрута.

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


Кнопка «Выбрать/заменить карту»
После нажатия на кнопку «Выбрать/заменить карту» откроется модальное окно, в котором пользователь сможет выбрать карту из файлов, заранее загруженных в личный кабинет SmartPlayer. Чтобы выбрать новую карту, необходимо нажать на неё.

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

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


Чтобы переместить новую зону в нужное место на карте, необходимо зажать её левой кнопкой мыши и перетащить. Также размер зоны можно изменить, наведя указатель на её границу. При этом изменится отображение курсора.

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

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

В список настроек терминала входят следующие параметры:
- имя — позволяет указать название нового терминала;
- положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить терминал;
- положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить терминал.

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


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

В список настроек лифта входят следующие параметры:
- имя — позволяет указать название нового лифта;
- положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лифт;
- положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лифт;
- чекбокс (галочка) «Лифт включён» — включает или отключает использование лифта при построении маршрута. Если данный параметр активирован для лифтов на исходном и конечном этажах, маршрут будет строиться с учётом перемещения на лифте.

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


Кнопка «Добавить лестницу»
После нажатия на кнопку «Добавить лестницу» пользователь перейдёт в раздел настроек лестницы на карте, который отобразится на панели после изменения интерфейса.

В список настроек лестницы входят следующие параметры:
- имя — позволяет указать название новой лестницы;
- положение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лестницу;
- положение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить лестницу;
- чекбокс (галочка) «Лестница включена» — включает или отключает использование лестницы при построении маршрута. Если данный параметр активирован для лестниц на исходном и конечном этажах, маршрут будет строиться с учётом перемещения по лестнице.

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


Кнопка «Добавить помещение»
После нажатия на кнопку «Добавить помещение» пользователь перейдёт в раздел настроек помещения на карте, который отобразится на панели после изменения интерфейса.

В список настроек помещения входят следующие параметры:
- имя — позволяет указать наименование помещения;
- название в поиске — позволяет указать название, по которому помещение можно будет найти с помощью системы поиска;
- кнопка «Добавить изображение» — позволяет выбрать для помещения одно из изображений, доступных в личном кабинете;
- описание — позволяет указать дополнительную информацию о помещении;
- размер шрифта — позволяет выбрать доступный размер шрифта из списка;
- отступ от левого края карты — позволяет указать числовое значение отступа от левого края карты;
- отступ от верхнего края карты — позволяет указать числовое значение отступа от верхнего края карты;
- точка входа в помещение по оси X — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить точку входа в помещение;
- точка входа в помещение по оси Y — поле недоступно для ручного ввода. Значение определяется автоматически после нажатия левой кнопкой мыши на карту в месте, где пользователь хочет установить точку входа в помещение;
- категории — позволяет выбрать из списка категорию, к которой необходимо привязать помещение;
- отображать помещение как — позволяет выбрать вариант отображения помещения из списка. Доступны два варианта: отображать название помещения или не отображать его;
- кнопка «Добавить иконку» — позволяет выбрать для помещения одну из иконок, доступных в личном кабинете;
- кнопка «Привязать к карте» — позволяет привязать к помещению зону, добавленную на карте этажа;
- чекбокс (галочка) «Отображать в панели навигации» — включает или отключает отображение помещения на панели навигации.
После завершения настройки помещения пользователю необходимо нажать на кнопку «Применить» на правой панели. Если внесённые изменения не устраивают пользователя, он может нажать на расположенную слева кнопку «Отменить».


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

После нажатия на кнопку откроется страница предпросмотра виджета, на которой пользователь увидит:
- карту с помещениями и точкой расположения терминала;
- список категорий в правой части экрана;
- список этажей над списком категорий.
Также пользователь может воспользоваться экранной клавиатурой и кнопкой выбора языка для поиска нужного объекта на карте. Эти элементы расположены в правой нижней части экрана под списком категорий.


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

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

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

Интеграция в трансляцию
Чтобы проверить работу данного виджета на устройстве, пользователю необходимо создать трансляцию, добавить в неё настроенный ранее виджет в качестве контента, настроить расписание и назначить трансляцию на устройство. Подробнее об этих действиях можно узнать в следующих статьях базы знаний SmartPlayer:
Дополнительная информация
Если данная статья не помогает использовать функциональность по назначению или после её прочтения остаются вопросы, их можно задать в разделе «Обсуждения» вверху страницы.

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