v.5.147.0#

Изменения

SDK обновлён до версии 5.35.0.

В данной версии были обновлены:
- эстиматор Photorealistic Face до версии 1;
- эстиматор Face Image Modification до версии 2.
В группу проверок face_quality ресурсов "/handlers" и "/verifiers" добавлены новые проверки:
- neck_occlusion — определяет, перекрыта ли шея одеждой или аксессуарами. Подробнее см. описание эстиматора Перекрытие шеи.
- photorealistic_face — определяет, является ли лицо на изображении настоящим (фотографичным) или нарисованным. Подробнее см. описание эстиматора Нарисованное лицо.
- duty_uniform — определяет наличие форменной одежды (погон) в верхней части тела. Подробнее см. описание эстиматора Форменная одежда.
- clothes_color_lightness — определяет, является ли одежда в верхней части тела (зона плеч) светлой или темной. Подробнее см. описание эстиматора Светлый цвет одежды.
В команду запуска контейнера Remote SDK добавлены новые аргументы, которые позволяют включать/отключать использование новых эстиматоров: --enable-duty-uniform-estimator, --enable-neck-occlusion-estimator, --enable-photorealistic-face-estimator, --enable-light-colored-clothes-estimator.

Подробнее см. в разделе "Включение/отключение некоторых эстиматоров и детекторов".
В сервис Remote SDK добавлена поддержка нового типа плагинов, которые позволяют заменять встроенные эстиматоры на пользовательские реализации (собственные нейронные сети или альтернативные алгоритмы), а также оптимизировать существующие эстиматоры без изменения исходного кода сервиса.

Подробнее см. в разделах руководства разработчика сервиса Remote SDK:
- "Plugins" — общая информация о системе плагинов сервиса;
- "Creating Estimator Replacement Plugins" — руководство по созданию плагинов замены эстиматоров;
- "Estimator Replacement Plugin Example" — пример реализации плагина для эстиматора подсчета количества людей с использованием ONNX Runtime.
Для сервиса Remote SDK добавлена возможность переключения версий алгоритмов Liveness и Deepfake через настройки в Configurator.

Ранее для смены версии алгоритмов требовалось вручную редактировать конфигурационный файл внутри контейнера. Теперь управление версиями вынесено в настройки Configurator: в группы параметров LUNA_REMOTE_SDK_LIVENESS_ESTIMATOR_SETTINGS и LUNA_REMOTE_SDK_DEEPFAKE_ESTIMATOR_SETTINGS добавлен параметр version. Параметр принимает целочисленные значения: 0 — используется версия алгоритма по умолчанию.

Это упрощает настройку и тестирование различных версий алгоритмов. Подробнее см. в разделе Управление версиями нейросетей Liveness и Deepfake.
Теперь в LUNA PLATFORM поддерживается работа с изображениями в форматах WebP, AVIF, HEIC и GIF.

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

Подробнее см. в ресурсах /images, /events, /sdk, /iso и /verifiers.
В сервисах Admin, Events, Faces и Handlers удалена поддержка устаревших кодировок: ISO-8859-x и KOI8-R/U.
В запросы get list of folder images и get list of folder objects добавлен новый query-параметр depth.

Параметр позволяет управлять уровнем вложенности при получении списка объектов из папки:
- depth=0 (значение по умолчанию): возвращаются все объекты внутри папки, включая содержимое подпапок (рекурсивно). Соответствует поведению в предыдущих версиях LUNA PLATFORM.
- depth=1: возвращаются только объекты и подпапки первого уровня вложенности. Названия подпапок возвращаются с завершающим символом /, а файлов — без. Это позволяет получать содержимое папки без рекурсивной загрузки всех объектов, что может снижать время отклика при работе с глубокими иерархиями.
Обновлен раздел документации с описанием сервиса Image Store.

Раздел расширен и структурирован в соответствии с актуальными возможностями сервиса. Добавлены описания типов хранилищ, особенностей хранения объектов, работы с папками (ограничения, права доступа, примеры для локального и S3-хранилищ) и уточнённые правила настройки TTL с приоритетами (объект → папка → бакет).

См. "Сервис Image Store".
Обновлён раздел документации "Формат потоков, поддерживаемый сервисом Video Agent" — добавлена информация об особенностях декодирования на CPU и GPU.
В запросы create stream и put stream добавлен query-параметр check_agent.

Параметр управляет проверкой доступности агентов для обработки указанных в запросе аналитик:
- check_agent=1 (по умолчанию): если агенты недоступны, поток не будет создан, а запрос завершится ошибкой;
- check_agent=0: поток создается даже при отсутствии доступных агентов и переходит в статус pending до их появления. Это позволяет создавать потоки, не дожидаясь восстановления агентов после перезапуска или кратковременных сбоев.
Примечание. Если поток создан, но у всех доступных агентов нет свободных слотов, он также будет находиться в статусе pending до освобождения ресурсов (независимо от значения check_agent).
Для Agent-lambda расширен набор собираемых метрик.

В метрику типа "счётчик" agent_counter_total добавлено новое значение eof_stream для лейбла agent_action. Это позволяет отслеживать случаи, когда потоки завершаются по достижении конца файла (end of file), дополняя существующие метрики жизненного цикла потоков и обработки кадров.

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

Исправлена ошибка, из-за которой пользовательский образ (base_image), указанный при создании, обновлении или импорте лямбд типа agent, заменялся на образ по умолчанию (lpa-lambda-base).