На странице:


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

Виртуальный триггер (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_idID объекта
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


  • No labels