Перейти к содержанию

FaceStream v.5.2.0#

Изменения

  • Добавлена поддержка API V2 сервиса LUNA Streams.

    Изменения второй версии ориентированы на использование совместного режима работы детектора лиц и тел. Детектор лиц и тел включается с помощью одновременного включения параметров "use-face-detector" и "use-body-detector" в настройках TrackEngine.

    Поддержка API V1 остается доступной.

    Основные изменения новой версии API:

    • удалено задание адреса и версии API сервиса LUNA API. Теперь настройки соединения с LUNA PLATFORM указывается в настройках FaceStream (группа параметров "FACE_STREAM_CONFIG") в разделе "lunaplatform".
    • параметр "min_score" разделен на два параметра — "min_score_face" и "min_score_body"
    • параметр "number_of_bestshots_to_send" раздел на два параметра — "face_bestshots_to_send" и "body_bestshots_to_send"
    • удалены все устаревшие параметры (например, "detection_handler")

    Руководство администратора полностью переработано под использование версии API V2.

    Плагин для проксирования запросов LUNA Streams через сервис LUNA API также поддерживает новую версию API. См. подробную информацию в разделе "Проксирование запросов в LUNA Streams через LUNA API".

    Пользовательский интерфейс LUNA Streams в настоящий момент не поддерживает API V2. Поддержка будет добавлена позднее.

    Важно! На данный момент есть ограничения на работу нижеописанного функционала API V2. 

    Общий функционал:

    • отсутствует параметр "preferred_program_stream_frame_width"
    • невозможно указать более одной аналитики в массиве аналитик

    Совместный режим работы лиц и тел:

    • не поддерживается группа параметров "data" > "analytics" > "primary_track_policy"
    • не поддерживается параметр "data" > "analytics" > "sending" > "full_frame_settings", определяющий какие исходные кадры будут отправлены (лица, тела или лица и тела). В настоящий момент отправляются только исходные кадры лиц и тел.
    • не поддерживается параметр "data" > "analytics" > "sending" > "bestshot_settings" > "type", определяющий какие лучшие снимки будут отправлены (лица, тела или лица и тела). В настоящий момент будут отправляться только лучшие снимки лиц и тел.

    Периодическая отправка лучших снимков в совместном режиме работает аналогично работе с телами. Это значит, что параметр "silent_period" не будет работать в совместном режиме.

    Описание ограничений совместного режима также описано в разделе "Совместный режим детектирования лиц и тел" в руководстве администратора.

  • Добавлена возможность отправлять во внешний сервис Crop-изображения вместо биометрических образцов (формат "warp") и модифицированных изображений (формат "gost").

    Отправка регулируется параметром "sending" > "portrait_type", принимающим новое значение "crop".

    Crop-изображение это фрагмент изображения, полученный путём расширения и обрезки области вокруг обнаруженного объекта. Расширение области определяется новым параметром "sending" > "crop_factor", увеличивающим размеры исходного прямоугольника, содержащего объект. Максимальный размер обрезанного изображения контролируется параметром новым параметром "sending" > "max_crop_size", ограничивающим наибольшую сторону области. Если размер фрагмента превышает заданный параметр, то фрагмент будет масштабирован пропорционально по обеим координатам до нужного размера. Crop-изображение позволяет захватить больше контекста и детализации вокруг объекта по сравнению с биометрическим образцом.

    Это позволяет более гибко управлять обработкой изображений. Отправка Crop-изображений имеет несколько ключевых преимуществ:

    1. Координаты лица: Вместе с Crop-изображением передаются координаты лица как на Crop-изображении, так и на исходном изображении. Это позволяет избежать повторного запуска детектора лиц, обеспечивая наличие лица на изображении и экономя вычислительные ресурсы.
    2. Дополнительная информация: Crop-изображение содержит больше контекста и деталей вокруг лица, что позволяет оценивать различные параметры, которые невозможно оценить на биометрическом образце. Например, эстимация Deepfake, Liveness и др., могут быть выполнены с большей точностью.
    3. Сторонние сервисы: Сторонние сервисы и алгоритмы распознавания лиц часто работают лучше с Crop-изображениями, чем с биометрическими образцами. Это связано с тем, что Crop-изображения содержат больше информации и контекста, что улучшает точность распознавания и анализа.

    Важно! Начиная с текущей версии FaceStream, необходимо использовать LUNA PLATFORM v.5.67.0 и выше. Более старые версии LUNA PLATFORM не поддерживаются текущей версией FaceStream.

Исправленные ошибки

  • Исправлена ​​ошибка отправки неправильного количества детекций лиц при использовании совместного детектора.

    Теперь количество обнаружений лиц ограничено параметром "face_bestshots_to_send". Для каждого трека количество отправляемых обнаружений лиц ограничено этим параметром. При каждом обнаружении будет отправлен только один биометрический образец.