HandyCafe Docs
owner cashier it-admin

Клієнти старих версій

HandyCafe може керувати інсталяціями клієнтів V3 і V4 поряд із сучасними клієнтами на тому самому сервері. Клієнти старих версій відображаються в Панелі адміністратора як окремий тип картки з урізаним набором дій, який відповідає можливостям оригінального протоколу.

Перш ніж клієнти старих версій з'являться в Панелі адміністратора, увімкніть підтримку виконання в Налаштування > Старі клієнти.

Як з'являються клієнти старих версій

Клієнти старих версій підключаються до сервера через оригінальний UDP multicast-протокол. Вони не використовують mDNS, як сучасні клієнти. Натомість сервер виявляє їх двома способами:

Шлях виявлення Що запускає
TCP Login Клієнт надсилає LoginRequest на TCP-порт команд. Сервер записує peer і надсилає подію підключення.
UDP Ping Клієнт транслює кадр Ping у multicast-групу. Сервер приймає його, оновлює запис peer і надсилає подію online.

Стан для кожного MAC-адресу зберігається в сховищі старих клієнтів разом із IP, ім'ям хоста, користувачем, який увійшов у систему, версією клієнта, таймерами сеансу та міткою останнього бачення. Кожен вхідний кадр скидає таймер неактивності. Якщо таймер спрацьовує без трафіку (типово 10 секунд), клієнт позначається як офлайн. Запис залишається в базі даних, щоб історія не губилася.

Картка старого клієнта

Кожен старий клієнт відображається окремою карткою, відмінною від карток сучасних клієнтів. У заголовку показуються відображуване ім'я (ім'я хоста, якщо воно є, або MAC, якщо ні), кольорова мітка online/offline і текстовий статус.

Кольори статусів і підписи

Статус Колір Значення
Online Зелений Активний сеанс працює.
Idle Блакитний Клієнт підключений і чекає. Активного сеансу немає.
Paused Бурштиновий Сеанс призупинено. Тарифікація зупинена.
Busy Фіолетовий Клієнт обробляє запит.
Payment Рожевий Клієнт перебуває у платіжному потоці.
Admin Індиго Клієнт у режимі адміністрування або обслуговування.
Offline Сірий Немає недавнього трафіку. Дії вимкнені, доки клієнт знову не вийде онлайн.
Timed Блакитно-сірий Працює обмежений за часом сеанс із дедлайном.

Годинник сеансу

Коли сеанс активний, на картці показується блок із годинником:

  • Час початку.
  • Час завершення (для сеансів із лімітом).
  • Використані хвилини.
  • Залишок хвилин із живим зворотним відліком.
  • Нарахована вартість.

Ідентифікаційна інформація

На картці завжди показуються:

  • MAC-адреса.
  • IP-адреса.
  • Версія клієнта (наприклад, "3.4.01").
  • Користувач, який увійшов у систему, якщо він є.

Панель дій

Коли клієнт онлайн, під блоком ідентифікації з'являється панель дій із доступними операціями.

Керування сеансом

Кнопка Коли видно Поведінка
Login Статус idle Відкриває діалог входу пристрою. Оберіть хвилини та спосіб оплати. Сервер надсилає команду Login з обраними значеннями. Сеанс починається на клієнті.
Logout Статус online, timed, paused, busy або payment Якщо сеанс постоплатний, діалог оплати збирає суму та спосіб. У журнал записується транзакція. Сервер надсилає команду Logout. Сеанс закривається на клієнті.

Додати час

Відкриває вибір хвилин. Приймає додатні значення (продовжити) або від'ємні (зменшити). Максимальна абсолютна величина - 10 000 хвилин у будь-який бік. Працює і для передплачених, і для постоплатних сеансів.

Якщо в налаштуваннях тарифів задані попередньо визначені значення хвилин, на картці також з'являється ряд кнопок-шаблонів. Натисніть шаблон, щоб застосувати значення без відкриття вибору.

Знімок екрана

Запитує живий знімок екрана зі старого клієнта через порт передачі файлів. Потік такий:

  1. Сервер надсилає команду запиту знімка.
  2. Клієнт відкриває короткоживучий TCP listener на еферемному порту.
  3. Сервер підключається, надсилає 9-байтовий заголовок передачі файлів і чекає.
  4. Клієнт захоплює екран, кодує його як стиснений BMP і передає назад.
  5. Сервер розпаковує BMP і зберігає його в папці legacy_screenshots у вашому каталозі даних HandyCafe.
  6. Відкривається переглядач знімків із новим зображенням.

Якщо клієнт не відповідає в межах тайм-ауту (типово 30 секунд на підключення, 20 секунд на дані), запит провалюється і з'являється повідомлення про помилку. Спробувати ще раз можна одразу.

Дії живлення

Дія Підтвердження Ефект
Logoff Немає Виводить користувача Windows із клієнтського комп'ютера. Сесія Windows завершується, але комп'ютер залишається увімкненим.
Reboot Так Надсилає команду перезавантаження. Клієнтський комп'ютер перезапускається.
Shutdown Так Надсилає команду вимкнення. Клієнтський комп'ютер вимикається.

Reboot і Shutdown показують діалог підтвердження, щоб запобігти випадковим діям живлення.

Непідтримувані операції

Старі клієнти не підтримують кожну функцію сучасних клієнтів HandyCafe. Основні відмінності:

  • Немає коригування паузи посеред сеансу. Зміни часу, надіслані під час паузи, ставляться в чергу, але клієнт може їх проігнорувати. Спочатку відновіть сеанс, застосуйте зміну, а потім за потреби знову поставте паузу.
  • Немає режиму Admin через серверну команду. Внутрішній статус адміністратора на клієнті не можна перемкнути із сервера. Режим Admin контролюється лише на самому клієнтському комп'ютері.
  • Немає реєстрації ліцензії із сервера. Сервер лише віддзеркалює байти ліцензії, які бачить у кадрах клієнта, але не може надіслати нову ліцензію на клієнт. Реєструйте клієнт локально.
  • Немає інтеграції гаманця учасника для сеансів, запущених на старих клієнтах. Платежі записуються як звичайні рядки transactions з transaction_type=sessions і MAC клієнта. Сучасні потоки гаманця тут не застосовуються.
  • Немає віддаленого робочого столу. Функція віддаленого робочого столу використовує UDP-потік, якого немає в старих клієнтах.
  • Немає push синхронізації файлів. Sync Explorer надсилає файли лише через сучасний протокол.

Для повної функціональності, коли це можливо, переходьте на сучасні клієнти HandyCafe.

Поведінка офлайн

Коли тайм-аут неактивності спливає, картка тьмяніє, мітка статусу стає сірою, а всі кнопки дій вимикаються. Запис клієнта залишається у сховищі, тож історія, MAC, ім'я хоста та дані останнього бачення зберігаються. Коли клієнт знову виходить онлайн (новий UDP ping або TCP login), картка оживає, а дії знову стають доступними.

Запис не видаляється автоматично. Щоб остаточно прибрати старий клієнт, відредагуйте його в адміністративній базі або видаліть через відповідний інструмент адміністратора.

Поради

  • Тримайте тайм-аут неактивності на рівні 10 секунд, якщо тільки ви не знаєте, що ваші старі клієнти надсилають beacon повільніше. Менший тайм-аут помилково позначає справні клієнти як офлайн під час коротких мережевих збоїв.
  • Якщо старий клієнт показується онлайн, але не реагує на команди, перевірте Protocol Variant у налаштуваннях. Невідповідність між варіантом сервера (STE vs Standard) і збіркою клієнта призводить до тихого відхилення команд.
  • Знімки екрана зі старих клієнтів зберігаються як стиснені BMP, а вони більші за сучасні PNG-захоплення. Тримайте папку legacy_screenshots на диску з достатнім вільним місцем, якщо ви робите багато знімків.
  • Використовуйте Додати час із кнопками-шаблонами під час зміни зміни. Один дотик продовжує сеанс на заздалегідь визначений крок, що швидше за ручне введення хвилин.
  • Поступово виводьте старі клієнти з експлуатації. Міграція поетапно дає змогу перевірити нові клієнти в Панелі адміністратора і лише потім вимикати старі.