Внешние детекторы

Существует возможность интеграции FindFace Multi с внешними детекторами, предоставляющими кадры для распознавания объектов, например, с терминалами контроля доступа. В этом случае при получении кадра от внешнего детектора FindFace Multi будет автоматически инициировать извлечение вектора признаков объекта и создание события. Работа с данными событиями выполняется по аналогии с событиями с камер видеонаблюдения.

Важно

Чтобы использовать внешний детектор для распознавания объектов, необходимо включить определение витальности лиц. Если вы не включили определение витальности лиц при установке продукта, можно сделать это сейчас, воспользовавшись информацией из раздела Включение определения витальности лиц.

Модель для определения витальности faceattr.liveness_web.v1, включенная в конфигурацию по умолчанию, используется для аутентификации по лицу. Если ваш сценарий использования подразумевает подключение к внешнему детектору для распознавания объектов, замените модель faceattr.liveness_web.v1 на модель faceattr.liveness_pacs.v3 в файле конфигурации findface-extraction-api.yaml. Модель экстрактора faceattr.liveness_pacs.v3 использует нормализатор crop2x.v2_maxsize400. Обязательно включите его в секции normalizers → models.

GPU

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

extractors:
  ...
  models:
    face_liveness:
      default:
        model: faceattr/faceattr.liveness_pacs.v3.gpu.fnk
    ...
normalizers:
  ...
  models:
    ...
    crop2x:
      model: facenorm/crop2x.v2_maxsize400.gpu.fnk
    ...

CPU

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

extractors:
  ...
  models:
    face_liveness:
      default:
        model: faceattr/faceattr.liveness_pacs.v3.cpu.fnk
    ...
normalizers:
  ...
  models:
    ...
    crop2x:
      model: facenorm/crop2x.v2_maxsize400.cpu.fnk
    ...

Перезапустите контейнер findface-multi-findface-extraction-api-1.

sudo docker container restart findface-multi-findface-extraction-api-1

Интеграция внешних детекторов выполняется через HTTP API. После первичной настройки FindFace Multi выдаст токен. Указывайте данный токен в каждом API-запросе, отправляемом внешним детектором в FindFace Multi, чтобы авторизовать устройство.

Для интеграции внешнего детектора с FindFace Multi выполните следующие действия:

  1. Перейдите в Источники Видео → Внешние детекторы.

  2. Нажмите + Добавить или + Добавить внешние детекторы, если еще не добавлено ни одного детектора.

    add_ext_detector_ru

  3. В открывшейся вкладке добавьте внешний детектор в группу камер, чтобы впоследствии было удобнее фильтровать события с данного устройства.

    ext_det_window_ru

    Совет

    Вы можете выделить отдельную группу камер специально под внешние детекторы.

  4. На вкладке Добавить и настроить включите liveness. На этой же вкладке вы увидите токен.

    ex_detect_config_ru

  5. Указывайте данный токен в каждом API-запросе, отправляемом внешним детектором в FindFace Multi для создания события. В результате кадры, переданные в запросах, будут связаны с камерой, соответствующей внешнему детектору, и обработаны по аналогии с кадрами с камер видеонаблюдения.

    detector_token_en

    Подробная интерактивная документация HTTP API FindFace Multi доступна после установки по адресу http://<ffsecurity_ip:port>/api-docs. Изучайте и пробуйте.

    Совет

    Документацию также можно найти в веб-интерфейсе, перейдя в меню по пунктам Настройки → Документация API.