Плагин Lamp в Media Station X (MSX) обеспечивает синхронизацию внешней подсветки с видеоконтентом на экране телевизора. Работает он через API локальных контроллеров — WLED, Philips Hue, Hyperion или Adalight — которые управляют LED-лентой за панелью. Настройка производится исключительно через JSON-конфигурацию запуска приложения, так как у MSX нет графического меню для плагинов.
Перед началом убедитесь, что контроллер подсветки прошит, подключен к той же локальной сети, что и телевизор, и отвечает на HTTP-запросы. IP-адрес устройства должен быть статическим или закрепленным по MAC-адресу в роутере, иначе при перезагрузке связь потеряется. Проверьте доступность API в браузере: введите http://IP_контроллера/json/state для WLED или аналогичный эндпоинт для других систем — должен вернуться JSON-ответ.
Подготовка и требования к оборудованию
Для работы подсветки нужна LED-лента с адресным управлением (WS2812B, SK6812, APA102) и совместимый микроконтроллер — ESP8266, ESP32 или готовый модуль типа WLED. Количество светодиодов по периметру экрана определяет нагрузку на блок питания: рассчитывайте 60 мА на диод при полном белом цвете. Для 50-дюймового телевизора обычно достаточно 3–4 метров ленты и блока на 5 В / 10–15 А.
Контроллер прошивается прошивкой WLED (рекомендуется) или ESPHome для интеграции в Home Assistant. В веб-интерфейсе WLED настройте «LED Count», «GPIO Pin» и «Color Order» (обычно GRB). Включите опцию «Realtime» → «UDP Realtime» для низкой задержки, если планируете использовать протокол DRGB или WARLS. Для MSX плагин Lamp чаще использует HTTP JSON API, поэтому UDP не обязателен, но снижает лаг.
- 🔌 Контроллер на ESP32/ESP8266 с прошивкой WLED 0.14.0+
- 📺 LED-лента SK6812 RGBW-NW для чистого белого или WS2812B для базового RGB
- ⚡ Блок питания 5 В с запасом тока 30–50% выше расчетного
- 🌐 Статический IP в локальной сети (DHCP reservation)
Добавление плагина в конфигурацию MSX
Конфигурация MSX передается через стартовый параметр start parameter в URL запуска приложения или через файл settings.json на сервере. Плагин регистрируется в массиве plugins объекта конфигурации. Минимальный фрагмент для активации выглядит так: он указывает тип контроллера и его сетевой адрес. Обратите внимание: ключ type определяет протокол общения — wled, hue, hyperion или adalight.
{
"plugins": [
{
"id": "lamp",
"type": "wled",
"host": "192.168.1.45",
"port": 80,
"zones": 1,
"capture": {
"enabled": true,
"width": 64,
"height": 36
}
}
]
}
После внесения изменений перезапустите приложение MSX на телевизоре. Откройте любой видео контент — подсветка должна среагировать на смену сцен. Если ничего не происходит, проверьте консоль разработчика (Remote Web Inspector для Tizen/webOS, ADB logcat для Android TV) на ошибки fetch к адресу контроллера. Частая причина — блокировка смешанного контента (HTTP внутри HTTPS-приложения), решается переносом MSX на локальный HTTPS или использованием http:// запуска.
| Параметр | Тип | Описание | Пример значения |
|---|---|---|---|
type |
string | Протокол контроллера | wled, hue, hyperion, adalight |
host |
string | IP-адрес или hostname контроллера | 192.168.1.45 |
port |
integer | Порт веб-интерфейса (обычно 80) | 80 |
zones |
integer | Количество зон захвата по периметру | 4 (верх, низ, лево, право) |
capture.enabled |
boolean | Включение захвата кадра | true |
Настройка параметров подключения к контроллеру
Для WLED плагин по умолчанию опрашивает эндпоинт /json/state и отправляет цвета через /json/state с полем seg. Если вы изменили порт веб-сервера в настройках WLED (Security → Web Server Port), укажите его в параметре port. Для Philips Hue требуется username (app key), полученный через процесс регистрации приложения на бридже — добавьте поле username в объект плагина. Hyperion работает через JSON-RPC на порту 19444 (по умолчанию), укажите host и port, а также priority и origin в дополнительных параметрах.
Сетевые таймауты задаются полями timeout (мс на запрос) и interval (период опроса/обновления). Значение interval ниже 50 мс дает плавность 20 FPS, но нагружает сеть и CPU телевизора. Оптимально — 80–100 мс. Если контроллер не отвечает, плагин пишет ошибку в лог и отключает захват до следующего успешного пинга. Проверьте пинг с телевизора: в терминале ADB или через встроенный браузер откройте http://IP:port.
⚠️ Внимание: На телевизорах Samsung Tizen 2018–2020 годов выпуска политика CSP (Content Security Policy) блокирует HTTP-запросы из HTTPS-приложения. Если MSX загружен по HTTPS, плагин Lamp не сможет достучаться до локального HTTP API контроллера. Решение: запускайте MSX по HTTP с локального сервера или настройте HTTPS на контроллере (WLED поддерживает TLS с версии 0.13).
Калибровка зон захвата и цветокоррекция
Параметр zones определяет, на сколько сегментов делится экран для усреднения цвета. При zones: 1 берется средний цвет всего кадра — эффект «общего свечения». При zones: 4 или 8 создается имитация Ambilight: верх, низ, стороны. Для точного соответствия физическим LED-диодам используйте объект mapping — массив объектов с координатами x, y, width, height в процентах от разрешения захвата (capture.width/height).
Цветокоррекция задается в объекте color: gamma (гамма-коррекция, обычно 2.2), saturation (насыщенность 0–2), brightness (яркость 0–1), threshold (порог отсечения темных пикселей). Если подсветка слишком агрессивно реагирует на темные сцены, повысьте threshold до 0.1–0.15. Для компенсации «выгорания» синего канала на дешевых лентах снизьте saturation до 0.8 и добавьте whiteValue при использовании RGBW лент.
- 🎯 Увеличьте
capture.width/heightдо 128x72 для детализации, но учтите нагрузку на CPU - 🌈 Настройте
gamma: 2.2для линейной воспринимаемой яркости - 🖤 Добавьте
threshold: 0.1чтобы подсветка гаслала в черных сценах - ⚪ Для RGBW лент укажите
whiteMode: "dual"в настройках WLED
Пример полного mapping для 4-зонного Ambilight 55"
[
{"x":0,"y":0,"width":100,"height":10}, // верх
{"x":0,"y":90,"width":100,"height":10}, // низ
{"x":0,"y":10,"width":10,"height":80}, // лево
{"x":90,"y":10,"width":10,"height":80} // право
]
Режимы работы и сценарии использования
Плагин поддерживает несколько режимов через параметр mode: video (захват кадра), music (аудио-визиализация через Web Audio API), static (фиксированный цвет), clock (часы/эффекты времени). Переключение режимов возможно динамически через JS API MSX: msxPlugin.call("lamp", "setMode", "music"). В режиме music плагин анализирует частотный спектр воспроизводимого аудио и генерирует эффекты на ленте — полезно для радиостанций или локальных файлов.
Для автоматического включения/выключения подсветки вместе с воспроизведением используйте события MSX onPlay, onPause, onStop в конфигурации лендинг-страницы. Пример: при старте видео вызывать setMode("video"), при паузе — setMode("static", {"color": [0,0,0]}). Это экономит ресурсы контроллера и предотвращает «мерцание» на статичных меню системного интерфейса телевизора.
Используйте режим "static" с низкой яркостью (5-10%) как ночник при просмотре ТВ в темноте — это снижает нагрузку на глаза и продлевает жизнь ленте.
Типичные ошибки и их устранение
Самая частая проблема — «подсветка не реагирует». Проверьте цепочку: MSX загружен по HTTP/HTTPS → плагин загружен (в логе Plugin lamp loaded) → запрос к контроллеру уходит (в Network tab виден GET /json/state) → контроллер отвечает 200 OK → LED меняют цвет. Если запрос уходит, но ответа нет — проверьте фаервол роутера (AP Isolation, Client Isolation) и подсеть: телевизор и ESP должны быть в одном VLAN.
Вторая проблема — «цвета инвертированы или сдвинуты». Это несоответствие Color Order в прошивке контроллера и ожиданий плагина. WLED ожидает порядок GRB для WS2812B; если лента светит красным вместо зеленого — смените порядок в веб-интерфейсе WLED (Config → LED Preferences → Color Order) на RBG, BRG и т.д. до совпадения. Третья — «лаги и дерганье»: уменьшите capture разрешение, увеличьте interval, отключите сглаживание в настройках WLED (Transitions → Transition Delay = 0).
⚠️ Внимание: Не пытайтесь запитать LED-ленту от USB-порта телевизора — ток ограничен 0.5–1 А, этого хватит только на 10–15 диодов. Перегрузка порта вызовет перезагрузку телевизора или сгорание контроллера USB. Всегда используйте отдельный блок питания с общим GND с контроллером.
☑️ Чек-лист диагностики подсветки
Обновление плагина и совместимость версий
Плагин Lamp входит в состав официального репозитория MSX и обновляется вместе с ядром приложения. Версия плагина привязана к версии MSX: если вы хостите MSX самодостаточно (self-hosted), обновите файлы plugin.lamp.js и plugin.lamp.json из репозитория msx-plugin-lamp на GitHub. Локальные копии кэшируются телевизором — после обновления сервера очистите кэш приложения (в настройках TV: Приложения → Media Station X → Очистить кэш) или измените версию в параметре запуска ?v=20260101.
Совместимость с прошивками телевизоров: Tizen 3.0+ (2017+), webOS 3.0+ (2016+), Android TV 6.0+, Fire OS 5+. На старых платформах (Tizen 2.4, webOS 2.x) WebGL-захват кадра (capture) может не работать из-за отсутствия OffscreenCanvas или ограничений CSP. В таком случае остается только режим static или управление через внешний сервер (Home Assistant, Node-RED), который сам делает скриншоты через ADB/HDMI-граббер.
Главное правило: настройка Lamp — это правка JSON-конфига MSX, а не меню телевизора. Все параметры контроллера, зон захвата и цветокоррекции задаются в объекте плагина перед запуском приложения.
Часто задаваемые вопросы
Можно ли использовать несколько контроллеров одновременно (например, WLED за ТВ и Philips Hue в комнате)?
Да, в массиве plugins можно объявить два объекта с id: "lamp" и разными type и host. Однако плагин Lamp текущей версии поддерживает только один активный экземпляр захвата. Для параллельной работы нужен кастомный форк или внешний оркестратор (Home Assistant), который дублирует команды на оба устройства.
Почему подсветка работает только в приложении MSX, а не в системном меню или HDMI-входах?
MSX — это веб-приложение, запускаемое в браузерном движке телевизора. У него нет доступа к видеобуферу системы (HDMI, встроенные тюнеры, другие приложения) из-за политики безопасности ОС. Захват кадра работает только внутри контента, воспроизводимого самим MSX (потоки, локальные файлы, IPTV). Для системного Ambilight нужен HDMI-граббер и отдельный контроллер (Hyperion, WLED с видео-входом).
Как снизить нагрузку на процессор телевизора при захвате кадра?
Уменьшите параметры capture.width и capture.height до 32x18 или 64x36. Увеличьте interval до 150–200 мс. Отключите сглаживание переходов на стороне контроллера (WLED: Transitions → Transition Delay = 0). Если телевизор мощный (2021+ год), можно оставить 128x72 при интервале 80 мс.
Поддерживает ли плагин адресную ленту SK6812 RGBW (с отдельным белым каналом)?
Да, если контроллер (WLED) настроен на тип ленты SK6812 RGBW и плагин получает корректный JSON-ответ с полем rgbw. В конфиге плагина добавьте "whiteChannel": true (если версия плагина это поддерживает) или управляйте белым каналом через настройки WLED (White Channel → "Use RGBW"). MSX плагин отправляет RGB, WLED сам микширует белый по алгоритму.
Можно ли управлять подсветкой голосом через Алису/Гугл/Сири?
Напрямую через MSX — нет, плагин не экспортирует устройство в умный дом. Но если контроллер (WLED, Hue) добавлен в Home Assistant / Яндекс Умный Дом / HomeKit, вы управляете им голосом отдельно от MSX. Сценарий: голосом включаете «режим кино» в HA, он ставит WLED в режим реального времени, MSX начинает слать цвета при старте видео.