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

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

Текущая версия от 23:13, 1 июля 2026

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

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

Последовательность настройки виджета

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

  1. Перейдите в общие настройки виджета, нажав на иконку в виде шестерёнки. После завершения настройки нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.
  2. Нажмите на кнопку «Категории», чтобы открыть страницу создания категорий помещений. На этой странице также можно отредактировать существующие категории.
  3. Добавьте этаж с помощью одноимённой иконки и нажмите на кнопку «Выбрать карту», расположенную справа. Карта должна быть предварительно добавлена в отдельную папку личного кабинета.
  4. Нажмите на кнопку «Настроить клики» и выделите нужные помещения на карте.
  5. Добавьте терминал с помощью одноимённой кнопки на панели справа.
  6. Добавьте остальные объекты здания: лифты, лестницы и помещения.
  7. Настройте стены на карте и точки входа в помещения.
  8. Повторяйте шаги 2–7, пока не будет добавлено нужное количество этажей.
  9. После настройки всех этажей нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.
  10. Повторно откройте виджет и нажмите на кнопку «Перейти в навигацию» в левом нижнем углу, чтобы проверить его работоспособность. Если все параметры настроены правильно, можно будет построить маршрут до нужного помещения.
  11. Чтобы изменить настройки виджета, нажмите на кнопку «Вернуться в конструктор» в левом нижнем углу.
  12. Если маршрут до определённого местоположения строится не по прямой, а зигзагами, его можно сгладить. Для этого откройте страницу настроек с помощью кнопки «Точки сглаживания».
  13. Установите точки сглаживания маршрута и нажмите на кнопки «Применить настройки» и «Сохранить», расположенные в нижней части виджета по центру.

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

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

Пример отображения виджета в формате ZIP-архива

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

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

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

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

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

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

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

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

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

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

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

Общие настройки виджета

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

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

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

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

Для настройки доступны следующие параметры:

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

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

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

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

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

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

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

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

Настройка здания

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

  • выбор здания — позволяет выбрать здание из списка доступных вариантов;
  • название здания — позволяет указать наименование здания;
  • кнопка «Добавить здание» — создаёт новое здание и открывает страницу для настройки навигации;
  • кнопка «Удалить здание» — удаляет выбранное здание из виджета. Перед удалением откроется модальное окно для подтверждения действия;
Пример отображения раздела «Здания» в виджете

Настройка этажей

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

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

Кнопка «Добавить этаж»

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

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

Установка границ на карте этажа

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

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

Пример отображения построения границ на карте этажа

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

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

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

Кнопка «Категории»

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

Пример отображения кнопки «Добавить категорию»

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

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

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

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

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

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

Кнопка «Точки сглаживания»

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

Пример отображения инструкции по работе с точками сглаживания и кнопки «Добавить точки»

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

Пример отображения изменения интерфейса и иконок для взаимодействия с точками сглаживания

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

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

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

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

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

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

Кнопка «Параметры навигации»

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

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

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

Настройка атрибутов этажа

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

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

Кнопка «Выбрать/заменить карту»

Пользователю рекомендуется заранее подготовить карты этажей для виджета в формате SVG.

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

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

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

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

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

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

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

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

Пример отображения перемещения зоны и изменения её размера

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

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

Кнопка «Добавить терминал»

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

Пример отображения настроек на панели после нажатия на кнопку «Добавить терминал»

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

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

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

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

Кнопка «Добавить лифт»

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

Пример отображения настроек на панели после нажатия на кнопку «Добавить лифт»

В список настроек лифта входят следующие параметры:

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

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

Пример отображения кнопок «Применить» и «Отмена»
По окончании настройки пользователь увидит добавленные лифты в списке. Лифты из списка можно отредактировать или удалить с помощью специальных иконок на данной панели.
Пример отображения настроенных лифтов и иконок для взаимодействия с ними

Кнопка «Добавить лестницу»

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

Пример отображения настроек на панели после нажатия на кнопку «Добавить лестницу»

В список настроек лестницы входят следующие параметры:

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

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

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

Кнопка «Добавить помещение»

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

Пример отображения настроек на панели после нажатия на кнопку «Добавить помещение»

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

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

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

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

Переход в навигацию

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

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

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

  • карту с помещениями и точкой расположения терминала;
  • список категорий в правой части экрана;
  • список этажей над списком категорий.

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

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

Построение маршрута на странице предпросмотра

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

Пример отображения подсвеченного объекта на карте и кнопки «Маршрут» рядом с системой поиска

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

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

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

Пример отображения кнопки «Завершить маршрут»

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

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

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

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

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

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