Лица
Виды готовых сценариев
Видеоаналитика лиц в OMNI Agent представлена тремя готовыми сценариями:
Лица: пол, возраст, внимание, эмоции
OMNI Agent детектирует лица, определяет их атрибуты (пол, возраст, эмоции и др.) и отслеживает их перемещения в поле зрения камер или на видеозаписях.
Для детекции лиц в OMNI Agent используются детекторы Face SDK — набора библиотек для разработки решений по распознаванию лиц.Лица: идентификация, контроль посторонних
С помощью OMNI Agent можно выполнять поиск лиц по БД (идентификация) для выявления совпадений и контроля посторонних. По умолчанию синхронизация базы лиц OMNI Agent с базой лиц OMNI Platform происходит в среднем 1 раз в минуту.
Для идентификации лиц в OMNI Agent задействованы методы Face SDK — набора библиотек для разработки решений по распознаванию лиц.Лица (контроль сокрытия)
OMNI Agent можно настроить на обнаружение сокрытия человеком лица при пересечении им отдельных виртуальных линий или нахождении в отдельных областях интереса (ROI) (Например, человек в кадре отворачивается или скрывает лицо шарфом, головным убором, очками, маской и т.д.).
Результаты контроля поступают в OMNI Platform или внешний сервис в формате событий контроля сокрытия лица. В событии прописывается статус проверки:hidden_or_low_quality — Человек находится в ROI / пересёк виртуальную линию, но не получено ни одной детекции с качеством достаточным для идентификации (значит скорее всего человек скрывает лицо).
identification — Человек находится в ROI / пересёк виртуальную линию, лицо задетектировано, как минимум, один раз, и найдено в базе.
non_identification — Человек находится в ROI / пересёк виртуальную линию, лицо задетектировано, но не найдено в базе.
Настройки готовых сценариев
Для изменения настроек сценария видеоаналитики нажмите на иконку ✏️ рядом с добавленным сценарием.

Во всех готовых сценариях доступны следующие группы настроек:
Настройка ROI/линий — управление областями интереса и линиями пересечения
Настройка выходных данных — включение анонимного режима
Настройка событий — конфигурация логики срабатывания и отправки событий
В этом разделе рассматриваются только специфические настройки текущих сценариев видеоаналитики.
Обнаружение лиц
| Настройка | Описание |
|---|---|
| Зона видеоаналитики | Возможность настройки размеров области кадра, по которой будет производиться обработка видеопотока. |
| Использовать CUDA для детектора | Активируется переключателем. При включении детектор лиц будет использовать ускорение на GPU. |
| Определение пола и возраста | Активируется переключателем. При включении Agent определяет пол и возраст обнаруженных лиц. |
| Определение эмоций | Активируется переключателем. При включении Agent распознаёт базовые эмоции на лицах: радость, удивление, спокойствие, гнев, отвращение, грусть и страх. |
| Порог уверенности детектора (score), в % | Определяет вероятность наличия лица в кадре: от 0 (0%) до 1 (100%). Значение по умолчанию — 0.6. Изображения лиц с показателем ниже этого порога не обрабатываются. Важно: убедитесь, что значения score, указанные для OMNI Agent и OMNI Platform совпадают. В противном случае часть активностей, сформированных из переданных процессов, не будет привязана к соответствующему профилю. Например: score на стороне Agent = 0.7, а score на стороне OMNI Platform = 0.85. В этом случае активности, сформированные из процессов со значением score в диапазоне [0.7, 0.85), не будут прикреплены к соответствующему профилю. |
| Минимальный размер лица, в пикселях | Позволяет исключить из обработки слишком мелкие объекты. Лица с размерами меньше заданного значения игнорируются (например, если необходимо отсечь лица вдалеке). |
| Порог угла наклона головы для обнаружения внимания | Ограничивает допустимый наклон головы (вверх/вниз) при анализе внимания. |
| Порог угла поворота головы для обнаружения внимания | Ограничивает допустимый поворот головы (влево/вправо) при анализе внимания. |
| Идентификатор группы активации | Используется для запуска/остановки сценариев видеоаналитики через API. |
Поиск лучшего кадра
| Настройка | Описание |
|---|---|
| Таймаут поиска лучшего кадра | Значение по умолчанию: 15000 мс. Лучший кадр и биометрический шаблон лица не обновляются в течение заданного времени. |
| Продолжать поиск лучших кадров лица | Параметр включен по умолчанию. Поиск лучших кадров лица продолжается после нахождения первого лучшего кадра. |
| Порог качества лица | Значение по умолчанию: -1000. Кадры лиц с качеством ниже заданного порога исключаются из поиска лучшего кадра. |
| Учитывать размер лица при выборе лучшего кадра | Включен по умолчанию. Параметр позволяет принять в качестве лучшего кадра кадр немного более низкого качества, если размер лица на нем значительно больше размеров лиц на предыдущих кадрах.
|
| Минимальный размер лица для лучшего кадра | Значение по умолчанию: 40 пикселей. Лица размером (меньшее значение из ширины и высоты) менее заданного порога исключаются из поиска лучшего кадра. |
| Порог угла вращения | Значение по умолчанию: 75°. Лица с поворотом головы от вертикального положения, превышающим этот порог, исключаются из поиска лучшего кадра. |
| Порог угла горизонтального отклонения | Значение по умолчанию: 40°. Лица с поворотом головы от фронтального положения, превышающим этот порог, исключаются из поиска лучшего кадра. |
| Порог угла вертикального отклонения | Значение по умолчанию: 40°. Лица с поворотом головы от фронтального положения, превышающим этот порог, исключаются из поиска лучшего кадра. |
Распознавание лиц
| Настройка | Описание |
|---|---|
| Включить распознавание | Параметр включен по умолчанию. Активирует построение биометрических шаблонов и поиск по базе лиц. |
| Включение CUDA | Повышает производительность за счёт использования GPU-ускорения. Требует наличия видеокарты Nvidia и установленных библиотек CUDA и cuDNN. |
База данных лиц
| Настройка | Описание |
|---|---|
| Включение CUDA | Повышает производительность за счёт использования GPU-ускорения. Требует наличия видеокарты Nvidia и установленных библиотек CUDA и cuDNN. |
| Порог совпадения | Значение по умолчанию: 0.876. Лица со значением схожести выше заданного порога принадлежат одному человеку. |
| Число кандидатов на идентификацию | Значение по умолчанию: 3. Число допустимых кандадатов на идентификацию, указанных в событии идентификации. Кандидат — это профиль из базы лиц, с которым произошла идентификация (лицо с подаваемого кадра и лицо из базы имеют высокую степень схожести). |
События
Помимо стандартных для всех сценариев событий ROI и пересечения линий, в этом сценарии доступны:
| Событие | Описание / Значение по умолчанию |
|---|---|
| События идентификации | Формируются в результате совпадения с лицом из базы. Отправка событий включена по умолчанию. В параметрах можно задать интервал пропуска повторных событий для одного лица — время, в течение которого события идентификации по данному лицу не будут отправляться на сервер. Значение по умолчанию: 5000 мс. |
| События неидентификации | Формируются в результате отсутствия совпадения с лицом из базы. Отправка событий включена по умолчанию. |
| События сокрытия лица | Формируются в случае, если степень сокрытия лица не позволяет распознать человека. Отправка событий включена по умолчанию. По умолчанию включен запрет на фильтрацию по группам пользователей, что позволяет настроить отправку событий на сервер вне зависимости от принадлежности распознанного человека к контрольному списку. Если параметр выключен, можно добавить отдельные контрольные списки, по которым будет выполняться идентификация. |