Объектная модель
Sample (Сэмпл)
Объект, в котором хранится результат обработки изображения в следующем формате:
- ID сэмпла.
- Дата создания сэмпла в формате ISO 8601.
- Дата последнего изменения сэмпла в формате ISO 8601.
- Результат детекции (SampleData).
Сэмпл используется платформой для создания профилей и сравнения лиц. Сравнение лиц (идентификация и верификация) выполняется по биометрическим шаблонам, хранящимся в сэмплах.
Profile (Профиль)
Объект содержит метаданные о человеке, его изображение (аватар), активности и набор сэмплов, включая главный cэмпл. Для создания профиля в OMNI Platform загружается изображение человека (аватар) через дашборд или интеграционный API. По загруженному изображению создается сэмпл, который автоматически привязывается к профилю. Этот первый созданный сэмпл автоматически становится главным сэмплом профиля, т.е. сэмплом, который будет использоваться в операциях идентификации и верификации лиц. Для людей, попавших в поле зрения камеры, и не имеющих профиля в системе, также предусмотрена возможность создать профиль из активности.
Profile Group (Группа)
Группа содержит набор идентификаторов профилей и метаданные о группе. Используется для группировки профилей по произвольным критериям, например, VIP-клиенты, сотрудники и т.д.
Activity (Активность)
Объект, в котором хранится информация о любом обнаруженном присутствии человека в поле зрения камеры. Динамические данные такого типа передаются OMNI-агентами и хранятся в форме процессов агента.
При появлении человека в кадре, OMNI Agent начинает формировать процессы разных типов (человек, трек, лицо, тело, эмоции и др.), которые передаются в OMNI Platform или внешние сервисы посредством webhook.
Активность представляет собой набор процессов, переданных по конкретному человеку (с момента его появления в поле зрения камеры до момента выхода из поля зрения камеры).
Все выделенные из процессов бинарные изображения (кропы), биометрические шаблоны и атрибуты лиц сохраняются в базе данных платформы. Далее биометрический шаблон из активности сравнивается с биометрическими шаблонами из главных сэмплов профилей из базы данных.
Если результат схожести (score) равен или превышает пороговое значение (score_threshold), которое по умолчанию равно 0.85, к активности привязывается ID профиля, после чего активность добавляется к этому профилю. Если для всех профилей результат схожести не превысил порогового значения, значит активность относится к человеку, у которого нет профиля в системе. В таком случае создать профиль можно по активности через дашборд или интеграционный API платформы.
Event (Событие)
Событие — это формат представления результатов распознавания и трекинга, отражающий факт совершения действия. События формируются на стороне OMNI-агента и затем передаются в OMNI Platform.
Типы событий:
- События идентификации/неидентификации (человек с камеры найден/не найден в базе).
- События ROI (человек находится в области интереса (ROI) или вышел из нее).
- События Crossing (человек пересек размеченную на видеопотоке линию в прямом/обратном направлении).
- События HAR (человек упал, сидит, лежит или участвует в драке).
Trigger (Триггер)
Триггер обеспечивает создание и отправку оповещений на эндпоинты, если информация из активности удовлетворяет условию срабатывания триггера. Объект содержит условие срабатывания, набор эндпоинтов и идентификатор привязанной к нему группы. Под условием срабатывания имеется в виду условие появления оповещений: оповещение создается в случае если человек, чей профиль добавлен в группу, попадает в поле зрения камеры.
Notification (Оповещение)
Оповещения об активности приходят в режиме реального времени на один или несколько эндпоинтов: в дашборд платформы, на почту или вебхук. Объект оповещения содержит мета-информацию об оповещении, а также ссылки на связанные с этим оповещением объекты: профиль, группу, триггер и эндпоинт.
Оповещение об активности приходит только в случае, если профиль, созданный в системе для этого человека, добавлен в группу.
Endpoint (Эндпоинт)
Объект содержит данные о точке доставки оповещений.
Типы эндпоинтов:
- Веб-интерфейс — отвечает за всплывающие оповещения в браузере.
- Почта.
- Вебхук.
При создании аккаунта пользователя создаются два эндпоинта, один типа веб-интерфейс, второй типа почта на адрес регистрации аккаунта. Пользователь может создавать дополнительные эндпоинты типа почта и вебхук, при этом создать еще один эндпоинт типа веб-интерфейс не получится, т.к. система имеет только один веб-интерфейс, к которому и привязан созданный по умолчанию эндпоинт.
Agent (Агент)
Объект, в котором хранятся сведения об OMNI-агенте, включая идентификатор, имя, дату создания и изменения, статус агента (активен/остановлен), список идентификаторов периферийных устройств (камер), подключенных к OMNI-агенту и другие связанные параметры.
Camera (Камера)
Объект, в котором хранятся данные периферийного устройства (камеры).