Форматы выходных данных

Результаты обработки видеопотоков с камер преобразуются агентом в формат процессов и событий для последующей передачи в OMNI Platform или сторонние сервисы.

Процессы

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

Каждый процесс содержит следующий набор данных:

• Идентификатор процесса;
• Временной интервал процесса (начало и окончание процесса);
• Тип процесса (трек, человек, лицо, тело, эмоция и др.);
• Объект детекции с определёнными атрибутами лица (объектом выступает человек, попавший в поле зрения камеры);
• Лучший кадр (best shot) и массив всех кадров, полученных, пока человек не вышел из поля зрения камеры.

Процессы передаются в OMNI Platform через HTTP-протокол или во внешний сервис через вебхук.

События

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

В зависимости от результатов идентификации OMNI-агент может передавать события двух типов: события идентификации (человек с камеры идентифицирован) и события неидентификации (человек с камеры не идентифицирован).

Структура события неидентификации:

• type (тип события) - non_identification
• camera (камера):
  • id - идентификатор камеры
  • type - тип камеры
  • title - название камеры
  • width - ширина кадра
  • height - высота кадра
  • stream - адрес rtsp-потока
  • real_name - исходное название
  • agent_id - идентификатор агента
• event (cобытие):
  • id - идентификатор события
  • detection_date - дата детекции
  • image - идентификатор кропа лица
  • original_image - идентификатор полного кадра
  • image_link - ссылка на кроп лица
  • original_image_link - ссылка на полный кадр

Структура события идентификации:

• type (тип события) - identification
• camera (камера):
  • id - идентификатор камеры
  • type - тип камеры
  • title - название камеры
  • width - ширина кадра
  • height - высота кадра
  • stream - адрес rtsp-потока
  • real_name - исходное название
  • agent_id - идентификатор агента
• candidates (профили, с которыми произошла идентификация):
  • profile:
    • id - идентификатор профиля
    • age - возраст
    • gender - пол
    • avatar_id - идентификатор аватара профиля
    • main_sample_id - идентификатор главного сэмпла
    • sample_link - ссылка на главный сэмпл профиля
  • profile_groups:
    • id - идентификатор группы, к которой привязан профиль
    • color - цвет группы, к которой привязан профиль
  • confidence - степень сходства лица с кадра с профилем-кандидатом (от 0 до 1)
• event (cобытие):
  • id - идентификатор события
  • detection_date - дата детекции
  • image - идентификатор кропа лица
  • original_image - идентификатор полного кадра
  • image_link - ссылка на кроп лица
  • original_image_link - ссылка на полный кадр