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

PUT /configure/channels/{channel-id}/facescomplete : Изменение настроек модуля Распознавание лиц (Complete)🔗

Примечание

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

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

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

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

Важно

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

Параметры🔗

Параметр

Описание

Enabled

Включён ли модуль. Допустимые значения: true — включён, false — выключен.

GeneralSettings

Общие настройки модуля Распознавание лиц (Complete), распространяются на все камеры с включённым модулем

.DatabaseSettings

Общие настройки БД модуля, распространяющиеся на все камеры с включённым модулем

.IsDedicated

Используется удалённая или локальная БД. Допустимые значения: true — используется удалённая БД, false — используется локальная БД. Значение полей IpAddress, Port, User, Password, OsType следует заполнять если GeneralSettings.DatabaseSettings.IsDedicated равняется true

.IpAddress

Адрес сервера удалённой базы данных, строка

.Port

Порт, число

.User

Имя пользователя, строка

.Password

Пароль пользователя, строка

.OsType

Тип операционной системы, строка Windows или Linux

ChannelSettings

Настройки модуля «Распознавание лиц» специфичные для конкретной камеры

.DelayBetweenSameDetectionsSeconds

Минимальное время в секундах перед повторным определением человека, число 0, 5, 30, 60

.MinObjectSize

Минимальный размер лица в кадре, прямоугольник описываемый 4-мя числами, в интервале от 0 до 1, "x, y, w, h", где x — позиция по оси X, y — позиция по оси Y, w —ширина, h — высота

.MaxObjectSize

Максимальный размер лица в кадре, прямоугольник описываемый 4-мя числами, в интервале от 0 до 1, "x, y, w, h", где x — позиция по оси X, y — позиция по оси Y, w —ширина, h — высота

.UnknownFaceThreshold

Минимальное сходство с образцом распознавания в процентах, значение в интервале от 60 до 99

.FaceDetectorSensitivity

Чувствительность поиска лиц в кадре, строка. Допустимые значения: Minimum, Low, Medium, High, Maximum

.DetectionMap

Зона детектирования, массив маски [40x40], представляет собой двумерный массив 0 и 1, где 1 — пиксель используется в детектировании, а 0 — пиксель не используется в детектировании

.DbId

Идентификатор базы данных, строка. Пустая строка — использование общей базы. Непустая строка — использование уникальной базы. Можно указать одинаковый идентификатор для нескольких камер, тогда они будут взаимодействовать с одной и той же базой. Для данного параметра не учитывается регистр. Пример: при значениях myperfectdb и MyPeRfeCtDb будет создана и использована одна и та же база данных. Идентификатор должен быть длиной не более 32-х символов, содержать латинские буквы, цифры и нижнее подчеркивание (_), в противном случае уникальная база не задастся

.DetectionMap

Зона детектирования, массив маски [40x40], представляет собой двумерный массив 0 и 1, где 1 — пиксель используется в детектировании, а 0 — пиксель не используется в детектировании

.RecognizeCoveredFaces

Нужно ли предпринимать попытки распознавания на лицах, закрытых масками или платками. Допустимые значения: true — перекрытые лица будут обнаруживаться и распознаваться при совпадении, false — перекрытые лица будут обнаруживаться, но никогда не будут распознаны

.RecognizeRotatedFaces

Нужно ли предпринимать попытки распознавания на лицах, повёрнутых более чем на ~30 градусов от положения анфас. Допустимые значения: true — повёрнутые лица будут обнаруживаться и распознаваться при совпадении, false — повёрнутые лица будут обнаруживаться, но никогда не будут распознаны

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

PUT http://localhost:8080/configure/channels/7d69e586-25c6-470e-a368-5570d57b2631/facescomplete

Пример тела 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
}