Источники видео

Для настройки видеомониторинга объектов добавьте камеры в FindFace Multi, сгруппировав их c учетом расположения.

Примечание

Права на создание групп камер и камер настраиваются в разрешениях пользователя (см. Управление ролями и пользователями).

В этой главе:

Создание группы камер

Совет

В системе доступна группа камер по умолчанию.

Для создания группы камер выполните следующие действия:

  1. Перейдите на вкладку Настройки. Выберите Группы камер.

  2. Нажмите + Новая группа камер.

    create_camera_group_ru

  3. На вкладке Сведения, введите имя группы и при необходимости комментарий к ней.

    camera_group_ru

  4. Если вам нужно выделить определенный экземпляр findface-video-worker для обработки видеопотоков с данной группы камер, создайте или выберите из уже созданных одну или несколько меток.

    Примечание

    Для того чтобы завершить выделение, перечислите метки в файле конфигурации findface-video-worker.yaml. Подробнее см. Привязка группы камер к экземпляру findface-video-worker.

  5. Если события от камер, принадлежащих одной группе, требуется дедуплицировать, т. е. исключить одинаковые события, поставьте флажок Убрать дубли событий с интервалом и задайте в секундах интервал дедупликации (интервал, с которым события проверяются на уникальность).

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

    Используйте дедупликацию очень осторожно. Если камеры из одной группы наблюдают разные сцены, некоторые объекты могут быть пропущены. Подробнее см. Дедупликация событий.

  6. По умолчанию на всех группах камер в системе используется универсальный порог срабатывания. Для того чтобы установить индивидуальный порог для группы камер, поставьте флажок Порог срабатывания и укажите нужное пороговое значение.

    Важно

    Для большинства случаев распознавания лиц значение, установленное по умолчанию для универсального порога срабатывания, является оптимальным. Не рекомендуется самостоятельно менять его. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).

  7. Нажмите Сохранить.

  8. На вкладке Права доступа назначьте права на работу с группой камер, указав, пользователям с какими ролями разрешено изменять/просматривать ее настройки.

    camera_group_permissions_ru

  9. Нажмите Сохранить.

Добавление камеры

Для добавления камеры выполните следующие действия:

  1. Перейдите на вкладку Источники видеоКамеры.

  2. Нажмите + Добавить камеры или + Добавить.

    camera_add_ru

  3. На вкладке Устройства введите URL потока и нажмите Дальше.

    camera_stream_url_ru

    • Укажите название камеры.

    • Добавьте камеру в группу.

    • Поставьте флажки для тех детекторов, которые нужно активировать для данной камеры: лица, силуэты, транспортные средства.

      camera_configure_ru

    • Нажмите Добавить и настроить. Вы увидите, как появятся дополнительные вкладки.

  4. Нажмите на камеру в списке, чтобы открыть мастер настройки обработки. Настройте параметры обработки видео.

  5. Если вы используете камеру ONVIF, выберите ее из списка обнаруженных устройств для автоматической загрузки доступных настроек и видеопотоков.

    camera_onvif_ru

Параметры обработки видео

  1. Для каждой камеры предоставляется полная статистика: продолжительность текущей сессии обработки, количество отправленных объектов, количество объектов, обработанных с ошибками после последнего перезапуска job-задания, количество пропущенных кадров и другие данные. Для просмотра этих данных нажмите на камеру и перейдите на вкладку Сведения.

    camera_info_ru

  2. На вкладке Основные вы можете изменить имя камеры, группу камер и описание. Вы можете записать видео и включить liveness (витальность). Поставьте флажки для тех детекторов, которые нужно активировать для данной камеры: лица, силуэты, транспортные средства.

    camera_general_ru

  3. На вкладке Дополнительные выполните тонкую настройку камеры:

    camera_advanced_ru

    • При необходимости измените ориентацию видео.

      Важно

      Вращение потока выполняется на стороне сервера findface-multi-legacy средствами постобработки. Это может негативно сказаться на производительности. Рекомендуем по возможности делать вращение потока на стороне камеры.

    • Таймаут: Время ожидания в миллисекундах отправки на сервер обнаруженных объектов.

    • Проверить SSL-сертификат: Поставьте флажок, чтобы включить проверку подписи SSL-сертификата при взаимодействии по https видеодетектора объектов с сервером. Снимите флажок, если вы используете самоподписанный сертификат.

    • Получать метки времени из потока: Поставьте флажок, чтобы отправлять на сервер временные метки, полученные из потока. Снимите флажок, чтобы отправлять текущие дату и время.

    • Добавить к временным меткам: Прибавлять указанное количество секунд к временным меткам из потока.

    • Параметры FFMPEG: Параметры FFmpeg для видеопотока. Задаются массивом строк ключ=значение, например, [“rtsp_transpotr=tcp”, “ss=00:20:00”].

    • Ограничение скорости воспроизведения: Если меньше нуля, то скорость не ограничивается, в остальных случаях поток читается с заданной скоростью play_speed. Не применимо для потоков с камер видеонаблюдения.

    • Формат ввода: Передать формат FFmpeg (mxg, flv, и т. д.), если он не может быть автоматически определен.

    • Минимальная интенсивность движения: Минимальная интенсивность движения, которая будет регистрироваться детектором движения.

    • Считывание кадров источника без пропусков: По умолчанию (false), если findface-video-worker не обладает достаточными ресурсами для обработки всех кадров с объектами, он будет пропускать некоторые из них. Если данная опция активна (true), findface-video-worker помещает лишние кадры в очередь, чтобы обработать из впоследствии. При обработке файлов как камер необходимо указать значение true.

    • Обработать поток один раз до конца или до первой ошибки (single_pass): Если true, то не перезапускать обработку потока при обнаружении ошибки.

    • URL роутера (router_url): IP адрес для отправки обнаруженных объектов во внешние видеообработчики из findface-video-worker. По умолчанию 'http://127.0.0.1'.

  4. Укажите область отслеживания (Зоны) в поле зрения камеры и область интереса. Нажмите Сохранить.

    camera_zones_ru

    Область отслеживания позволяет обнаруживать и отслеживать лица/силуэты и транспортные средства только внутри заданного прямоугольника. Используйте данную опцию, чтобы уменьшить нагрузку на видеодетектор объектов. Область интереса позволяет отправлять на сервер только объекты, обнаруженные в ее пределах.

  5. На вкладках Лица, Силуэты и ТC укажите настройки детектора объектов каждого типа.

    camera_analytics_ru

    • Размер: Минимальный и максимальный размер отправляемых объектов, в пикселях.

    • Качество: Минимальное пороговое значение качества изображения лица. Допустимый диапазон от 0 до 1. Базовое рекомендуемое значение 0,45 — соответствует удовлетворительному качеству изображения лица. Не меняйте значение по умолчанию без предварительной консультации с нашими техническими экспертами (support@ntechlab.com).

    • Качество JPEG: Качество сжатия полного кадра для отправки.

    • Полный кадр PNG: Отправлять полные кадры в формате PNG, а не в формате JPEG, как установлено по умолчанию. Не включайте этот параметр, не посоветовавшись с нашей командой, так как он может повлиять на работу всей системы.

    • Коэффициент перекрытия границ распознанного объекта: Процент перекрытия границ между двумя последовательными кадрами, чтобы эти bbox’ы считались одним треком. Диапазон значений: от 0 до 1. Не меняйте значение по умолчанию без предварительной консультации с нашими техническими экспертами (support@ntechlab.com).

    • Максимальная длительность трека: Максимальное приблизительное количество кадров в треке, по достижении которого трек будет принудительно закрыт. Включите опцию, чтобы автоматически завершать вечные треки, например, треки детектирования лиц с рекламных носителей.

    • Интервал закрытия трека: Завершить трек, если в нем не было распознано новых изображений объекта в течение заданного времени (в секундах).

    • Отправить историю трека: Отправлять массив координат границ объекта вместе с событием. Может быть применено для внешних интеграций, чтобы отобразить путь объекта.

    • Обрезать полный кадр: Поставьте флажок если необходимо обрезать полный кадр по размеру ROT-области перед отправкой на распознавание. Размер полного кадра будет равен размеру ROT-области.

    • Буферный режим: По умолчанию для обработки видео система использует буферный режим, т.е. отправляет по одному кадру наилучшего качества на трек для экономии места на диске. Отключите данный режим, чтобы получать больше кадров лица, если это необходимо. Если буферный режим включен, параметры режима реального времени не работают.

    Параметры режима реального времени:

    Примечание

    Эти параметры не работают, если включен буферный режим.

    • Интервал: Временной интервал в секундах (целое или десятичное число), в течение которого в режиме реального времени выбирается лучший кадр с объектом.

    • Отправлять первый распознанный объект немедленно: Поставьте флажок, чтобы отправлять первый объект из трека сразу, как только фильтры по качеству/размеру/региону интереса пройдены, не дожидаясь окончания первого realtime_post_interval в режиме реального времени. Снимите флажок, чтобы отправлять первый объект из трека только после окончания первого realtime_post_interval.

    • Отправлять первый кадр трека: При завершении трека в дополнение к overall-кадру трека будет дополнительно отправлен первый кадр трека. Может быть применимо для внешних интеграций.

    • Отправлять в каждом интервале: Поставьте флажок, чтобы отправлять лучший кадр в каждом временном realtime_post_interval в режиме реального времени. Снимите флажок, чтобы отправлять лучший кадр, только если его качество улучшилось по сравнению с предыдущим отправленным кадром.

    • Отправлять последний кадр трека: При завершении трека в дополнение к overall-кадру трека будет дополнительно отправлен последний кадр трека. Может быть применимо для внешних интеграций.

    • Порог срабатывания: Порог срабатывания применяется для сопоставления обнаруженного объекта с объектом внутренней сущности.

  6. (Опционально) На вкладке Геопозиция укажите географические координаты камеры.

    camera_geo_ru

  1. Отключенная по умолчанию вкладка Настройки очистки VMS содержит настройки очистки видео для отдельной камеры. Следуйте инструкции Включение настроек очистки VMS в веб-интерфейсе, чтобы добавить вкладку.

    custom_vms_cleanup_ru

    Пользовательские настройки очистки VMS переопределяют глобальные настройки для отдельной камеры. Доступны следующие пользовательские настройки очистки VMS:

    Удалять интервалы между треками

    • Включить индивидуальные настройки: включить индивидуальные настройки удаления интервалов между треками. По умолчанию используются глобальные настройки.

    • Удалять интервалы между треками: удалять промежутки видео между треками, не содержащие событий распознавания.

    • Сохранять события: сохранять события для выбранного объекта (лица, силуэта, транспортного средства).

    • Добавить отступы к треку: промежуток видео в секундах до и после трека с событиями, который добавляется к треку.

    • Порог очистки: минимальный промежуток между треками в секундах. Если промежуток между треками ниже порога, видео не будет удалено. Минимальное значение для это поля — 360 секунд.

    • Удалять интервалы между треками через: временной период (в днях), в течение которого хранится весь видеоархив. По истечении этого периода начнется очистка интервалов между треками так, как она задана в настройках. Значение может быть больше либо равно нулю.

    Очищать архив

    • Включить индивидуальные настройки: включить индивидуальные настройки очистки архива. По умолчанию используются глобальные настройки.

    • Очищать архив: включить очищение всего видеоархива.

    • Удалять данные старше: количество дней, в течение которых видеоархив хранится в системе. По истечении этого срока видеоархив удаляется.

    Нажмите на Показать глобальные настройки, чтобы увидеть глобальные настройки очистки VMS.

Загрузка и обработка видеофайла

Для того чтобы загрузить и обработать видеозапись, выполните следующие действия:

  1. Перейдите на вкладку Источники видеоЗагрузки.

  2. Нажмите + Загрузить файлы или + Загрузить.

    video_uploads_ru

  3. Укажите URL или выберите файл. Нажмите Загрузка.

    video_upload_file_en

  4. Назначьте группу камер, к которой система будет приписывать события с объектами из данного видео. Группа камер Video archive default Camera Group идеально подходит для этой задачи. Вы также можете создать новую группу камер с базовыми настройками специально для данного видео. Поставьте флажки для тех детекторов, которые нужно активировать для данного видео: лица, силуэты, транспортные средства.

    video_upload_pref_ru

    Нажмите Добавить и настроить. В результате видеозапись будет загружена и добавлена в список.

  5. Нажмите на видео в списке, чтобы открыть мастер настройки обработки. Настройте параметры обработки видео аналогичным образом, как и для камер.

    video_upload_configuration_ru

    • (Опционально) Выберите камеру в составе группы, чтобы более точно промаркировать события распознавания объектов из этого видео.

    • (Опционально) Настройте метки времени для событий распознавания объектов.

  6. В списке загрузок видео нажмите три точки → Обработать текущий, чтобы запустить идентификацию объектов. Вы можете просмотреть события идентификации объектов на вкладках События и Эпизоды, отфильтровав список событий по группе камер/ камере, ассоциированной с видео.

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

Вы также можете использовать объект типа камера для интеграции внешнего детектора.

camera_ex_detect_ru

При необходимости измените имя внешнего детектора. Укажите исходную группу камер и описание. При необходимости включите liveness.

camera_ex_detect_set_ru

Мониторинг работы камер

Мониторинг работы камер выполняется на вкладке Камеры.

monitor_cameras_ru

Статусы камер:

  • Зеленый: идет обработка видеопотока с камеры, проблем не обнаружено.

  • Желтый: камера работает менее 30 секунд или имеют место одна или несколько ошибок при отправке объектов.

  • Красный: камера не работает.

  • Серый: камера отключена.

Совет

Вы можете настроить отображение желтого и красного статусов на основании доли пропущенных кадров и доли неудачных отправок объектов на сервер. Для этого измените следующие параметры в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
   ...

   # max camera frames_dropped percent
   'MAX_CAMERA_DROPPED_FRAMES': {'yellow': 0.1, 'red': 0.3},
   # max camera objects failed percent
   'MAX_CAMERA_FAILED_OBJECTS': {'yellow': 0.1, 'red': 0.3},

   ...
   }

Выполните перезапуск контейнеров FindFace Multi.

cd /opt/findface-multi/

sudo docker-compose restart

Каждая камера связана с так называемым job-заданием, задачей на обработку видео, содержащей параметры конфигурации и данные видеопотока, которая назначается определенному экземпляру findface-video-worker. Данная задача может быть перезапущена.

Для перезапуска job-задания откройте настройки камеры и нажмите на кнопку Перезапустить. При этом количество ошибок будет обнулено.

camera_restart_ru

При большом количестве камер в системе используйте следующие фильтры:

  • Название содержит,

  • Группы камер,

  • Статус функционирования (Любой / Активные / Неактивные),

  • Статус рабочего состояния (Любой / Серый / Зеленый / Красный / Желтый).

    camera_filters_ru