Trueconf

Интеграция с TrueConfRoom

Компоненты интеграции:

Пакет	ОС	Поставляется
trueconf-room	ubuntu 22.04	mvs-trueconfroom
Lyra3.AdvancedCapture2.API	ubuntu 22.04	mvs-trueconfroom
akvcam	ubuntu 22.04	mvs-trueconfroom
mvs-bootloader	ubuntu 22.04	mvs-trueconfroom
mvs-autologin	ubuntu 22.04	mvs-trueconfroom
Lyra3.OR.Server.API	Centos 7	mvs-lyra3-or-server
Lyra3.OR.TerminalApp	ubuntu 18.04	mvs-lyra3-or-terminalapp

Настройка интеграции с TrueconfRoom на Lyra3.OR.Server.API

Lyra3.OR.Server.API осуществляет видеоменеджмент вирутальных мониторов trueconf через kumo. Для идентификации порта, к которому подключен пк с trueconf-room используется флаг IsTrueConfLine (см. sdiswitchouputmap.yml)

...
  - GersId: gers1
    LinesMap:
     - GersInputLine: 0
       IsConferenceLine: False
       SdiSwitchOutPort: 5
       SdiSwitchInPort: 5
       IsTrueConfLine: False
...

Порт kumo, к которому подключается рабочая станция с trueconf-room нормально отключен. Включение его производится на время звонка либо конференции TrueconfRoom Lyra3.OR.Server.API подключается к trueconf-room для совершения и приема звоков через вебсокетное соединение.

В случае, если используется бесплатная версия trueconf-room, необходимо установить проксирующее приложение:

sudo yum install -y mvs-websocket-proxy

Конфигурация приложения /etc/mvs.lyra3.hp/WebSocket.Proxy.conf:

PROXY_IP=192.168.6.130  		## ip_address where trueconf-room is installed
PROXY_PORT=8014        			## maybe any custom port > 1024
PROXY_PORT_IMG=8766     		## trueconf-room client static (avatars, previews etc.)
WS_PORT=8765            		## trueconf-room ws port (8765 by default)
WS_SERVER_IP=192.168.6.130  ## ip_address where trueconf-room is installed

Автостарт:

sudo systemctl enable --now WebSocket.Proxy.service
sudo systemctl status WebSocket.Proxy.service

В секции TrueConfServiceOptions файла конфигурации /etc/mvs.lyra3.or/Lyra3.OR.Server.API.yml указывается состояние интеграции (фактически, будет ли служа пытаться установить вебсокетное соединение), ws-url, по которому должно производиться соединение и пароль администратора, задаваемый в trueconf-room

TrueConfServiceOptions:
  IsTrueConfConfigured: true
  WebsocketUri: ws://127.0.0.2:8765
  Credentials: <TrueConRoomAdminPassw0rd>

Настройка интеграции с TrueconfRoom на Lyra3.OR.TerminalApp

интеграция настравиватеся в секции apps файла /etc/mvs.lyra3.or/Lyra3.OR.TerminalApp.yml

...
  - enabled: true
    name: trueConfRoom
    configuration:
      url: http://<WebSocket_address>:8014
...

В данном примере указывается адрес и порт WebSocket.Proxy, устанавливаемого на сервере Lyra3.OR.Server.API, в случае, если используется TrueConf Room Pro, необходимо указывать адрес рабочего места TrueConf Room

Рабочее место Trueconf Room

trueconf-room не поддерживается на дистрибутивах Ubuntu 18, поэтому все необходимые приложения размещены в отдельном репозитории:

Подключение репозитория:

sudo apt install curl vim sudo gnupg -y
curl -L https://repo.mvslyra.com/keys/mvs_key.gpg | sudo apt-key add -
sudo apt update

cat > /etc/apt/auth.conf.d/mvs_lyra.conf <<EOF
machine repo.mvslyra.com
login <user>
password <password>
EOF

cat > /etc/apt/sources.list.d/mvs_lyra3.list <<EOF
deb [arch=amd64] deb https://repo.mvslyra.com/repository/yukki-deb22 bionic main
EOF

Установить сервисный пакет:

sudo yum install -y mvs-trueconfroom

sudo reboot

Для захвата изображения приложением TrueconfRoom используется эмулятор видеоисточника Lyra3.OR.AdvancedCapture2.API, которому в свою очередь необходим драйвер akvcam. Проверить, загружен ли он можно следующим образом:

lsmod | grep akvcam

akvcam                163840  3
videobuf2_vmalloc      20480  1 akvcam
videobuf2_v4l2         32768  1 akvcam
videobuf2_common       61440  4 videobuf2_vmalloc,videobuf2_v4l2,akvcam,videobuf2_memops
videodev              237568  6 videobuf2_v4l2,videobuf2_common,akvcam

Конфигурации Lyra3.OR.AdvancedCapture2.API (/etc/mvs.lyra3.or/Lyra3.OR.AdvancedCapture2.API.yml):

...
RabbitMQOptions:
  ConnectionURI: "amqp://mvslyra3or:<password>@<rabbitmq_or_server_addr>:5672/"

AkvcamOptions:
  Width: 1280
  Height: 720
  OutputDeviceIndex: 3 # /dev/video3

ServerOptions:
  ServerUri: http://<or_server_addr>:3319

Lyra3.OR.AdvancedCapture2.API получает лейаут изображения (стримов герса) из сцены сервера операционной и передает их в видеоустройство (здесь /dev/video3)

Запустить сервис:

sudo systemctl enable --now Lyra3.OR.AdvancedCapture2.API
sudo systemctl status Lyra3.OR.AdvancedCapture2.API

Запуск TrueConfRoom (приложение):

sudo systemctl enable --now mvs-trueconfroom-ui.service

В веб-интерфейсе задать пароль администратора и перезапустить приложение TrueConf Room:

sudo systemctl restart trueconf-room-web.service

Troubelshooting: приложение TrueConf Room не показывает audio источнки

Для устранения необходимо остановить pulseaudio и перезагрузить рабочую станцию

systemctl disable --user pulseaudio.service
systemctl disable --user pulseaudio.socket
sudo reboot