Documentation for Face Intellect 8.0-8.1. Documentation for other versions of Intellect is available too.

Previous page FIRSERVER requests  Examples of frequently used scripts Next page

Events received from the FIRSERVER object can be used in Intellect scripts to run the procedures when the corresponding event occurs (see Guide for creating scripts (programming)).
The description of the events from the FIRSERVER object:
EventDescription
PERSON_NOT_FOUNDThe face was captured but not recognized (cannot be found in the Face Intellect database)
FIND_PERSONThe face is recognized
ADD_PERSON_FROM_FILE_OKThe reference face file is added to the Face Intellect database
ADD_PERSON_FROM_FILE_ERRORThere is an error when adding the reference face file to the Face Intellect database
IDENTIFY_ACCEPTThe verification is accepted
IDENTIFY_DECLINEThe verification is declined
RECOGNITION_PASSThe face is recognized and the Access event generation checkbox is set (see Configuring the events generation)
TEMPERATURE_ALARM

Temperature rise (when the temperature threshold specified for the thermal camera is exceeded, see Configuring the Face Recognition Server operation with thermal camera)

FACE_TEMPERATURE_SYNC_PROBLEMThe Server time and thermal camera time differ by more than 10 minutes
MASK_DETECTEDThe mask is found on the face (see Configuring the events generation)
MASK_NOT_DETECTEDThere is no mask on the face (see Configuring the events generation)
MASK_NOT_IN_PLACEThe mask is placed incorrectly
DATABASE_ERRORDatabase error (lost connection with the Fir database)
REGENERATE_STARTBiometric vectors re-generation in progress
REGENERATE_STOPBiometric vectors re-generation complete
REGENERATE_CANCELBiometric vectors re-generation cancelled

The parameters of the events of the FIRSERVER object:

ParametersDescription
requestId<>The ID of the request
fraction<>The millisecond when the face was captured
owner<>The server name. It is used for the PERSON_NOT_FOUND event
protocol_id<>The captured face ID (the link to the image)
date<>

The date of the recognition completion

face_id<>The unique ID of the face in Intellect
imageBase64<>

The face vector image in the "base64" format

guid_pk<>The event ID (is generated randomly for every event)
confidence<>

The quality percentage of the added face image, it has the double type and the 0.0-1.0 range of values

capture_fraction<>The millisecond when the face was added to the Face Intellect database
capture_date<>

The date of the image capture

sim<>The similarity percentage
surname<>

The last name of the person who looks similar to the recognized face

comment<>

The comment on adding the user (the face)

capture_time<>

The time of the image capture

cam_name<>The name of the camera that captured the face
patronymic<>The middle name of the person
filename<>

The full name of the image file

department<>

The department the user (the face) is added to

name<>

The name of the added user (face)

obj_id<>The face ID. The value is empty if there was no face match
error<>

The explanation of why the error occurred

gender<>The gender of the recognized or unrecognized face (unknown, male, female)
age<>The age of the recognized or unrecognized face
param0<>

The following can be specified:

  • similarity percentage during the verification;
  • temperature in the TEMPERATURE_ALARM event;
  • "Timeout"if the IDENTIFY_DECLINE event occurred due to the expiration of the temperature timeout from the thermal camera
total_passes<>The general number of passes of the currently recognized face
firstId<>The unique identifier of the captured face
camera_id<>The identifier of the camera that captured a face
camera_name<>The name of the camera that captured a face
person_id<>The user ID in the Intellect objects tree, if the recognized face was created with the Create user in Intellect database mark. It is used for the FIND_PERSON event
person_guid<>The recognized face ID that is assigned to the user when a face is added to the reference face database. It is used for the FIND_PERSON event
eye_closeness<>

The result of the closed eyes recognition by the detector when using the Tevian recognition module:

  • unknownnot recognized (if a recognition module other than Tevian is used);
  • eye_closedeyes are closed;
  • eye_not_closedeyes are not closed
temperature<>

Face temperature in degrees Celsius from the thermal camera

temperature_alarm<>

Temperature threshold from the thermal camera; when this value is exceeded, the TEMPERATURE_ALARM event is generated

info<>Contains the following information separated by a semicolon (;): the names and identifiers of the cameras, that has ever captured the faces, and the number of passes

emotion<>

Emotion

glasses<>

Glasses

headwear<>

Headwear

evasion<>

Concealment of the face

facialHair<>

Facial hair

frame_type<>

Used for internal development

hairColor<>

Hair color

hairType<>

Type of bald head

liveness<>

Fake face

timeout<>
The waiting time in seconds for the temperature from the thermal camera if the IDENTIFY_DECLINE event occurred due to a timeout
noImage<>

The user doesn't have a saved photo:

1—there is no photo;

0—there is a photo

quality<>The quality of the saved user photo in the Access Manager as a percentage. If quality<0>, the user doesn't have a photo in the Access Manager
  • No labels