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

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 Agent и затем передается в OMNI Platform. В зависимости от результатов идентификации события могут быть двух типов: события идентификации (человек с камеры идентифицирован) и события неидентификации (человек с камеры не идентифицирован).

Trigger (Триггер)

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

Notification (Оповещение)

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

примечание

Оповещение об активности приходит только в случае, если профиль, созданный в системе для этого человека, добавлен в группу.

Endpoint (Эндпоинт)

Объект содержит данные о точке доставки оповещений.

Типы эндпоинтов:

• Веб-интерфейс - отвечает за всплывающие оповещения в браузере.
• Почта
• Вебхук

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

Agent (Агент)

Объект, в котором хранятся сведения об OMNI Agent, включая идентификатор, имя, дату создания и изменения, статус агента (активен/остановлен), список идентификаторов периферийных устройств (камер), подключенных к агенту и другие связанные параметры.

Camera (Камера)

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