Page History
The FIRSERVER object corresponds to the Face Recognition Server system object.
Events that come in from the FIRSERVER object are listed in the table. The procedures are initiated when the corresponding event occurs. FIRSERVER events have the following format:
| Code Block |
|---|
OnEvent("FIRSERVER","_id_","_event_") |
FIRSERVER events are described in the table.
| Event | Description |
|---|---|
| GET_IMAGE | A request to get the image by the ID |
| PERSON_NOT_FOUND | The |
...
| face was captured but not recognized (cannot be found in the Face- |
...
| Intellect database) | |
| FIND_PERSON | The face is recognized |
| ADD_PERSON_FROM_FILE_OK | The reference face file is added to the Face-Intellect database |
| ADD_PERSON_FROM_FILE_ERROR | There is an error while adding the reference face file to the Face-Intellect database |
| IDENTIFY_ACCEPT | The verification is accepted |
| IDENTIFY_DECLINE | The verification is declined |
Action statement format for describing the actions with the Face Recognition Server:
| Code Block |
|---|
DoReact("FIRSERVER","_id_","_command_" [,"_parameters_"]); |
FIRSERVER parameters are described in the table.
| Parameters | Description |
|---|---|
| requestId<> | The ID of the request |
| fraction<> | The millisecond when the face was captured |
| owner<> | The server name for the PERSON_NOT_FOUND event |
| protocol_id<> | The captured face ID (the link to the image) |
| date<> | The date of the recognition completion |
| id<> | The ID of the person |
...
| added to the Face-Intellect database |
...
| imageBase64<> | The face vector image in "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 |
...
The FIND_PERSON event is created when the face is recognized:
FIRSERVER|1|FIND_PERSON|capture_fraction<VALUE>,fraction<VALUE>,capture_date<VALUE>,owner<VALUE>,protocol_id<VALUE>,id<VALUE>,sim<VALUE>,date<VALUE>,surname<VALUE>,comment<VALUE>,capture_time<VALUE>,guid_pk<VALUE>,cam_name<VALUE>,patronymic<VALUE>,imageBase64<VALUE> where capture_date is the date of capturing the image, capture_time is the time of capturing the image and date is the date when recognition is completed.
...
The ADD_PERSON_FROM_FILE_OK event is created when the reference face file is added to the Face-Intellect database:
FIRSERVER|1|ADD_PERSON_FROM_FILE_OK|operator<VALUE>,surname<VALUE>,filename<VALUE>,core_global<VALUE>,department<VALUE>,time<VALUE>,_TRANSPORT_ID<VALUE>,fraction<VALUE>,action<ADD_PERSON_FROM_FILE_OK>,date<VALUE>,name<VALUE>,comment<VALUE> where filename is the full name of the photo file, name is the name of the added user, surname is the surname of the added user, department is thedepartment the user is added to and comment is the comment.
...
| 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 use (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 occured |
| gender<> | The gender of the recognized or unrecognized face (unknown, male, female) |
| age<> | The age of the recognized or unrecognized face |
| param0<> | The similarity percentage during the verification |