Объектная модель

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 (Камера)

Объект, в котором хранятся данные периферийного устройства (камеры).