Vidicap Cloud

← Guides for technicians

Music in the operating room (add-on module: AirPlay and Bluetooth)

Музыка в операционной (доп. модуль: AirPlay и Bluetooth)

Бригада включает свою музыку с телефона, и она играет из колонок операционной через Vidicap. Подходит любой телефон:

  • iPhone, iPad, Mac — по AirPlay, как на любую колонку Apple: «Пункт управления» → значок AirPlay → имя операционной.
  • Android и iPhone — по Bluetooth: один раз подключить телефон с экрана Vidicap, дальше он подключается сам.
  • Интернет-радио — без телефона: вкладка «Радио» на экране Vidicap, станция включается одним нажатием.

Играет любое приложение: Spotify, Apple Music, YouTube Music, Яндекс Музыка, файлы на телефоне. Пауза, следующая песня и громкость — и на телефоне, и на экране Vidicap.

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

Где Что нужно
Vidicap Touch 2.0 (Ubuntu 24.04) программа 2.14.0 и новее, затем установка модуля
Vidicap Touch 1.0 (Ubuntu 18.04) программа 1.18.0 и новее (обновляется с экрана: «Платформа» → «Программа устройства»), затем установка модуля

Обе ревизии умеют одно и то же. AirPlay в обеих — первой версии (AirPlay 1): все iPhone, iPad и Mac играют на него; нельзя только одновременно играть одну песню в нескольких комнатах (это AirPlay 2).

Что нужно из оборудования

  • Колонки на аудиовыход компьютера Vidicap: активные колонки или саундбар на гнездо 3,5 мм, USB-колонки, или звук монитора по HDMI (обычно тихий). Это те же колонки, через которые слышен консультант по голосовой связи.
  • Сеть для AirPlay: телефон и Vidicap в одной сети (Wi‑Fi больницы и сеть операционной). Если гостевой Wi‑Fi отделён от сети оборудования, попросите IT разрешить между ними mDNS (Bonjour, UDP 5353) и порты AirPlay (TCP 5050, UDP 6001–6011) — иначе Vidicap не появится в списке AirPlay.
  • Интернет для радио: Vidicap должен выходить в интернет (HTTPS, порт 443, и HTTP, порт 80). Телефоны по AirPlay и Bluetooth интернет от Vidicap не требуют.
  • Bluetooth: встроенный в компьютер или USB-адаптер Bluetooth (любой, с поддержкой Linux; 10–15 $). Без адаптера работает только AirPlay, на экране написано «нет адаптера».

Установка

Как любой дополнительный модуль (инструкция «Дополнительные модули: установка с экрана Vidicap»):

  • Vidicap Touch 2.0: «Настройки» → «Платформа» → «Доп. модули» → «Музыка (AirPlay и Bluetooth)» → «Установить модуль» → «Перезагрузить устройство».
  • Vidicap Touch 1.0: кнопка «Платформа» → «Проверить обновления» → «Доп. модули» → «Музыка (AirPlay и Bluetooth)» → «Установить модуль» → «Точно? Нажмите ещё раз» → «Перезагрузить устройство».
  • Без платформы: файл vidicap-module-music-<версия>.zip на флешке, тот же блок «Доп. модули» → «С флешки»; или техник в терминале: unzip vidicap-module-music-1.0.0.zip && sudo ./vidicap-module-music/install-module.sh, затем sudo reboot.

Ничего докачивать не нужно: на Touch 2.0 приёмник AirPlay (shairport-sync) и Bluetooth ставятся вместе с программой 2.14.0, на Touch 1.0 приёмник AirPlay лежит в самом модуле, а Bluetooth и звук уже есть в Ubuntu 18.04. На устройстве с более старой программой экран вместо установки пишет «Сначала обновите программу устройства до 1.18.0 (2.14.0) или новее».

После перезагрузки в главном меню появляется плитка «Музыка».

Vidicap Touch 2.0: главное меню с плиткой «Музыка»

Vidicap Touch 1.0: главное меню с плиткой «Музыка»

Как включить музыку с iPhone (AirPlay)

  1. Телефон в Wi‑Fi больницы (той же сети, что и Vidicap).
  2. Откройте «Пункт управления» (смахните от правого верхнего угла вниз), нажмите значок AirPlay на карточке музыки.
  3. Выберите имя операционной, например «Vidicap Операционная 3». Имя видно на странице «Музыка» справа, под «Имя в телефоне».
  4. Включите музыку в любом приложении — она играет из колонок операционной.

На экране Vidicap видно, с какого телефона играет музыка, название песни, исполнителя и обложку альбома (с модуля 1.1.1). Кнопки ◀◀ / ▶ / ▶▶ ставят паузу и листают песни прямо на телефоне.

Когда программа Vidicap закрывается (выключение, перезапуск, Alt+F4 в тестовом режиме), музыка останавливается: приёмник AirPlay и радио выключаются, телефон по Bluetooth отключается (с модуля 1.1.2).

Обложку присылает сам iPhone по AirPlay, вместе с песней; Vidicap ничего не ищет в интернете. Если у песни нет обложки (радио в приложении, своя запись), слева от названия ничего нет, как раньше. По Bluetooth и в интернет-радио обложек нет: телефоны Android по Bluetooth их почти никогда не передают. Обложка хранится только на самом Vidicap, пока играет песня, и никуда не отправляется.

Vidicap Touch 2.0: играет музыка с iPhone по AirPlay

Vidicap Touch 1.0: играет музыка с iPhone по AirPlay

Как подключить Android (Bluetooth)

Первый раз — с экрана Vidicap, потом телефон подключается сам.

  1. На странице «Музыка» нажмите «Подключить телефон». Кнопка станет оранжевой: «Vidicap виден телефонам: 2:00» — две минуты Vidicap виден в списке Bluetooth.
  2. На телефоне: «Настройки» → «Bluetooth» → в списке доступных устройств выберите имя операционной («Vidicap Операционная 3»). PIN не нужен.
  3. Телефон подключён — он появляется в списке «Телефоны Bluetooth», Vidicap снова скрывается. Включите музыку.

Vidicap Touch 1.0: Vidicap виден телефонам две минуты

В следующий раз достаточно включить Bluetooth на телефоне и выбрать Vidicap — подключать с экрана заново не нужно. Новый телефон Vidicap принимает только две минуты после «Подключить телефон»: посторонний телефон из коридора к колонкам операционной не подключится.

Чтобы убрать телефон из списка (сменился сотрудник, потерян телефон) — «Забыть» рядом с ним.

Vidicap Touch 2.0: музыка с Android по Bluetooth

Vidicap Touch 1.0: музыка с Android по Bluetooth

iPhone тоже подключается по Bluetooth так же — удобно, если в операционной нет Wi‑Fi.

Интернет-радио

Без телефона: на странице «Музыка» справа откройте вкладку «Радио» и нажмите станцию. Она играет из колонок операционной, на экране слева — название станции и, если станция его передаёт, текущая песня.

  • ▶▶ / ◀◀ — следующая и предыдущая станция, ❚❚ — пауза, «Выключить радио» — выключить.
  • Громкость и приглушение во время разговора — те же, что для музыки с телефона.
  • Если телефон начинает играть по AirPlay или Bluetooth, радио выключается само: телефон важнее.
  • Если связь со станцией пропала, Vidicap переподключается сам; на экране написано «нет связи с радиостанцией — проверьте интернет».

Станции в модуле: Radio Swiss Classic, Radio Swiss Jazz, Radio Swiss Pop, FIP, SomaFM Groove Salad, SomaFM Secret Agent — без рекламы и разговоров, удобно для операционной.

Vidicap Touch 2.0: интернет-радио

Vidicap Touch 1.0: интернет-радио

Свои станции (например, местное радио) добавляет техник в терминале, от пользователя программы, затем перезапускает программу:

vidicap-music station add "Радыё Беларусь" https://адрес-потока
vidicap-music station remove "Радыё Беларусь"

Адрес потока — ссылка на сам поток (MP3, AAC; http или https), а не на сайт станции. На экране видно до 10 станций: свои идут после встроенных. Если сеть больницы закрывает внешние сайты, попросите IT открыть адреса нужных станций.

Громкость и приглушение

  • «Громкость музыки» — ползунок и кнопки − / +. Меняет громкость только музыки: голос консультанта остаётся таким же громким. Громкость на самом телефоне тоже работает.
  • «Когда говорит консультант или ассистент» — насколько тише становится музыка, пока идёт голосовая связь с операционной или Vidicap Assistant слушает команду (по умолчанию 25 % от обычной громкости; 0 % — музыка замолкает). Пока музыка приглушена, на странице написано «Тише: идёт разговор».
  • «Отключить телефон» — музыка с этого телефона перестаёт играть здесь (если, например, кто-то забыл выключить музыку и ушёл). Телефон может подключиться снова.

Если музыка играет сразу с двух телефонов (один по AirPlay, другой по Bluetooth), звучат оба; на экране показан тот, что по AirPlay. Новый телефон по AirPlay перебивает прежний.

Настройки для техника

  • AirPlay / Bluetooth — кнопки вверху справа включают и выключают каждый способ. Под названием — состояние: «работает», «нет приёмника», «нет адаптера», «выключен».
  • Имя в телефоне берётся из названия точки на платформе («Vidicap» + название точки); без платформы — «Vidicap» + имя компьютера. Своё имя можно задать в терминале: vidicap-music name "Операционная 3" (от пользователя программы), затем перезапустить программу.
  • Состояние в терминале: vidicap-music — приёмник AirPlay, адаптер Bluetooth, подключённые телефоны, потоки музыки и их громкость.
  • Настройки хранятся в ~/.local/share/vidicap/music/music.json пользователя программы, журнал приёмника AirPlay — airplay.log там же.
  • Отключить модуль, не удаляя: vidicap-music off и перезапуск программы; удалить: sudo ./install-module.sh --remove.

Неполадки

Что видно Что сделать
Vidicap нет в списке AirPlay на iPhone Телефон и Vidicap в одной сети? Проверьте на странице «Музыка»: под «AirPlay» должно быть «работает». В гостевом Wi‑Fi попросите IT пропустить mDNS (UDP 5353) и порты TCP 5050, UDP 6001–6011. На Touch 2.0 должна работать служба avahi-daemon (systemctl status avahi-daemon).
Под «AirPlay» всё время «запуск…» Порт занят приёмником, который остался от прошлого запуска программы (модули до 1.1.2 не выключали его при выходе). С модуля 1.1.3 такой приёмник останавливается сам. Если не помогло, причина в последней строке airplay.log (~/.local/share/vidicap/music/) и в журнале программы: airplay: shairport-sync exited with ….
Под «AirPlay» написано «нет приёмника» Touch 2.0: программа старше 2.14.0 — обновите программу (она ставит пакет shairport-sync). Touch 1.0: модуль поставлен не полностью — поставьте заново.
Под «Bluetooth» — «нет адаптера» Вставьте USB-адаптер Bluetooth и перезапустите программу. Проверка: bluetoothctl show должен показать Controller.
Телефон по Bluetooth подключается, но звука нет На телефоне в настройках Bluetooth у Vidicap должен быть включён «Звук мультимедиа». Touch 1.0: пакет pulseaudio-module-bluetooth (есть в Ubuntu 18.04 по умолчанию). Touch 2.0: пакет libspa-0.2-bluetooth (ставится с программой 2.14.0).
Музыку не слышно, хотя на экране играет Громкость на странице «Музыка» и на самом телефоне; колонки включены и подключены к тому выходу, что выбран в системе.
«нет связи с радиостанцией — проверьте интернет» Есть ли у Vidicap интернет (curl -I https://stream.srg-ssr.ch)? Сеть больницы может закрывать внешние адреса — попросите IT открыть адреса станций. Своя станция: проверьте адрес потока.
Нет обложки альбома (iPhone по AirPlay) Модуль «Музыка» должен быть 1.1.1 или новее, после обновления модуля перезапустите программу. На iPhone отключитесь от Vidicap в AirPlay и подключитесь снова: телефон заново узнаёт, что Vidicap принимает обложки. Обложку присылает приложение: у радио и некоторых записей её нет. В журнале программы видно airplay: cover … bytes на каждую присланную обложку.
Кнопки ◀◀ / ▶ / ▶▶ серые Телефон не дал управлять воспроизведением — управляйте с телефона. По AirPlay iPhone даёт управлять почти всегда, некоторые приложения на Android — нет.

← VR (test): Vidicap as a pass-through device (add-on module) Room systems: lighting, climate, power (add-on module, LogicMachine) →