Инструкции по разделам
- Сценарии
- События
- Доступы
- Управление камерами
- Базы данных
- SQL-запросы
- HTTP-запросы
- API
- Управление камерами
Сценарии
Сценарии – раздел меню, в котором отображаются существующие сценарии видеоаналитики. Здесь вы можете просмотреть сценарии, создать новые и отредактировать существующие.
Созданные сценарии – список сценариев с указанием названия, даты и времени создания сценария.
Создать сценарий – кнопка для создания нового сценария видеоаналитики. При нажатии открывается окно создания сценария. После создания сценарий появится в списке и можно кликнуть на него, чтобы перейти к наполнению и редактированию.
Загрузить сценарий – кнопка для загрузки сценария из внешнего источника. Позволяет импортировать сценарии, созданные ранее, в том числе, в других проектах.
Статус «Опубликован» – указывает на то, что одна из версий сценария опубликована, а значит, сценарий может быть привязан к камере и генерировать события.
Загрузить – иконка, позволяющая скачать сценарий на локальный компьютер. Вы можете сохранить копию сценария в файл для резервного копирования, создания нового на основе или переноса в другой проект.
Информация – иконка для просмотра информации о сценарии, добавленной в комментарии при создании сценария.
Удалить – иконка с изображением мусорного ведра, позволяющая удалить сценарий. При нажатии сценарий будет удален из системы без подтверждения
Создание сценария
Для того, чтобы добавить новый сценарий в список, кликните на кнопку "Создать сценарий" (3). Откроется окно создания сценария:
Название сценария – поле для ввода названия нового сценария. Введите уникальное и описательное имя для вашего сценария.
Описание сценария – поле для ввода описания сценария. Вы можете добавить подробное описание, чтобы объяснить цель и функциональность сценария.
Тип сценария –– выпадающий список для выбора типа сценария. Выберите соответствующую категорию или тип сценария из предложенного списка.
Создать на основе – выпадающий список для выбора уже существующего сценария, на основе которого вы хотите создать новый. Это полезно для создания сценариев, которые имеют схожие параметры или настройки.
Кнопка «Создать сценарий» – кнопка для сохранения и создания нового сценария. Нажмите эту кнопку после заполнения всех необходимых полей, чтобы завершить процесс создания сценария.
События
События – раздел меню, в котором вы можете просматривать все зарегистрированные события видеоаналитики.
Табы с названиями сценариев – навигационное меню между событиями по разным сценариям. Выберите нужный сценарий, чтобы увидеть соответствующие события.
Периоды времени – кнопки для быстрого выбора временного периода отображения событий: Сегодня, Вчера, Неделя, Месяц, Квартал, Год.
Диапазон дат – календарь для выбора конкретного диапазона дат, в котором вы хотите видеть события.
Фильтр событий – выбор отображаемых событий. Здесь указано, сколько событий показывается из числа добавленных в сценарий. При клике вы можете исключить определенное события из демонстрации, а затем включить обратно при необходимости.
Камеры – выбор конкретных камер, события с которых вы хотите просмотреть. В данном случае указано, что задействованы все камеры, к которым подключен сценарий «Умный шлагбаум» (11/11).
Статистика – вкладка для просмотра статистических данных по событиям.
События – активная вкладка, демонстрируемая на изображении, показывающая список событий.
Показывать по 20 событий – выбор количества событий, отображаемых на одной странице.
Фильтры – панель для применения дополнительных фильтров к отображаемым событиям. Вы можете добавлять различные критерии для фильтрации. Например, отфильтровать список по конкретному Гос. номеру.
Скачать отчет – кнопка для загрузки отчета по событиям в виде файла в формате .csv. Это удобно для анализа и отчетности.
Номера страниц – навигация по страницам списка событий. Вы можете переходить к следующим или предыдущим страницам с помощью этих кнопок.
Изображение события – миниатюра с кадром, на котором выявлено событие. При клике изображение откроется в увеличенном масштабе.
Время, в которое произошло событие и название камеры, на котором оно выявлено.
Детали события – дополнительные метки и информация о событии.
Отметка "Нравится" – кнопка для пометки события как верно выявленного. Можно использовать для операторов и дальнейшего обучения моделей и повышения точности их работы.
Скачать событие – кнопка для скачивания изображения конкретного события.
Доступы
Доступы – раздел меню, в котором вы можете управлять доступами пользователей по лицу и транспортных средств по гос.номеру к различным зонам, определяемым сценариями. Например, сценарий «Умный шлагбаум» будет открывать шлагбаум, если распознает гос. номер автомобиля и тот совпадет с гос. номером, добавленным в «доступы» и связанным с группой камер, в которую добавлена камера, зафиксировавшая этот гос. номер.
Имена – список имен пользователей или транспортных средств, для которых настроены доступы.
Тип ID – тип идентификатора. В данном случае, это может быть "Лицо" или "Гос. номер".
ID – гос. номер автомобиля или иконка изображения, указывающая что загружена фотография для распознавания лица пользователя.
Группы камер – группы камер, к которым привязан данный идентификатор: лицо или номер. Определяет сценарии, которые смогут использовать эти доступы: те сценарии, что подключены к любой камере из выбраной для доступа группы.
Комментарий – поле для дополнительных комментариев или заметок, связанных с доступом.
Экспорт доступов – кнопка для экспорта списка доступов в файл. Это может быть полезно для создания отчетов или резервного копирования.
Редактировать доступы – кнопка для редактирования существующих доступов. Нажмите ее, чтобы внести изменения в настройки доступа для выбранных пользователей или транспортных средств, а также добавить доступы.
Номера страниц – навигация по страницам списка доступов. Вы можете переходить к следующим или предыдущим страницам с помощью этих кнопок.
Поиск на странице – поле для поиска по текущему списку доступов. Введите любую добавленную информацию о доступе, чтобы быстро найти его в списке.
Редактирование доступов
Редактирование доступов становится доступно при клике на кнопку "Редактировать доступы" (8)
Кнопка "Отменить" - позволяет отменить изменения и выйти из режима редактирования.
Кнопка "Сохранить изменения" - предназначена для сохранения любых внесенных изменений в конфигурации доступов.
Кнопка "Добавить доступ" - дает возможность создать новую запись о доступе для лица или транспортного средства.
Редактируемые поля. Для изменения кликните и введите/вставьте/загрузите нужное
Управление камерами
Управление камерами – Раздел, содержащий список подключенных камер к проекту, возможность подключить новые, отредактировать существующие, привязать сценарий к камере для выявления событий, мониторить и управлять состоянием камер.
Состояние камеры – индикатор состояния камеры. Вы можете включить или выключить камеру, нажав на переключатель. Желтым отображаются неполадки: по какой-то причине мы не смогли получить кадр с камеры.
Название камеры – поле, где отображается название камеры. Названия помогают идентифицировать камеры в списке.
Группа – поле, указывающее на группу, к которой относится камера. Группы камер используются для выдачи доступов по лицу или по гос. номеру в разделе "Доступы".
Тип – поле, указывающее на тип камеры. Существующие типы: "Снэпшот" , "RTSP поток" или "Домофоны"
Сценарии – поле, показывающее привязанные к камере сценарии для генерации событий видеоаналитики.
Удаление камеры – значок корзины для удаления камеры. Нажмите на этот значок, чтобы удалить соответствующую камеру из списка.
Поиск по названиям или ссылка – строка поиска для быстрого нахождения камеры по её названию или ссылке. Введите текст, чтобы отфильтровать камеры в списке.
Обновить список – кнопка для обновления списка камер. Нажмите, чтобы загрузить актуальный статус и данные о камерах.
Добавить камеру – кнопка для добавления новой камеры. Нажмите, чтобы открыть форму для добавления новой камеры в систему.
Добавление камеры
Кнопка «Вернуться к списку камер» возвращает пользователя на страницу со списком камер.
Поле «Ссылка на видеопоток». Вставьте сюда ссылку для получения видеопотока с вашей камеры.
Поле «Название камеры». Придумайте и введите название камеры, чтобы отличать ее от других в списке.
Чекбокс «Внешняя камера» позволяет вам создать камеру-заглушку, чтобы слать на нее изображениясамостоятельно через собственные или сторонние сервисы и иметь возможность подключить сценарии для выявления событий видеоаналитики.
Поле «Тип камеры» . В нем автоматически указывается тип камеры: Снэпшот/RTSP-поток/Домофоны
Поле «FPS». Задайте частоту обработки кадров в кадрах в секунду. Лучше выставлять дробные значение вроде 0,1 (1 кадр в 10 секунд), чтобы не создавать очередь обработки и не получать события слишком часто.
Сценарии. Здесь вы можете выбрать сценарий для привязки к камере из списка добавленных в проект в разделе "Сценарии" и опубликованных.
Группы. Введите название группы или групп, чтобы объединить камеры по определенному признаку. Это поможет вам проще ориентироваться в списке камер, а также выдать доступ (по лицу или гос.номеру в разделе "Доступы") при необходимости сразу на группу камер.
Чекбокс "Доступ к камере по логину и паролю". Выберите, если для доступа к вашей камере нужен логин и пароль.
Поле «Логин» . Введите, если для доступа к вашей камере нужен логин.
Поле «Пароль». Введите, если для доступа к вашей камере нужен пароль.
Поле для отображения изображения с камеры. Каждый раз после редактирования любого из полей мы пытаемся получить кадр с камеры, когда получение кадра пройдет успешно, он отобразится в этом поле.
Кнопка «Обновить кадр» пытается получить новый кадр в реальном времени с камеры. Если получается, кадр обновляется.
Кнопка «Нарисовать» позволяет добавить линии разметки на кадр с камеры. Разметка требуется для большинства сценариев.
Кнопка «Удалить разметку» удаляет разметку с кадра.
Поле «Разметка камеры (X, Y)» содержит координаты разметки камеры. При добавлении разметки вручную координаты подставляются автоматически.
Базы данных
- Перейдите в раздел «Базы данных»
- Нажмите на кнопку «Новая база данных»
- Введите параметры вашей Базы данных
- Нажмите на кнопку «Добавить»
SQL-запросы
Работа с SQL-запросами
Данное руководство поможет вам разобраться с настройкой баз данных, созданием SQL-запросов и их использованием в сценариях на платформе.
1. Работа с базами данных
1.1. Просмотр списка баз данных
1.2. Добавление новой базы данных
-
Нажмите кнопку "Добавить базу данных".
-
Введите следующие параметры:
-
Название базы данных.
-
Тип базы данных (например, Oracle, MySQL, PostgreSQL).
-
Хост, порт, имя пользователя, пароль и имя базы данных.
-
-
Протестируйте подключение перед добавлением, чтобы удостовериться, что имеется доступ к базе данных с введенными параметрами. Результат проверки рабочего подключение "успешное подключение"
- Нажмите кнопку "Добавить базу данных" для сохранения.
-
После добавления база появится в списке.
1.3. Настройка базы данных
-
Нажмите на иконку параметров (шестерёнка) напротив нужной базы данных в списке.
-
Откроется модальное окно с параметрами базы данных:
-
Вы можете изменить название, тип базы данных, хост, порт, имя пользователя, пароль, имя базы данных и проверить подключение.
-
Для сохранения изменений нажмите "Сохранить изменения".
-
-
Для удаления базы данных нажмите кнопку "Удалить базу данных".
-
Если база данных используется в запросах, система уведомит вас о невозможности удаления и покажет список связанных запросов.
-
2. Работа с SQL-запросами
2.1. Просмотр списка SQL-запросов
-
Перейдите в раздел "SQL-запросы".
-
На странице отображается список всех созданных SQL-запросов:
-
Колонка "Базы данных и сценарии" отображает, к каким базам данных и в каких сценариях использован запрос.
-
Используйте поле поиска для поиска запросов по названию.
-
Вы можете фильтровать запросы по базам данных или сценариям.
-
-
Для создания нового SQL-запроса нажмите кнопку "Создать SQL-запрос".
2.2. Создание SQL-запроса
-
Нажмите кнопку "Создать SQL-запрос".
-
В открывшемся редакторе выполните следующие действия:
-
В разделе "Основные данные" укажите название запроса и выберите базу данных из выпадающего списка.
-
В разделе "SQL-запрос" введите текст SQL-запроса.
- После этого доступно сохранение запроса, но сохранять запрос без успешного получения результата крайне не рекомендуется, потому что это может привести к ошибкам в реальных диалогах при использовании такого запроса в сценарии впоследствии.
-
В разделе "Переменные во входных параметрах", если такие есть, добавьте параметры запроса:
-
Укажите имя переменной.
-
Задайте тип переменной ("Число" или "Строка").
-
-
-
Для проверки запроса нажмите кнопку "Получить результаты":
-
Отобразятся результаты выполнения запроса.
-
Убедитесь, что запрос выполняется корректно, и результаты соответствуют ожидаемым.
-
-
Нажмите кнопку "Сохранить запрос" для завершения.
2.3. Редактирование SQL-запроса
-
Для редактирования существующего запроса выберите его из списка и нажмите на его название.
-
Внесите изменения в открывшемся редакторе.
-
Нажмите кнопку "Сохранить запрос" для сохранения изменений.
2.4. Удаление SQL-запроса
HTTP-запросы
Работа с HTTP-запросами
Это руководство поможет вам научиться создавать HTTP-запросы, редактировать их и использовать в сценариях на платформе.
1. Работа с HTTP-запросами
1.1. Просмотр списка запросов
-
Перейдите в раздел "HTTP-запросы".
-
На странице отображается список всех существующих запросов:
-
Поле поиска позволяет найти запрос по названию.
-
Фильтры помогут выбрать запросы, связанные с определёнными сценариями.
-
-
Чтобы создать новый запрос, нажмите кнопку "Создать HTTP-запрос".
1.2. Создание HTTP-запроса
-
После нажатия кнопки "Создать HTTP-запрос" откроется редактор.
-
В разделе "Основные данные":
-
Укажите название запроса.
-
Выберите тип запроса (например, GET или POST).
-
Вставьте URL-адрес для отправки запроса.
- После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
-
-
В разделе "Входные параметры":
-
На вкладке "Параметры" добавьте ключи и значения параметров.
-
На вкладке "Заголовки" укажите заголовки запроса.
-
На вкладке "Тело" укажите структуру тела запроса, если это POST-запрос.
- Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»
-
-
В разделе "Принимаемые результаты":
1.3. Работа с разделом "Результаты"
-
После настройки нажмите кнопку "Получить результаты".
-
Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.
-
Сравните возвращённые результаты с указанными принимаемыми параметрами: совпадения подсвечиваются зелёным цветом, а несоответствия красным. Вы можете редактировать или удалять принимаемые параметры в этом разделе, чтобы уточнить настройки.
1.4. Сохранение запроса
-
Сохраняйте запрос только после того, как убедитесь, что принимаемые результаты совпадают с полученными в разделе "Результаты".
-
Если результаты не совпадают, скорректируйте принимаемые параметры или настройте запрос повторно, чтобы избежать ошибок в реальных звонках.
API
Раздел API в навигационном меню перенаправляет на страницу API, с различными методами для взаимодействия с платформой.
Управление камерами
Камеры (список камер)
Назначение раздела
Раздел "Камеры" предназначен для управления списком видеоустройств, подключённых к платформе. Здесь отображаются как обычные камеры, так и внешние источники видеопотока. Можно быстро проверить статус устройств, организовать группировку, подключить сценарии видеоаналитики, а также удалить устройства при необходимости.
Просмотр списка камер
В таблице представлены все добавленные камеры и источники:
-
Название камеры
-
Статус подключения (включена/выключена)
-
Тип устройства (RTSP-поток / внешний источник)
-
Названия подключённых сценариев видеоаналитики
-
Информация о группе
-
Техническое предупреждение — "Проблемы с получением кадров"
Можно использовать строку поиска или фильтры справа, чтобы быстро найти нужное устройство по имени, группе, типу, сценарию и другим параметрам.
Добавление новой камеры
Нажмите кнопку "Добавить камеру", затем выберите Камера или Внешний источник. После этого откроется соответствующая страница добавления с настройками устройства.
Подробнее см. в отдельной инструкции по добавлению и редактированию камер.
Удаление камеры
Чтобы удалить камеру, нажмите иконку корзины рядом с её названием в списке. При удалении система предупредит, что события видеоаналитики с этой камеры также будут удалены.
Особенности
-
Камеры можно объединять в группы, что помогает фильтровать список и управлять доступами.
-
Поддерживается отображение технических статусов: например, "Проблемы с получением кадров".
-
Интерфейс поддерживает поиск и фильтрацию по множеству параметров.
Советы по работе
-
Давайте камерам понятные названия (например, "Цех 2, складская зона") — это ускоряет поиск и поддержку.
-
Используйте группировку, если камер много — так можно централизованно управлять доступами.
-
Регулярно проверяйте статус камер — жёлтые метки подскажут, если с видеопотоком возникли проблемы.
Добавление камер и внешних источников
Инструкция описывает процесс добавления новых устройств видеонаблюдения в систему. Можно добавить два типа устройств: камера или внешний источник. В зависимости от выбора доступны разные поля и параметры настройки.
Добавление камеры
-
Перейдите в раздел Камеры и нажмите кнопку Добавить камеру.
-
В открывшемся окне выберите тип подключения — Камера.
-
Заполните обязательные поля:
-
Название — укажите понятное имя устройства (например, "Склад 1, северный вход").
-
Протокол — по умолчанию RTSP.
-
IP-адрес и порт (обычно 554).
-
Логин и пароль — если камера требует авторизацию.
-
-
При необходимости выберите одну или несколько групп, к которым будет относиться камера.
-
Выберите модель камеры и шаблон данных (если доступно).
-
Настройте дополнительные параметры с помощью тумблеров:
-
Включить видеоаналитику — влияет только на доступность подключения сценариев после добавления устройства.
-
Включить онлайн-просмотр — при активации камера будет доступна для онлайн-мониторинга в соответствующих разделах.
-
Хранить видеоархив — при активации становятся доступными параметры настройки хранения: срок хранения (от 3 часов до 180 дней).
-
-
При корректных данных справа отображается кадр с камеры.
-
Нажмите Добавить камеру для завершения настройки.
Если камера успешно добавлена, появится предложение сразу подключить сценарии видеоаналитики.
Добавление внешнего источника
-
Перейдите в раздел Камеры и нажмите кнопку Добавить камеру.
-
В окне выбора типа источника выберите Внешний источник.
-
Заполните следующие поля:
-
Название источника — задайте имя, по которому источник будет отображаться в списке.
-
Группы — при необходимости выберите одну или несколько групп.
-
-
Нажмите Добавить внешний источник, чтобы завершить процесс.
Созданный внешний источник будет использоваться для передачи изображений и событий сценариям видеоаналитики через API или интеграционные модули. Подгрузка изображения при добавлении внешнего источника является рекомендуемой, но не обязательной — её можно выполнить позже при подключении сценария., чтобы завершить процесс.
Примечания
-
Все незаполненные обязательные поля будут выделены при попытке сохранения.
-
Если URL потока указан с ошибкой, появится предупреждение (например, "отсутствует протокол" или "не удалось получить кадр").
-
При отключении тумблеров связанные поля скрываются из интерфейса (только для камер).
-
При закрытии формы без сохранения система предупредит о несохранённых изменениях.
После добавления устройств настройка сценариев выполняется через интерфейс подключения сценариев видеоаналитики или позже через редактирование устройства.