Установка

Подготовка

Windows

• Перед установкой OMNI Agent на Windows установите Microsoft Visual C++ Redistributable for Visual Studio.
• Убедитесь, что имя пользователя Windows содержит только ASCII символы (латинские буквы, цифры и знаки препинания).

Linux

Дайте разрешение на выполнение инсталлятора:

• Нажмите на иконку инсталлятора правой кнопкой мыши.
• Откройте пункт Properties, перейдите во вкладку Permission и поставьте галочку в поле Allow execute.

Установка

Установка с GUI

1. Скачайте инсталлятор OMNI Agent из дистрибутива поставки.
2. Запустите инсталлятор и следуйте инструкциям мастера установки.

Установка без GUI (только для Linux/Windows x86_64)

Для установки на Linux

Установите следующие GUI библиотеки:

sudo apt update && sudo apt install libxrender1 libx11-xcb-dev libxkbcommon-x11-0 libfontconfig1 fontconfig libfontconfig1-dev

1. Скачайте инсталлятор OMNI Agent из дистрибутива поставки.

2. Запустите инсталлятор:

   Windows:

   InstallOMNIAgent.exe install

   Команда запускается из консоли от имени администратора.

   Linux:

   sudo -E ./InstallOMNIAgent install

   При возникновении любых предупреждений или ошибок с упоминанием папки Desktop, проигнорируйте их (введите Ignore).

   Для дополнительной информации передайте флаг --help.

Активация

1. Запустите OMNI Agent в веб-браузере.

2. В появившемся окне "Выбор сервера" укажите домен сервера и нажмите Далее. Домен для локального развертывания прописан в поле ingress.rules.gateway.host файла platform.values.yaml дистрибутива OMNI Platform — сервера сбора данных OMNI Agent. Для работы с OMNI Agent в облаке укажите домен https://cloud.3divi.ai/.

   

3. Войдите в OMNI Agent. Данные для входа (электронная почта и пароль) указаны в файле конфигурации OMNI Platform ./cfg/platform.secrets.json в переменных platform-usersecret.default_password и platform-user-secret.default_email.

   

4. В результате вы перейдете на главную страницу веб-интерфейса OMNI Agent.

ВАЖНО

Агент не поддерживает одновременную работу веб-конфигуратора на нескольких рабочих местах (в том числе более одной вкладки браузера).

Подключение камеры / загрузка видеофайла

После активации нажмите +Добавить в левом верхнем углу страницы:

• Для использования IP камеры выберите RTSP, в открывшемся окне укажите название камеры и URL.

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

• Для загрузки видеофайла выберите Файл, в открывшемся окне укажите полный путь до файла без кириллических символов.

  

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

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

ВАЖНО

Рекомендации по подбору и размещению камер

Выбор сценариев видеоаналитики и интеграций

После добавления камеры / загрузки видеофайла в веб-интерфейсе должно отобразиться превью с камеры / видеофайл. Слева появится меню с выбором доступных сценариев видеоаналитики и интеграций.

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

• Объекты, которые нужно искать в кадре (например, лица, тела, мобильные телефоны и др.)

• Действия, которые нужно выполнять с объектами (отслеживание, идентификация, анализ поведенческой активности)

• Модели и алгоритмы компьютерного зрения, которые отвечают за выполнение этих задач.

Нажмите + Добавить сценарий и выберите подходящие готовые сценарии из выпадающего списка:

• Лица: идентификация, контроль посторонних — Поиск лиц по базе данных, включая выявление посторонних, не внесенных в базу.

• Лица: контроль сокрытия — Выявление случаев, когда человек в кадре отворачивается или скрывает лицо шарфом, головным убором, очками, маской и т.д.

• Лица: пол, возраст, внимание, эмоции — Обнаружение и отслеживание лиц с возможностью распознавания атрибутов, включая пол, возраст, эмоции и пр.

• Объекты: телефоны — Обнаружение и отслеживание объекта типа «мобильный телефон» в кадре.

• Объекты: универсальный детектор — Обнаружение и отслеживание произвольных объектов по шаблонам, полученным по технологии few-shot learning.

• Тела: контроль периметра и рабочих зон (вид сверху) — Обнаружение и отслеживание тел и ключевых точек скелета людей в областях интереса.

• Тела: контроль периметра и рабочих зон (обзорный вид) — Обнаружение и отслеживание тел и ключевых точек скелета людей в областях интереса.

• Тела: поведенческая аналитика (вид сверху) — Обнаружение и отслеживание таких действий как сидение и лежание.

• Тела: поведенческая аналитика (обзорный вид) — Обнаружение и отслеживание таких действий как падение, драка, сидение и лежание.

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

Далее вы можете указать способ передачи данных из OMNI Agent — доступны три варианта: в OMNI Platform по HTTP, в сторонний сервис через вебхук или по протоколу MQTT.

Когда все настройки выбраны, нажмите Сохранить внизу страницы.

Превью с камеры / видеофайла

Обнаруженные лица и тела выделяются на превью рамками (bbox), а ключевые точки скелетов — сплошными или пунктирными линиями.

Вариации рамок (bbox) обнаруженных лиц

Обозначение	Описание	Превью
bbox с углами красного цвета	Лицо обнаружено, человек не смотрит в камеру
bbox с двойными углами красного цвета	Лицо обнаружено, человек смотрит в камеру
bbox c углами красного цвета в виде +	Недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции
bbox c двойными углами красного цвета в виде +	Недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции, при этом человек смотрит в камеру
bbox с углами зелёного цвета	Лицо обнаружено и идентифицировано, человек не смотрит в камеру
bbox с двойными углами зелёного цвета	Лицо обнаружено и идентифицировано, человек смотрит в камеру
bbox c углами зелёного цвета в виде +	Лицо обнаружено и идентифицировано, недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции
bbox с пунктирными углами красно-голубого цвета	Лицо обнаружено, человек не смотрит в камеру, при этом находится в ROI
bbox с двойными пунктирными углами красно-голубого цвета	Лицо обнаружено, человек смотрит в камеру, при этом находится в ROI
bbox красно-голубого цвета c углами в виде +	Недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции, при этом человек находится в ROI
bbox с двойными углами красно-голубого цвета в виде +	Недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции, при этом человек смотрит в камеру и находится в ROI
bbox с пунктирными углами жёлто-зелёного цвета	Лицо обнаружено и идентифицировано, человек не смотрит в камеру, но при этом находится в ROI
bbox с двойными пунктирными углами жёлто-зелёного цвета	Лицо обнаружено и идентифицировано, человек смотрит в камеру и находится в ROI
bbox жёлто-зелёного цвета c углами в виде +	Лицо обнаружено и идентифицировано, человек находится в ROI, недостаточное качество изображения или неподходящий угол поворота головы для корректной детекции

Вариации рамок (bbox) обнаруженных тел

Обозначение	Описание	Превью
bbox зелёного цвета	Нейро-детектор видит тело, присваивает ему уникальный идентификатор и сравнивает с ранее зафиксированными телами, чтобы определить, был ли этот человек уже в кадре. Если человек уже появлялся в кадре, его трек будет продолжен. В противном случае создаётся новый трек для нового тела с уникальным идентификатором
bbox голубого цвета и подсветка в области интереса (ROI)	Нейро-детектор видит тело и отслеживает его нахождение в ROI. Однако событие входа в зону интереса создаётся только после истечения времени, указанного в параметрах run.params.json

Обозначения обнаруженных ключевых точек скелета

Обозначение	Описание	Превью
Сплошная линия фиолетового цвета	Джоинты скелета со значением достоверности детекции выше порогового (0,5)
Пунктирная линия фиолетового цвета	Джоинты скелета со значением достоверности детекции ниже порогового (0,5)

Работа в режиме службы Linux/Windows

После установки можно настроить работу OMNI Agent в режиме службы ОС. Это обеспечит автоматическое включение OMNI Agent при запуске ОС и его работу в фоновом режиме.

Linux

1. Закройте терминал с OMNI Agent.

2. Включите автозапуск OMNI Agent при запуске ОС.

   sudo systemctl enable OMNIAgent.service

3. Запустите OMNI Agent в режиме службы.

   sudo systemctl start OMNIAgent.service

4. Проверьте статус OMNI Agent.

   sudo systemctl status OMNIAgent.service

Windows

1. Закройте терминал с OMNI Agent.

2. Откройте Диспетчер задач Windows -> Службы -> OMNIAgent.

3. Нажмите на службу OMNIAgent правой кнопкой мыши, выберите Свойства -> Общие -> Тип запуска -> Автоматически.

4. Нажмите Применить.

Удаление

Linux

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

sudo systemctl stop OMNIAgent.service
sudo systemctl status OMNIAgent.service
sudo systemctl disable OMNIAgent.service
sudo /opt/OMNIAgent/uninstall purge

Windows

Запустите ярлык UninstallOMNIAgent с рабочего стола или через командную строку C:\Program files\OMNIAgent\uninstall purge.