up

docs/USER_GUIDE.md

@@ -58,26 +58,27 @@ Windows 11, macOS 13+, Ubuntu 24.04 LTS или Debian 13. Эти требова
    Нажмите «Войти». Пароль вводите только в приложении, не отправляйте в отчёты.
 2. При необходимости нажмите «Обновить список игр» и выберите игру
    в поле «Выберите игру для подготовки».
-3. Нажмите «Загрузить материалы». Дождитесь завершения; при необходимости
-   используйте «Отменить загрузку». Не выезжайте с незавершённой загрузкой.
-4. В отдельном блоке **«Материалы показа» выберите подготовленную игру**.
-   Загрузка и выбор игры на сервере сами по себе не выбирают пакет для показа.
-   Статусы игр отображаются как «Черновик», «Идёт», «Пауза», «Завершена».
-   Сообщение «Тестовый режим: синтетические аудио и видео» означает, что игровая
-   копия не выбрана.
-5. Откройте показ, проверьте изображения, вступление, видео и плейлисты.
-   Отключите сеть и повторите пробный показ. Затем перезапустите приложение
-   без сети и убедитесь, что выбранная игра доступна.
+3. Нажмите «Подключить выбранную игру». Она станет игрой показа, даже если ещё
+   не подготовлена на этом компьютере. Отдельно скачивать полный пакет не требуется.
+4. Приложение получает состояние экрана и музыки раз в секунду, сначала скачивает
+   нужные сейчас файлы, затем остальные материалы игры и связанные плейлисты.
+   Связь и подготовка продолжаются при закрытом показе. Прогресс виден в пульте.
+   При ошибке доступна кнопка «Повторить подготовку»; уже сохранённые файлы остаются.
+5. Откройте показ вручную. Приложение применит текущую серверную сцену и музыку,
+   включая воспроизведение. До готовности нового файла прежнее содержимое канала
+   сохраняется. Все медиа читаются только с локального диска.
+6. Перед выездом дождитесь полной подготовки без ошибок и проверьте игру без сети.
+   «Материалы показа» позволяет выбирать ранее сохранённые игры и тестовый режим.
+   Офлайн доступны только фактически скачанные файлы.
 
 Если ОС не предоставляет защищённое хранилище, приложение предупреждает:
 вход действует до закрытия приложения, но материалы сохраняются. После перезапуска
 для серверного управления потребуется повторный вход; локальный пакет доступен офлайн.
 
-Для обновления материалов закройте показ, выберите игру на сервере и нажмите
-«Проверить изменения», затем явно «Загрузить материалы». Если файл заменили
-по прежнему адресу, проверка изменений может этого не заметить — загрузите
-материалы повторно. Новый плейлист тоже требует подготовки. Ошибка или отмена
-обновления сохраняет прежнюю готовую копию.
+Новые адреса материалов и изменения плейлистов автоматически подготавливаются
+во время показа. Если заменили содержимое файла по прежнему адресу, для
+принудительной загрузки закройте показ и нажмите «Загрузить материалы».
+Ошибка или отмена ручного обновления сохраняет прежний полный пакет.
 
 ## Проведение показа
 
@@ -95,7 +96,9 @@ Windows 11, macOS 13+, Ubuntu 24.04 LTS или Debian 13. Эти требова
 режим, текст, надпись и длительность таймера. «Сохранить план» отправляет план
 на сервер; «Отменить» возвращает сохранённый вариант. Для удаления всего плана
 нажмите «Удалить план», затем «Сохранить план». При ошибке сохранения черновик
-остаётся в редакторе. Изменения черновика и сохранение сами не меняют проектор.
+остаётся в редакторе. Изменения черновика и сохранение сами не меняют проектор. Публикация текста
+кнопкой «Показать текст» использует подходящий текстовый шаг общего плана
+или добавляет новый, поскольку сервер передаёт произвольный текст через план.
 
 План общий с сайтом. При параллельных правках последнее сохранение
 заменяет его целиком. Во время редактирования фоновое обновление не меняет
@@ -106,8 +109,8 @@ Windows 11, macOS 13+, Ubuntu 24.04 LTS или Debian 13. Эти требова
 локально сразу. При наличии связи действие отправляется на сервер для остальных
 привязанных экранов. Без сети показ продолжается по последней копии; статус
 предупреждает о неподтверждённом обновлении. Офлайн-команды не накапливаются:
-восстановление связи само не меняет проектор и не отправляет прошлые переходы.
-Следующее действие онлайн снова управляет общим планом.
+после восстановления связи принимается текущее серверное состояние. Прошлые
+локальные переходы на сервер не отправляются.
 
 ### Вступление, видео и музыка
 
@@ -148,39 +151,37 @@ Windows 11, macOS 13+, Ubuntu 24.04 LTS или Debian 13. Эти требова
 
 ## Связь с сервером
 
-1. Войдите и выберите готовую игру в «Материалы показа».
-2. Проверьте строку «Игра для управления»: это название локально выбранного
-   пакета, независимо от игры в списке загрузки выше. Нажмите «Подключить управление
-   этой игрой»; запишите показанный номер экрана.
-   Откройте показ и дождитесь «Связь с сервером есть».
-3. Откройте существующую страницу управления этой игрой на сайте.
-   При необходимости назначьте звук экрану через сайт или кнопку
-   «Назначить звук этому экрану». Это отключает звук других экранов игры
-   по существующим правилам сервера. Статус назначения звука показывается отдельно
-   от локального переключателя «Выключить весь звук». До подтверждения сервером
-   назначение неизвестно; при закрытом показе или потере связи отображается
-   последнее подтверждённое состояние.
-4. Отправьте новую команду. Первое состояние после подключения, открытия окна
-   или восстановления связи не повторяет старые команды.
+Подключите выбранную игру кнопкой в «Игра и сервер». Для ранее сохранённой игры
+можно использовать «Подключить управление этой игрой». Проверьте название
+в строке «Игра для управления» и номер экрана. Подготовка файлов не требует
+открытого показа; само окно автоматически не открывается.
 
-Опрос сервера идёт раз в секунду при открытом показе. Быстрые команды между
-опросами могут объединяться. Локальные команды компьютера действуют только
-на его показ и не рассылаются другим экранам. Новая команда сервера может
-изменить локальный показ. «Отключить управление» прекращает управление приложением,
-но сохраняет привязку экрана на сервере. Для отвязки используйте сайт.
-При отсутствии интернета пользуйтесь локальным пультом.
+Приложение постоянно принимает изменения сцены, текста, таймера и музыки.
+Первый ответ после подключения, открытия окна или восстановления сети применяется
+как текущее состояние сервера. Одинаковая версия не запускает медиа повторно.
+Команды локального пульта при доступной сети отправляются на сервер и относятся
+ко всем привязанным экранам. Выключение всего звука остаётся локальной настройкой.
+
+Назначение звука экрану меняется отдельно через сайт или «Назначить звук этому
+экрану». Оно отключает звук остальных экранов по правилам сервера. При отсутствии
+связи отображается последнее подтверждённое назначение.
+
+Без сети продолжайте локально. После её возврата серверное состояние заменяет
+локальное; накопленные локальные действия не отправляются. Точная синхронизация
+позиций ограничена данными существующего API. «Отключить управление» прекращает
+получение состояний, но не удаляет привязку экрана на сервере.
 
 ## Сбои и восстановление
 
 | Ситуация | Действия ведущего |
 | --- | --- |
-| Нет сети | Продолжайте локально. После возврата сети дождитесь связи и отправьте новую команду через сайт. |
+| Нет сети | Продолжайте локально. После возврата сети приложение примет текущие экран и музыку сервера. |
 | Проектор отключился, изменилось разрешение или произошёл сон | Прочитайте причину в пульте, восстановите дисплей/выход звука, выберите внешний экран и явно откройте показ. Медиа остановлены, работающий таймер сохранён на паузе. |
 | Нет звука | Проверьте выход и mute ОС, кабель/USB/HDMI, «Выключить весь звук», громкость канала, открытое окно и статус проигрывателя. Для серверных команд проверьте назначение звука экрану. |
 | Ошибка подготовки сцены | Проверьте сообщение и нажмите «Повторить подготовку». При повторении проверьте пакет до продолжения игры. |
 | Пакет повреждён или отсутствует файл | При доступной сети закройте показ и загрузите материалы заново. Для удаления выберите другой пакет или тестовый режим, затем «Удалить материалы» у нужной игры. Без сети восстановить отсутствующие байты нельзя. |
 | Истёк вход или сессия экрана | Повторно войдите или подключите управление по сообщению пульта. Готовые материалы остаются на диске. |
-| Приложение перезапущено | Выбранная игра и сохранённые результаты восстанавливаются. Откройте показ и запустите нужные медиа/таймер явно; их текущее выполнение не восстанавливается. |
+| Приложение перезапущено | Выбранная игра и сохранённые результаты восстанавливаются. Откройте показ вручную: онлайн применяется текущее состояние сервера, офлайн запускайте медиа локально. |
 | Пульт пуст или зависает при запуске | Запишите ОС, версию, симптомы и сообщения запуска, передайте отчёт. Не считайте такой запуск успешным. |
 
 При открытом показе приложение запрашивает блокировку автоматического сна,