Устройства и адаптеры
Empty state и первый запуск
Заголовок раздела «Empty state и первый запуск»
Если bridge уже видит Bluetooth-адаптер, но ни одной колонки ещё не настроено, dashboard показывает Scan for devices. Этот shortcut теперь переводит прямо в Configuration → Devices → Discovery & import и сразу запускает сканирование.
Если же адаптер вообще не найден, empty state предлагает Add adapter, открывает Configuration → Bluetooth, создаёт пустую строку адаптера и ставит фокус в первое поле.
Добавление колонки
Заголовок раздела «Добавление колонки»
Рекомендуемый сценарий такой:
- Откройте Configuration → Devices.
- Нажмите Scan в карточке Discovery & import.
- В результатах выберите Add или Add & Pair.
- Заполните имя плеера и дополнительные поля.
- Сохраните конфиг и при необходимости выполните перезапуск.
Поведение сканирования
Заголовок раздела «Поведение сканирования»- Сканирование идёт в фоне и интерфейс периодически опрашивает результат.
- Найденные устройства можно сразу добавить в fleet table.
- Add & Pair выполняет pairing/trust/connect до добавления строки в конфиг.
- После завершения сканирования кнопка уходит в cooldown и не даёт спамить повторные попытки.
Already paired
Заголовок раздела «Already paired»Блок Already paired позволяет импортировать устройства, которые хост уже знает, без повторного сканирования.
Таблица Device fleet
Заголовок раздела «Таблица Device fleet»Device fleet — основное место для управления колонками.
| Колонка | За что отвечает |
|---|---|
| Enabled | Временно исключает устройство из запуска |
| Player name | Имя в Music Assistant |
| MAC | Bluetooth-адрес |
| Adapter | Привязка к конкретному контроллеру |
| Port | Пользовательский sendspin listener port |
| Delay | static_delay_ms |
| Live | Runtime badge из работающего bridge |
| Remove | Удаление строки из конфига |
При раскрытии строки появляются advanced-поля: preferred format, listen host и keepalive interval.
Порты, host и keepalive на уровне устройства
Заголовок раздела «Порты, host и keepalive на уровне устройства»В v2.40.5 текущий device-flow использует такие network/runtime-поля:
| Поле | Текущее поведение |
|---|---|
listen_port | Если задан, устройство всегда использует именно этот порт |
listen_host | Переопределяет advertised host/address для listener’а этого устройства |
keepalive_interval | Любое положительное значение включает keepalive-тишину; всё меньше 30 секунд поднимается до 30 |
keepalive_silence | Legacy-совместимое поле из старых addon-конфигов; отдельного переключателя для него в текущем web UI больше нет |
Если listen_port пуст, runtime использует BASE_LISTEN_PORT + индекс устройства. Каждый эффективный listener port должен быть уникальным. Для multi-bridge setups на одном хосте либо задавайте разный диапазон BASE_LISTEN_PORT для каждого bridge, либо указывайте явные listen_port для всех колонок.
listen_host полезен в первую очередь там, где Music Assistant должен подключаться к bridge по адресу, отличному от автоопределённого.
Управление адаптерами
Заголовок раздела «Управление адаптерами»
Во вкладке Bluetooth доступны:
- понятные имена адаптеров,
- ручные adapter entries,
- refresh detection,
- policy-параметры восстановления,
- переключатель Prefer SBC codec.
Привязка колонки к адаптеру
Заголовок раздела «Привязка колонки к адаптеру»В поле Adapter можно указывать:
hci0,hci1и т.д.,- или MAC-адрес адаптера.
Использование MAC особенно удобно в LXC-окружениях, где имя hciN может меняться после перезагрузки.
Глубокие ссылки из dashboard
Заголовок раздела «Глубокие ссылки из dashboard»Dashboard теперь возвращает вас в точное место редактирования, а не просто открывает общий раздел:
- Шестерёнка устройства → подсвечивает нужную строку в Configuration → Devices.
- Shortcut/gear адаптера → подсвечивает нужную строку в Configuration → Bluetooth.
- Бейдж группы → открывает соответствующие настройки группы в Music Assistant в новой вкладке.
Режимы сетки и списка
Заголовок раздела «Режимы сетки и списка»Один и тот же fleet можно просматривать в двух layout’ах:
- Режим сетки для небольшого числа устройств.
- Режим списка для больших fleet’ов, с sortable columns и expandable rows.
По умолчанию bridge переключается в режим списка, если видно больше 6 устройств, но ваш ручной выбор запоминается в браузере и используется при следующем открытии.
Re-pair, Release и Reclaim
Заголовок раздела «Re-pair, Release и Reclaim»Из dashboard доступны такие действия:
| Действие | Когда использовать |
|---|---|
| Reconnect | Нужно принудительно переподключить BT без правки конфига |
| Re-pair | Pairing/trust state на хосте сломано или устарело |
| Release | Нужно временно вернуть колонку телефону или ПК |
| Reclaim | Нужно снова отдать Bluetooth-управление bridge |
Release не удаляет устройство из конфига — bridge просто перестаёт активно его переподключать до нажатия Reclaim.
Политика reconnect и auto-disable
Заголовок раздела «Политика reconnect и auto-disable»Во вкладке Bluetooth есть два параметра, которые напрямую влияют на доступность устройств:
- BT check interval задаёт частоту проверки и попыток Bluetooth-восстановления.
- Auto-disable threshold может сохранить устройство в disabled-состоянии после серии неудачных reconnect.
Если колонка постоянно флапает, bridge может auto-disable её, чтобы защитить остальную группу. После устранения причины Bluetooth-проблемы включите устройство снова в Configuration → Devices.
Delay tuning и keepalive
Заголовок раздела «Delay tuning и keepalive»Для сложных колонок особенно полезны такие поля:
static_delay_ms— компенсация различий Bluetooth-латентности при групповом воспроизведении.keepalive_interval— периодическая тишина, чтобы некоторые колонки не засыпали между треками.keepalive_silence— legacy-boolean из старых addon-конфигов; сейчас keepalive фактически управляется черезkeepalive_interval > 0.preferred_format— уменьшает ресэмплинг или нагрузку CPU в зависимости от настроек MA.