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) или новее».
После перезагрузки в главном меню появляется плитка «Музыка».


Как включить музыку с iPhone (AirPlay)
- Телефон в Wi‑Fi больницы (той же сети, что и Vidicap).
- Откройте «Пункт управления» (смахните от правого верхнего угла вниз), нажмите значок AirPlay на карточке музыки.
- Выберите имя операционной, например «Vidicap Операционная 3». Имя видно на странице «Музыка» справа, под «Имя в телефоне».
- Включите музыку в любом приложении — она играет из колонок операционной.
На экране Vidicap видно, с какого телефона играет музыка, название песни, исполнителя и обложку альбома (с модуля 1.1.1). Кнопки ◀◀ / ▶ / ▶▶ ставят паузу и листают песни прямо на телефоне.
Когда программа Vidicap закрывается (выключение, перезапуск, Alt+F4 в тестовом режиме), музыка останавливается: приёмник AirPlay и радио выключаются, телефон по Bluetooth отключается (с модуля 1.1.2).
Обложку присылает сам iPhone по AirPlay, вместе с песней; Vidicap ничего не ищет в интернете. Если у песни нет обложки (радио в приложении, своя запись), слева от названия ничего нет, как раньше. По Bluetooth и в интернет-радио обложек нет: телефоны Android по Bluetooth их почти никогда не передают. Обложка хранится только на самом Vidicap, пока играет песня, и никуда не отправляется.


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

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


iPhone тоже подключается по Bluetooth так же — удобно, если в операционной нет Wi‑Fi.
Интернет-радио
Без телефона: на странице «Музыка» справа откройте вкладку «Радио» и нажмите станцию. Она играет из колонок операционной, на экране слева — название станции и, если станция его передаёт, текущая песня.
- ▶▶ / ◀◀ — следующая и предыдущая станция, ❚❚ — пауза, «Выключить радио» — выключить.
- Громкость и приглушение во время разговора — те же, что для музыки с телефона.
- Если телефон начинает играть по AirPlay или Bluetooth, радио выключается само: телефон важнее.
- Если связь со станцией пропала, Vidicap переподключается сам; на экране написано «нет связи с радиостанцией — проверьте интернет».
Станции в модуле: Radio Swiss Classic, Radio Swiss Jazz, Radio Swiss Pop, FIP, SomaFM Groove Salad, SomaFM Secret Agent — без рекламы и разговоров, удобно для операционной.


Свои станции (например, местное радио) добавляет техник в терминале, от пользователя программы, затем перезапускает программу:
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) →