Интеграция со СКУД Gate

Просмотр видео

Для отображения видео с камер, подключенных к серверу Macroscop, на рабочем месте СКУД Gate, используются две утилиты:

GateVideoBridge: отображает видео с камер в отдельных окнах на мониторе оператора. Видео в реальном времени отображается по событию в Gate; видео из архива отображается при выборе события в журнале событий Gate.
Gate.CLIObserver: является связующим звеном между Gate и Macroscop. Эту утилиту запускает сама СКУД Gate, оператор не будет с ней взаимодействовать.

Обе утилиты устанавливаются вместе с приложением Macroscop Клиент и располагаются в одной с ним папке.

После настройки Macroscop и Gate необходимо запустить и настроить GateVideoBridge. Утилита должна быть запущена в течение всего времени работы.

Когда в Gate возникает событие, сам Gate запускает утилиту Gate.CLIObserver и передает ей такие параметры, как расположение и размеры окна на экране, индекс камеры, видео от которой нужно отобразить в этом окне, адрес и порт сервера. Когда оператор выбирает событие в журнале событий, Gate запускает Gate.CLIObserver с теми же параметрами, дополняя их временем события.

Далее Gate.CLIObserver транслирует эти параметры в утилиту GateVideoBridge, которая отображает видео с указанной камеры в окне указанного размера в указанном месте. При этом, для отображения в реальном времени на экране можно отобразить столько камер, сколько доступно на сервере Macroscop. Видео из архива всегда воспроизводится в одном и том же окне.

Ниже приведена схема взаимодействия приложений и утилит:

Примечание

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

Настройка GateVideoBridge

Для настройки GateVideoBridge нужно запустить утилиту GateVideoBridge, размещённую в папке с установленным приложением Macroscop Клиент (по умолчанию это папка C:UsersИмя_пользователяAppDataLocalProgramsMacroscop Client).

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

Предупреждение

При первом запуске утилиты она добавляется в список задач планировщика заданий Windows. После этого она будет автоматически запускаться при входе любого пользователя в операционную систему. Если такой функциональности не требуется, можно удалить утилиту из автозапуска; описание данной процедуры приведено ниже.

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

Для проверки доступности сервера служит кнопка Проверить подключение. При этом откроется диалоговое окно с результатом подключения.

В случае доступности сервера будет указан его статус:

активен: если сервер функционирует нормально;
неверная конфигурация: если есть ошибки в конфигурации сервера;
неверный ключ или файл лицензии: если есть ошибки в лицензии сервера;
повреждены файлы архива: если есть ошибки архива.

Если сервер недоступен, то откроется окно с сообщением об ошибке.

На вкладке Интеграция отображается список всех доступных пользователю камер. Для каждой камеры отображается её индекс в СКУД Gate. На этой же вкладке отображается видео с выделенной в текущий момент камеры. Для поиска камеры в списке можно использовать поле фильтра, размещённое под списком.

Терминал Gate

Для настройки взаимодействия СКУД Gate с системой видеонаблюдения Macroscop следует пользоваться Инструкцией по работе с СВН "Macroscop" и руководством пользователя на ПО GATE Server-Terminal, размещенными в разделе Документация сайта Gate. При добавлении камеры в ПО Gate необходимо указать именно тот адрес сервера, который указывался в GateVideoBridge. Индекс камеры нужно посмотреть в настройках GateVideoBridge на вкладке Интеграция. При этом название камеры в ПО Gate и GateVideoBridge могут не совпадать.

При нажатии кнопки Просмотр терминал Gate может запросить путь к утилите Gate.CLIObserver.exe. Эта утилита размещается в папке с установленным приложением Macroscop Клиент (по умолчанию это папка C:UsersИмя_пользователяAppDataLocalProgramsMacroscop Client).

Дополнительные возможности GateVideoBridge

Для отображения видео в реальном времени с камеры можно вызвать контекстное меню на значке GateVideoBridge в области уведомлений панели задач и выбрать требуемую камеру. В этом случае окно отобразится в том же месте на экране, в котором отображалось ранее. При изменении положения и размеров окна они будут сохраняться до тех пор, пока их не изменит пользователь, либо пока окно не будет открыто на основании параметров, передаваемых утилитой Gate.CLIObserver.exe.

Проверка интеграции при отсутствии Gate

Иногда нужно проверить работу интеграции с Gate при отсутствии взаимодействия с самой СКУД. В таком случае следует запустить и настроить GateVideoBridge, после чего вручную запустить Gate.CLIObserver через командную строку с передачей дополнительных параметров.

Полный список параметров командной строки утилиты Gate.CLIObserver:

-a, --archive: просмотр архива (указывается вместе с -t). Опциональный параметр.
-t, - -time: временная метка в архиве в формате YYYY-MM-DD hh:mm:ss (указывается вместе с -a). Опциональный параметр.
-s, --server: адрес сервера (IP-адрес или доменное имя). Обязательный параметр
-p, --port: порт сервера (порт сервера для видео в реальном времени должен отличаться от порта, используемого для просмотра архива). Обязательный параметр
-c, --cam-index: индекс камеры. Обязательный параметр
-P, --window-pos: координаты верхнего левого и правого нижнего углов окна в формате X1 Y1 X2 Y2 (начало координат в левом верхнем углу экрана, X увеличивается вправо, Y увеличивается вниз). Опциональный параметр.

Примеры использования:

Отобразить видео в реальном времени в окне, левый верхний угол которого расположен в левом верхнем углу экрана, а правый нижний — по координатам X=400, Y=300 (ширина окна будет равна 400, а высота — 300 пикселей). Камера подключена к серверу 127.0.0.1 с портом 8080 и имеет индекс 2.
```
Gate.CLIObserver.exe -s 127.0.0.1 -p 8080 -c 2 -P 0 0 400 300
```
Отобразить видео в реальном времени в окне, левый верхний угол которого расположен на расстоянии 100 пикселей от левого края экрана и 200 пикселей — от верхнего края экрана, а правый нижний угол по координатам X=500, Y=500 (ширина окна будет равна 400, а высота — 300 пикселей). Камера подключена к серверу 127.0.0.1 с портом 8080 и имеет индекс 2.
```
Gate.CLIObserver.exe -s 127.0.0.1 -p 8080 -c 2 -P 100 200 500 500
```
Отобразить видео в реальном времени в окне, размеры и положение которого были в прошлый раз на момент его закрытия. Например, если отображали окно из предыдущего примера, а потом переместили, растянули окно и закрыли его, то новые расположение и размеры сохранятся и окно в данном примере будет иметь последние расположение и размеры. Камера подключена к серверу 127.0.0.1 с портом 8080 и имеет индекс 2.
```
Gate.CLIObserver.exe -s 127.0.0.1 -p 8080 -c 2
```
Отобразить видео из архива, начиная с даты 01.06.2020 и времени 10:40:30, в окне, левый верхний угол которого расположен на расстоянии 100 пикселей от левого края экрана и 200 пикселей от верхнего края экрана, а правый нижний угол по координатам X=500, Y=500 (ширина окна будет равна 400, а высота — 300 пикселей). Камера подключена к серверу 127.0.0.1 с портом 8080 и имеет индекс 2 (здесь нужно указать порт 8079).

Примечание

Отображение архива аналогично отображению видео реального времени, при этом требуются дополнительные параметры --archive и --time (или их укороченные варианты -a и -t). При этом значение порта нужно указывать на единицу меньше — это особенность интеграции Gate с системами видеонаблюдения.
```
Gate.CLIObserver.exe -s 127.0.0.1 -p 8079 -c 2 -P 100 200 500 500 -a -t 2020-06-01 10:40:30
```

Примечания:

Если X1 > X2 или Y1 < Y2, то окно отображается с теми положением и размерами, которые были в предыдущий раз (или по умолчанию, если окно отображается впервые).
Лог-файлы Gate.CLIObserver хранятся там же, где и остальные лог-файлы Macroscop.

Удаление задачи автозапуска GateVideoBridge

Для удаления утилиты GateVideoBridge из автозапуска необходимо запустить Планировщик заданий Windows:

Затем нужно открыть Библиотека планировщика заданий, выделить в открывшемся списке задачу GateVideoBridge, вызвать правой кнопкой мыши контекстное меню и выбрать пункт Удалить.

Отображение нескольких окон наблюдения для одной камеры

Для одновременного отображения нескольких окон наблюдения для одной камеры необходимо ввести последовательность команд:

start Gate.CLIObserver.exe -s 127.0.0.1 -p 8080 -c 0 -P 0 0 400 300

start Gate.CLIObserver.exe -s 127.0.0.1 -p 8080 -c 0 -P 400 300 1000 800