Интеграция SmartPlayer с ivideon/en: различия между версиями

Материал из SmartPlayer
(Новая страница: «== '''Situation Description''' == This instruction is intended to provide information on the proper setup of the ivideon service, as well as information for its integration with the SmartPlayer platform. == '''Usage Scenario for Integration with ivideon''' == To understand how the integration between ivideon and SmartPlayer will occur, the following general interaction scenario will be used: * Register/log in to the ivideon personal account * Add and configu...»)
(Новая страница: «=== '''Adding a device to the ivideon personal account''' === On the main page, the user will be prompted to add a device via a special button in the center of the screen - "Connect Device." thumb|center| Example of the "Connect Device" button displayed in the ivideon user personal account|800px By clicking the "Connect Device" button, the user will open a list where they need to select the desired devic...»)
Строка 27: Строка 27:
After logging into ivideon, the user will be presented with the main page of their personal account.
After logging into ivideon, the user will be presented with the main page of their personal account.
[[File:Стартовая_страница_ivideon.png|thumb|center| Example of the main page of the user's personal account in the ivideon service |800px]]
[[File:Стартовая_страница_ivideon.png|thumb|center| Example of the main page of the user's personal account in the ivideon service |800px]]
<div lang="ru" dir="ltr" class="mw-content-ltr">
=== '''Adding a device to the ivideon personal account''' ===
=== '''Добавление устройства в личный кабинет ivideon''' ===
On the main page, the user will be prompted to add a device via a special button in the center of the screen - "Connect Device."
На главной странице пользователю предложат добавить устройство по специальной кнопке в центре экрана - "Подключить устройство".
[[File:Подключить_устройство.png|thumb|center| Example of the "Connect Device" button displayed in the ivideon user personal account|800px]]
[[File:Подключить_устройство.png|thumb|center| Пример отображения кнопки "Подключить устройство" в личном кабинете пользователя сервиса ivideon|800px]]
By clicking the "Connect Device" button, the user will open a list where they need to select the desired device. In this case, it's an IP camera.
Кликнув на кнопку "Подключить устройство" пользователю откроется список, в котором необходимо выбрать нужное устройство. В данном случае это IP-камера.
[[File:Ip_камера.png|thumb|center| Example of the list of available devices for connection in the ivideon user personal account|800px]]
[[File:Ip_камера.png|thumb|center| Пример отображения списка доступных для подключения устройств в личном кабинете пользователя сервиса ivideon|800px]]
Next, the user is advised to choose the connection method for the IP camera. ivideon technical support specialists strongly recommend using a wired "Ethernet" connection.
Далее пользователю рекомендуется выбрать способ подключения IP-камеры. Специалисты технической поддержки ivideon настоятельно рекомендуют использовать проводное подключение "Ethernet".
[[File:Подключение_через_кабель_.png|thumb|center| Example of the types of camera connections in the ivideon user personal account|800px]]
[[File:Подключение_через_кабель_.png|thumb|center| Пример отображения типа подключений камеры в личном кабинете пользователя сервиса ivideon|800px]]
At this stage, the user will be asked to provide the device's serial number. If the user does not have this information, it is possible to register the device using the MAC address. By clicking on the special line "Use MAC address," the user will be redirected to a new registration window.
На данном этапе пользователя попросят указать серийный номер устройство. Если данной информацией пользователь не располагает, то существует возможность зарегистрировать устройство с помощью MAC-адреса. Кликнув на специальную строку "Использовать MAC-адрес", пользователь сможет перейти в новое окно регистрации.
[[File:Серийный_номер_.png|thumb|center| Example of registering a device via serial number and displaying the line for registration via MAC address|800px]]
[[File:Серийный_номер_.png|thumb|center| Пример регистрации устройства через серийный номер и отображения строки на переход для регистрации через MAC-адрес|800px]]
In the opened registration window, the user needs to enter the MAC address of the device, which can be found on the device itself (IP camera) or on the box in which the device was packaged upon purchase.
В открывшемся окне регистрации пользователю необходимо ввести MAC-адрес устройства, который можно найти на самом устройстве (IP- камере) или на коробке, в которой устройство было упаковано при покупке.
[[File:Мак_адрес.png|thumb|center| Example of registering a device via MAC address|800px]]
[[File:Мак_адрес.png|thumb|center| Пример регистрации устройства через MAC-адрес|800px]]
After entering the MAC address and clicking the "Continue" button, the user's camera will be registered and displayed in their personal account.
После указания MAC-адреса и нажатия клавиши "Продолжить" камера пользователя будет зарегистрирована и отобразится в личном кабинете.
=== '''Using the camera's web interface for configuration''' ===
=== '''Использование web-интерфейса камеры для настройки''' ===
Manufacturers of various cameras provide an internal interface for configuring the camera. To access it, a certain sequence of steps must be followed.<br>
Производителями различных камер предусмотрен внутренний интерфейс с настройками камеры. Чтобы до него добраться необходимо проделать определенный порядок действий.<br>
First, the user needs to go to the "Settings" section in the ivideon personal account and proceed to the "Security" category.
Первым делом пользователю в личном кабинете ivideon необходимо перейти в раздел "Настройки" и переходим в категорию "Безопасность".
[[File:Настройки_безопасности_.png|thumb|center| Example of the "Settings" section and the "Security" category in the ivideon personal account|800px]]
[[File:Настройки_безопасности_.png|thumb|center| Пример отображения раздела "Настройки" и категории "Безопасность" в личном кабинете ivideon|800px]]
In this category, the user can change the camera password and set the desired one if they do not know it.
В данной категории пользователь может изменить пароль к камере и указать нужный, если он его не знает.
[[File:Изменить_пароль.png|thumb|center| Example of the line for changing the device password|800px]]
[[File:Изменить_пароль.png|thumb|center| Пример отображения строки для изменения пароля от устройства|800px]]
Next, proceed to the camera information section. To do this, the user needs to click on the three vertical dots in the window of the registered camera and open the list of options for interacting with the camera. In this list, the user selects the line "Camera Information."
Следующим шагом переходим в раздел информация о камере. Для этого пользователю необходимо в окне зарегистрированной камеры нажать на три вертикальных точки и открыть список возможностей по взаимодействию с камерой. В этом списке пользователь выбирает строку "Информация о камере".
[[File:Информация_о_камере.png|thumb|center| Example of the "Camera Information" line in the ivideon personal account|800px]]
[[File:Информация_о_камере.png|thumb|center| Пример отображения строки "Информации о камере" в личном кабинете ivideon|800px]]
In the opened window, information about the camera will be provided. At the bottom of the window, there will be the required block "IP Address" with the line "eth 0". The needed IP address will be listed in this line.
В открывшемся окне будет описана информации о камере. Внизу окна будет нужный пользователю блок "IP-адрес" со строкой "eth 0". В этой строке и будет указан нужный IP-адрес.
[[File:Ip_адрес_камеры.png|thumb|center| Example of the camera's IP address displayed in the ivideon personal account|800px]]
[[File:Ip_адрес_камеры.png|thumb|center| Пример отображения IP-адреса камеры в личном кабинете ivideon|800px]]
This IP address is copied and pasted into the browser's address bar to open the camera's settings interface. The opened page will require login credentials for the camera.
Данный IP-адрес копируется и вставляется в браузере в адресную строку. Это нужно чтобы открыть тот самый интерфейс настроек камеры. Открывшаяся страница с авторизацией потребует ввести логин и пароль от камеры.
After this, in the camera's web interface, go to the "Configuration" section and enable the setting or checkbox for "Enable motion detection."<br>
После этого в web-интерфейсе настроек камеры необходимо будет найти настройку "Configuration/конфигурации" и включить настройку или чекбокс (поставить галочку) у настройки "Enable motion detection" (включить обнаружение движения).<br>
{{Note|'''Limitation:''' The camera must support the setting for detecting object crossing of a zone; otherwise, the previously mentioned "Enable motion detection" setting may be unavailable in the camera's web interface. An example of a camera that supports the zone-crossing detection setting can be found [here](https://www.dssl.ru/products/ds-2cd2183g2-is-2-8-mm-ip-kamera/). ivideon technical support specialists are always available to assist users with camera settings.|warn}}
{{Note|'''Ограничение:''' камера должна поддерживать настройку пересечения объектом зоны, иначе указанная ранее настройка "Enable motion detection" может быть недоступна в настройках web-интерфейса камеры. Пример камеры поддерживающей настройку зоны с реакцией на пересечние можно по [https://www.dssl.ru/products/ds-2cd2183g2-is-2-8-mm-ip-kamera/ ссылке]. В настройках камеры пользователю всегда сможет помочь специалист технической поддержки ivideon|warn}}
Some cameras also offer the option to record and store logs. For this purpose, the camera is equipped with the ability to insert a USB-flash drive. Logs can also be viewed in the camera's web interface (this feature is not available on all devices).
Также некоторым камерам доступно записи и хранения логов. Для этого в камере предусмотрена возможность вставить USB-flash накопитель. Просмотреть логи можно также в web-интерфейсе камеры (присутствует не у всех производителей).
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
<div lang="ru" dir="ltr" class="mw-content-ltr">
=== '''Отображение событий в личном кабинете ivideon''' ===
=== '''Отображение событий в личном кабинете ivideon''' ===

Версия от 15:17, 23 октября 2024

Situation Description

This instruction is intended to provide information on the proper setup of the ivideon service, as well as information for its integration with the SmartPlayer platform.

Usage Scenario for Integration with ivideon

To understand how the integration between ivideon and SmartPlayer will occur, the following general interaction scenario will be used:

  • Register/log in to the ivideon personal account
  • Add and configure the camera in the ivideon personal account
  • Obtain an API key for integration with SmartPlayer
  • Log in to the SmartPlayer personal account
  • Create a broadcast in SmartPlayer with two pages
  • Page #1 plays background content (idle mode)
  • Page #2 plays content that will be triggered by the motion detection camera
  • After the content from page #2 is played, it returns (switches back) to page #1

ivideon Setup

If you encounter problems setting up the personal account and devices in ivideon, it is recommended to contact ivideon's technical support specialist.

User Registration/Authorization in ivideon Service

The first step for the user is to register in the ivideon service. You can register by following this link. To start the registration process, the user needs to follow the link and click on the "Register" button.

Example of the "Register" button displayed on the ivideon service page

After clicking, a new window will open with a list of information that needs to be provided by the user. This list includes the following information:

  • Name
  • Email address (E-Mail)
  • Phone number
  • Password
  • Checkbox (checkmark) to accept the terms of service and privacy policy
Example of the required information for registration in the ivideon service
If the user already has an account in the ivideon service, they need to log in.

After logging into ivideon, the user will be presented with the main page of their personal account.

Example of the main page of the user's personal account in the ivideon service

Adding a device to the ivideon personal account

On the main page, the user will be prompted to add a device via a special button in the center of the screen - "Connect Device."

Example of the "Connect Device" button displayed in the ivideon user personal account

By clicking the "Connect Device" button, the user will open a list where they need to select the desired device. In this case, it's an IP camera.

Example of the list of available devices for connection in the ivideon user personal account

Next, the user is advised to choose the connection method for the IP camera. ivideon technical support specialists strongly recommend using a wired "Ethernet" connection.

Example of the types of camera connections in the ivideon user personal account

At this stage, the user will be asked to provide the device's serial number. If the user does not have this information, it is possible to register the device using the MAC address. By clicking on the special line "Use MAC address," the user will be redirected to a new registration window.

Example of registering a device via serial number and displaying the line for registration via MAC address

In the opened registration window, the user needs to enter the MAC address of the device, which can be found on the device itself (IP camera) or on the box in which the device was packaged upon purchase.

Example of registering a device via MAC address

After entering the MAC address and clicking the "Continue" button, the user's camera will be registered and displayed in their personal account.

Using the camera's web interface for configuration

Manufacturers of various cameras provide an internal interface for configuring the camera. To access it, a certain sequence of steps must be followed.
First, the user needs to go to the "Settings" section in the ivideon personal account and proceed to the "Security" category.

Example of the "Settings" section and the "Security" category in the ivideon personal account

In this category, the user can change the camera password and set the desired one if they do not know it.

Example of the line for changing the device password

Next, proceed to the camera information section. To do this, the user needs to click on the three vertical dots in the window of the registered camera and open the list of options for interacting with the camera. In this list, the user selects the line "Camera Information."

Example of the "Camera Information" line in the ivideon personal account

In the opened window, information about the camera will be provided. At the bottom of the window, there will be the required block "IP Address" with the line "eth 0". The needed IP address will be listed in this line.

Example of the camera's IP address displayed in the ivideon personal account

This IP address is copied and pasted into the browser's address bar to open the camera's settings interface. The opened page will require login credentials for the camera. After this, in the camera's web interface, go to the "Configuration" section and enable the setting or checkbox for "Enable motion detection."

Limitation: The camera must support the setting for detecting object crossing of a zone; otherwise, the previously mentioned "Enable motion detection" setting may be unavailable in the camera's web interface. An example of a camera that supports the zone-crossing detection setting can be found [here](https://www.dssl.ru/products/ds-2cd2183g2-is-2-8-mm-ip-kamera/). ivideon technical support specialists are always available to assist users with camera settings.

Some cameras also offer the option to record and store logs. For this purpose, the camera is equipped with the ability to insert a USB-flash drive. Logs can also be viewed in the camera's web interface (this feature is not available on all devices).

Отображение событий в личном кабинете ivideon

После настройки web-интерфейса камеры в личном кабинете ivideon пользователю начнут приходить события.

Пример отображения событий в личном кабинете ivideon

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

Пример отображения фильтров событий в личном кабинете ivideon

Из имеющихся фильтров пользователю необходимо использовать фильтр по типу события:

  1. Пересечении линии
  2. Вход в зону

После применения фильтра в личном кабинете будут отображаться только отсортированные события, описанные выше.

Пример фильтрации событий в личном кабинете ivideon
Ограничение: если одно из событий указанных выше произошло ("Пересечение линии" и "Вход в зону") то приходит в личный кабинет. Промежуток регистрации события - одно событие в течение пяти минут. Если после запуска таймера отсчета в пять минут у камеры произойдет событие (изменения одного цвета пикселя в зоне камеры) то пятиминутный таймер сбросится и начнет отсчет по новой. При этом событие в личный кабинет ivideon не придет, так как изначальный таймер в пять минут не закончил свой отсчет. Следовательно, и событие, на которое должна среагировать трансляция в SmartPlayer не приходит. Ограничение на длительность таймера в пять минут отключить невозможно.
Также нужно понимать, что хоть событие и не пришло в личный кабинет ivideon, но система его видела и засчитала. А это значит, что таймер в пять минут снова обновится и начнет отсчет.

Интеграция со SmartPlayer

Для интеграции со SmartPlayer пользователю в личном кабинете SmartPlayer необходимо сделать три действия:

  1. Добавить на нужное устройство камеру
  2. Создать API ключ в личном кабинете ivideon и с его помощью подключиться к SmartPlayer
  3. Подготовить серверное приложение и трансляцию/-ии с правильно настроенными событиями

Все эти пункты подробнее будут изложены ниже.

Добавление камеры на устройство используемое в трансляции SmartPlayer

Чтобы получать информацию об изменении состоянии камеры пользователю необходимо подключить ее к устройство, которое он будет использовать в трансляции. Данное действие можно сделать в личном кабинете SmartPlayer.

Предварительно устройство, к которому будет привязана камера, должно быть добавлено в личный кабинет. Оно будет отображено в разделе "Устройства".

Изначально пользователю необходимо перейти в раздел "Устройства" личного кабинета.

Пример отображения раздела "Устройства" в личном кабинете SmartPlayer

Далее ему нужно найти нужное устройство, кликнуть по нему и в правом тулбаре перейти в раздел "Настройки".

Пример отображения раздела "Настройки" в списке настроек устройства

В разделе настроек ему нужно найти категорию - "Камера" и открыть данную категорию.

Пример отображения категории "Камера" в настройках устройства

Открыв категорию "Камера" пользователю необходимо будем нажать на кнопку "Добавить камеру" и заполнить следующие поля:

  • Название камеры - ввести название камеры
  • Идентификатор камеры - получить его можно в личном кабинете ivideon, в разделе "Информация о камере" (ID камеры)
С помощью кнопки "Добавить камер" пользователь может добавить несколько камер к одному устройству.
Пример отображения ID камеры в личном кабинете ivideon

Прием данных в SmartPlayer по API ключу от ivideon

Чтобы подключиться к SmartPlayer и получать события от ivideon пользователю необходимо получить API - ключ внутри личного кабинета ivideon. После получения API-ключа пользователю нужно будет добавит его в настройках личного кабинета SmartPlayer.

Создание API-ключа в личном кабинете ivideon

Чтобы получить API-ключ пользователю ivideon необходимо иметь специальный тариф.

Чтобы получить API-ключ пользователю нужно перейти в раздел "Настройки" личного кабинета ivideon и перейти в категорию "Доступ и безопасность".

Пример отображения раздела "Настройки" и категории "Доступ и безопасность" в личном кабинете ivideon

В открывшейся странице пользователю необходимо найти блок "Для разработчиков" и напротив строки "Ключи доступа к API" нажать кнопку "Открыть".

Пример отображения функционала для создания API-ключа в личном кабинете ivideon

Открыв новую страницу, пользователь должен создать новый API ключ. Для этого ему необходимо в правом верхнем углу нажать на кнопку "Создать ключ". Также можно удалить все ключи на этой странице нажав на кнопку "Удалить все ключи".

Пример отображения кнопки "Создать ключ"

В открывшемся окне обязательно нужно ввести имя ключа и нажать на кнопку "Продолжить". Кнопка "Продолжить" будет неактивна пока пользователь не введёт название ключа.

Пример отображения кнопки "Продолжить" и строки для ввода названия ключа

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

Пример отображения окна с созданным API-ключом

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

Пример отображения созданного API-ключа

Применение API-ключа для интеграции со SmartPlayer

Полученный API-ключи в личном кабинете ivideon пользователь должен добавить в личный кабинет SmartPlayer. Для этого пользователю необходимо авторизоваться в личном кабинете SmartPlayer и перейти в раздел "Настройки".

Пример отображения раздела "Настройки" в личном кабинете SmartPlayer

В разделе "Настройки" пользователю необходимо перейти в блок "Интеграции".

Пример отображения Блока "Интеграции" в настройках

В данной блоке пользователю необходимо настроить следующие параметры:

  • Активировать чекбокс (галочку)
  • Ввести значение API-ключа (должен быть скопирован из личного кабинете ivideon)
  • Выбрать тип событий, которые будут использоваться в трансляции. В текущем кейсе будут использоваться только значения - "пересечения линии" и "вход в зону".
Пример отображения заполняемых параметров в блоке "Интеграции"

Создание трансляции для проигрывания в SmartPlayer с нужными настройками

Чтобы принимать данные с сервиса ivideon и заставить правильно реагировать на эти событие SmartPlayer пользователю необходимо создать трансляцию со специально настроенными параметрами.

Данный функционал доступен на следующих версиях клиентских приложения SmartPlayer:
  • Windows - ver. 2.41.7
  • Linux - ver. 2.41.7
  • Android - ver. 1.74.2 и выше.
Также на данный момент не реализован на клиентских приложения Web OS и Tizen OS

Подготовка серверного приложения:

  • Создать личный кабинет на нужном серверном приложении. При создании личного кабинета необходимо выставить роль - "admin" с видеоаналитикой
  • Вручную создать трансляцию в личном кабинете и настроить переходы для нужного контента и значениями событий (действиями для событий)

Программная часть:

  • При реализации программной части необходимо использовать "socket.io v.2". Данное решение доступно по ссылке

Личный кабинет:

  • Взаимодействие с личным кабинетом происходит по протоколу: http(s) и webSocket. Информация о "socket.io v.2" указана выше.

Информация по протоколам:

  • restApi - используется в большинстве случаев для авторизации и работы с файлами
  • Socket.io - используется большинством методов для работы с личным кабинетом

Авторизация:

  • Информация о получении необходимых токенов можно получить по ссылке
  • Информация о корректной настройки для "join" можно получить по ссылке

Получение трансляции:

  • С помощью определенного события можно получить список трансляций. Информация о получении события доступна по ссылке.

После получения данных необходимо будет выбрать нужное событие. У этого объекта необходимо взять ID, который будет подставлен в событие, описанное ниже.
Отправка ответного события:

  • Следующим шагом отправляется другое событие, доступное по ссылке, с нужными параметрами.

Событие с правильными параметрами должно переключать страницы в эфирной сетке.

Создание трансляции в личном кабинете

После настройки серверной части пользователь сможет воспользоваться подготовкой событий для воспроизведения их в трансляции.
Чтобы начать работу с событиями в трансляции пользователю необходимо сначала авторизоваться в личном кабинете.
Следующим шагом пользователю найти в личном кабинете раздел "Трансляции" и выбрать категорию "Создать".

Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете

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

Пример отображения интерфейса создания трансляции в личном кабинете

Далее пользователю необходимо в зависимости от своих задач создать нужно количестве страниц. Данное действие делается в левой нижней части экрана по специальной иконке в виде большого символа "+".

Пример отображения готовых страниц и иконки для добавления новых страниц в личном кабинете

Создав нужное количество страниц, пользователь должен на каждой странице выбрать зону для контента. Это делается по специальной иконке в виде прямоугольника вверху экрана.

Пример отображения иконки создания зоны для контента

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

Пример отображения тулбара с настройками для зоны

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

Пример отображения иконки для перехода в настройки страницы

В настройках страницы пользователю необходимо найти строку с параметром "Событие" и нажать на иконку в виде "+".

Пример отображения строки с параметром "Событие"

Данное действие откроет новое окно со списком событий для данной страницы.

Настройка события

Проделав действия, описанные ранее пользователю откроется окно с выбором событий. В данном окне будет три доступных варианта:

  1. Распознавание лица
  2. RFID метка
  3. Серверное приложение (нужный вариант)
Пример отображения вариантов событий при создании трансляций

Пользователь выбирает событие "Серверное приложение" и ему добавится новая строка для заполнения "Ключ". В ней необходимо выбрать вариант "По полезной нагрузке".

Пример отображения поля "Ключ" и его значения

Выбрав данный ключ пользователю станет доступна еще одна строка - "Значение". В этой строке пользователь и должен указать одно из специальных значений:

Таблица значений
Название Значение
Пересечение линии ivs.vca.line_detection.event/started
Вход в зону ivs.vca.field_detection.event.enter/started
Пример отображения поля с прописанным значением

После завершения заполнения всех полей в окне пользователю необходимо нажать на кнопку "Сохранить" в центре экрана.

Связанная информация

Для дальнейшего завершения настройки трансляции рекомендуется ознакомиться со следующими Wiki-страницами

Итог

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

Видеоинструкция

Настройка интеграции ivideon и SmartPlayer

Дополнительная информация

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

Пример отображения вкладки "Обсуждения" на wiki-странице

Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения"

Источник — https://wiki.smartplayer.org/index.php?title=Интеграция_SmartPlayer_с_ivideon/en&oldid=14671