Документация для версии Face-Интеллект 8.2. Документация на другие версии также доступна.

Предыдущая страница Запросы FIRSERVER  Примеры часто используемых скриптов Следующая страница

События, поступающие от объекта FIRSERVER, можно использовать в скриптах ПК Интеллект для запуска процедур при возникновении соответствующего события (см. Руководство по созданию скриптов (программирование)).

Описание событий от объекта FIRSERVER:

СобытиеОписание
PERSON_NOT_FOUNDЛицо захвачено, но не распознано (нет в базе данных ПК Face-Интеллект)
FIND_PERSONЛицо распознано
ADD_PERSON_FROM_FILE_OKЭталонное лицо добавлено в БД ПК Face-Интеллект
ADD_PERSON_FROM_FILE_ERRORОшибка при добавлении эталонного лица в БД ПК Face-Интеллект
IDENTIFY_ACCEPTВерификация пройдена
IDENTIFY_DECLINEВерификация не пройдена
RECOGNITION_PASSРаспознавание лица при событии прохода, если включена его генерация (см. Настройка генерации событий)
TEMPERATURE_ALARMПревышение температуры (при превышении заданного порога температуры от тепловизора, см. Настройка работы Сервера распознавания лиц с тепловизором)
FACE_TEMPERATURE_SYNC_PROBLEMВремя Сервера и время тепловизора рассинхронизировано более чем на 10 минут
MASK_DETECTEDМаска на лице обнаружена (см. Настройка генерации событий)
MASK_NOT_DETECTEDМаска на лице отсутствует (см. Настройка генерации событий)
MASK_NOT_IN_PLACE Маска надета неправильно
DATABASE_ERRORОшибка БД (потеряна связь с базой данных Fir)
REGENERATE_STARTРегенерация векторов
REGENERATE_STOPРегенерация завершена
REGENERATE_CANCELРегенерация прервана

Список параметров событий объекта FIRSERVER:

ПараметрыОписание параметров
requestId<>Идентификатор запроса
fraction<>Миллисекунда захвата лица
owner<>Имя сервера. Используется для события PERSON_NOT_FOUND
protocol_id<>id захваченного лица для (ссылка на картинку)
date<>Дата, когда завершилось распознавание
face_id<>Уникальный идентификатор лица в ПК Интеллект
imageBase64.N<>Изображение захваченного камерой лица в формате Base64 для сравнения с сохраненной фотографией пользователя в базе данных эталонных лиц, где N – номер изображения (imageBase64.1<>, imageBase64.2<> и т.д.). Используется для событий IDENTIFY_ACCEPT и IDENTIFY_DECLINE
imageBase64Count<>Количество изображений захваченных камерой лиц в формате Base64 для сравнения с сохраненной фотографией пользователя в базе данных эталонных лиц. Используется для событий IDENTIFY_ACCEPT и IDENTIFY_DECLINE
guid_pk<> id события (генерируется случайным для каждого события)
confidence<>Процент качества добавленного лица, имеет тип double и диапазон значений 0,0-1,0
capture_fraction<>Миллисекунда добавления лица в базу
capture_date<>Дата захвата изображения
sim<>Процент совпадения
surname<>Фамилия персоны, с которой схоже найденное лицо
comment<>Комментарий при добавлении пользователя (лица) 
capture_time<>Время захвата изображения
cam_name<>Имя камеры, по которой было захвачено лицо
patronymic<>Отчество персоны
filename<>Полное имя файла с изображением
department<>Отдел, в который будет добавлен пользователь (лицо)
name<>Имя добавляемого пользователя (лица)
obj_id<>id лица, приходит пустым, если нет совпадений
error<>Описание причины ошибки
gender<>Пол распознанного или нераспознанного лица (unknown, male, female)
age<>Возраст распознанного или нераспознанного лица
param0<>

Может указываться:

  • Процент схожести при верификации;
  • Температура в событии TEMPERATURE_ALARM;
  • Timeout, если событие IDENTIFY_DECLINE наступило из-за истечения времени ожидания температуры от тепловизора
total_passes<>Общее число проходов для текущего распознанного лица
firstId<>Уникальный идентификатор захваченного лица
camera_id<>Идентификатор камеры, захватившей лицо
camera_name<>Название камеры, захватившей лицо
person_id<>id пользователя в дереве объектов ПК Интеллект, если распознанное лицо было создано с флагом "Создавать пользователя в базе Интеллект". Используется для события FIND_PERSON
person_guid<>

id распознанного лица, который назначается пользователю при добавлении лица в базу эталонных лиц. Используется для события FIND_PERSON

eye_closeness<>

Результат распознавания закрытых глаз детектором при использовании модуля распознавания Tevian:

  • unknown – не опознано (если используется отличный от модуля распознавания Tevian ;

  • eye_closed – глаза закрыты;

  • eye_not_closed – глаза не закрыты.

temperature<>

Температура лица в градусах Цельсия от тепловизора

temperature_alarm<>

Порог температуры от тепловизора, при превышении которой будет сформировано событие TEMPERATURE_ALARM

info<>

Через разделитель точка с запятой (;) указаны названия камер, их идентификаторы, которые когда-либо захватывали данное лицо, и количество проходов

emotion<>

Эмоция

glasses<>

Очки

headwear<>

Головной убор

evasion<>

Сокрытие лица

facialHair<>

Растительность на лице

frame_type<>

Используется для внутренней разработки

hairColor<>

Цвет волос

hairType<>

Тип лысины

liveness<>

Поддельное лицо

timeout<>
Время ожидания температуры от тепловизора в секундах, если событие IDENTIFY_DECLINE наступило по таймауту
noImage<>

Отсутствие у пользователя сохраненной фотографии в Бюро Пропусков:

1 − фотографии нет;

0 − фотография есть

quality<>Качество сохраненной фотографии пользователя в Бюро Пропусков в процентах. Если quality<0>, то у пользователя нет фотографии в Бюро пропусков
  • No labels