View Source

Общие сведения

Виртуальный триггер (Virtual Trigger) – это сервис, позволяющий передавать в систему внешние события через Public API. Для его реализации был добавлен новый тип детектора – DetectorEx, который может использоваться как самостоятельный детектор, так и как поддетектор в системе.

Каждый объект DetectorEx поддерживает два метода:

RaiseOccasionalEvent — метод для обработки однофазных и двухфазных событий.
RaisePeriodicalEvent — метод для отправки треков.

Каждый объект DetectorEx работает как отдельный сервис и имеет название DetectorEx.N, где N – ID детектора в системе.

Взаимодействие с внешним сервисом (External Service)

Внешний сервис (External Service) может генерировать события самостоятельно, используя доступные данные, либо на основании видеопотока (например, через RTSP). Передача событий возможна:

напрямую через API в клиенте ПК Интеллект Х;
через HTTP-запрос.

Методы

Метод RaiseOccasionalEvent

Данный метод позволяет отправить однофазное или двухфазное событие. Методу RaiseOccasionalEvent нужно передавать запрос RaisePeriodicalEventRequest с параметрами, которые указаны в таблице:

Параметр	Описание
access_point	Точка доступа детектора DetectorEx
event_type	Тип события: Event1 (однофазное); Event2 (двухфазное)
timestamp	Время события с указанием секунд и наносекунд (см. подробнее)
data	Пользовательские данные (см. подробнее)
event_id	Уникальный идентификатор события, обязателен для двухфазных событий
event_state	Статус события: HAPPENED – для однофазного события; BEGAN – только для двухфазных событий; ENDED – только для двухфазных событий

Ответом на запрос является RaiseOccasionalEventResponse с полем error.

Возможные значения поля error:

OK;
BAD_EVENT_TYPE;
BAD_TIMESTAMP;
BAD_DATA.

Метод RaisePeriodicalEvent

Данный метод предназначен для отправки треков детектору DetectorEx. Метод RaisePeriodicalEvent принимает запрос RaiseOccasionalEventRequest с параметрами, которые указаны в таблице:

Параметр

Описание

access_point

Точка доступа детектора DetectorEx

event_type

Тип TargetList

timestamp

Временная метка для точки трека

data

Данные трека (тип PeriodicalEventData). Тип PeriodicalEventData принимает только параметр target_list типа TargetList. Тип TargetList в свою очередь принимает параметр tracklets, который является списком объектов Tracklet. Объект Tracklet описан имеет следующие параметры:

Параметр	Описание
object_id	ID объекта
object_unique_id	Уникальный ID трека
object_type	Тип объекта (число от 1 до 127)
rectangle	Координаты прямоугольника, который имеет следующие параметры для заполнения: x и у со значениями от 0.0 до 1.0; width – ширина от точки х; height – высота от точки y
logical_center	Центр в прямоугольнике (опционально)
color	Цвет объекта (HsvColor) в стандарте HSV (Hue, Saturation, Value — тон, насыщенность, значение (яркость)). Тип HsvColor принимает следующие параметры: hue – тон, значение должно быть в диапазоне от 0.0 до 360.0; saturation – насыщенность цвета, значение должно быть в диапазоне от 0.0 до 1.0; value – яркость цвета, значение должно быть в диапазоне от 0.0 до 1.0