Интеграция с Gate🔗

В Macroscop реализована интеграция со СКУД Gate. Это позволит транслировать на АРМ оператора СКУД Gate онлайн и архивный видеопоток с видеокамер системы видеонаблюдения Macroscop для видеоверификации событий доступа. А также отправлять из Macroscop код распознанного автономера или лица в заданные точки доступа СКУД Gate в качестве идентификатора.

Примечание

Интеграция доступна в версии Macroscop 3.2 и выше.

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

Для отображения видео с камер, подключенных к серверу 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. Видео из архива всегда воспроизводится в одном и том же окне.

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

../../_images/video-scheme.png

Примечание

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

Настройка GateVideoBridge🔗

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

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

../../_images/bridge-menu.png

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

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

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

../../_images/bridge-connection.png

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

../../_images/bridge-ok.png

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

  • активен: если сервер функционирует нормально;

  • неверная конфигурация: если есть ошибки в конфигурации сервера;

  • неверный ключ или файл лицензии: если есть ошибки в лицензии сервера;

  • повреждены файлы архива: если есть ошибки архива.

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

../../_images/bridge-error.png

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

../../_images/bridge-integration.png

Терминал Gate🔗

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

../../_images/gate-terminal.png

При нажатии кнопки Просмотр терминал 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:

../../_images/sheduler-run.png

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

../../_images/sheduler-remove.png

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

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

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
../../_images/multiple-views.png