Руководство пользователя SoftPlayer

Извлечь SoftPlayer на целевую машину и убедиться, что среда соответствует требованиям.

1. Убедитесь, что целевая машина работает под управлением Windows 10/11 x64.
2. Извлеките пакет SoftPlayer в постоянную директорию, например C:\SoftPlayer\.
3. Убедитесь, что директория содержит SoftPlayer.exe, appsettings.json и структуру поддиректорий SoftPlayerMedia\.
4. Для воспроизведения видео 8K убедитесь, что машина имеет GPU с поддержкой аппаратного декодирования (GTX 1060+ или эквивалент); 4K и ниже работает на интегрированной графике.

• SoftPlayer.exe виден в извлечённой директории.
• Директория SoftPlayerMedia\ предварительно создана с поддиректориями: Video, StandBy, Audio, PPT и др.

• Разместите SoftPlayer по стабильному пути — медиафайлы, логи и состояние лицензии сохраняются относительно директории программы.
• Рекомендуется хранилище SSD со скоростью чтения 200 МБ/с+ для более плавного воспроизведения высокого разрешения.

Убедиться, что программа запускается корректно, и завершить первоначальную настройку.

1. Дважды щёлкните SoftPlayer.exe для запуска (права администратора не требуются).
2. При первом запуске программа открывает руководство по быстрому старту в браузере по умолчанию (только при первом запуске; последующие запуски пропускают этот шаг).
3. После прочтения руководства откройте http://localhost:8766/ в браузере для доступа к консоли управления.
4. На вкладке Dashboard убедитесь, что статус плеера нормальный, и что видны версия и информация о лицензии.

• Браузер успешно открывает консоль управления (http://localhost:8766/) и показывает Dashboard.
• Номер версии и статус лицензии видны в заголовке консоли.

Для отключения руководства при первом запуске установите System.ShowQuickStartOnFirstRun в false в appsettings.json.

Успешно управлять плеером через UDP и убедиться в работе канала управления.

1. Поместите видеофайл (например, test.mp4) в директорию SoftPlayerMedia\Video\.
2. Откройте PowerShell и выполните следующие команды:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. Наблюдайте, начнёт ли окно SoftPlayer воспроизводить указанное видео.

• Окно SoftPlayer начинает воспроизводить указанный видеофайл.
• Вкладка Log в консоли управления показывает, что команда получена.

• Видеофайл помещён в неправильную директорию (должен быть в SoftPlayerMedia\Video\, а не в корневой директории программы).
• Неверный порт (по умолчанию 7600, а не порт консоли управления 8766).

Освоить формат команд и понять успешные и неудачные ответы.

1. Формат команды: команда:аргумент, например video:show.mp4 или volume:80.
2. Команды без аргумента можно отправить просто как имя команды (двоеточие необязательно), например play.
3. Формат успешного ответа: OK:исходная-команда, например OK:video:show.mp4.
4. Формат ответа об ошибке: ERR:исходная-команда:сообщение-об-ошибке.
5. Для путей к медиафайлам нужно только имя файла — плеер автоматически ищет в соответствующей поддиректории: video: ищет в SoftPlayerMedia/Video/.

• Ответ с префиксом OK после отправки команды подтверждает правильный формат и выполнение.
• Ответ ERR включает конкретную причину (файл не найден, ошибка формата и т.д.).

Для указания поддиректории используйте косую черту: video:subfolder/video.mp4 ищет в SoftPlayerMedia/Video/subfolder/.

Освоить все команды, связанные с воспроизведением видео.

1. Воспроизведение локального видео: video:filename.mp4 (ищет в директории Video).
2. Воспроизведение сетевого видеопотока: webvideo:URL (поддерживает HTTP/HTTPS/RTSP/RTMP/UDP потоки).
3. Воспроизведение/возобновление: play: (возобновить паузу медиа).
4. Пауза: pause: (приостановить текущее медиа).
5. Остановка и возврат к заставке: stop: (возврат к экрану приветствия / циклу заставки).
6. Полная остановка / чёрный экран: stoped: (энергосберегающий чёрный экран).
7. Повторное воспроизведение текущего медиа: replay:.
8. Управление прогрессом: seek:миллисекунды (перейти к позиции), forward: (перемотка на 10 с вперёд), backward: (перемотка на 10 с назад).
9. Скорость воспроизведения: speed:1.5 (поддерживает 1.5x, 2.0x и т.д.).

• После команды video: плеер начинает воспроизводить указанный файл.
• После команды stop: возвращается к экрану заставки (если файл заставки настроен).

• Для длительного режима заставки на выставках используйте standby: для цикличного воспроизведения файла заставки, а не stoped: с чёрным экраном (чёрный экран может заставить посетителей думать, что устройство сломано).
• stop и stoped имеют разную семантику: stop возвращается к экрану приветствия; stoped показывает чистый чёрный экран.

Освоить команды управления громкостью и воспроизведением аудио.

1. Установить громкость (0-100): volume:80 (устанавливает точное значение).
2. Увеличить громкость на 10%: volup: (увеличивает на 10% за вызов).
3. Уменьшить громкость на 10%: voldown: (уменьшает на 10% за вызов).
4. Переключить отключение звука: mute: (переключение между выключенным и включённым звуком).
5. Явно отключить звук: muteon:.
6. Явно включить звук: muteoff:.
7. Воспроизвести аудиофайл: audio:filename.mp3 (ищет в SoftPlayerMedia/Audio/).
8. Остановить аудио: audiostoped:.

• После volume:50 громкость плеера снижается до 50%.
• mute: переключается между звуком и тишиной.

Освоить команды цикличного списка, PPT-разбивки на страницы и загрузки веб-страниц.

1. Цикличное воспроизведение плейлиста: listloop:file1.mp4;file2.mp4;file3.mp4 (разделяйте файлы точками с запятой).
2. Последовательное воспроизведение (остановка в конце): liststop:filename.
3. Следующий трек: next:, Предыдущий трек: prev:.
4. Открыть PPT в полноэкранном режиме: ppt:filename.pptx (ищет в SoftPlayerMedia/PPT/).
5. Навигация по PPT: ppt:next (следующий слайд), ppt:prev (предыдущий), ppt:home (первый), ppt:end (последний).
6. Переход к слайду: ppt:goto-5 (переход к странице 5).
7. Автоматическое пролистывание PPT: ppt:auto-5-filename.pptx (автоматическое пролистывание каждые 5 секунд).
8. Загрузить веб-страницу: web:URL (отображение указанного URL в полноэкранном режиме).

• После команды listloop: плеер циклически воспроизводит перечисленные файлы.
• ppt:next переводит PPT к следующему слайду.

• PPT-файлы должны быть помещены в SoftPlayerMedia/PPT/ перед отправкой команд.
• Для PDF-файлов команда переходит в окно просмотра с имитацией нажатия клавиш для разбивки на страницы.
• Используйте listloop для сценариев цикличного воспроизведения на выставках вместо ручной отправки отдельных команд.

Понять команды маски и системного уровня.

1. Показать наложение маски: openmask: (накладывает слой маски на видео).
2. Скрыть наложение маски: closemask:.
3. Установить поведение после окончания воспроизведения: endbehavior:Stop / Loop / Standby.
4. Получить версию: version: (ответ включает информацию о текущей версии).
5. Перезапустить плеер: restart: (удалённый перезапуск процесса плеера).

• После openmask: на видео появляется наложение маски.
• После version: получен ответ с информацией о версии.

Знать правильное расположение для каждого типа медиафайлов.

1. SoftPlayerMedia/Video/ — видеофайлы (.mp4/.mkv/.avi и др.), используются командой video:.
2. SoftPlayerMedia/StandBy/ — файлы заставки, используются командой standby: и циклом по умолчанию.
3. SoftPlayerMedia/Audio/ — аудиофайлы (.mp3/.wav/.flac и др.), используются командой audio:.
4. SoftPlayerMedia/BackgroundAudio/ — фоновое аудио, автоматически зацикливается при включении.
5. SoftPlayerMedia/PPT/ — файлы PPT/PDF, используются командой ppt:.
6. SoftPlayerMedia/Mask/ — изображения маски, используются командой openmask:.
7. SoftPlayerMedia/Thumbnail/ — директория кэша эскизов (автогенерируется, ручные файлы не нужны).

• После помещения видео в Video/ команда video:filename корректно его воспроизводит.
• Структура директории создаётся автоматически при первом запуске — ручная настройка не нужна.

Ежедневно управлять медиафайлами через браузерную консоль управления.

1. Откройте http://IP-плеера:8766/ в браузере для доступа к консоли управления.
2. Нажмите верхнюю навигацию для переключения на вкладку Files.
3. Выберите целевую директорию (Video / StandBy / Audio / PPT и т.д.).
4. Нажмите Upload для выбора файлов или перетащите файлы в область загрузки.
5. Поддерживается создание папок, переименование, удаление файлов/папок и загрузка файлов.
6. Файлы поддерживают до 3 уровней вложенных директорий; при загрузке выбирайте текущую директорию.

• Только что загруженный файл появляется в списке файлов после загрузки.
• Команда video:filename успешно воспроизводит только что загруженный файл.

• Консоль использует Basic Auth — настройте имя пользователя/пароль в appsettings.json.
• Лимит загрузки одного файла по умолчанию — 500 МБ, настраивается в файле конфигурации.
• Обслуживающий персонал на месте может загружать заменяющий контент через консоль без RDP.

Понять правила пробного периода и правильно спланировать время приобретения лицензии.

1. 30-дневный пробный период начинается автоматически при первом запуске SoftPlayer.
2. Все функции доступны в течение пробного периода, включая воспроизведение высокого разрешения и все UDP-команды.
3. Проверьте оставшиеся дни пробного периода на вкладке Dashboard консоли управления.
4. После окончания пробного периода для продолжения использования необходимо импортировать лицензионный код.

• Dashboard консоли управления показывает текущий статус пробного периода и оставшиеся дни.
• Команды отвечают нормально в течение пробного периода без ограничений функций.

• Используйте пробный период для завершения тестирования и приёмки до официальной сдачи проекта.
• Приобретите лицензию до окончания пробного периода, чтобы избежать простоя выставки.

Выбрать правильный уровень лицензии в зависимости от реальных потребностей выставки в разрешении.

1. Лицензия Standard: поддерживает до 4K разрешения (3840×2160).
2. Лицензия Professional: поддерживает до 16K разрешения (15360×8640).
3. Требования к оборудованию для 4K: Intel i3+, 8 ГБ ОЗУ, интегрированная графика (дискретный GPU не нужен).
4. Требования к оборудованию для 8K: Intel i5 8-го поколения+, 16 ГБ ОЗУ, GTX 1060+.
5. Требования к оборудованию для 16K: Intel i7+, 32 ГБ ОЗУ, RTX 3070+.
6. Если неясно, какой уровень нужен, используйте пробный период для проверки фактических требований к разрешению перед покупкой.

• Уровень лицензии соответствует максимальному разрешению устройства отображения в проекте.
• Конфигурация серверного оборудования соответствует минимальным требованиям для целевого разрешения.

Компьютеры без дискретного GPU могут воспроизводить 4K и ниже (программа автоматически переключается на программное декодирование), но 8K/16K требуют соответствующего дискретного GPU.

Импортировать лицензионный код для перехода с пробной версии на полную.

1. Найдите поле Device ID на Dashboard консоли управления и скопируйте его.
2. Предоставьте ID устройства поставщику, указав требуемый уровень (Standard/Professional).
3. После получения лицензионного кода перейдите на вкладку Configuration в консоли и найдите раздел License Management.
4. Вставьте лицензионный код в поле ввода и нажмите Import License.
5. После успешного импорта статус лицензии на Dashboard меняется с Trial на Standard или Professional.

• Dashboard консоли управления показывает статус полной версии (Standard или Professional).
• Воспроизведение видео высокого разрешения больше не ограничено.

• Применение лицензионного кода на неправильном устройстве (коды привязаны к устройству; новая машина требует нового кода).
• Ожидание окончания пробного периода перед подачей заявки на лицензию, что вызывает простой выставки.

Восстановить канал управления UDP-командами.

1. Убедитесь, что SoftPlayer запущен (виден в панели задач или диспетчере задач).
2. Убедитесь, что порт в команде соответствует настройке UdpPort в appsettings.json (по умолчанию 7600).
3. Проверьте, разрешает ли брандмауэр Windows входящий UDP-трафик на порт 7600.
4. Если включён белый список IP (IpWhitelistEnabled: true), убедитесь, что IP отправителя находится в AllowedIps.
5. Проверьте вкладку Log консоли управления на наличие записей о получении команд, чтобы подтвердить, доходят ли команды до плеера.

• Логи консоли управления показывают записи о получении команд, подтверждая работу UDP-канала.
• Отправка volume:50 изменяет громкость плеера.

• Сначала тестируйте с 127.0.0.1 (localhost) для исключения сетевых проблем перед использованием реального IP.
• При отправке из SoftControl убедитесь, что протокол UDP-команды SoftControl и порт соответствуют конфигурации SoftPlayer.

Диагностировать и устранить сбои воспроизведения медиафайлов.

1. Убедитесь, что видеофайл находится в SoftPlayerMedia\Video\ (а не в корневой директории программы).
2. Имена файлов чувствительны к регистру — убедитесь, что имя в команде точно соответствует реальному имени файла, включая расширение.
3. Для файлов в поддиректориях укажите относительный путь: video:subfolder/video.mp4.
4. Перейдите на вкладку Files в консоли управления, чтобы убедиться, что файл действительно существует.
5. Для необычных форматов файлов проверьте логи консоли управления на наличие сообщений об ошибках VLC.
6. Попробуйте открыть тот же файл непосредственно в VLC Player на этой машине, чтобы исключить повреждение файла.

• Целевой файл виден в списке файлов консоли управления.
• Имя файла в команде точно соответствует отображаемому в списке файлов.

• Имя файла в команде содержит полноширинные пробелы или символы, вызывая ошибку «файл не найден».
• Несоответствие регистра расширения файла (например, команда использует .MP4, но файл действительно .mp4).

Устранить проблемы производительности воспроизведения видео высокого разрешения.

1. Сначала подтвердите текущий уровень лицензии: Standard поддерживает только 4K; Professional поддерживает 16K.
2. Проверьте, поддерживает ли GPU аппаратное декодирование (для 8K требуется GTX 1060+ или эквивалент).
3. В диспетчере задач на вкладке Performance проверьте загрузку декодирования GPU — близко к 100% указывает на узкое место GPU.
4. Проверьте требования к скорости чтения с диска: 4K требует 25-50 Мбит/с, 8K требует 80-100 Мбит/с, 16K требует 200+ Мбит/с.
5. Храните видеофайлы высокого разрешения на SSD, чтобы избежать узких мест чтения HDD.
6. Для настройки параметров VLC см. встроенную документацию (docs\User Manual.html) в директории программы.

• Уровень лицензии соответствует требуемому разрешению воспроизведения.
• Конфигурация оборудования соответствует минимальным требованиям для целевого разрешения.

Восстановить доступ к браузерной консоли управления.

1. Убедитесь, что SoftPlayer запущен.
2. Сначала попробуйте http://localhost:8766/ локально, чтобы исключить сетевые проблемы.
3. Проверьте appsettings.json, убедитесь, что HttpMonitor.Enabled равно true и порт 8766.
4. Проверьте, разрешает ли брандмауэр Windows TCP-трафик на порт 8766.
5. Если порт занят другой программой, измените HttpMonitor.Port в appsettings.json и перезапустите.

• Браузер может получить доступ к http://localhost:8766/ и отображает консоль управления.
• Dashboard консоли управления показывает статус работы плеера.