HandyCafe Docs
owner it-admin

Как настроить рабочий стол клиента

Это руководство проведет вас через создание меню приложений, которое видят клиенты на своих ПК, применение визуальных тем, настройку экрана ожидания и публикацию анонсов. Все изменения на сервере мгновенно отправляются на подключенные клиенты через TCP.


Как создать меню приложений

Меню приложений используется клиентами во время сессии. Оно организовано в категории, каждая из которых содержит одно или несколько приложений. Управление каталогом осуществляется с сервера.

Что вам понадобится

  • HandyCafe Server с подключенным хотя бы одним клиентом.
  • Исполняемые файлы приложений, уже установленные на клиентских ПК (для типов Game и App).
  • Изображения для иконок (PNG, JPG или WebP). Рекомендуемый размер 128x128 пикселей.

Шаги

  1. Откройте приложение HandyCafe Server и перейдите в Настройки в боковом меню.
  2. Выберите вкладку Клиенты, затем переключитесь на подвкладку Контент.
  3. В панели Категорий слева нажмите кнопку Добавить категорию.
  4. Введите название категории, например «Игры» или «Браузеры», и подтвердите. Новая категория появится в списке.
  5. Выберите только что созданную категорию. В правой панели нажмите Добавить приложение.
  6. Заполните данные приложения. Введите Название (например «Counter-Strike 2»), необязательное Описание и задайте Тип: Game, Browser, Link, File или App.
  7. В поле Путь к исполняемому файлу введите полный путь к приложению на клиентском ПК. Например: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Для типа Link введите URL.
  8. Загрузите иконку, нажав на область иконки. Вы можете вставить URL для получения изображения из интернета или выбрать локальный файл на вашей машине. Иконка отображается в сетке приложений на клиенте.
  9. По желанию загрузите Изображение постера для более насыщенной визуальной карточки. Это крупное изображение, показываемое в режимах отображения с приоритетом постера. Также можно включить переключатель Карусель Hero для размещения приложения во вращающемся баннере в верхней части рабочего стола клиента.
  10. Перетаскивайте элементы в списке категорий или приложений для изменения порядка. Переключатель видимости рядом с приложением позволяет скрыть его без удаления. Нажмите Сохранить по завершении.

Ожидаемый результат

Все подключенные клиентские рабочие столы обновятся в течение нескольких секунд. Новая категория и приложения появятся в сетке приложений клиента. Клиенты смогут запускать приложения нажатием на их карточки.

Распространенные ошибки

  • Ввод пути, не существующего на клиентском ПК. Карточка приложения появится, но запуск не сработает. Всегда проверяйте путь к исполняемому файлу на реальной клиентской машине.
  • Забыли сохранить после внесения изменений. Несохраненные правки не отправляются на клиенты.
  • Использование слишком больших изображений без сжатия. Любое разрешение допустимо, но изображения более 512x512 замедляют синхронизацию без визуального преимущества при размере карточки.

Как задать тему рабочего стола

Темы управляют общим видом клиентского рабочего стола во время активной сессии. Вы выбираете цветовую тему, пресет макета, плотность карточек и настройки фона.

Что вам понадобится

  • HandyCafe Server запущен.
  • Для фонов с изображениями или видео: медиафайлы в формате PNG, JPG, WebP, MP4 или WebM.

Шаги

  1. Перейдите в Настройки > Клиенты > вкладка Внешний вид.
  2. В разделе Тема выберите одну из доступных цветовых тем: Neon Arena (сине-фиолетовая игровая эстетика), Crimson Pulse (красно-темные тона) или Emerald Depth (зелено-бирюзовая палитра). Предпросмотр обновляется при выборе.
  3. В разделе Пресет макета выберите расположение контента на экране. Варианты: Split Classic (категории слева, приложения справа), Hero Wide Top (крупная карусель hero вверху, приложения внизу), Catalog Wide Bottom (компактный hero, широкая сетка приложений) или Compact Focus (минимум элементов, максимум места для приложений).
  4. Задайте Плотность карточек для управления количеством приложений на экране. Large показывает крупные карточки с большим количеством деталей. Medium балансирует размер и количество. Compact вмещает максимум приложений в ряд.
  5. Настройте Фон. Выберите тип: Сплошной (выберите цвет), Градиент (выберите два цвета), Изображение (загрузите файл) или Видео (загрузите MP4/WebM). Для типов Изображение и Видео настройте ползунок Непрозрачность наложения для затемнения фона за карточками и ползунок Размытие для смягчения изображения.
  6. Нажмите Сохранить. Тема немедленно отправляется на все подключенные клиенты.

Ожидаемый результат

Клиентские рабочие столы обновятся с новыми визуальными настройками. Тема, макет, размеры карточек и фон обновляются без перезапуска клиентов.

Распространенные ошибки

  • Использование видеофона со слишком большим размером файла. Ограничьте видео до 20 МБ для быстрой синхронизации. Длинные или высококачественные видео вызывают заметную задержку загрузки на клиентских ПК.
  • Слишком низкая непрозрачность наложения на насыщенном фоновом изображении. Текст и подписи карточек становятся трудночитаемыми. Наложение 40-60% подходит для большинства изображений.

Как настроить экран ожидания

Экран ожидания показывается клиентам когда ПК не используется. Он может отображать слайд-шоу из изображений или видео, часы и название вашего кафе.

Что вам понадобится

  • Файлы изображений (PNG, JPG, WebP или GIF) или видеофайлы (MP4, WebM) для слайд-шоу.
  • HandyCafe Server запущен.

Шаги

  1. Перейдите в Настройки > Клиенты > вкладка Экран ожидания.
  2. Включите переключатель Включить слайд-шоу.
  3. Нажмите Добавить медиа для загрузки изображений или видео. Можно добавить несколько элементов. Поддерживаемые форматы: PNG, JPG, WebP, GIF, MP4 и WebM.
  4. Установите Длительность для каждого элемента в секундах. Это определяет как долго каждый слайд виден перед переходом. Значение между 8 и 15 секундами подходит для большинства установок.
  5. Выберите эффект Перехода: Fade (плавное затухание), Slide (горизонтальное скольжение) или Zoom (эффект масштабирования).
  6. Включите переключатель Наложение часов для отображения цифровых часов на экране ожидания. Используйте палитру для выбора цвета текста часов, обеспечивающего максимальный контраст с вашим слайд-шоу.
  7. Включите переключатель Название кафе для отображения названия вашего заведения на экране ожидания. Название берется из общих настроек сервера.
  8. Нажмите Сохранить. Конфигурация экрана ожидания отправляется на все подключенные клиенты.

Ожидаемый результат

Клиентские ПК без активной сессии отображают слайд-шоу с настроенными переходами, наложением часов и названием кафе. Слайд-шоу воспроизводится в цикле.

Распространенные ошибки

  • Добавление слишком многих изображений высокого разрешения без учета времени синхронизации. Каждый медиафайл должен быть передан на каждый клиент. Поддерживайте общий размер слайд-шоу разумным.
  • Слишком малая длительность (менее 3 секунд). Быстрые переходы могут выглядеть резко и затруднять чтение текста на слайдах.
  • Отсутствие проверки цвета часов на всех изображениях слайд-шоу. Белые часы невидимы на ярком белом слайде. Выберите цвет, подходящий для всего набора слайдов.

Как создать анонс

Анонсы появляются на клиентских рабочих столах для продвижения мероприятий, публикации новостей или отображения рекламы. Система автоматически отслеживает показы и клики.

Что вам понадобится

  • HandyCafe Server с подключенным хотя бы одним клиентом.
  • Баннерное изображение (рекомендуемый размер 1200x400 пикселей или шире) для визуального анонса.

Шаги

  1. Перейдите в Настройки > Клиенты > вкладка Контент.
  2. Прокрутите до раздела Анонсы ниже категорий приложений.
  3. Нажмите Добавить анонс.
  4. Введите Заголовок и Текст анонса. При необходимости ссылки на внешнюю страницу введите URL в поле Ссылка.
  5. Задайте Тип. Выберите Announcement для общих новостей, Event для ограниченных по времени акций с интерактивными полями формы или Text для простых текстовых сообщений.
  6. Задайте Категорию для классификации: Link, Game, Announcement или Ad. Это определяет где анонс отображается в клиентском макете.
  7. Загрузите Баннерное изображение, нажав на область изображения и выбрав файл. Баннер отображается в полосе анонсов на клиентском рабочем столе. Нажмите Сохранить.

Ожидаемый результат

Анонс появляется на подключенных клиентских рабочих столах в полосе анонсов. По мере просмотра и взаимодействия клиентов сервер отслеживает Количество показов (сколько раз анонс был отображен) и Количество кликов (сколько раз клиент нажал на него).

Распространенные ошибки

  • Создание анонсов без баннерного изображения. Текстовые анонсы без изображения легко пропускаются клиентами в полосе анонсов.
  • Забыли установить срок действия или удалить устаревшие анонсы. Старые акции, оставленные активными, создают негативное впечатление.
  • Использование слишком длинного текста. Область отображения компактна. Текст должен быть кратким, а подробности размещены по ссылке.