Пользовательский интерфейс сервиса LUNA Streams#
Для сервиса LUNA Streams доступен пользовательский интерфейс.
Интерфейс можно открыть в браузере, указав адрес и порт сервиса LUNA Streams:
<streams_server_address>:<streams_server_port>
Порт сервиса LUNA Streams по умолчанию — 5160.
Рекомендуется ознакомиться с разделом "Взаимодействие FaceStream с LUNA Streams" перед ознакомлением с данной главой.
Пользовательский интерфейс сервиса содержит три вкладки — «Streams», «Groups» и «Queue».
- «Streams» — вкладка, в которой отображаются статусы потоков и их предварительный просмотр, есть возможность настраивать параметры видеопотока для каждого из источников.
- «Groups» — вкладка, в которой отображаются группы потоков.
- «Queue» — вкладка в которой отображаются потоки, находящиеся в очереди на обработку.
Общий вид доступных вкладок представлен на рисунке ниже:
Вкладка «Streams»#
Вкладка «Streams» предназначена для отображения всех потоков, их предварительного просмотра, идентификатора, названия, статуса, описания, группы и настройки параметров видеопотока для каждого источника.
Общий вид вкладки «Streams» представлен на рисунке ниже:
Вкладка «Streams» содержит следующие элементы:
- кнопка «Add» — кнопка для добавления потока (1);
- перечень потоков:
- «Last frame» — последний кадр видеопотока (предварительный просмотр);
- «Stream ID» — идентификатор видеопотока;
- «Name» — название видеопотока;
- «Status» — текущий статус видеопотока;
- «Description» — дополнительная информация о видеопотоке;
- «Group» — название группы, к которой привязан видеопоток. Привязать видеопоток к группе или отвязать от нее можно в разделе «Groups»;
- кнопка для просмотра видеопотока (2);
- кнопка для редактирования параметров видеопотока (3);
- кнопка для удаления видеопотока (4);
- количество отображаемых на странице потоков задается переключателем в нижнем правом углу страницы. Всего может быть 10, 25, 50 или 100 видеопотоков на одной странице (5);
- кнопки для управления обработкой потока:
- кнопка «Play» для запуска обработки потока (6) (отправляет запрос на обработку потока, поток распределяется на определенный экземпляр FaceStream и тот начинает его обрабатывать);
- кнопка «Pause» для паузы в обработке потока, например, для экономии ресурсов (7) (приостанавливает процесс обработки потока, но поток остается закрепленным за тем же экземпляром FaceStream);
- кнопка «Stop» для остановки обработки потока (8) (останавливает процесс обработки потока, поток больше не закреплен за тем же экземпляром FaceStream).
Создание потока#
Для добавления потока нажмите на кнопку «Add», после чего откроется форма «Create stream» для указания параметров.
Необходимо указать значения параметров потока и нажать кнопку «Create» в правом верхнем углу экрана.
В таблицах ниже приведено соответствие между описанием в пользовательском интерфейсе и названием соответствующих параметров.
Группа «General stream parameters»#
В данной группе отражены общие параметры создания потока.
Группа «General stream parameters»
| Описание параметра | Название в настройках |
|---|---|
| Account ID | Параметр «account_id» |
| Stream name | Параметр «name» |
| Description | Параметр «description» |
| Group | Параметр «group» |
| Status | Статус потока |
Группа «Stream data»#
В данной группе отражены основные параметры для работы с видеопотоком/видеофайлом/изображениями.
Группа «Stream data»
| Описание параметра | Название в настройках |
|---|---|
| Type | Параметр «type» |
| Full path to the source | Параметр «reference» |
| ROI coordinates | Параметр «roi» |
| DROI coordinates | Параметр «droi» |
| Rotation angle of the image from the source | Параметр «rotation» |
| Frame width | Параметр «preferred_program_stream_frame_width» |
| Endless | Параметр «endless» |
| Mask | Параметр «mask» |
Группа «Stream handler parameters»#
Данная группа параметров определяет параметры обработчика, создаваемого в LUNA PLATFORM, с помощью которого будут обрабатываться потоки. Для лиц и тел следует использовать различные обработчики. Обработчик должен быть создан в LP 5 заранее.
Группа «Stream handler parameters»
| Описание параметра | Название в настройках |
|---|---|
| Handler URL | Параметр «origin» |
| API version | Параметр «api_version» |
| ID of the handler for the best frames | Параметр «handler_id» группы «bestshot_handler» |
| Authorization (Token) | Токен из группы параметров «authorization» |
Группа «Geoposition»#
Данная группа параметров включает информацию о расположении источника видеопотока.
Группа «Geoposition»
| Параметры | Название в настройках |
|---|---|
| City, Area, District, Street, House number, Longitude (in degrees), Latitude (in degrees) | Группа параметров «location» |
Группа «Autorestart»#
Данная группа параметров позволяет настроить автоматический перезапуск потока.
Группа «Geoposition»
| Описание параметра | Название в настройках |
|---|---|
| Autorestart | Параметр «restart» |
| Attempt count | Параметр «attempt_count» |
| Autorestart delay (in seconds) | Параметр «delay» |
Группа «Sending parameters»#
В данной группе параметров определяется период, в течение которого будет проводиться анализ кадров для выбора лучшего кадра, а также определяются все параметры, связанные с составлением коллекции лучших кадров.
Группа «Sending parameters»
| Описание параметра | Название в настройках |
|---|---|
| Frame analysis period after which the best shot will be sent | Параметр «time_period_of_searching» |
| Wait duration between track analysis periods | Параметр «silent_period» |
| Track analysis and waiting period duration measure | Параметр «type» |
| Number of frames that the user sets to receive from the track or certain periods of this track | Параметр «number_of_bestshots_to_send» |
| Send only full set | Параметр «send_only_full_set» |
| Delete best shot and detection data | Параметр «delete_track_after_sending» |
Группа «Use Primary Track»#
Данная группа параметров предназначена для работы с системами контроля управления доступом (СКУД, турникеты на входах) для упрощения контроля и внедрения технологии распознавания лиц при входе на охраняемую территорию. Данная группа параметров используется только для работы с лицами.
Группа «Use Primary Track»
| Описание параметра | Название в настройках |
|---|---|
| Use Primary Track | Параметр «use_primary_track_policy» |
| Minimum detection size for Primary Track mode | Параметр «best_shot_min_size» |
| Size of detection for the main track | Параметр «best_shot_proper_size» |
Группа «Healthcheck parameters»#
В данной группе можно задать параметры повторного подключения к потоку при возникновении ошибок проигрывания потока.
Группа «Healthcheck parameters»
| Описание параметра | Название в настройках |
|---|---|
| Maximum number of stream errors to reconnect to the stream | Параметр «max_error_count» |
| Error count period duration (in seconds) | Параметр «period» |
| Time between reconnection attempts (in seconds) | Параметр «retry_delay» |
Группа «Liveness parameters»#
Данная группа параметров используется проверки на Liveness, т.е. для проверки наличия живого человека в кадре и предотвращает использование распечатанного фото или фото с телефона для прохождения проверки.
Группа «Liveness parameters»
| Описание параметра | Название в настройках |
|---|---|
| Check RGB ACS Liveness | Параметр «use_mask_liveness_filtration» |
| Check FlyingFaces Liveness | Параметр «use_flying_faces_liveness_filtration» |
| Which track frames will be checked for Liveness | Параметр «liveness_mode» |
| Number of frames in the track for Liveness check when liveness-mode is enabled | Параметр «number_of_liveness_checks» |
| Threshold value at which the system will consider that there is a real person in the frame | Параметр «liveness_threshold» |
| Livenesses weights (RGB ACS, FlyingFaces) | Параметр «livenesses_weights» |
| Number of background frames that are used for the corresponding checks | Параметр «mask_backgrounds_count» |
Группа «Filtering parameters»#
Данная группа параметров описывает объекты фильтрации изображений и отправки результирующих лучших кадров.
Группа «Liveness parameters»
| Описание параметра | Название в настройках |
|---|---|
| Threshold value to filter detections | Параметр «min_score» |
| Head rotation angle threshold (to the left or right, yaw) | Параметр «detection_yaw_threshold» |
| Head tilt angle threshold (up or down, pitch) | Параметр «detection_pitch_threshold» |
| Head tilt angle threshold (to the left or right, roll) | Параметр «detection_roll_threshold» |
| Number of frames used to filter photo images by the angle of tilt of the head | Параметр «yaw_number» |
| Number of frames the system must collect to analyze head yaw angle | Параметр «yaw_collection_mode» |
| Mouth overlap threshold (minimum mouth visibility) | Параметр «mouth_occlusion_threshold» |
| Minimum body detection size | Параметр «min_body_size_threshold» |
Группа «Additional parameters»#
Данная группа параметров предназначена для детальной настройки обработки видеопотока.
Группа «Liveness parameters»
| Описание параметра | Название в настройках |
|---|---|
| Frame processing | Параметр «frame_processing_mode» |
| Number of threads for video decoding | Параметр «ffmpeg_threads_number» |
| Maximum FPS for video processing | Параметр «real_time_mode_fps» |
После сохранения настроек для вновь созданного потока появится сообщение Source <stream_id> was successfully created.
Редактирование потока#
Для редактирования параметров потока необходимо нажать кнопку "Edit".
Форма редактирования потока аналогична форме создания потока.
Измените необходимые параметры и нажмите кнопку «Save» в правом верхнем углу формы.
После сохранения настроек параметров потока появится сообщение Source <stream_id> was successfully updated.
Удаление потока#
Для удаления потока необходимо нажать кнопку "Delete" или в форме редактирования потока нажать кнопку "Delete" во вкладке «Streams».
Во всплывающем окне необходимо подтвердить действие — нажать кнопку «Delete» или отменить действие через кнопку «Cancel».
После нажатия кнопки «Delete» появится сообщение об удалении потока.
Вкладка «Groups»#
Потоки можно группировать. Группировка предназначена для объединения потоков с несколькими камерами в логические группы (например, по территориальному признаку).
См. подробную информацию в разделе "Группировка потоков".
При создании потока, его можно добавить только в одну группу.
Вкладка «Groups» содержит таблицу, которая отображает название групп, идентификаторы групп, описания, даты создания, ID аккаунта в LUNA PLATFORM и настройки параметров групп.
Вкладка «Groups» представлена на рисунке ниже:
Вкладка «Groups» содержит следующие элементы и параметры группы:
- кнопка «Add» — кнопка для создания группы (1);
- перечень групп и их параметров:
- «Name» — название группы;
- «Group ID» — идентификатор группы, присваиваемый LUNA Streams;
- «Description» — дополнительная пользовательская информация о группе;
- «Date created» — дата и время создания группы;
- «Account ID» — идентификатор аккаунта в LUNA PLATFORM 5;
- кнопка редактирования группы (2);
- кнопка удаления группы (3);
- количество отображаемых на странице групп задается переключателем в нижнем правом углу страницы. Всего может быть 10, 25, 50 или 100 групп на одной странице (4).
Процесс создания, редактирования и удаления группы аналогичен вышеописанным процессам для потока.
Привязка потока к группе#
Чтобы привязать поток к группе, в разделе «Streams» в строке потока нажмите кнопку для редактирования параметров. В форме редактирования в основных параметрах потока укажите для параметра «Group» значение из доступных в выпадающем списке. Поток будет привязан к выбранной группе. Нажмите кнопку «Save» в правом верхнем углу формы.
Вкладка «Queue»#
По умолчанию новый поток создается со статусом «pending» и сразу же попадает в очередь обработки. Обработку потока можно отложить, указав статус «pause» при создании. Как только появляется свободный «рабочий процесс FaceStream» потока с запросом на пул из очереди, поток принимается к обработке и ему присваивается статус «in_progress».
См. подробную информацию в разделе "Процесс обработки потоков в LUNA Streams".
Вкладка «Queue» носит информационный характер и предназначена для отображения всех потоков, находящихся в очереди на обработку, их идентификаторов и статусов.
Вкладка «Queue» содержит следующие элементы и параметры потока:
- перечень потоков:
- «Stream ID» — идентификатор видеопотока в LUNA Streams, генерируется при создании потока;
- «Stream name» — название видеопотока;
- «Status» — текущий статус видеопотока;
- количество отображаемых на странице потоков задается переключателем в нижнем правом углу страницы. Всего может быть 10, 25, 50 или 100 потоков на одной странице.