Инструкции по разделам


Сценарии

image.png

image.png
Созданные сценарии – список сценариев с указанием названия, даты и времени создания сценария.

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

image.png
Загрузить сценарий – кнопка для загрузки сценария из внешнего источника. Позволяет импортировать сценарии, созданные ранее, в том числе, в других проектах.

image.png
Статус «Опубликован» – указывает на то, что одна из версий сценария опубликована, а значит,  сценарий может быть привязан к камере и генерировать события.

image.png
Загрузить – иконка, позволяющая скачать сценарий на локальный компьютер. Вы можете сохранить копию сценария в файл для резервного копирования, создания нового на основе или переноса в другой проект.

image.png
Информация – иконка для просмотра информации о сценарии, добавленной в комментарии при создании сценария.

image.png
Удалить – иконка с изображением мусорного ведра, позволяющая удалить сценарий. При нажатии сценарий будет удален из системы без подтверждения

Создание сценария

Для того, чтобы добавить новый сценарий в список, кликните на кнопку "Создать сценарий" (3). Откроется окно создания сценария:

image.png

image.png
Описание сценария – поле для ввода описания сценария. Вы можете добавить подробное описание, чтобы объяснить цель и функциональность сценария.

image.png
Тип сценария –– выпадающий список для выбора типа сценария. Выберите соответствующую категорию или тип сценария из предложенного списка.

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

image.png
Кнопка «Создать сценарий» – кнопка для сохранения и создания нового сценария. Нажмите эту кнопку после заполнения всех необходимых полей, чтобы завершить процесс создания сценария.

События

image.png

image.png
События – раздел меню, в котором вы можете просматривать все зарегистрированные события видеоаналитики.

image.png
Табы с названиями сценариев – навигационное меню между событиями по разным сценариям. Выберите нужный сценарий, чтобы увидеть соответствующие события.

image.png
Периоды времени – кнопки для быстрого выбора временного периода отображения событий: Сегодня, Вчера, Неделя, Месяц, Квартал, Год.

image.png
Диапазон дат – календарь для выбора конкретного диапазона дат, в котором вы хотите видеть события.

image.png
Фильтр событий – выбор отображаемых событий. Здесь указано, сколько событий показывается из числа добавленных в сценарий. При клике вы можете исключить определенное события из демонстрации, а затем включить обратно при необходимости.

image.png
Камеры – выбор конкретных камер, события с которых вы хотите просмотреть. В данном случае указано, что задействованы все камеры, к которым подключен сценарий «Умный шлагбаум» (11/11).

image.png
Статистика – вкладка для просмотра статистических данных по событиям.

image.png
События – активная вкладка, демонстрируемая на изображении, показывающая список событий.

image.png
Показывать по 20 событий – выбор количества событий, отображаемых на одной странице.

image.png
Фильтры – панель для применения дополнительных фильтров к отображаемым событиям. Вы можете добавлять различные критерии для фильтрации. Например, отфильтровать список по конкретному Гос. номеру.

image.png

image.png
Скачать отчет – кнопка для загрузки отчета по событиям в виде файла в формате .csv. Это удобно для анализа и отчетности.

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

image.png
Изображение события – миниатюра с кадром, на котором выявлено событие. При клике изображение откроется в увеличенном масштабе.

image.png
Время, в которое произошло событие и название камеры, на котором оно выявлено.

image.png
Детали события – дополнительные метки и информация о событии. 

image.png
Отметка "Нравится" – кнопка для пометки события как верно выявленного. Можно использовать для операторов и дальнейшего обучения моделей и повышения точности их работы.

image.png
Скачать событие – кнопка для скачивания изображения конкретного события. 

Доступы

image.png

image.png
Доступы – раздел меню, в котором вы можете управлять доступами пользователей по лицу и транспортных средств по гос.номеру к различным зонам, определяемым сценариями. Например, сценарий «Умный шлагбаум» будет открывать шлагбаум, если распознает гос. номер автомобиля и тот совпадет с гос. номером, добавленным в «доступы» и связанным с группой камер, в которую добавлена камера, зафиксировавшая этот гос. номер.

image.png
Имена –  список имен пользователей или транспортных средств, для которых настроены доступы.

image.png
Тип ID –  тип идентификатора. В данном случае, это может быть "Лицо" или "Гос. номер".

image.png
ID – гос. номер автомобиля или иконка изображения, указывающая что загружена фотография для распознавания лица пользователя.

image.png
Группы камер – группы камер, к которым привязан данный идентификатор: лицо или номер. Определяет сценарии, которые смогут использовать эти доступы: те сценарии, что подключены к любой камере из выбраной для доступа группы.

image.png
Комментарий – поле для дополнительных комментариев или заметок, связанных с доступом.

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

image.png
Редактировать доступы – кнопка для редактирования существующих доступов. Нажмите ее, чтобы внести изменения в настройки доступа для выбранных пользователей или транспортных средств, а также добавить доступы.

image.png
Номера страниц – навигация по страницам списка доступов. Вы можете переходить к следующим или предыдущим страницам с помощью этих кнопок.

image.png
Поиск на странице – поле для поиска по текущему списку доступов. Введите любую добавленную информацию о доступе, чтобы быстро найти его в списке.

Редактирование доступов

Редактирование доступов становится доступно при клике на кнопку "Редактировать доступы" (8)

image.png

image.png
Кнопка "Отменить" - позволяет отменить изменения и выйти из режима редактирования.

image.png
Кнопка "Сохранить изменения" - предназначена для сохранения любых внесенных изменений в конфигурации доступов.

image.png
Кнопка "Добавить доступ" - дает возможность создать новую запись о доступе для лица или транспортного средства.

image.png
Редактируемые поля. Для изменения кликните и введите/вставьте/загрузите нужное

Управление камерами

image.png

image.png
Управление камерами – Раздел, содержащий список подключенных камер к проекту, возможность подключить новые, отредактировать существующие, привязать сценарий к камере для выявления событий, мониторить и управлять состоянием камер.

image.png
Состояние камеры – индикатор состояния камеры. Вы можете включить или выключить камеру, нажав на переключатель. Желтым отображаются неполадки: по какой-то причине мы не смогли получить кадр с камеры.

image.png
Название камеры – поле, где отображается название камеры. Названия помогают идентифицировать камеры в списке.

image.png
Группа – поле, указывающее на группу, к которой относится камера. Группы камер используются для выдачи доступов по лицу или по гос. номеру в разделе "Доступы". 

image.png
Тип – поле, указывающее на тип камеры. Существующие типы: "Снэпшот" , "RTSP поток" или "Домофоны"

image.png
Сценарии – поле, показывающее привязанные к камере сценарии для генерации событий видеоаналитики.

image.png
Удаление камеры – значок корзины для удаления камеры. Нажмите на этот значок, чтобы удалить соответствующую камеру из списка.

image.png
Поиск по названиям или ссылка  – строка поиска для быстрого нахождения камеры по её названию или ссылке. Введите текст, чтобы отфильтровать камеры в списке.

image.png
Обновить список – кнопка для обновления списка камер. Нажмите, чтобы загрузить актуальный статус и данные о камерах.

image.png
Добавить камеру – кнопка для добавления новой камеры. Нажмите, чтобы открыть форму для добавления новой камеры в систему.

Добавление камеры

image.png

image.png
Кнопка «Вернуться к списку камер» возвращает пользователя на страницу со списком камер.

image.png
Поле «Ссылка на видеопоток». Вставьте сюда ссылку для получения видеопотока с вашей камеры.

image.png
Поле «Название камеры». Придумайте и введите название камеры, чтобы отличать ее от других в списке.

image.png
Чекбокс «Внешняя камера» позволяет вам создать камеру-заглушку, чтобы слать на нее изображениясамостоятельно через собственные или сторонние сервисы и иметь возможность подключить сценарии для выявления событий видеоаналитики.

image.png
Поле «Тип камеры» . В нем автоматически указывается тип камеры: Снэпшот/RTSP-поток/Домофоны

image.png
Поле «FPS». Задайте частоту обработки кадров в кадрах в секунду. Лучше выставлять дробные значение вроде 0,1 (1 кадр в 10 секунд), чтобы не создавать очередь обработки и не получать события слишком часто.

image.png
Сценарии. Здесь вы можете выбрать сценарий для привязки к камере из списка добавленных в проект в разделе "Сценарии" и опубликованных. 

image.png
Группы. Введите название группы или групп, чтобы объединить камеры по определенному признаку. Это поможет вам проще ориентироваться в списке камер, а также выдать доступ (по лицу или гос.номеру в разделе "Доступы") при необходимости сразу на группу камер.

image.png
Чекбокс "Доступ к камере по логину и паролю". Выберите, если для доступа к вашей камере нужен логин и пароль.

image.png
Поле «Логин» . Введите, если для доступа к вашей камере нужен логин.

image.png
Поле «Пароль». Введите, если для доступа к вашей камере нужен пароль.

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

image.png
Кнопка «Обновить кадр» пытается получить новый кадр в реальном времени с камеры. Если получается, кадр обновляется.

image.png
Кнопка «Нарисовать» позволяет добавить линии разметки на кадр с камеры. Разметка требуется для большинства сценариев.

image.png
Кнопка «Удалить разметку» удаляет разметку с кадра.

image.png
Поле «Разметка камеры (X, Y)» содержит координаты разметки камеры. При добавлении разметки вручную координаты подставляются автоматически.

Базы данных

Перед началом работы с SQL-запросами, нужно добавить вашу базу данных в платформу.
Для этого:
  1. Перейдите в раздел «Базы данных»
  2. Нажмите на кнопку «Новая база данных»
  3. Введите параметры вашей Базы данных
  4. Нажмите на кнопку «Добавить»

image.png

SQL-запросы

Работа с SQL-запросами

Данное руководство поможет вам разобраться с настройкой баз данных, созданием SQL-запросов и их использованием в сценариях на платформе.


1. Работа с базами данных

1.1. Просмотр списка баз данных

image.png

  1. Перейдите в раздел "Базы данных".

  2. На странице отображается список подключённых баз данных

  3. Для добавления новой базы данных нажмите кнопку "Добавить базу данных".

    image.png

1.2. Добавление новой базы данныхimage.png

  1. Нажмите кнопку "Добавить базу данных".

  2. Введите следующие параметры:

    • Название базы данных.

    • Тип базы данных (например, Oracle, MySQL, PostgreSQL).

    • Хост, порт, имя пользователя, пароль и имя базы данных.

  3. Протестируйте подключение перед добавлением, чтобы удостовериться, что имеется доступ к базе данных с введенными параметрами. Результат проверки рабочего подключение "успешное подключение"

    image.png

  4. Нажмите кнопку "Добавить базу данных" для сохранения.
  5. После добавления база появится в списке.

1.3. Настройка базы данных

image.png

  1. Нажмите на иконку параметров (шестерёнка) напротив нужной базы данных в списке.

  2. Откроется модальное окно с параметрами базы данных:

    • Вы можете изменить название, тип базы данных, хост, порт, имя пользователя, пароль, имя базы данных и проверить подключение.

    • Для сохранения изменений нажмите "Сохранить изменения".

  3. Для удаления базы данных нажмите кнопку "Удалить базу данных".

    • Если база данных используется в запросах, система уведомит вас о невозможности удаления и покажет список связанных запросов.


2. Работа с SQL-запросами

2.1. Просмотр списка SQL-запросов

image.png

image.png

  1. Перейдите в раздел "SQL-запросы".

  2. На странице отображается список всех созданных SQL-запросов:

    • Колонка "Базы данных и сценарии" отображает, к каким базам данных и в каких сценариях использован запрос.

    • Используйте поле поиска для поиска запросов по названию.

    • Вы можете фильтровать запросы по базам данных или сценариям.

  3. Для создания нового SQL-запроса нажмите кнопку "Создать SQL-запрос".

2.2. Создание SQL-запроса

image.png

  1. Нажмите кнопку "Создать SQL-запрос".

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

    • В разделе "Основные данные" укажите название запроса и выберите базу данных из выпадающего списка.

    • В разделе "SQL-запрос" введите текст SQL-запроса.

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

      • Укажите имя переменной.

      • Задайте тип переменной ("Число" или "Строка").

  3. Для проверки запроса нажмите кнопку "Получить результаты":

    • Отобразятся результаты выполнения запроса.

    • Убедитесь, что запрос выполняется корректно, и результаты соответствуют ожидаемым.

  4. Нажмите кнопку "Сохранить запрос" для завершения.

2.3. Редактирование SQL-запроса

image.png

  1. Для редактирования существующего запроса выберите его из списка и нажмите на его название.

  2. Внесите изменения в открывшемся редакторе.

  3. Нажмите кнопку "Сохранить запрос" для сохранения изменений.

2.4. Удаление SQL-запроса

  1. Нажмите иконку удаления рядом с запросом в списке.

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

    image.png


HTTP-запросы

Работа с HTTP-запросами

Это руководство поможет вам научиться создавать HTTP-запросы, редактировать их и использовать в сценариях на платформе.


1. Работа с HTTP-запросами

1.1. Просмотр списка запросов

image.png

  1. Перейдите в раздел "HTTP-запросы".

  2. На странице отображается список всех существующих запросов:

    • Поле поиска позволяет найти запрос по названию.

    • Фильтры помогут выбрать запросы, связанные с определёнными сценариями.

  3. Чтобы создать новый запрос, нажмите кнопку "Создать HTTP-запрос".

1.2. Создание HTTP-запроса

image.png


  1. После нажатия кнопки "Создать HTTP-запрос" откроется редактор.

  2. В разделе "Основные данные":

    • Укажите название запроса.

    • Выберите тип запроса (например, GET или POST).

    • Вставьте URL-адрес для отправки запроса.

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

    • На вкладке "Параметры" добавьте ключи и значения параметров.

    • На вкладке "Заголовки" укажите заголовки запроса.

    • На вкладке "Тело" укажите структуру тела запроса, если это POST-запрос.

    • Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»
       image.png
  4. В разделе "Принимаемые результаты":

    • Добавьте параметры, которые сервер возвращает в ответе.

    • Укажите вложенные параметры (до 5 уровней вложенности).

    • После добавления параметров нажмите "Сохранить запрос". Затем перейдите в раздел "Результаты", чтобы протестировать запрос.

      image.png

1.3. Работа с разделом "Результаты"

  1. После настройки нажмите кнопку "Получить результаты".

  2. Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.

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

image.png

1.4. Сохранение запроса

  1. Сохраняйте запрос только после того, как убедитесь, что принимаемые результаты совпадают с полученными в разделе "Результаты".

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

image.png

API

image.png

Раздел API в навигационном меню перенаправляет на страницу API, с различными методами для взаимодействия с платформой.

image.png

Управление камерами

Управление камерами

Камеры (список камер)

Назначение раздела

Раздел "Камеры" предназначен для управления списком видеоустройств, подключённых к платформе. Здесь отображаются как обычные камеры, так и внешние источники видеопотока. Можно быстро проверить статус устройств, организовать группировку, подключить сценарии видеоаналитики, а также удалить устройства при необходимости.

Просмотр списка камер

В таблице представлены все добавленные камеры и источники:

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

Добавление новой камеры

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

Подробнее см. в отдельной инструкции по добавлению и редактированию камер.

Удаление камеры

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


Особенности


Советы по работе


 

Управление камерами

Добавление камер и внешних источников

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


Добавление камеры

  1. Перейдите в раздел Камеры и нажмите кнопку Добавить камеру.

  2. В открывшемся окне выберите тип подключения — Камера.

  3. Заполните обязательные поля:

    • Название — укажите понятное имя устройства (например, "Склад 1, северный вход").

    • Протокол — по умолчанию RTSP.

    • IP-адрес и порт (обычно 554).

    • Логин и пароль — если камера требует авторизацию.

  4. При необходимости выберите одну или несколько групп, к которым будет относиться камера.

  5. Выберите модель камеры и шаблон данных (если доступно).

  6. Настройте дополнительные параметры с помощью тумблеров:

    • Включить видеоаналитику — влияет только на доступность подключения сценариев после добавления устройства.

    • Включить онлайн-просмотр — при активации камера будет доступна для онлайн-мониторинга в соответствующих разделах.

    • Хранить видеоархив — при активации становятся доступными параметры настройки хранения: срок хранения (от 3 часов до 180 дней).

  7. При корректных данных справа отображается кадр с камеры.

  8. Нажмите Добавить камеру для завершения настройки.

Если камера успешно добавлена, появится предложение сразу подключить сценарии видеоаналитики.


Добавление внешнего источника

  1. Перейдите в раздел Камеры и нажмите кнопку Добавить камеру.

  2. В окне выбора типа источника выберите Внешний источник.

  3. Заполните следующие поля:

    • Название источника — задайте имя, по которому источник будет отображаться в списке.

    • Группы — при необходимости выберите одну или несколько групп.

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

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


Примечания

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