Перечень приоритетных настроек#
Для отправки фотоизображений в LUNA PLATFORM в первую очередь необходимо настроить FaceStream на работу с лицами или телами (см. настройки для переключения режима обнаружения ниже), а также настроить основные параметры, необходимые для корректной работы приложения.
Примечание. Состав необходимых настроек зависит от выбранного режима работы FaceStream: через LUNA Streams или в роли агента LUNA PLATFORM (через сервис LUNA Video Manager). Подробнее см. в разделе Сервисы для управления потоками.
Все настройки разделены следующим образом:
-
Настройки FaceStream — задаются в секции
FACE_STREAM_CONFIGв LUNA Configurator или в конфигурационном файлеfs3Config.conf. -
Настройки управления потоками — задаются в запросе с телом в формате JSON к сервису управления потоками (LUNA Streams или LUNA Video Manager).
-
Настройки TrackEngine — задаются в секции
TRACK_ENGINE_CONFIGв LUNA Configurator или в конфигурационном файлеtrackengine.conf.
См. подробное описание нижеперечисленных параметров в соответствующих разделах.
Общие параметры для работы с лицами и телами#
Следующие параметры используются независимо от выбранного режима работы и типа детектируемых объектов.
Настройки FaceStream#
| Параметр | Описание |
|---|---|
| sending > async_requests | Включает асинхронную отправку запросов в LUNA PLATFORM |
| sending > send_source_frame | Включает отправку исходного кадра в LUNA PLATFORM |
| sending > jpeg_quality_level | Задаёт степень сжатия исходного кадра |
| lunaplatform > origin | Полный сетевой путь до LUNA PLATFORM |
| lunaplatform > api_version | Версия API LUNA PLATFORM (по умолчанию 6) |
Настройки для работы через LUNA Streams#
При работе через LUNA Streams дополнительно требуются следующие настройки.
Настройки FaceStream
| Параметр | Описание |
|---|---|
| lunastreams > origin | Полный сетевой путь до сервиса LUNA Streams |
| lunastreams > api_version | Версия API LUNA Streams (по умолчанию 1) |
Настройки управления потоками
| Параметр | Описание |
|---|---|
| data > type | Тип источника сигнала (tcp, udp, videofile, images) |
account_id |
Идентификатор аккаунта в LUNA PLATFORM (формат UUID) |
data > analytics > event_handler > handler_id |
Идентификатор обработчика в LUNA PLATFORM для генерации событий |
data > analytics > event_handler > frame_store |
URL для сохранения исходных кадров (адрес бакета LUNA Image Store или эндпоинт /images сервиса LUNA PLATFORM) |
Настройки для работы в роли агента LUNA PLATFORM (через LUNA Video Manager)#
При работе в роли агента LUNA PLATFORM используются следующие настройки.
Настройки FaceStream
| Параметр | Описание |
|---|---|
| lunavideomanager > agent_name | Имя агента (по умолчанию facestream) |
| lunavideomanager > agent_api_version | Версия API агента (по умолчанию 1) |
| lunavideomanager > max_stream_count | Максимальное количество одновременно обрабатываемых потоков |
| lunavideomanager > create_groups | Создавать группы при их отсутствии (true/false) |
| lunavideomanager > internal_agent | Тип агента: true — внутренний, false — внешний |
| lunavideomanager > token | Токен для авторизации (только для внешнего агента) |
| lunavideomanager > luna_account_id | UUID аккаунта в LUNA PLATFORM. Используется для создания и управления аналитиками, группами и потоками |
Настройки управления потоками
| Параметр | Описание |
|---|---|
| data > type | Тип источника сигнала (stream или videofile). Тип images не поддерживается. |
account_id |
Идентификатор аккаунта в LUNA PLATFORM (формат UUID). Используется для авторизации внутреннего агента. |
analytics.parameters.parameters |
Параметры аналитики FaceStream (см. раздел Настройки аналитики) |
Авторизация#
Способ авторизации зависит от типа агента:
-
Внутренний агент (
internal_agent: true) — идентификатор аккаунта передаётся в заголовкеLuna-Account-Idво всех запросах к сервисам LUNA PLATFORM (согласно спецификации API). -
Внешний агент (
internal_agent: false) — требуется явная авторизация с помощьюtoken, переданного в секцииlunavideomanagerконфигурации FaceStream.
Отправка исходных изображений#
Способ сохранения исходных изображений также зависит от типа агента:
-
Внутренний агент — изображения сохраняются по адресу, указанному в настройке
LUNA_IMAGE_STORE_IMAGES_ADDRESSв LUNA Configurator. -
Внешний агент — изображения отправляются на эндпоинт
/imagesсервиса LUNA PLATFORM.
Настройки для работы с лицами#
Для отправки фотоизображений лиц в LUNA PLATFORM необходимо указать следующие параметры.
Настройки TrackEngine
| Параметр | Значение | Описание |
|---|---|---|
| use-face-detector | 1 |
Включить детекцию лиц |
| use-body-detector | 0 |
Отключить детекцию тел |
Настройки FaceStream
| Параметр | Значение | Описание |
|---|---|---|
| sending > request_type | jpeg |
Тип запроса для отправки изображений |
| sending > portrait_type | warp |
Формат передачи изображения |
| sending > aggregate_attr_requests | true/false |
Агрегация лучших кадров для получения одного биометрического шаблона |
Настройки для работы с телами#
Для отправки фотоизображений тел в LUNA PLATFORM необходимо указать следующие параметры.
Настройки TrackEngine
| Параметр | Значение | Описание |
|---|---|---|
| use-face-detector | 0 |
Отключить детекцию лиц |
| use-body-detector | 1 |
Включить детекцию тел |
Настройки FaceStream
| Параметр | Значение | Описание |
|---|---|---|
| sending > aggregate_attr_requests | true/false |
Агрегация лучших кадров для получения одного биометрического шаблона |
| sending > minimal_body_track_length_to_send | 3 |
Минимальное количество детекций в треке для отправки |
| sending > detection_path_length | 100 |
Максимальное количество детекций для параметра "minimal_body_track_length_to_send" |
Подробную информацию об обработчиках можно найти в документации
APIReferenceManual.htmlв комплекте поставки LUNA PLATFORM 5.