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

FaceStream v.5.1.0#

Изменения FaceStream

  • Изменён принцип создания потоков. Ранее настройки для потоков задавались в конфигурационном файле "input.json" или в секции Configurator "FS_CONFIG". Теперь настройки для потоков задаются в теле формата JSON и отправляются с помощью HTTP запроса к сервису LUNA Streams (см. запрос "create stream" в документе "StreamsReferenceManual.html" комплекта поставки).

    После отправки HTTP запроса с заданными параметрами к сервису LUNA Streams, параметры добавляются в базу данных LUNA Streams под уникальным идентификатором "stream_id". В зависимости от количества доступных потоков в лицензии (данная информация поступает из сервиса LUNA Licenses), параметры попадают во внутреннюю очередь, где находятся в статусе "pending" пока FaceStream не заберёт их из очереди для последующей обработки (см. подробное описание сервиса в разделе "Взаимодействие FaceStream с LUNA Streams" в руководстве администратора).

    Изменения лицензирования:

    Сервис может обрабатывать определённое количество потоков одновременно. Количество таких потоков задаётся в параметре лицензионного ключа LUNA PLATFORM 5, определяющим количество потоков для работы LUNA Streams. Таким образом, начиная с версии 5.1.0, FaceStream лицензируется с помощью ключа LUNA PLATFORM 5.

    Для запуска LUNA Streams и FaceStream необходимо как минимум три дополнительных компонента LUNA PLATFORM:

    • Сервис LUNA Licenses. С помощью данного сервиса выполняется лицензирование сервиса LUNA Streams.
    • Сервис LUNA Configurator. Настройки LUNA Streams хранятся в данном сервисе аналогично настройкам "FACE_STREAM_CONFIG" и "TRACK_ENGINE_CONFIG" для FaceStream. При отсутствии необходимости использования LUNA Configurator, можно запустить LUNA Streams с использованием конфигурационных файлов, однако данные действия не описаны в руководстве по установке.
    • Контейнер PostgreSQL. В данном контейнере создаётся база данных LUNA Streams, в которую сохраняются параметры потоков, заданные ранее в теле JSON (см. описание базы данных в разделе "Описание базы данных LUNA Streams" руководства администратора). При необходимости можно использовать базу данных Oracle. Её использование не описано в документации.

    Также по умолчанию запускается контейнер InfluxDB OSS 2. С помощью БД Influx осуществляется мониторинг сервисов LUNA PLATFORM. При необходимости мониторинг можно отключить.

    Если компоненты LUNA PLATFORM не запущены и не активирована лицензия LUNA PLATFORM, то перед запуском FaceStream нужно выполнить следующие действия:

    • Активировать лицензию.
    • Запустить требуемые компоненты.
    • Загрузить настройки LUNA Streams и FaceStream в LUNA Configurator.
    • Создать и инициализировать базу данных LUNA Streams.

    Если компоненты LUNA PLATFORM запущены и активирована лицензия LUNA PLATFORM, то перед запуском нужно выполнить следующие действия:

    • Загрузить настройки LUNA Streams и FaceStream в LUNA Configurator.
    • Убедиться, что в лицензии указан параметр, определяющий количество потоков для обработки сервисом LUNA Streams и указать адрес сервера с запущенным сервисом LUNA Licenses в сервисе LUNA Configurator (если сервис LUNA Licenses не находится на сервере с LUNA Streams).
    • Создать и инициализировать базу данных LUNA Streams.

    Описание выполнения данных действий приведено в руководстве по установке FaceStream.

  • Добавлена возможность развернуть FaceStream с помощью скрипта Docker Compose. Скрипт позволяет автоматически запустить и настроить LUNA Streams и FaceStream. Перед запуском скрипта должны быть выполнены следующие действия:

    • Активирована лицензия.
    • Запущены требуемые компоненты.
    • Настройки LUNA Streams и FaceStream загружены в Configurator.
    • Создана и инициализирована база данных LUNA Streams.

  • В документацию добавлено описание ошибок, возвращаемых сервисами LUNA Streams и LUNA Licenses, а также общих ошибок, которые могут возникнуть при взаимодействии с LUNA PLATFORM.

  • В настройки FaceStream (секция "FACE_STREAM_CONFIG" сервиса LUNA Configurator) добавлена секция "lunastreams", позволяющая указать адрес используемого сервиса LUNA Streams (параметр "origin"), его версию API (параметр "api_version") и верхнюю границу количества потоков FS (параметр "max_number_streams"). Если сервис LUNA Streams запущен на другом сервере, то необходимо перед запуском FaceStream указать актуальный адрес сервиса. См. подробную информацию в руководстве администратора FaceStream.

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

    • input, luna_account_id > account_id
    • input, transport > data, type
    • input, url > data, reference
    • output, image_store_url > event_handler, frame_store

    Переработан способ передачи данных для генерации события. Ранее для генерации события LUNA PLATFORM использовался параметр "output" > "url" в котором при работе с лицами необходимо было указать адрес к ресурсу "/events" в формате http://<luna_address>:<port>/6/handlers/<handler_id>/events, где <handler_id> - идентификатор обработчика. При работе с телами использовались отдельные параметры "luna_human_handler_id" и "luna_dynamic_human_handler_id", а поле "url" заполнялось в формате http://<luna_address>:<port>/6/. Теперь идентификатор обработчика задаётся в группе "event_handler" > "bestshot_handler"/"detection_handler" > "handler_id", где "bestshot_handler" - статический обработчик для лица или тела, "detection_handler" динамический "handler_id" LUNA PLATFORM для работы с телами (бывш. "luna_dynamic_human_handler_id"). Адрес сервиса LUNA API и версия API теперь задаются отдельно. Ниже приведен пример передачи данных для генерации события, когда заданы статический и динамический обработчики для тела.

    "event_handler": { "origin": "http://127.0.0.1:5000", "api_version": 6, "bestshot_handler": { "handler_id": "ee4c42b6-23ae-410e-a2aa-a4220e64ba4b" }, "detection_handler": { "handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6" } }

    Если необходимо обработать лицо, то должен быть задан "handler_id" с параметрами для обработки лица в группе "bestshot_handler", а группа "detection_handler" не обязательна к заполнению.

    См. подробную информацию настройках управления потоками в руководстве администратора FaceStream.

  • Прекращена поддержка обычного режима запуска FaceStream. Теперь запустить FaceStream можно только в серверном режиме.

  • Информация по запуску FaceStream в серверном режиме с конфигурационными файлами перенесена в руководство администратора (см. раздел "Использование FaceStream с конфигурационными файлами").

  • Изменены параметры логирования по умолчанию в настройках FaceStream, секции "Logging":

  • Параметр "severity" теперь равен "1". Это означает, что в логи будут выводиться только предупреждения системы.

  • Параметр "mode" теперь равен "l2c". Это означает, что логи будут выводиться только в консоль.