Что делать, если Live Wall тормозит на проекторе

Чек-лист «всё работает»

Перед запуском убедитесь:

• ✅ Браузер обновлён до последней версии (Chrome 120+, Safari 17+, Firefox 120+, Edge 120+)
• ✅ Полноэкранный режим включён (F11 / Cmd+Ctrl+F)
• ✅ Wi-Fi или 4G стабильны (3+ Mbps достаточно)
• ✅ Ноутбук не в режиме энергосбережения (или подключён к зарядке)
• ✅ Разрешение проектора 1920×1080 (Full HD) — оптимально

Если всё это проверено и проблемы остались — ниже разбор по симптомам.

Чёрный экран при загрузке

Симптомы: открыли URL, видите чёрный фон, ничего не появляется через 10+ секунд.

Причины:

• LiveWall выключен в настройках альбома → откройте weshot.io/albums/<slug>/settings → раздел Live Wall → переключатель должен быть включён.
• Альбом приватность «по приглашению» без выданного токена → раздел «Кто видит ваши фото».
• Браузер заблокировал JavaScript → разрешите JS для домена weshot.io.

Тормозит, переходы дёргаются

Симптомы: фото меняются с заметными лагами, Ken Burns эффект «прыгает».

Причины:

• Слабый ноутбук (< 4 ГБ RAM) → закройте все остальные вкладки и приложения.
• Высокое разрешение проектора (4K и выше) на бюджетной графике → переключите проектор на 1080p в настройках macOS / Windows.
• Включён режим энергосбережения → подключите зарядку, выключите Battery Saver.
• Параллельно открыта Я.Метрика / Hotjar / другая аналитика → закройте.

Как срочно ускорить:

• Поменяйте переход на Crossfade (самый лёгкий) в настройках Live Wall.
• Уменьшите скорость до 8–10 секунд на кадр (даёт браузеру передышку между анимациями).
• Выберите макет Hero или Split (Mosaic тяжелее, потому что показывает 6 фото).

Новые фото не появляются

Симптомы: гости загружают, на проекторе старые кадры.

Причины:

• Polling каждые 8 секунд — это нормальная задержка. Подождите 10-15 секунд после загрузки.
• Браузер ушёл в background tab (Chrome агрессивно ограничивает фоновые вкладки) → держите Live Wall во вкладке на переднем плане в полноэкранном режиме.
• Не работает интернет на ноутбуке → проверьте ping weshot.io в терминале.

Live Wall не использует WebSocket — он опрашивает сервер каждые 8 секунд (см. AGENTS.md). Это сделано для стабильности на нестабильных Wi-Fi event-залов. Минус — небольшая задержка появления контента.

Текст пожеланий выходит за края

Симптомы: длинное пожелание не помещается в карточку, обрезается.

Причины:

• Слишком длинный текст для текущего макета → пожелания ограничены 280 символами на стороне сервера, но при крупном шрифте могут не вместиться.
• Стиль карточки Polaroid имеет фиксированный размер → переключитесь на Paper или Bubble — они авторазмерные.

QR-код не сканируется

Симптомы: телефон не распознаёт QR с проектора.

Причины:

• Проектор размытый или плохо настроен → QR требует чёткости. Проверьте фокус.
• Слишком далеко → QR на проекторе размером ~30×30 см распознаётся с расстояния до 5 метров. Если зал больше — увеличьте размер QR в настройках.
• Свет на проектор → задерните шторы или ослабьте свет вокруг экрана.

Аварийный план

Если ничего не помогло за 5 минут до начала события:

1. Откройте альбом просто как страницу — weshot.io/<slug> на проекторе вместо Live Wall. Не настолько красиво, но фото и пожелания тоже видны.
2. Используйте слайдшоу из macOS / Windows — скачайте десяток лучших фото вручную, запустите штатное слайдшоу. Live Wall можно подключить позже.
3. Напишите в саппорт прямо в моменте — support@weshot.io или Telegram @weshot_support. На событиях стараемся отвечать в течение 10 минут в рабочее время.

И главное — не забывайте, что проектор это дополнение к событию, а не его сердце. Гостям важнее быть вместе, чем смотреть на красивый экран.