Объект CAM соответствует системному объекту Камера.

От объекта CAM поступают события, представленные в таблице. Запуск процедур происходит при возникновении соответствующего события. 

Описание событий от объекта CAM:

События

Описание событий

Комментарий

ARM

Камера поставлена на охрану

Если постановка на охрану выполнена Оператором с Карты или из Монитора видеонаблюдения, в параметре user_id<> содержится идентификатор пользователя, выполнившего это действие

ATTACH

Подключение


BLINDING

Камера залеплена


DETACH

Обрыв

Событие генерируется при потере входного сигнала с камеры на плате видеоввода

DISARM

Камера снята с охраны

Если снятие с охраны выполнено Оператором с Карты или из Монитора видеонаблюдения, в параметре user_id<> содержится идентификатор пользователя, выполнившего это действие

FILE_REC_ERROR

Ошибка записи на диск

Событие генерируется, когда происходит ошибка записи видеоархива на диск

MD_START

Тревога


MD_STOP

Конец тревоги


PRINT

Печать кадра


REC

Запись на диск

Если запись инициирована Оператором с Карты или из Монитора видеонаблюдения, в параметре user_id<> содержится идентификатор пользователя, выполнившего это действие

REC_STOP

Остановка записи на диск

Если запись остановил Оператор с Карты или из Монитора видеонаблюдения, в параметре user_id<> содержится идентификатор пользователя, выполнившего это действие

UNBLINDING

Камера открыта


RECORDER_ON

Запись включена


RECORDER_OFF

Запись выключена


DISC_MOUNT

Диск подмонтирован


DISC_UNMOUNT

Диск отмонтирован


FINISHED_AVI_EXPORT

Экспорт видео завершен

В случае, если попытка экспорта видео завершилась неудачей, событие имеет ненулевой параметр error_result.

В параметре param<0> содержится дополнительная информация, отображаемая в соответствующем столбце в Протоколе событий в формате "ИмяКомпьютера;ПериодЭкспорта;ИмяПользователя;ИдентификаторПользователя" − например, param0<LOCALHOST;04-06-18 16:50:55_04-06-18 16:55:55;;1>

MD_LIMITПревышено количество объектов в кадре

Событие генерируется при превышении количества обнаруженных трекером объектов в кадре (см. Создание и настройка объекта Трекер). Событие генерируется при каждом изменении количества объектов (в большую или меньшую сторону), пока оно не будет меньше пороговой.

В параметре object_count<> передается число объектов в кадре, которое обнаружено трекером, превышает заданный лимит и отличается от предыдущего значения.

См. также описание события NEW_OBJECT ниже

NEW_OBJECTТрекер обнаружил новый объект в кадре

Помимо прочих, содержит следующие параметры:

  • total<> – общее количество объектов в кадре на момент возникновения события
  • new_id<> – идентификатор обнаруженного объекта
ARCH_DELETEУдаление записиУдаление записи архива по камере из Монитора видеонаблюдения
OPEN_FILEОткрытие файла

Открытие файла для воспроизведения виртуальным устройством видеоввода. Свидетельствует о начале воспроизведения следующего файла в выбранной папке.

Помимо прочих, содержит следующие параметры:

  • name<> – название проигрываемого файла
  • tss<> – время в формате UTC в миллисекундах с 01.01.1970
CLOSE_FILEЗакрытие файла

Завершение воспроизведения файла виртуальным устройством видеоввода. Свидетельствует об окончании воспроизведения файла в выбранной папке.

Помимо прочих, содержит следующие параметры:

  • name<> – название файла, проигрывание которого завершилось
  • tss<> – время в формате UTC в миллисекундах с 01.01.1970
ARCH_PROTECTEDФайл защищен от перезаписи

Событие отображается, когда пользователь защищает файл от перезаписи.

В параметре param<0> содержится дополнительная информация об имени компьютера, фрагменте, имени и id пользователя, отображаемая в столбце Доп. инфо в Протоколе событий в формате

"ИмяКомпьютера;ЗащищенныйПериод;ИмяПользователя;ИдентификаторПользователя" − например, param0<LOCALHOST;04-06-18 16:50:55.612_04-06-18 16:55:55.612;User 1;1>

ARCH_UNPROTECTEDСнята защита файла от перезаписи

Событие отображается, когда пользователь снимает защиту файла от перезаписи.

В параметре param<0> содержится дополнительная информация об имени компьютера, фрагменте, имени и id пользователя, отображаемая в столбце Доп. инфо в Протоколе событий в формате

"ИмяКомпьютера;ЗащищенныйПериод;ИмяПользователя;ИдентификаторПользователя" − например, param0<LOCALHOST;04-06-18 16:50:55.612_04-06-18 16:55:55.612;User 1;1>

FRAME_SKIPPEDПропуски кадров

Событие FRAME_SKIPPED поступает в ПК Интеллект, если есть пропуски кадров при записи в архив. По умолчанию событие генерируется, если за период проверки было более 50 пропусков кадров. Когда пропуски кадров прекращаются, генерируется событие FRAME_SKIPPED_STOP. В описании этого события содержится информация о количестве пропущенных кадров и промежутке времени, в который были пропуски. Оба события по умолчанию генерируются не чаще чем раз в 30 секунд.

События регулируются следующими ключами реестра (см. Справочник ключей реестра):

  • событие FRAME_SKIPPED можно отключить с помощью ключа реестра FileSystem.NotifyCoreFrameSkipped;
  • время задержки между сменой состояний в секундах задаётся в ключе FileSystem.RecordingStateChangeDelay. Минимальное значение − 30 секунд. Если указать меньшее значение, то всё равно будет использоваться минимальное − 30 (ключ в реестре перезапишется);
  • количество пропущенных кадров за период, при котором будет генерироваться FRAME_SKIPPED, задаётся в ключе FileSystem.MaxSkippedFramesByPeriod.
FRAME_SKIPPED_STOPКонец пропуска кадров
ARCH_BOOKMARKEDСоздана закладка

Событие отображается, когда пользователь добавляет закладку.

В параметре param<0> (столбце Доп. инфо в Протоколе событий) содержится комментарий к закладке

ARCH_UNBOOKMARKEDУдалена закладка

Событие отображается, когда пользователь удаляет закладку

TEMPERATURE_ALARMПорог температурыВ параметре param0<> содержится значение температуры, полученное от тепловизора
IGNORE_KEEP_NO_LESSИгнорирование "Хранить не менее"Событие генерируется при удалении из архива видеозаписей, которые должны были бы храниться в течение более длительного периода времени, задаваемого параметром Хранить не менее. См. также Настройка глубины архива по видеокамере
AVAILABILITYНаличие ключевой позиции в файле лицензии и количество объектов

Событие приходит в ответ на команду GET_AVAILABILITY и содержит информацию о количестве добавленных в ключ лицензии объектов для заданной позиции. Параметры:

  • qty_localpriority<> − количество разрешенных объектов заданного типа на этом компьютере (локальная часть ключа)
  • qty<> − общее количество разрешенных объектов заданного типа в лицензии (общая часть ключа)
  • pos<> − номер позиции в ключе лицензии

Если позиция в ключе отсутствует, то событие будет со значением ноль

WRITING_FAILEDОшибка записи
FILESYSTEM_FAILEDОшибка файловой системы

Содержит обязательный параметр error_msg<>текст ошибки; также может содержать параметры cam<> идентификатор камеры и error_code<> код ошибки. Пример:

CAM|-1|FILESYSTEM_FAILED|error_msg<Failed to delete index file: D:\\VIDEO\\INDEX\\14061608.idx, error code: 5.>,error_code<5>

Список команд и параметров для объекта CAM представлен в таблице.

Команда – описание команды

Параметры

Описание параметров

"SETUP" – устанавливает (изменяет) параметры камеры

rec_priority<>

Приоритет записи (от 0 до 3, 0 – обычный, 3 – все ресурсы)

compression<>

Степень компрессии (0 – компрессия отсутствует, 1- макс. качество, …, 5 – мин. качество)

sat_u<>

Насыщенность цвета (0 – мин, 10 – макс)

proc_time<>

Период дозаписи (0-30 сек)

manual<>

Управление настройкой яркости и контрастности (0 – ручное; 1 – автоматическое; 2 – автоматическое,  но около значений, выставленных вручную)

contrast<>

Контрастность (0 – мин, 10 – макс)

md_size<>

Размер объектов детектора движения (1-16)

md_mode<>

Режим записи пауз (1 – включено, 0 – выключено)

audio_type<>

Тип звукового сопровождения

pre_rec_time<>

Время предзаписи (0-20 сек)

bright<>

Яркость (0 – мин, 10 – макс)

audio_id<>

Номер микрофона (пустой параметр, если нет микрофона)

rec_time<>

Скорость записи (1-30 кадров/сек, 0 – не используется)

alarm_rec<>

Запись тревог (1 – включено, 0 – выключено)

hot_rec_time<>

Время горячей записи (0-30 сек)

hot_rec_period<>

Период горячей записи (0-20 сек)

mux<>

Номер канала (0 – 1 канал, 15 – 16 канал)

color<>

Цвет (0 – черно-белый, 1 – цветной)

activity<>

-

arch_days<>

Количество дней архива

blinding<>

Камера залеплена

config_id<>

-

decoder<>

-

flags<>

Флаги

fps<>

Скорость записи (0 – не используется, 1 – 30 кадров/сек)

ifreq<>

Частота опорных кадров в последовательности (1 – каждый кадр опорный, 2 – 100 кадр)

mask 0, mask1, mask2, mask3, mask4

Маска детектора

md_contrast<>

Чувствительность детектора движения (0-15)

motion<>

Оценка движения компрессора (5-255)

name<>

Имя объекта

password_crc<>

Пароль на видеоархив

priority<>

Приоритет источника постановки на запись (0 – автоматическое, 1 – ручное)

resolution<>

Разрешение (0 – стандартное CIF, 1 – высокое 2CIF, 2 – максимальное 4CIF)

type<>

Тип объекта

yuv<>

Цветовая схема кодирования видеосигнала (0 – YUV4:2:0, 1 – YUV4:2:2)

"DELETE" – отключает камеру

-

-

"START_VIDEO" – включает видеопоток для текущей камеры

slave_id<>

Имя компьютера, к которому подключена камера

comress<>

Степень компрессии

register_only<>

-

"STOP_VIDEO" – выключает видеопоток для текущей камеры

slave_id<>

Имя компьютера, к которому подключена камера

"REQUEST_MASK"

mask<>

Маска

"MUX1", "MUX2", "MUX3" – вывести изображение камеры на 1, 2, 3 аналоговые выходы

-

-

"ACTIVATE" – вывести камеру на монитор

monitor<>

Номер монитора

"ARM" – поставить камеру на охрану

-

-

"DISARM" – снять камеру с охраны

-

-

"REC" – начать запись камеры

time<>

Время записи в секундах, если равно нулю, то записывается 1 кадр

rollback<>

Если равно 1, то запись производится с откатом

priority<>Задает приоритет команды начала записи. Подробнее см. Приложение 1. Приоритеты команд начала и остановки записи
stream_id<>

Задает номер потока для записи. Номер потока имеет вид "n.m", где n – id камеры, m – номер потока.

Примечание. Если указанный поток не используется ни по какому другому назначению, кроме записи по команде (и по выбору на клиенте), необходимо убедиться, что для него не установлен флажок Блокировать отключение неиспользуемых потоков – см. Панель настройки объекта Камера

"REC_STOP" – остановить запись камеры

priority<>

Задает приоритет команды остановки записи. Подробнее см. Приложение 1. Приоритеты команд начала и остановки записи

user_id<>Если остановка записи была выполнена пользователем из Монитора видеонаблюдения, то в данном параметре передается идентификатор пользователя. В противном случае данный параметр отсутствует
from_macro<>Если остановка записи была выполнена по макрокоманде, то в данном параметре передается идентификатор макрокоманды. В противном случае данный параметр отсутствует

"SET_MASK" – установить маску

mask<>

Маска

"ADD_SUBTITLES" – добавить титры

command<>

Текст накладываемых титров

title_id<>

Идентификатор объекта Титрователь, используемого для наложения титров
page<>Обязательный параметр при записи титров в базу данных титров для обеспечения в дальнейшем возможности поиска по титрам. Возможные значения: BEGIN (начало записи в базе), END (конец записи в базе)

"SIP_CONNECT"  – Sip подключен

-

-

"SIP_DISCONNECT" – Sip отключен

-

-

"SET_IPINT_PARAM" – Установить (изменить) параметры IP-устройства. Реакция позволяет менять настройки IP-устройства не заходя в его web-интерфейс.

Примечание. Для работы реакции необходимо включить режим многопоточного видеосигнала – см. Настройка многопоточного видеосигнала, а также Приложение 2. Определение значений param_id и param_value для реакции SET_IPINT_PARAM

param_id<>Название параметра. Набор параметров для каждой камеры индивидуален – см. Приложение 2. Определение значений param_id и param_value для реакции SET_IPINT_PARAM
param_value<>Значение параметра. Набор параметров для каждой камеры индивидуален – см. Приложение 2. Определение значений param_id и param_value для реакции SET_IPINT_PARAM
vstream_id<>Номер видеопотока (необязательный параметр). Имеет вид "Номер камеры"."Номер потока", например 1.1, 1.2
"GET_FRAME" – получить кадр с камеры, даже если она не отображается на Мониторе видеонаблюденияpath<>Путь для сохранения кадра. Если параметр отсутствует, в системе будет сформировано событие FRAME_SENT с параметром data. Обработка данного события описана в разделе Метод SaveToFile
stream<>

Необязательный параметр. Задает поток в ПК Интеллект, с которого требуется получить кадр. Поток можно указать по номеру или по назначению. Возможные назначения:

  • stream_archive – поток для записи в архив
  • stream_alarm – поток для записи в архив по тревогам
  • stream_client – поток для отображения
  • stream_analytic – поток для видеоаналитики

Номер потока состоит из идентификатора камеры и номера потока, например, 4.3 – третий поток с камеры 4

time<>Необязательный параметр. Указывается, если требуется запросить кадр архива. Формат значения параметра: ДД-ММ-ГГГГ ЧЧ:ММ:СС − например, time<19-09-2017 11:35:34>
gate<>Необязательный параметр. Задает сетевое имя Видеошлюза, из архива которого следует получать кадр
arch<>Необязательный параметр. Задает сетевое имя Долговременного архива, из которого следует получать кадр
slave_id<>Необязательный параметр. Задает сетевое имя Сервера, из архива которого следует получать кадр
password_crc<>Необязательный параметр. Задает CRC-последовательность, которая будет записана в результирующий файл, содержащий запрошенный кадр

"ARCH_DEL_RECORD" – удалить записи архива за определенный период

fromTime<>

Обязательный параметр. Время в формате ГГГГ-ММ-ДДTЧЧ:ММ:СС.ННН, где ННН – миллисекунды. Будут удалены записи, начиная с первой, содержащей указанный момент времени, и заканчивая последней, содержащей момент времени toTime. Если не указано время в параметре toTime, будет удалена только одна запись

toTime<>

Необязательный параметр. Время в формате ГГГГ-ММ-ДДTЧЧ:ММ:СС.ННН, где ННН – миллисекунды. Описание см. выше
"REC_RESTART" – перезапустить запись по камере--

"ARCH_BOOKMARK_RECORD" – создать закладку

time1<>Дата начала периода архива, включенного в закладку, в формате ДД-ММ-ГГ ЧЧ:ММ:СС.ННН, где ННН – миллисекунды
time2<>Дата окончания периода архива, включенного в закладку, в формате ДД-ММ-ГГ ЧЧ:ММ:СС.ННН, где ННН – миллисекунды
comment<>Комментарий к закладке
slave_id<>

Идентификаторы компьютера и Монитора видеонаблюдения, с использованием которых будет выполняться создание закладки. Формат параметра: <имя компьютера>.<айди монитора>.

Например, slave_id<WS2.1> – здесь WS2 является идентификатором компьютера, а 1 – идентификатором Монитора видеонаблюдения

"CRUISE_START" – автопанорамированиеcruise_id<>Номер маршрута на камере
action<>

Выполняемое действие:

  • CRUISE_START – начать автопанорамирование по указанному маршруту
  • PATROL_PLAY – начать патрулирование по указанному маршруту
cam_id<>Идентификатор камеры
"GET_DEPTH" – получить глубину архива. В ответ на реакцию в системе формируется событие ARCHIVE_DEPTH от объекта SLAVE (см. SLAVE Компьютер). Отсутствие одного или обоих параметров означает запрос глубины по записям для всех возможных значений параметраdrive<>

Диск или сетевой путь, по которому запрашивается глубина архива.

Название диска задается формате "<буква диска>:\\", например drive<D:\\>

Примечание. Символ "\" – экранируемый.

Сетевой путь задается в формате UNC

arch

Указывает, что требуется запросить глубину долговременного архива.

Пример.

DoReactStr("CAM","2","GET_DEPTH","drive<D:\\>,cam<2>,arch");
gate

Указывает, что требуется запросить глубину архива видеошлюза.

Пример.

DoReactStr("CAM","1","GET_DEPTH","drive<V:\\>,gate");
"CLEAR_SUBTITLES" – удалить все титры с видеоизображения

title_id<>

Идентификатор объекта Титрователь

"GET_AVAILABILITY" – проверить наличие ключевой позиции

pos<>Номер позиции в ключе лицензии

Свойства объекта CAM показаны в таблице:

Свойства объекта CAM

Описание свойств объекта

ID<>

Идентификатор объекта

PARENT_ID<>

Идентификатор родительского объекта

TELEMETRY_ID<>

Идентификатор модуля телеметрии (ID поворотника)

REGION_ID<>

Идентификатор региона

Объект CAM может находиться в состояниях, описанных в таблице:

Состояние объекта CAM

Описание состояния

"ALARMED"

Камера находится в тревожном состоянии

"DISARM_DETACHED"

Нет сигнала от камеры

"DETACHED"

Нет сигнала от камеры

"ARMED"

Камера поставлена на охрану

"DISARMED"

Камера снята с охраны