Skip to main content
Version: 2.4.0

Output Data

OMNI Agent detects faces and silhouettes, identifies people (if their faces are in the database) and tracks their positions in video streams from cameras and video files.OMNI Agent receives video streams and video files via the rtcp protocol, processes them and converts recognition and tracking data into two formats: processes and events.

Output Data Formats​

Processes

A data format for representing recognition and tracking results implemented within time intervals.

Each process contains the following set of data:
  • Process ID;
  • Process time interval (start and end of the process);
  • Process type (track, human, face, body, emotion etc.);
  • Detection object with face attributes (object is a human in the camera’s field of view);
  • Best shot.

Processes are sent to OMNI Platform via the HTTP protocol or to an external service via a webhook.

Events

A data format for representing identification results, generated by OMNI Agent and transferred to OMNI Platform for subsequent sending to a third-party service via a web socket.

Depending on the identification results, OMNI Agent can send two types of events: identification events (the person from the camera is identified) and non-identification events (the person from the camera is not identified).

Structure of non-identification event:

type - non_identification

camera:

  • id - camera identifier
  • type - camera type
  • title - camera title
  • width - frame width
  • height - frame height
  • stream - rtsp-stream address
  • real_name - original name
  • agent_id - agent identifier

event:

  • id - event identifier
  • detection_date - detection date
  • image - face crop identifier
  • original_image - original image identifier
  • image_link - link to the face crop
  • original_image_link - link to the original image

Structure of identification event:

type - identification

camera:

  • id - camera identifier
  • type - camera type
  • title - camera title
  • width - frame width
  • height - frame height
  • stream - rtsp-stream address
  • real_name - original name
  • agent_id - agent identifier

candidates (profiles with which identification occurred):

  • profile:

    • id - profile identifier
    • age
    • gender
    • navatar_id - identifier of profile avatar
    • main_sample_id - main sample identifier
    • sample_link - link to the main sample

  • profile_groups:

    • id - identifier of the group which the profile is linked to
    • color - color of the group which the profile is linked to

  • confidence - the degree of similarity of the face from the frame with the candidate (from 0 to 1)

event:

  • id - event identifier
  • detection_date - detection date
  • image - face crop identifier
  • original_image - orginal image identifier
  • image_link - link to the face crop
  • original_image_link - link to the original image

Output Data Transfer​

img.png

Online Mode​

Processes and events are transferred to OMNI Platform via HTTP protocol in real time. OMNI Agent's face database is synchronized with a face database of OMNI Platform on average once per minute.

Standalone Mode​

Processes are transferred to third-party services via webhooks. To set up webhooks, follow Webhooks section.