Интеграция SmartPlayer с ivideon: различия между версиями
Нет описания правки |
Нет описания правки |
||
Строка 45: | Строка 45: | ||
В данной категории пользователь может изменить пароль к камере и указать нужный, если он его не знает. | В данной категории пользователь может изменить пароль к камере и указать нужный, если он его не знает. | ||
[[File:Изменить_пароль.png|thumb|center| Пример отображения строки для изменения пароля от устройства|800px]] | [[File:Изменить_пароль.png|thumb|center| Пример отображения строки для изменения пароля от устройства|800px]] | ||
Следующим шагом переходим в раздел информация о камере и | Следующим шагом переходим в раздел информация о камере. Для этого пользователю необходимо в окне зарегистрированной камеры нажать на три вертикальных точки и открыть список возможностей по взаимодействию с камерой. В этом списке пользователь выбирает строку "Информация о камере". | ||
[[File:Информация_о_камере.png|thumb|center| Пример отображения строки "Информации о камере" в личном кабинете ivideon|800px]] | |||
Данный IP-адрес копируется и вставляется в браузере в адресную строку. Это нужно чтобы открыть тот самый интерфейс настроек камеры. | В открывшемся окне будет описана информации о камере. Внизу окна будет нужный пользователю блок "IP-адрес" со строкой "eth 0". В этой строке и будет указан нужный IP-адрес. | ||
[[File:Ip_адрес_камеры.png|thumb|center| Пример отображения IP-адреса камеры в личном кабинете ivideon|800px]] | |||
Открывшаяся страница с авторизацией потребует ввести логин и пароль от камеры. | Данный IP-адрес копируется и вставляется в браузере в адресную строку. Это нужно чтобы открыть тот самый интерфейс настроек камеры. Открывшаяся страница с авторизацией потребует ввести логин и пароль от камеры. | ||
После этого в web-интерфейсе настроек камеры необходимо будет найти настройку "Configuration/конфигурации" и включить настройку или чекбокс (поставить галочку) у настройки "Enable motion detection" (включить обнаружение движения).<br> | После этого в web-интерфейсе настроек камеры необходимо будет найти настройку "Configuration/конфигурации" и включить настройку или чекбокс (поставить галочку) у настройки "Enable motion detection" (включить обнаружение движения).<br> | ||
{{Note|'''Ограничение:''' камера должна поддерживать настройку пересечения объектом зоны, иначе указанная ранее настройка "Enable motion detection" может быть недоступна в настройках web-интерфейса камеры. Пример камеры поддерживающей настройку зоны с реакцией на пересечние можно по [https://www.dssl.ru/products/ds-2cd2183g2-is-2-8-mm-ip-kamera/ ссылке]. В настройках камеры пользователю всегда сможет помочь специалист технической поддержки ivideon|warn}} | {{Note|'''Ограничение:''' камера должна поддерживать настройку пересечения объектом зоны, иначе указанная ранее настройка "Enable motion detection" может быть недоступна в настройках web-интерфейса камеры. Пример камеры поддерживающей настройку зоны с реакцией на пересечние можно по [https://www.dssl.ru/products/ds-2cd2183g2-is-2-8-mm-ip-kamera/ ссылке]. В настройках камеры пользователю всегда сможет помочь специалист технической поддержки ivideon|warn}} | ||
Строка 56: | Строка 55: | ||
=== '''Отображение событий в личном кабинете ivideon''' === | === '''Отображение событий в личном кабинете ivideon''' === | ||
После настройки web-интерфейса камеры в личном кабинете ivideon пользователю начнут приходить события. | После настройки web-интерфейса камеры в личном кабинете ivideon пользователю начнут приходить события. | ||
[[File:Список_событий ivideon.png|thumb|center| Пример отображения событий в личном кабинете ivideon|800px]] | |||
В разделе личного кабинета "События" пользователю необходимо | В разделе личного кабинета "События" пользователю необходимо отсортировать события с помощью фильтров. | ||
[[File:Строка_фильтров.png|thumb|center| Пример отображения фильтров событий в личном кабинете ivideon|800px]] | |||
Из имеющихся фильтров пользователю необходимо использовать фильтр по типу события: | |||
# Пересечении линии | # Пересечении линии | ||
# Вход в зону | # Вход в зону | ||
После применения фильтра в личном кабинете будут отображаться только события | После применения фильтра в личном кабинете будут отображаться только отсортированные события описанные выше. | ||
[[File:Типы_событий.png|thumb|center| Пример фильтрации событий в личном кабинете ivideon|800px]] | |||
{{Note|'''Ограничение:''' если одно из событий указанных выше произошло ("Пересечение линии" и "Вход в зону") то приходит в личный кабинет. Промежуток регистрации события - одно событие в течении пяти минут. Если после запуска таймера отсчета в пять минут у камеры произойдет событие (изменения одного цвета пикселя в зоне камеры) то пятиминутный таймер сбросится и начнет отсчет по новой. При этом событие в личный кабинет ivideon не придет, так как изначальный таймер в пять минут не закончил свой отсчет. Следовательно и событие на которое должна среагировать трансляция в SmartPlayer не приходит. Ограничение на длительность таймера в пять минут отключить невозможно.<br> | {{Note|'''Ограничение:''' если одно из событий указанных выше произошло ("Пересечение линии" и "Вход в зону") то приходит в личный кабинет. Промежуток регистрации события - одно событие в течении пяти минут. Если после запуска таймера отсчета в пять минут у камеры произойдет событие (изменения одного цвета пикселя в зоне камеры) то пятиминутный таймер сбросится и начнет отсчет по новой. При этом событие в личный кабинет ivideon не придет, так как изначальный таймер в пять минут не закончил свой отсчет. Следовательно и событие на которое должна среагировать трансляция в SmartPlayer не приходит. Ограничение на длительность таймера в пять минут отключить невозможно.<br> | ||
Также нужно понимать что хоть событие и не пришло в личный кабинет ivideon, но система его видела и засчитала. А это значит что таймер в пять минут снова обновится и начнет отсчет. |warn}} | Также нужно понимать что хоть событие и не пришло в личный кабинет ivideon, но система его видела и засчитала. А это значит что таймер в пять минут снова обновится и начнет отсчет. |warn}} |
Версия от 11:25, 18 октября 2024
Описание ситуации
Данная инструкция предназначена для получения информации о правильной настройке сервиса ivideon, а также информации для его интеграции с платформой SmartPlayer.
Сценарий использования при интеграции с ivideon
Для понимания как будет происходить интеграция между ivideon и SmartPlayer будет использоваться следующий сценарий взаимодействия в общем виде:
- Зарегистрироваться/авторизоваться в личном кабинете ivideon
- Добавить камеру и настроить камеру в личном кабинете ivideon
- Получить API ключ для интеграции со SmartPlayer
- Авторизоваться в личном кабинете SmartPlayer
- Создать трансляцию в SmartPlayer с двумя страницами
- Страница №1 проигрывает фоновый контент (режим бездействия)
- Страница №2 проигрывает контент, который будет проигрываться для настроенной на движение камеры
- После проигрывания контента со страницы №2 происходит переход (возвращение) на страницу №1
Настройка ivideon
Регистрация/авторизация пользователя в сервисе ivideon
Первым шагом для пользователя будет регистрация в сервисе ivideon. Пройти регистрацию можно по ссылке. Для начала процесса регистрации пользователю необходимо перейти по ссылке и нажать на строку "Регистрация".
После нажатия пользователю откроется новое окно со списком данных, которые необходимо указать о себе. В этот список входит следующая информация:
- Имя
- Адрес электронной почты (E-Mail)
- Номер телефона
- Пароль
- Чекбокс (галочка) о принятии условий обслуживания и политике конфиденциальности/
После авторизации на сервисе ivideon пользователю откроется главная страница личного кабинета пользователя.
Добавление устройства в личный кабинет ivideon
На главной странице пользователю предложат добавить устройство по специальной кнопке в центре экрана - "Подключить устройство".
Кликнув на кнопку "Подключить устройство" пользователю откроется список, в котором необходимо выбрать нужное устройство. В данном случае это IP-камера.
Далее пользователю рекомендуется выбрать способ подключения IP-камеры. Специалисты технической поддержки ivideon настоятельно рекомендуют использовать проводное подключение "Ethernet".
На данном этапе пользователя попросят указать серийный номер устройство. Если данной информацией пользователь не располагает, то существует возможность зарегистрировать устройство с помощью MAC-адреса. Кликнув на специальную строку "Использовать MAC-адрес" пользователь сможет перейти в новое окно регистрации.
В открывшемся окне регистрации пользователю необходимо ввести MAC-адрес устройства, который можно найти на самом устройстве (IP- камере) или на коробке в которой она хранилась.
После указания MAC-адреса и нажатия клавиши "Продолжить" камера пользователя будет зарегистрирована и отобразится в личном кабинете.
Использование web-интерфейса камеры для настройки
Производителями различных камер предусмотрен внутренний интерфейс с настройками камеры. Чтобы до него добраться необходимо проделать определенный порядок действий.
Первым делом пользователю в личном кабинете ivideon необходимо перейти в раздел "Настройки" и переходим в категорию "Безопасность".
В данной категории пользователь может изменить пароль к камере и указать нужный, если он его не знает.
Следующим шагом переходим в раздел информация о камере. Для этого пользователю необходимо в окне зарегистрированной камеры нажать на три вертикальных точки и открыть список возможностей по взаимодействию с камерой. В этом списке пользователь выбирает строку "Информация о камере".
В открывшемся окне будет описана информации о камере. Внизу окна будет нужный пользователю блок "IP-адрес" со строкой "eth 0". В этой строке и будет указан нужный IP-адрес.
Данный IP-адрес копируется и вставляется в браузере в адресную строку. Это нужно чтобы открыть тот самый интерфейс настроек камеры. Открывшаяся страница с авторизацией потребует ввести логин и пароль от камеры.
После этого в web-интерфейсе настроек камеры необходимо будет найти настройку "Configuration/конфигурации" и включить настройку или чекбокс (поставить галочку) у настройки "Enable motion detection" (включить обнаружение движения).
Также некоторым камерам доступно записи и хранения логов. Для этого в камере предусмотрена возможность вставить USB-flash накопитель. Просмотреть логи можно также в web-интерфейсе камеры (присутствует не у всех производителей).
Отображение событий в личном кабинете ivideon
После настройки web-интерфейса камеры в личном кабинете ivideon пользователю начнут приходить события.
В разделе личного кабинета "События" пользователю необходимо отсортировать события с помощью фильтров.
Из имеющихся фильтров пользователю необходимо использовать фильтр по типу события:
- Пересечении линии
- Вход в зону
После применения фильтра в личном кабинете будут отображаться только отсортированные события описанные выше.
Также нужно понимать что хоть событие и не пришло в личный кабинет ivideon, но система его видела и засчитала. А это значит что таймер в пять минут снова обновится и начнет отсчет.
Интеграция со SmartPlayer
Для интеграции со SmartPlayer пользователю в личном кабинете ivideon необходимо получить API - ключ. Данный ключ можно получить в личном кабинете ivideon. Чтобы получить API-ключ пользователю нужно перейти в раздел для разработчика и создать по отдельной кнопке API-ключ.
Создание трансляции для проигрывания в SmartPlayer с нужными настройками
Чтобы принимать данные с сервиса ivideon и заставить правильно реагировать на эти событие SmartPlayer пользователю необходимо создать трансляцию со специально настроенными параметрами.
- Windows - ver. 2.41.7
- Linux - ver. 2.41.7
- Android - ver. 1.74.2 и выше.
Подготовка серверного приложения:
- Создать личный кабинет на нужном серверном приложении. При создании личного кабинета необходимо выставить роль - "admin" с видеоаналитикой
- Вручную создать трансляцию в личном кабинете и настроить переходы для нужного контента и значениями событий (действиями для событий)
Программная часть:
- При реализации программной части необходимо использовать "socket.io v.2". Данное решение доступно по ссылке
Личный кабинет:
- Взаимодействие с личным кабинетом происходит по протоколу: http(s) и webSocket. Информация о "socket.io v.2" указана выше.
Информация по протоколам:
- restApi - используется в большинстве случаев для авторизации и работы с файлами
- Socket.io - используется большинством методов для работы с личным кабинетом
Авторизация:
- Информация о получении необходимых токенов можно получить по ссылке
- Информация о корректной настройки для "join" можно получить по ссылке
Получение трансляции:
- С помощью определенного события можно получить список трансляций. Информация о получении события доступна по ссылке.
После получения данных необходимо будет выбрать нужное событие. У этого объекта необходимо взять ID, который будет подставлен в событие, описанное ниже.
Отправка ответного события:
- Следующим шагом отправляется другое событие, доступное по ссылке, с нужными параметрами.
Событие с правильными параметрами должно переключать страницы в эфирной сетке.
Создание трансляции в личном кабинете
После настройки серверной части пользователь сможет воспользоваться подготовкой событий для воспроизведения их в трансляции.
Чтобы начать работу с событиями в трансляции пользователю необходимо сначала авторизоваться в личном кабинете.
Следующим шагом пользователю найти в личном кабинете раздел "Трансляции" и выбрать категорию "Создать".
После нажатия по категории "Создать" пользователю откроется новое окно, в котором будет показан весь интерфейс для создания трансляции.
Далее пользователю необходимо в зависимости от своих задач создать нужно количестве страниц. Данное действие делается в левой нижней части экрана по специальной иконке в виде большого символа "+".
Создав нужное количество страниц, пользователь должен на каждой странице выбрать зону для контента. Это делается по специальной иконке в виде прямоугольника вверху экрана.
При создании зоны открывается тулбар с настройками зоны, в котором можно настраивать параметры зоны.
После выделения зоны для контента пользователь может индивидуально настроить зону с контентом, в соответствии со своими нуждами.
Проделав действия, описанные выше пользователю необходимо выбрать страницу с контентом и открыть настройки страницы по иконке в левой нижней части личного кабинета. Настройки страницы откроются также в тулбаре справа, как и настройки для зоны контента.
В настройках страницы пользователю необходимо найти строку с параметром "Событие" и нажать на иконку в виде "+".
Данное действие откроет новое окно со списком событий для данной страницы.
Настройка события
Проделав действия описанные ранее пользователю откроется окно с выбором событий. В данном окне будет три доступных варианта:
- Распознавание лица
- RFID метка
- Серверное приложение (нужный вариант)
Пользователь выбирает событие "Серверное приложение" и ему добавится новая строка для заполнения "Ключ". В ней необходимо выбрать вариант "По полезной нагрузке".
Выбрав данный ключ пользователю станет доступна еще одна строка - "Значение". В этой строке пользователь и должен указать специальную константу имеющую следующее значение:
ivs.vca.line_detection.event/started
После завершения заполнения всех полей в окне пользователю необходимо нажать на кнопку "Сохранить" в центре экрана.
Связанная информация
Для дальнейшего завершения настройки трансляции рекомендуется ознакомиться со следующими Wiki-страницами
Итог
После завершения настройки личного кабинет ivideon, интеграции с серверными приложением SmartPlayer и настройки трансляции с использованием событийной модели в личном кабинете SmartPlayer должно начать функционировать. Данное решение будет проигрывать и изменять контент при любом приближении человека в рамках выбранной и настроенной на камере зоны.
Видеоинструкция
Настройка интеграции ivideon и SmartPlayer
Дополнительная информация
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения"