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

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 по HTTP-протоколу (Типы событий).

EventFilters (Фильтры событий)

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

Event endpoints (Эндпоинты событий)

Объект отвечает за отправку событий по веб-сокету (эндпоинт типа «веб-сокет») или на вебхук-сервер (эндпоинт типа «вебхук»). Идентификаторы эндпоинтов типа «веб-сокет» выступают в роли токенов подключения по веб-сокету.

Agent (Агент)

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

Camera (Камера)

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