⌂ > 🛠 Конфигурационный REST API > ⇄ Путь

faceslight : Изменение настроек модуля Распознавание лиц (Light)🔗

Примечание

Доступно в версии Macroscop 4.6 и выше.

Предупреждение

Доступно только в лицензиях Enterprise и ULTRA.

Данный запрос может выполняться только пользователем с максимальными правами, то есть входящим в группу Старшие администраторы.

Важно

Во всех примерах указан локальный хост (localhost). При отправке реальных запросов замените его на адрес и порт сервера, на который отправляете запрос.

Параметры🔗

Параметр	Описание	Тип
Enabled	Включён ли модуль. Допустимые значения: true — включён, false — выключен.	bool
GeneralSettings	Общие для всех камер настройки модуля Распознавание лиц (Light), применяемые ко всем каналам с включённым модулем	class
.DatabaseSettings	Настройки доступа к базе лиц Light PostgreSQL	class
ChannelSettings	Настройки модуля Распознавание лиц (Light) специфичные для конкретной	class
.MinObjectSize	Минимальный размер лица в кадре	class
.MaxObjectSize	Максимальный размер лица в кадре	class
.MinFrameCountForRecognition	Максимальный размер лица в кадре	class
.UnknownFaceThreshold	Минимальное количество кадров для распознавания. Допустимые значения: [0; 5]. Значение по умолчанию: 2	int?
.FaceDetectorSensitivity	Точность распознавания. Допустимые значения: Minimum, Low, Medium, High, Maximum. Значение по умолчанию: Medium	enum?
.DetectionMap	Битовая маска зоны, описанная матрицей. Каждый элемент матрицы соответствует области кадра. Индекс элемента определяет положение соответствующей области кадра: [0, 0] - область в левом верхнем углу; [29, 39] - область в правом нижнем углу. Матрица 30 строк * 40 столбцов. Каждый элемент матрицы принимает значение 0 или 1: 0 - область кадра не входит в зону распознавания; 1 - область кадра входит в зону распознавания.	byte[,]
.DbId	Идентификатор базы данных, строка. Пустая строка — использование общей базы. Непустая строка — использование уникальной базы. Можно указать одинаковый идентификатор для нескольких камер, тогда они будут взаимодействовать с одной и той же базой. Для данного параметра не учитывается регистр. Пример: при значениях myperfectdb и MyPeRfeCtDb будет создана и использована одна и та же база данных. Идентификатор должен быть длиной не более 32-х символов, содержать латинские буквы, цифры и нижнее подчеркивание (_), в противном случае уникальная база не задастся	string
.LowDelayMod	Включён ли режим низкой задержки. Допустимые значения: true — включён, false — выключен.	bool?

Примечание

Все параметры являются необязательными при отправке PUT-запроса. Если параметр не указан, его текущее значение останется неизменным.

Описание параметра GeneralSettings.DatabaseSettings:

Параметр	Описание	Тип
IsDedicated	Локальная или удалённая база данных используется. Если выбрана удалённая база данных, для конфигурирования доступа к ней используются остальные настройки из раздела DatabaseSettings. Допустимые значения: true — включён, false — выключен.	bool?
IpAddress	IP-адрес удалённой БД. Непустая строка, содержащая IPv4 адрес. Значение по умолчанию: "127.0.0.1"	string
Port	Порт удалённой БД. Допустимые значения: [0; 65535]. Значение по умолчанию: 5432	int?
User	Имя пользователя удалённой БД. Непустая строка. Значения по умолчанию: для ОС Windows — "postgres", для ОС Linux — "macroscop".	string
Password	Пароль удалённой БД для пользователя. Непустая строка. Значение по умолчанию: "masterkey"	string
OsType	Операционная система хост-машины, на котором установлена удалённая БД. Допустимые значения: "Windows", "Linux".	enum

Описание параметра ChannelSettings.MinObjectSize:

Параметр	Описание	Тип
Width	Минимальная ширина, выражаемая в долях от ширины кадра (например, 0.5 — половина ширины кадра). Допустимые значения: [0; 1], строго меньше MaxObjectSize.Width	double?
Height	Минимальная высота, выражаемая в долях от высоты кадра (например, 0.5 - половина высоты кадра). Допустимые значения: [0; 1], строго меньше MaxObjectSize.Height	double?

Описание параметра ChannelSettings.MaxObjectSize:

Параметр	Описание	Тип
Width	Максимальная ширина, выражаемая в долях от ширины кадра (например, 0.5 - половина ширины кадра). Допустимые значения: [0; 1], строго больше MinObjectSize.Width	double?
Height	Максимальная высота, выражаемая в долях от высоты кадра (например, 0.5 - половина высоты кадра). Допустимые значения: [0; 1], строго больше MinObjectSize.Height	double?

Пример запроса🔗

PUT http://localhost:8080/configure/channels/81060b4d-7f0c-47af-8ec1-124dc79fd750/faceslight

Пример тела PUT-запроса для отключения модуля🔗

{
      "GeneralSettings": {
          "DatabaseSettings": {
              "IsDedicated": false,
              "IpAddress": "127.0.0.1",
              "Port": 3050,
              "User": "SYSDBA",
              "Password": "masterkey",
              "OsType": "Windows"
     },
     },
     "ChannelSettings": {
          "DelayBetweenSameDetectionsSeconds": 5,
          "MinObjectSize": "0.1,0.1,0.06,0.06",
          "MaxObjectSize": "0.3,0.3,0.5,0.5",
          "UnknownFaceThreshold": 85.0,
          "FaceDetectorSenstivity": "Medium",
          "DetectionMap": [
              [1, 1, 1, 1, 1, "... ", 1, 1, 1, 1, 1],
              "... ",
              [1, 1, 1, 1, 1, "... ", 1, 1, 1, 1, 1]
          ],
          "DbId": "user12713",
          "RecognizeCoveredFaces": true,
          "RecognizeRotatedFaces": false
     },
     "Enabled": false
}