Elecard ViCont — Начало работы

    | |revisiondate|: 2025-03-19 07:35:26 UTC
    | |revisionid|: f0307ec

1. Начало работы

Описание программы

Elecard ViCont — это решение для удаленного управления контентом на экранах в режиме реального времени. Программное обеспечение ViCont работает в клиент-серверном режиме. Клиентская часть представлена плеером, который получает настройки от сервера и проигрывает принимаемый поток, плейлист из медиафайлов или отдельные медиафайлы.

Системные требования

Плеер

Сервер

ОС Linux Ubuntu 22.04

ОС Linux + Docker

OC Android 7+

ОС Linux + Docker

Работа с сервером

Работа с системой ViCont осуществляется посредством браузера.

Поддерживаемые браузеры:

  • Chromium версия 54 и новее

  • Google Chrome версия 54 и новее

  • Mozilla Firefox версия 47 и новее

  • Microsoft Edge версия 100 и новее

Для корректной работы убедитесь, что ваш браузер обновлен до последней версии.

Минимальное разрешение экрана: 1680х1050
На меньших разрешениях корректность отображения интерфейса не гарантируется.

Технические характеристики

Плееры на ОС Ubuntu

Прием потоков

Протоколы: UDP, RTP, SRT
Контейнеры: MPEG2-TS
Форматы видео: MPEG-2, H.264, H.265
Форматы аудио: MPEG-1 Layer II, AAC-LC, HE-AAC v1 & v2
Разрешения: SD, HD, Full HD, 4K

Использование плейлистов из файлов

Контейнеры: MPEG2-TS, MP4
Форматы видео: MPEG-2, H.264, H.265
Форматы аудио: MPEG-1 Layer II, AAC-LC, HE-AAC v1 & v2
Разрешения: SD, HD, Full HD, 4K

Отправка статистики по протоколам: HTTP и SNMP

Плееры на ОС Android

Прием потоков

Протоколы: UDP, RTP, SRT, HLS, MPEG-DASH
Контейнеры: MP4, MPEG2-TS
Форматы видео: MPEG-2, H.264, H.265
Форматы аудио: MPEG-1 Layer II, AAC-LC, HE-AAC v1 & v2
Разрешения: SD, HD, Full HD, 4K

Использование плейлистов из файлов

Контейнеры: MP4
Форматы видео: MPEG-2, H.264, H.265
Форматы аудио: MPEG-1 Layer II, AAC-LC, HE-AAC v1 & v2
Разрешения: SD, HD, Full HD, 4K

Отправка статистики по протоколам: HTTP и SNMP

Установка ПО ViCont

Необходимые условия

Для установки серверной части необходимо наличие следующих компонентов:

  1. Docker. На этой странице выберите инструкцию по установке Docker в соответствии с дистрибутивом (на английском языке).

  2. Python 3. Python предустановлен в большинстве дистрибутивов Linux, в том числе Ubuntu. Проверить его наличие и версию можно с помощью команды:

    python3 --version

Если Python не установлен, установите его, выбрав подходящую инструкцию на этой странице (на английском языке).

Установка сервера ViCont

Загрузите пакет сервера с именем вида vicont-bundle-<версия>-<тег>.tar.gz и распакуйте его:

tar -xzvf vicont-bundle-<версия>-<тег>.tar.gz

Далее перейдите в папку vicont-bundle:

cd vicont-bundle

Разрешите запуск установочного скрипта:

chmod +x *.sh

Запустите установочный скрипт:

sudo ./deploy.sh [OPTIONS]

При запуске можно передавать дополнительные аргументы. Например, опция -n или --no-demo отключает загрузку демо-данных на сервер:

sudo ./deploy.sh --no-demo

Демо-данные включают в себя видеофайл, пример редактируемого макета (см. раздел Дизайн в Руководстве пользователя) и последние актуальные версии пакетов плееров.

Справку по доступным опциям можно получить, передав аргумент -h или --help. Выполнение установочного скрипта после этого завершится.

После установки веб-интерфейс будет доступен по адресу: http://<адрес_сервера>:8090. Вместо адрес_сервера укажите любой из имеющихся сетевых интерфейсов.

Для входа в веб-интерфейс используйте следующие данные 1:

Пользователь — admin
Пароль — Adm!nV1-NT
1

Данная учетная запись не может быть удалена.

После первого входа в систему рекомендуется сменить пароль. Далее нажмите на значок шестеренки в правом верхнем углу интерфейса и в выпадающем списке выберите пункт Настройки сервера. В открывшемся окне укажите Интерфейс сети и Порт. Это адрес и порт, по которому плеер будет обращаться к веб-серверу. Они используются при установке плеера через веб-интерфейс. Если интерфейс сети и порт будут заданы неправильно, плеер не сможет подключиться к серверу при установке.

Изменение параметров сервера

Пакет сервера содержит скрытый файл .env. В нем прописаны значения переменных окружения, например номер порта или путь к папке, в которой будет храниться журнал событий. Описания переменных даны в самом файле в виде комментариев. При необходимости значения переменных можно менять. Если вы редактировали значения после установки сервера, запустите скрипт rebuild.sh:

sudo ./rebuild.sh

В противном случае запустите deploy.sh.

Вы также можете задать значения переменных непосредственно при запуске скрипта, например:

sudo ADMIN_USERNAME=admin ADMIN_PASSWORD=admin ./rebuild.sh

или

sudo ADMIN_USERNAME=admin ADMIN_PASSWORD=admin ./deploy.sh

Обновление сервера

Чтобы обновить сервер, загрузите пакет обновления и распакуйте его в ту же папку, что и первоначальный пакет:

tar -xzvf vicont-bundle-<версия>-<тег>.tar.gz

Перейдите в папку с пакетом обновления vicont-bundle:

cd vicont-bundle

Разрешите запуск установочного скрипта:

chmod +x *.sh

Запустите обновление сервера:

sudo ./deploy.sh

Примечание

Процесс обновления не затрагивает параметры доступа и сохраненную базу данных.

Поскольку при первом входе в систему учетные данные, скорее всего, были изменены, то для успешной загрузки демо-данных на сервер необходимо отредактировать значения переменных окружения ADMIN_USERNAME и ADMIN_PASSWORD перед обновлением сервера. Задать актуальные значения переменных можно в файле .env или в файле /root/.vicont_credentials.

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

Примечание

Если не редактировать значения переменных, сервер все равно успешно обновится, но демо-данные загружены не будут.

При обновлении скрипт проверяет наличие файла /root/.vicont_credentials. Если файл отсутствует, скрипт создает его, используя значения переменных окружения ADMIN_USERNAME и ADMIN_PASSWORD либо значения по умолчанию, т.е. admin и Adm!nV1-NT, соответственно. Владельцем файла является суперпользователь. Только он имеет права на чтение и запись данных.

Установка плеера

Плеер можно установить несколькими способами.

Установка через веб-интерфейс

Рекомендуется использовать этот способ установки плеера. Вы также можете загрузить и установить пакет плеера непосредственно на устройство. Этот процесс описан в пункте Автономная установка.

Чтобы установить новый плеер или подключить уже существующий без установки, перейдите на страницу Плееры и нажмите на кнопку Добавить. В открывшемся окне вы можете указать параметры плеера или импортировать список плееров, используя CSV-файл.

Для добавления плеера через форму ввода укажите следующие параметры:

  • Имя (обязательный параметр) — имя для идентификации плеера.

  • Описание — дополнительная информация для добавляемого плеера.

  • MAC-адрес (обязательный параметр) — MAC-адрес сетевого интерфейса компьютера, на котором будет работать плеер.

  • Группа — выбор группы, в которую нужно добавить плеер при необходимости. Группы используются для массового управления плеерами. Если группа не указана, будут использоваться индивидуальные параметры плеера.

  • Пакет — выбор версии пакета плеера, если требуется установка нового плеера. В противном случае оставьте в поле значение Без установки.

Чтобы установить новый плеер на ОС Ubuntu, также укажите:

  • IP-адрес и Порт (обязательные параметры) — данные компьютера для подключения к нему по протоколу SSH. По умолчанию используется порт 22.

  • Имя пользователя и Пароль (обязательные параметры) — учетные данные для удаленного подключения к компьютеру. От имени выбранного пользователя будет выполняться вход в систему и загрузка плеера.

_images/adding_players_with_install_ubuntu_ru.png

Чтобы установить новый плеер на ОС Android, также укажите:

  • IP-адрес и Порт (обязательные параметры) — данные компьютера для подключения к нему через утилиту adb. По умолчанию используется порт 5555.

_images/adding_players_with_install_android_ru.png

После ввода всех параметров нажмите на кнопку Применить.

Вы можете одновременно добавить несколько плееров через специальный шаблон в CSV-формате. Чтобы скачать форму шаблона, нажмите на кнопку Шаблон CSV. Заполните форму и загрузите ее, нажав на кнопку Импорт из CSV. Проверьте импортированные параметры и примените изменения.

Автономная установка

Загрузите ZIP-архив на компьютер, на котором должен быть установлен плеер. Для этого кликните на значок шестерёнки в правом верхнем углу экрана и выберите раздел Пакеты плееров. На открывшейся странице выберите нужный пакет плеера на ОС Ubuntu или Android и в столбце Управление нажмите на появившуюся кнопку скачивания. Выбирать можно только те пакеты, которые перед этим были загружены на сервер.

Установка плеера на ОС Ubuntu

Примечание

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

  1. Распакуйте скачанный ZIP-архив с плеером на OC Ubuntu в выбранную вами папку:

    unzip <имя архива>

    В архиве находятся следующие файлы:

    • Инструкции по установке плеера на русском и английском языках (readme)

    • Конфигурационный файл (config.json)

    • Архив с пакетом плеера (tar.gz)

    • Файл инсталляции (install)

  2. Перейдите к файлу config.json и убедитесь, что адрес сервера ViCont указан верно:

    "server": {
    "address": "127.0.0.1",
    "port": 8090
}

  3. В строке address задайте актуальное значение IP-адреса, а в строке port — актуальное значение порта.

  4. Запустите установку плеера от пользователя с правами sudo:

    sudo ./install -p <путь к пакету плеера> -u <имя пользователя>

    Вместо <путь к пакету плеера> и <имя пользователя> укажите путь до пакета и имя пользователя, от которого будет запускаться плеер, например:

    sudo ./install -p ./Elecard.Player-1.2.9.tar.gz -u user

  5. Перезагрузите компьютер:

    sudo reboot

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

Установка плеера на ОС Android

Плеер на ОС Android поставляется в APK-формате. Его можно установить двумя способами.

Способ 1: c помощью утилиты adb

  1. Распакуйте скачанный ZIP-архив с плеером на ОС Android в выбранную вами папку.

    В архиве находятся следующие файлы:

    • Инструкции по установке плеера на русском и английском языках (readme)

    • Архив с apk-пакетом плеера (tar.gz)

  2. Распакуйте tar.gz-архив с пакетом плеера.

  3. Включите режим разработчика на Android-устройстве.

  4. Если на вашем компьютере нет утилиты adb, скачайте ее. Перейдите по ссылке и в разделе Загрузки выберите версию, подходящую для вашего компьютера. Кликните по названию выбранной версии, чтобы скачать ZIP-архив с утилитой.

  5. Распакуйте архив в папку на компьютере и перейдите к ней с помощью терминала.

  6. Подключитесь к Android-устройству:

    adb connect <IP-адрес Android-устройства>:5555

  7. Установите пакет плеера из архива:

    adb install <путь к пакету плеера>

    Вместо <путь к пакету плеера> укажите путь до устанавливаемого пакета, например:

    adb install C:\Android\Elecard.Player-0.1.26.apk

  8. Запустите плеер:

    adb shell am start -n com.elecard.vicont.player/com.elecard.vicont.player.MainActivity

Способ 2: установка непосредственно на устройство

  1. Скачайте, распакуйте и установите пакет плеера (APK) непосредственно на Android-устройство.

  2. Запустите плеер кликом по иконке Vicont Player.

У Android-плееров, установленных в автономном режиме, при первом запуске будет показан экран, где необходимо ввести IP-адрес и порт сервера. Введите адрес и порт и нажмите CONNECT.

_images/android_start_screen.png

При установке плеера через adb вы можете избежать появления этого экрана, запустив плеер с помощью команды:

adb shell am start -n com.elecard.vicont.player/com.elecard.vicont.player.MainActivity -e serverAddress "http://<адрес сервера>:8090"

Примечание

Плееры, установленные в автономном режиме, можно добавить в веб-интерфейсе ViCont на вкладке Плееры ➝ Незарегистрированные плееры.

Добавление новых пользователей

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

  • Гость — ознакомительный доступ, позволяющий просматривать все страницы и данные, без возможности вносить какие-либо изменения. Эта роль также не позволяет изменять свои учетные данные.

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

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

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