Глоссарий#
Термин | Определение |
---|---|
Лучший кадр, Bestshot | Кадр видеопотока, на котором лицо зафиксировано в оптимальном ракурсе для дальнейшего использования в системе распознавания лиц |
Bbox | Прямоугольник, ограничивающий пространство изображения с обнаруженным лицом |
Interaction over Union (IOU) | Пересечение над объединением. Данный параметр определяет коэффициент пересечения двух детекций |
JSON | Текстовый формат обмена данными, основанный на JavaScript. |
Liveness | Программный способ подтверждения витальности (живучести, жизненности) человека по одному или нескольким изображениям с целью предотвращения спуфинг-атак |
MessagePack (MsgPack) | Быстрый и компактный формат двоичной сериализации для обмена данными |
Атрибуты | Пол и возраст человека, определяемые системой автоматически |
Детекция | Действия по нахождению областей изображения, содержащих лица |
Спуфинг-атака | Тип атаки, основанной на фальсификации передаваемых данных, в частности подмена живого человека на поддельное изображение (например, фотографию) с целью обмана системы |
Введение#
Данный документ содержит сведения о VisionLabs LUNA KIOSK и описывает принципы работы компонентов.
VisionLabs LUNA KIOSK (далее – Система) представляет собой набор библиотек, обеспечивающих возможность реализации работы в режиме реального времени для выполнения детекции лица в кадре, проверки витальности человека и передачи данных во внешнюю систему.
Система предназначена для:
- приема и обработки цветного видеопотока с устройства видеозаписи,
- проверки качества изображения,
- выбора лучшего кадра,
- детекции лица методом машинного вычисления по двум изображениям,
- проверки предъявляемого изображения Liveness-алгоритмами,
- защиты от подмены изображения макетами путем анализа карты глубин,
- передачи лучшего кадра в системы интеграции устройств.
Системные требования#
Для установки полного пакета Системы должны выполняться минимальные системные требования, приведенные ниже (Таблица 1 и Таблица 2).
Таблица 1. Минимальные системные требования для архитектуры x64
Необходимый ресурс |
Рекомендовано |
---|---|
Процессор |
Intel(R) Core(TM) i3-10110U |
Оперативная память |
4Гб и выше |
Жесткий диск |
HDD или SSD не менее 1,4 ГБ |
Операционная система |
|
Поддержка инструкций |
Advanced Vector Extensions 2 (AVX2) |
Для запуска приложения под Windows установите пакет Visual C++ Redistributable.
Таблица 2. Минимальные системные требования для архитектуры ARM
Необходимый ресурс |
Рекомендовано |
---|---|
Процессор |
Rockchip RK3588S |
Оперативная память |
4Гб и выше |
Жесткий диск |
HDD или SSD не менее 128 ГБ |
Операционная система |
Armbian 23 (aarch64) |
Корректная работа Системы обеспечивается 3D-камерами Intel® RealSense™ Camera D400-Series с версией прошивки 5.15.0.2, камерами VLS LUNA CAMERA 3D и ИК-камерами VLS LUNA CAMERA 2D:
- Intel® RealSense™ Depth Cameras D415;
- Intel® RealSense™ Depth Cameras D435;
- Intel® RealSense™ Depth Cameras D435i;
- VLS LUNA CAMERA 3D / VLS LUNA CAMERA 3D Embedded;
- VLS LUNA CAMERA 2D.
Информацию о камерах VLS LUNA CAMERA 3D / VLS LUNA CAMERA 3D Embedded можно запросить у представителя VisionLabs.
Для работы с 3D-камерами Intel® RealSense™ Camera D400-Series, VLS LUNA CAMERA 3D и VLS LUNA CAMERA 2D необходимо использовать USB 3.0.
Архитектура Системы#
Высокоуровневая схема архитектуры Системы представлена ниже (Рисунок 1).
Система состоит из следующих компонентов:
- RSEngine – компонент, который включает в себя:
- библиотеку SDK VisionLabs из набора средств разработки VisionLabs, предназначенную для обработки изображений;
- библиотеки:
- RealSense2 SDK – для работы с камерой Intel RealSense;
- VLS LUNA CAMERA 3D SDK – для работы с камерой VLS LUNA CAMERA 3D;
- VLS LUNA CAMERA 2D SDK – для работы с камерой VLS LUNA CAMERA 2D;
- Мониторинг камеры, предназначенный для проверки состояния камеры;
- RSE Server – WebSocket сервер для взаимодействия с внешней системой WebSocket Client.
Алгоритм работы#
Выбор лучшего кадра#
Взаимодействие компонентов при выборе лучшего кадра отражено ниже (Рисунок 2).
Ниже представлено пояснение к рисунку (Таблица 3).
Таблица 3. Описание диаграммы взаимодействия компонентов Системы при выборе лучшего кадра
Шаг |
Описание |
---|---|
(1) |
В RSE Server поступает запрос на соединение по WebSocket от клиента. Пример запроса:
|
(2) |
RSE Server передает запрос RSEngine на запуск камеры (в библиотеку камеры). В зависимости от того, какая камера подключена, |
(3) |
Библиотека камеры запускает камеру |
(4) |
Библиотека камеры получает RGB, IR, Depth видеопотоки с камеры, разбивает на кадры и анализирует |
(5) |
Библиотека камеры передает набор кадров в RSE Server. В зависимости от параметра
|
(6) |
RSE Server отправляет запрос на обработку кадра (производится по каждому кадру) в SDK VisionLabs |
(7) |
SDK VisionLabs выполняет:
В случае, если все проверки пройдены, то процесс продолжается (переход к шагу 8). Если хотя бы одна проверка не пройдена, SDK VisionLabs отправляет запрос к камере на получение новых кадров для проведения повторной проверки до тех пор, пока есть детекция (возврат к шагу 4) |
(8) |
SDK VisionLabs выполняет оценку Liveness и сравнивает полученное значение оценки Liveness с пороговым значением. В случае, если полученное значение Liveness выше порогового значения, то текущий кадр становится лучшим кадром. Если полученное значение Liveness ниже порогового значения, то SDK VisionLabs отправляет запрос к камере на получение новых кадров для проведения повторной проверки до тех пор, пока есть детекция (возврат к шагу 4) |
(9) |
В случае, если проверка Liveness пройдена успешно, то полученный лучший кадр и атрибуты лица направляются в RSE Server |
(10) |
RSE Server преобразует выбранный лучший кадр и метаинформацию в формат MessagePack и отправляет клиенту во внешнюю систему |
Мониторинг состояния камеры#
Взаимодействие компонентов при мониторинге состояния камеры отражено ниже (Рисунок 3).
Ниже представлено пояснение к рисунку (Таблица 3).
Мониторинг запускается по умолчанию раз в 300 секунд, длительность можно изменить в параметрах
camera-monitoring
иcamera-monitoring-delay
в файлеrsengine.conf
.
Таблица 4. Описание диаграммы взаимодействия компонентов Системы при мониторинге состояния камеры
Шаг |
Описание |
---|---|
(1) |
RSE Server передает запрос RSEngine на запуск мониторинга камеры |
(2) |
Мониторинг камеры передает запрос на получение информации о статусе камеры в библиотеку камеры — RealSense2 SDK, VLS LUNA CAMERA 3D SDK или VLS LUNA CAMERA 2D SDK в зависимости от того, какая камера подключена — IntelRealSense, VLS LUNA CAMERA 3D или VLS LUNA CAMERA 2D SDK |
(3) |
Библиотека камеры передает запрос на получение информации о статусе камеры |
(4) |
Библиотека камеры получает статус камеры |
(5) |
Библиотека камеры передает информацию о статусе камеры в мониторинг камеры |
(6) |
RSEngine передает информацию о статусе камеры в RSE Server |
(7) |
RSE Server записывает данные о статусе камеры в реестр (на ОС Windows) или в рабочую папку ./logs (на ОС Ubuntu 24.04 x64, Debian 10 x64 и Armbian 23) |
Описание компонентов#
Компонент RSEngine#
RSEngine обеспечивает взаимодействие внутри Системы библиотек SDK VisionLabs, RealSense2 SDK, VLS LUNA CAMERA 3D SDK, VLS LUNA CAMERA 2D SDK.
Компонент SDK VisionLabs#
SDK VisionLabs представляет собой набор средств разработки (software development kit), включающий библиотеки и нейронные сети для анализа изображений с целью:
- детекции лиц на изображениях и ключевых точек (ориентиров) лица;
- выбор лучшего кадра;
- оценки атрибутов изображения для дальнейшей проверки Liveness;
- оценки лица на изображении Liveness-алгоритмами.
Все описанные ниже оценки выполняются для проверки соответствия изображения требованиям Liveness. Все проверки являются внутренними и результат не передаётся вовне. Результат проверки может быть выведен только в случае ошибки, если какой-либо атрибут изображения/лица не подходит для оценки Liveness (см. описание ошибок в "Приложении 2. Коды статусов и описание ошибок");
Компонент RealSense2 SDK#
RealSense2 SDK представляет собой компонент, который позволяет:
- получать входящие изображения от камер Intel RealSense;
- производить настройку параметров детекции;
- включать/выключать камеру, менять различные параметры. Например, яркость подсветки лазера, автоэкспозицию, яркость.
- автоматически обновлять соединение с камерой. При обновлении соединения происходит переподключение к камере. Если Система не может переподключиться к камере, выполняется программный сброс кабеля соединения. В случае неуспешности выполнения обозначенных операций, данная проблема будет отражена в отчете о статусе камеры в логах Системы.
Компонент VLS LUNA CAMERA 3D SDK#
VLS LUNA CAMERA 3D SDK представляет собой компонент, который позволяет:
- получать входящие изображения от камер VLS LUNA CAMERA 3D / VLS LUNA CAMERA 3D Embedded;
- производить настройку параметров детекции;
- включать/выключать камеру, менять различные параметры (например, яркость подсветки лазера, автоэкспозицию, яркость).
Компонент VLS LUNA CAMERA 2D SDK#
VLS LUNA CAMERA 2D SDK представляет собой компонент, который позволяет:
- получать входящие изображения от инфракрасных камер VLS LUNA CAMERA 2D;
- производить настройку параметров детекции;
- включать/выключать камеру;
- менять угол поворота видеокадра камеры.
Функции камер#
Детектирование лиц#
Детектор использует специальные алгоритмы обнаружения лиц и решает следующие задачи:
- обнаружения лица на изображении;
- определения 5 ключевых точек на лице: две для глаз, одна для кончика носа и две для углов рта;
- оценка качества детекции – степень вероятности, что на изображении обнаружено именно лицо, а не другой объект.
Оценка качества изображения#
Выполняется оценка качества изображения по следующим параметрам:
- Blur – смазанность (размытость);
- Light – засвеченность;
- Dark – затемненность.
Оценка статуса рта#
Выполняется оценка статуса рта по следующим параметрам:
- Opened – рот открыт;
- Occluded – рот перекрыт сторонним предметом;
- Smiling – наличие улыбки.
Оценка статуса глаз#
Выполняется оценка статуса глаз по следующим параметрам:
- Closed – глаза закрыты;
- Open – глаза открыты;
- Occluded – глаза перекрыты (например, солнечными очками).
Оценка положения головы#
Выполняется оценка положения головы по следующим параметрам:
- Roll – угол наклона головы вокруг продольной оси;
- Pitch – угол наклона головы вокруг поперечной оси;
- Yaw – угол поворота головы вокруг вертикальной оси.
Проверка Depth Liveness#
Выполняется проверка «витальности» человека на изображении по карте глубин.
Производится анализ матрицы глубины (16 бит), которая содержит информацию о расстоянии поверхностей объектов сцены (лиц) до точки обзора.
Проверка IR Liveness#
Выполняется проверка «витальности» человека на изображении при помощи анализа инфракрасного изображения.
Для выполнения проверки камера должна быть оборудована инфракрасной подсветкой.
Проверка FPR Liveness#
FPR – анаграмма по названиям проверок – FlyingFaces, Phone и Replay Liveness. Выполняется проверка «витальности» человека на изображении при помощи:
- FlyingFaces Liveness – алгоритм, который позволяет определять распечатанные фотографии и маски.
- Phone Liveness – алгоритм, который позволяет определять наличие телефона в расширенном BBox;
- Replay Liveness – алгоритм, который позволяет определять артефакты видеозаписи;
Компонент Мониторинг камеры#
Мониторинг камеры используется для проверки состояния камеры.
Мониторинг камеры выполняет запрос следующих параметров камеры:
- данных о прошивке;
- статуса работы инфракрасных камер – включена/выключена;
- статуса работы RGB-камеры - включена/выключена;
- серийного номера камеры;
- статуса работы всей камеры - включена/выключена;
- температуры камеры;
- дата последнего обновления.
Пример содержимого реестра в разделе мониторинга представлен ниже (Рисунок 4).
Компонент RSE Server#
RSE Server представляет собой WebSocket сервер, обрабатывающий команды от внешних систем.
RSE Server принимает запросы и отправляет ответы посредством WebSocket.
Формат запроса:
- Код запроса операции (1 байт)
- Дополнительная полезная нагрузка (MessagePack или строка)
Пример запроса:
GET ws://127.0.0.1:4444/
– установка соединения по WebSocket.
0
- содержимое сообщения для старта сессии.
Формат ответа:
- Код ответа операции (1 байт)
- Дополнительная полезная нагрузка (MessagePack или строка)
Одновременно может быть обработан только один запрос.
В зависимости от необходимого типа интеграции (выбирается на усмотрение разработчика внешней системы) можно настроить RSE Server следующими способами:
- RSE Server ожидает запросы на подключение к камере (представлены в Таблице 5) от внешней системы – необходимо выставить параметр
cs_communication = msg-pack
; - RSE Server запускает процесс получения видеопотока и процесс детекции лиц, как только установится WebSocket соединение – необходимо выставить параметр
cs_communication = json
.
Таблица 5. Описание запросов к RSE Server
Название запроса |
Код запроса |
Описание |
Полезная нагрузка |
Возможные ответы на запрос |
---|---|---|---|---|
RSE_START_CAPTURE |
0 |
Запускает процесс получения видеопотока и процесс детекции лиц |
Нет |
|
RSE_STOP |
1 |
Останавливает все запущенные процессы |
Нет |
|
В зависимости от выбранного типа интеграции (выбирается на усмотрение разработчика внешней системы) ответ сервера может быть представлен в двух форматах:
- если разработчик внешней системы установил параметр
cs_communication = msg-pack
, то каждый ответ будет поступать в форматеmsg-pack
и будет содержать полеmessageType
с кодом ответа и некоторые дополнительные поля с данными (полезные нагрузки), описанными в Таблице 6; - если разработчик внешней системы установил параметр
cs_communication = json
, то каждый ответ будет поступать в форматеjson
и подразделяться на типы сообщений, описанные в Таблице 7.
Таблица 6. Ответы на запросы к RSE Server при формате ответа MessagePack
Название ответа |
Код |
Описание |
Полезная нагрузка |
---|---|---|---|
RSE_CAPTURE_OK |
54 |
Захваченный набор видеокадров |
— rgbFrame – RGB кадр в формате uint8 array; — rgbFrameWidth – ширина RGB кадра в пикселях в формате int; — rgbFrameHeight – высота RGB кадра в пикселях в формате int; — irFrame – IR кадр в формате uint8 array; — depthFrame – Depth кадр в формате uint8 array |
RSE_CAPTURE_META |
55 |
Метаданные обнаруженных лиц |
— gotBestshot – индикатор был ли получен bestshot, в формате bool, возвращает:
— bestshot – RGB-кадр, в формате uint8 array:
|
RSE_STOP_OK |
50 |
Вся обработка остановлена. RSE Server готов к новым запросам |
Полезной нагрузки нет |
RSE_UNKNOWN |
51 |
Запрос не был распознан |
Полезной нагрузки нет |
RSE_INTERNAL_ERROR |
52 |
Возникла ошибка при обработке запроса |
Полезной нагрузки нет |
RSE_BUSY |
53 |
Запрос отклонен, т.к. сервер занят |
Полезной нагрузки нет |
Таблица 7. Ответы на запросы к RSE Server при формате ответа JSON
Тип сообщения |
Описание |
Полезная нагрузка |
---|---|---|
visual |
Тип ответа, который используется для трансляции видеопотока пользователю |
— msg_type – тип возвращаемого сообщения (visual); — img_b64 – кадр с камеры в формате base64; — metadata – параметры возвращаемого изображения:
|
bestshot |
Тип ответа, когда лицо успешно найдено. Этот кадр может использоваться для последующей обработки (например, во внешней системе распознавания лиц) |
— msg_type – тип возвращаемого сообщения (bestshot); — img_b64 – лицо с кадра камеры в формате base64; — metadata – параметры возвращаемого изображения:
|
Компонент WebSocket Client#
WebSocket Client является внешним компонентом для взаимодействия с RSE Server.
WebSocket Client – это JavaScript-библиотека для связи с RSE Server посредством WebSocket. Используется минимизированный формат двоичной сериализации MessagePack в качестве библиотеки протоколов для кодирования и декодирования сообщений, если сервер возвращает ответы в формате MessagePack.
Настройка Системы#
Данный раздел содержит общие сведения в части настройки Системы и логирования.
Система позволяет настраивать следующие параметры:
- Общие параметры (подробнее см. "Приложение 1. Общие параметры конфигурации").
- Параметры захвата изображений (изменяются в файле
rsengine.conf
); - Параметры детекции лиц (изменяются в файле
rsengine.conf
); - Параметры выполнения проверки IOU — проверка пересечения BBox лица на ИК- и RGB-изображении (изменяются в файле
rsengine.conf
).
Параметры захвата изображений, параметры детекции лиц, параметры выполнения проверки IOU являются зафиксированными по умолчанию и не предполагают изменений со стороны пользователя (администратора). Настройка данных параметров производится только правообладателем (ООО «ВижнЛабс»).
В составе поставки Системы находятся другие файлы .conf. Не рекомендуется менять параметры в этих файлах, так как это может нарушить работу Системы. Настройка Системы может проводиться только в рамках инструкций, приведенных ниже.
Настройка Системы на ОС Windows#
Система настраивается через реестр Windows.
Настройки, полученные сервером от клиента, сохраняются до перезапуска Системы.
При настройке Системы через реестр Windows, необходимо выполнить запись параметров по следующему пути:
\*\* HKEY\_LOCAL\_MACHINE \ SOFTWARE \ VisionLabs \ RSEServer \*\*
При изменении настроек конфигурации новые конфигурации будут перезаписывать предыдущие.
Для изменения параметров в реестре необходимо найти соответствующий параметр, внести изменения и применить их.
Настройка Системы на ОС Ubuntu 24.04 x64 и Debian 10 x64#
Система настраивается посредством изменения данных в клиентских файлах конфигурации в поставке (server.conf
и rsengine.conf
).
Для применения настроек клиентской конфигурации необходимо внести изменения в файлах server.conf
и rsengine.conf
(Таблица 8, Таблица 9) и перезапустить RSE Server.
Для изменения параметров необходимо внести изменения в соответствующий файл и применить изменения.
Логирование#
RSE Server производит запись логов в консоль, а также в файл журнала Windows для сборов под Windows.
В файлах журналов используется следующая схема наименований файлов: server_YYYY-MM-DD.log.
Приложение 1. Общие параметры конфигурации#
Общие параметры изменяются в реестре (для Windows) файлах server.conf
(Таблица 8) и rsengine.conf
(Таблица 9). Параметры конфигурации реестра Windows представлены ниже (Таблице 10).
Таблица 8. Общие параметры конфигурации в файле server.conf
Наименование параметра |
Тип данных |
Знач. по умолч. |
Описание |
---|---|---|---|
|
|
|
Путь к каталогу данных RSE Server. Не рекомендуется изменять значение параметра. |
|
|
|
Путь к config-файлу библиотеки RSEngine. Актуален для настройки Системы на ОС Ubuntu 24.04 x64, Debian 10 x64, Armbian 23 и ОС Windows, использующей файлы конфигурации |
|
|
|
Тип взаимодействия сервера с клиентом. Зависит от выбранной конфигурации Системы. Может принимать следующие значения:
|
|
|
|
Возвращаемый формат изображения лучших кадров. Выбирается исходя из требований внешнего ПО. Может принимать следующие значения:
|
|
|
|
Сохранение лучших кадров на диск в
директорию
|
|
|
|
Директория сохранения лучших кадров при
активации переменной |
|
|
|
Шифрование лучших кадров при их сохранении. Не используется в этой версии Системы.
|
|
|
|
IP адрес сервера на котором следует запуститься чтобы принимать вебсокет соединения. При использовании одной копии необходимо указывать localhost, при использовании нескольких запущенных копий – указывать главный сервер. |
|
|
|
Порт, на котором RSE Server принимает соединения |
|
|
|
Уровень логирования фильтрует сообщения журнала и имеет следующие уровни от 0 до 3:
|
|
|
|
Путь к доступному для записи каталогу для хранения журналов сервера |
|
|
|
Посуточная ротация логов
|
|
|
|
Продолжать получать бестшоты в сессии, даже если бестшот уже был получен
|
Таблица 9. Общие параметры конфигурации в файле rsengine.conf
В файле
rsengine.conf
уникальные настройки для каждой камеры разнесены по блокам.
Наименование параметра |
Тип данных |
Знач. по умолч. |
Описание |
---|---|---|---|
|
|
|
Режим работы Системы с камерами.
|
|
|
|
Параметр включает/выключает мониторинг состояния камеры.
|
|
|
|
Параметр устанавливает в секундах частоту опроса состояния камеры у службы мониторинга |
|
|
|
Использование данных с RGB и IR камер для проведения проверок. Не рекомендуется изменять данный параметр.
|
|
|
|
Использование информации о положении и статусе глаз при проверке Liveness.
|
|
|
|
Использование информации о статусе рта при проверке Liveness.
|
|
|
|
Использование информации об объемности лица на изображении при проверке Liveness. Не рекомендуется изменять данный параметр.
|
|
|
|
Проверка FPR Liveness. Не рекомендуется изменять данный параметр.
|
|
|
|
Минимальный порог значения Liveness при проверки лица на объемном изображении. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows), где:
|
|
|
|
Минимальный порог значения Liveness при проверки лица. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows), где:
|
|
|
|
Передача координат Bbox лица с RGB изображения в IR изображения для последующей обработки.
|
|
|
|
Пороговое значения для использования IOU при построении Bbox. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества изображения перед проверкой Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Порог сравнения лица с IR и RGB изображений. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный отступ между Bbox лица и границами кадра в пикселях. Лицо должно находиться в минимум 10 пикселях от границы кадра при проведении проверки Liveness, чтобы не была потеряна информация о лице. 10…100 пикселей. |
|
|
|
Минимальный порог оценки качества изображения, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества освещенности лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества затемненности лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества размытости лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Максимальный угол наклона головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Максимальный угол вращения головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Максимальный угол поворота головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Включение режима авто экспозиции для RGB изображения. Не рекомендуется отключать эту настройку.
|
|
|
|
Включение режима авто экспозиции для IR изображения.Не рекомендуется отключать эту настройку.
|
|
|
|
Проверка недостатка освещения изображения на IR изображении. |
|
|
|
Обрезка исходного кадра для уменьшения зоны интереса для повышения качества распознавания. Преднастроенные ниже параметры ограничивают центральную часть кадра, где лицо искажено меньше всего. Не рекомендуется отключать эту настройку.
|
|
|
|
Горизонтальная координата левого верхнего угла зоны интереса. Задается от верхнего левого угла кадра. Не рекомендуется изменять данный параметр. |
|
|
|
Вертикальная координата левого верхнего угла зоны интереса. Задается от верхнего левого угла кадра. Не рекомендуется изменять данный параметр. |
|
|
|
Ширина зоны интереса. Не рекомендуется изменять данный параметр. |
|
|
|
Высота зоны интереса. Не рекомендуется изменять данный параметр. |
|
|
|
Угол поворота видеокадра камеры. Возможные значения: |
|
|
|
Проверка IR Liveness.
|
Таблица 10. Параметры конфигурации реестра Windows
Наименование параметра |
Тип данных |
Знач. по умолч. |
Описание |
---|---|---|---|
|
|
|
Путь к каталогу данных RSE Server. Не рекомендуется изменять значение параметра. |
|
|
|
Тип взаимодействия сервера с клиентом. Зависит от выбранной конфигурации Системы. Может принимать следующие значения:
|
|
|
|
Возвращаемый формат изображения лучших кадров. Выбирается исходя из требований внешнего ПО. Может принимать следующие значения:
|
|
|
|
Сохранение лучших кадров на диск
в директорию
|
|
|
|
Директория сохранения лучших
кадров при активации переменной
|
|
|
|
Шифрование лучших кадров при их сохранении. Не используется в этой версии Системы.
|
|
|
|
Адрес сервера на котором развернут RSE Server. При использовании одной копии необходимо указывать localhost, при Использовании нескольких запущенных копий – указывать главный сервер. |
|
|
|
Порт, на котором RSE Server принимает соединения |
|
|
|
Уровень логирования фильтрует сообщения журнала и имеет следующие уровни от 0 до 3:
|
|
|
|
Путь к доступному для записи каталогу для хранения журналов сервера |
|
|
|
Режим работы Системы с камерами
|
|
|
|
Параметр включает/выключает мониторинг состояния камеры.
|
|
|
|
Параметр устанавливает в секундах частоту опроса состояния камеры у службы мониторинга |
|
|
|
Использование данных с RGB и IR камер для проведения проверок. Не рекомендуется изменять данный параметр.
|
|
|
|
Использование информации о положении статусе глаз при проверке Liveness.
|
|
|
|
Использование информации о статусе рта при проверке Liveness.
|
|
|
|
Использование информации об объемности лица на изображении при проверке Liveness. Не рекомендуется изменять данный параметр.
|
|
|
|
Проверка FPR Liveness. Не рекомендуется изменять данный параметр.
|
|
|
|
Минимальный порог значения Liveness при проверки лица на объемном изображении. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows), где:
|
|
|
|
Минимальный порог значения Liveness при проверки лица. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows), где:
|
|
|
|
Передача координат Bbox лица с RGB изображения в IR изображения для последующей обработки.
|
|
|
|
Пороговое значения для использования IoU при построении Bbox. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества изображения перед проверкой Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Порог сравнения лица с IR и RGB изображений. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный отступ между Bbox лица и границами кадра в пикселях. Лицо должно находиться в минимум 10 пикселях от граница кадра при проведении проверки Liveness, чтобы не была потеряна информация о лице. 10…100 пикселей. |
|
|
|
Минимальный порог оценки качества изображения, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества освещенности лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества затемненности лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Минимальный порог оценки качества размытости лица на изображении, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. Порог задается в диапазоне от 0.0 до 1.0 (0…100 для Windows). |
|
|
|
Максимальный угол наклона головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Максимальный угол вращения головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Максимальный угол поворота головы относительно оси камеры, при котором будет произведена проверка Liveness. Параметр подбирается аналитически разработчиками и не рекомендуется к изменению. |
|
|
|
Включение режима авто экспозиции для RGB изображения. Не рекомендуется отключать эту настройку.
|
|
|
|
Включение режима авто экспозиции для IR изображения. Не рекомендуется отключать эту настройку.
|
|
|
|
Проверка недостатка освещения изображения на IR изображении. |
|
|
|
Использование обрезки исходного кадра для уменьшения зоны интереса для повышения качества распознавания. Преднастроенные ниже параметры ограничивают центральную часть кадра, где лицо искажено меньше всего. Не рекомендуется отключать эту настройку.
|
|
|
|
Горизонтальная координата левого верхнего угла зоны интереса. Задается от верхнего левого угла кадра. Не рекомендуется изменять данный параметр. |
|
|
|
Вертикальная координата левого верхнего угла зоны интереса. Задается от верхнего левого угла кадра. Не рекомендуется изменять данный параметр. |
|
|
|
Ширина зоны интереса. Не рекомендуется изменять данный параметр. |
|
|
|
Высота зоны интереса. Не рекомендуется изменять данный параметр. |
|
|
|
Посуточная ротация логов
|
|
|
|
Продолжать получать бестшоты в сессии, даже если бестшот уже был получен
|
|
|
|
Угол поворота видеокадра камеры. Возможные значения: |
|
|
|
Проверка IR Liveness.
|
Приложение 2. Коды статусов и описание ошибок#
Коды статусов и описание ошибок failureReason
в полезных нагрузках ответа RSE_CAPTURE_META
при выполнении проверки Liveness приведены в Таблице 11.
Коды общие для ответов msg-pack и JSON.
Таблица 11. Коды статусов и описание ошибок failureReason
в ответе RSE_CAPTURE_META
Код статуса | Описание |
---|---|
0 | Ошибок нет, кадр прошел проверки |
1 | Некорректный RGB-кадр |
2 | Некорректный Depth-кадр |
3 | Некорректный ИК-кадр |
4 | Лицо не обнаружено |
5 | Лицо не обнаружено (лицо в кадре слишком маленькое) |
6 | Обнаруженное лицо не проходит по одному из параметров конфигурации |
7 | Невозможно оценить лицо в кадре по 5 точкам |
10 | Лицо в кадре обрезано |
11 | Лицо повернуто — слишком короткое расстояние между глазами |
12 | Liveness проверка глаз не пройдена |
13 | Не удалось нормализовать RGB-кадр |
14 | Не удалось нормализовать Depth-кадр |
15 | Не удалось нормализовать ИК-кадр |
16 | Некорректное положение головы |
17 | Глаза закрыты |
18 | Необходима нейтральная мимика мышц рта |
19 | Liveness проверка Depth-кадра не пройдена |
20 | Liveness проверка ИК-кадра не пройдена |
21 | Низкое качество кадра |
22 | RGB-кадр слишком яркий |
23 | RGB-кадр слишком темный |
25 | Изображение размыто |
26 | Проверка FPR Liveness не пройдена |
28 | Идет Liveness проверка сравнение RGB- и ИК-кадра |
29 | Liveness проверка ИК-кадра без подсветки |
31 | Ошибка распознавания лица в кадре |
32 | Не удалось обнаружить лицо на ИК-кадре |
33 | Низкое качество Depth-кадра |
34 | Обнаружено несколько лиц с пересекающимися зонами BBox |