Объектная модель
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 (Камера)
Объект, в котором хранятся данные периферийного устройства (камеры).