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

Материал из SmartPlayer

Описание ситуации

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

Сценарий использования при интеграции с ivideon

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

  • Зарегистрироваться/авторизоваться в личном кабинете ivideon
  • Добавить камеру и настроить камеру в личном кабинете ivideon
  • Получить API ключ для интеграции со SmartPlayer
  • Авторизоваться в личном кабинете SmartPlayer
  • Создать трансляцию в SmartPlayer с двумя страницами
  • Страница №1 проигрывает фоновый контент (режим бездействия)
  • Страница №2 проигрывает контент, который будет проигрываться для настроенной на движение камеры
  • После проигрывания контента со страницы №2 происходит переход (возвращение) на страницу №1

Настройка ivideon

При возникновении проблем с настройкой личного кабинета и устройств в личном кабинете ivideon рекомендуется обращаться к специалиста технической поддержки компании ivideon.

Регистрация/авторизация пользователя в сервисе ivideon

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

Пример отображения строки "Регистрации" на странице сервиса ivideon

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

  • Имя
  • Адрес электронной почты (E-Mail)
  • Номер телефона
  • Пароль
  • Чекбокс (галочка) о принятии условий обслуживания и политике конфиденциальности/
Пример отображения необходимых данных для регистрации в сервисе ivideon
Если пользователь уже имеет учетную запись в сервисе ivideon ему необходимо авторизоваться в нем.

После авторизации на сервисе ivideon пользователю откроется главная страница личного кабинета пользователя.

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

Добавление устройства в личный кабинет ivideon

На главной странице пользователю предложат добавить устройство по специальной кнопке в центре экрана - "Подключить устройство".

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

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

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

Далее пользователю рекомендуется выбрать способ подключения IP-камеры. Специалисты технической поддержки ivideon настоятельно рекомендуют использовать проводное подключение "Ethernet".

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

На данном этапе пользователя попросят указать серийный номер устройство. Если данной информацией пользователь не располагает, то существует возможность зарегистрировать устройство с помощью MAC-адреса. Кликнув на специальную строку "Использовать MAC-адрес" пользователь сможет перейти в новое окно регистрации.

Пример регистрации устройства через серийный номер и отображения строки на переход для регистрации через MAC-адрес

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

Пример регистрации устройства через MAC-адрес

После указания MAC-адреса и нажатия клавиши "Продолжить" камера пользователя будет зарегистрирована и отобразится в личном кабинете.

Использование web-интерфейса камеры для настройки

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

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

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

Файл:Изменить пароль..png
Пример отображения строки для изменения пароля от устройства

Следующим шагом переходим в раздел информация о камере и находим строку с локальным IP-адресом.

Данный IP-адрес копируется и вставляется в браузере в адресную строку. Это нужно чтобы открыть тот самый интерфейс настроек камеры.

Открывшаяся страница с авторизацией потребует ввести логин и пароль от камеры.

После этого в web-интерфейсе настроек камеры необходимо будет найти настройку "Configuration/конфигурации" и включить настройку или чекбокс (поставить галочку) у настройки "Enable motion detection" (включить обнаружение движения).

Ограничение: камера должна поддерживать настройку пересечения объектом зоны, иначе указанная ранее настройка "Enable motion detection" может быть недоступна в настройках web-интерфейса камеры. Пример камеры поддерживающей настройку зоны с реакцией на пересечние можно по ссылке

Создание трансляции для проигрывания в 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

Пример отображения поля с прописанной константой

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

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

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

Итог

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

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

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

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

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

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

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