Установка на киоск
Пошаговая инструкция для установки программного обеспечения на компьютер киоска.
Что понадобится
- Доступ в админку системы (раздел «Устройства»).
- Компьютер с Windows 10/11.
- Яндекс Браузер или Google Chrome.
- Считыватель карт, подключённый по USB.
- Права на установку драйверов и запись на рабочий стол.
Шаг 1. Зарегистрировать киоск в админке
- Откройте админку и перейдите на страницу «Устройства».
- Нажмите «Добавить» и создайте новое устройство типа «Киоск».
- Задайте уникальный код устройства (
DeviceCode) — его будет проще запомнить, если привязать к месту установки, например:korpus-1k2
- Привяжите конфигурацию — именно она будет отображаться на экране этого киоска.
- Запишите код — он понадобится на шаге 6.
Важно. Каждый киоск должен иметь свой уникальный код.
Код в админке и в файле
kiosk-config.jsonна компьютере киоска должны совпадать.
Шаг 2. Подключить считыватель
- Подключите считыватель к USB до запуска установки.
- Убедитесь, что Windows видит устройство (Диспетчер устройств → Порты COM и LPT).
Скрипт попытается автоматически определить тип считывателя и COM-порт. Поддерживаются типы: ACS, SL500, CRT, Z2.
Шаг 3. Установить драйвер считывателя (если нужно)
Устанавливайте драйвер, только если считыватель ещё не работал на этом компьютере (ReadCard раньше не запускался или устройство не видно в системе).
- Подключите считыватель к USB.
- Откройте папку
Драйверав каталоге установки. - Отключите проверку подписанных драйверов в windows по инструкции в kiosk-install\Драйвера\Win10_DRV_z-2_rd-all
- Для Windows 10/11 используйте драйвер из:
Драйвера\Win10_DRV_z-2_rd-all\DRV_Win_All\
- Установите драйвер через Диспетчер устройств:
- правый клик по неопознанному устройству → Обновить драйвер → Выполнить поиск на этом компьютере → указать папку
DRV_Win_All.
- правый клик по неопознанному устройству → Обновить драйвер → Выполнить поиск на этом компьютере → указать папку
- После установки в Диспетчере устройств → Порты (COM и LPT) должно появиться устройство с номером порта (например,
COM3).
Если драйвер уже стоял и ReadCard ранее работал — этот шаг можно пропустить.
Шаг 4. Установить браузер
Установите один из браузеров (достаточно одного):
Скрипт установки сам найдёт браузер в стандартных папках. Если браузер установлен в нестандартное место — путь можно указать вручную (см. раздел «Если что-то пошло не так»).
Шаг 5. Настроить файл конфигурации
В папке установки откройте файл kiosk-config.json (если его нет — скопируйте kiosk-config.example.json и переименуйте).
Обязательно заполните три поля:
| Поле | Что указать | Пример |
|---|---|---|
DeviceCode |
Уникальный код из шага 1 | "korpus-1" |
ServiceUrl |
Адрес сервера приложения | "192.168.1.10" или "kiosk.example.ru" |
ServicePort |
Порт сервера | "3000" |
Пример готового файла:
{
"EnableReadCardActions": true,
"EnableBrowserShortcutActions": true,
"EnableWindowsStartupSync": true,
"ServiceUrl": "192.168.1.10",
"ServicePort": "3000",
"DeviceCode": "korpus-1"
}
Остальные поля можно не трогать — скрипт подставит их сам.
Шаг 6. Запустить установку
- Дважды щёлкните по файлу
Install-Kiosk.batв папке установки. - Дождитесь сообщения
Done.в окне. - Нажмите любую клавишу, чтобы закрыть окно.
Запускайте от имени пользователя, под которым будет работать киоск (обычно это учётная запись на рабочем столе).
Что должно получиться
После успешной установки:
| Что | Где |
|---|---|
| Папка KIOSK | Рабочий стол |
| Программа ReadCard | Рабочий стол\KIOSK\ReadCard\ |
| Ярлык браузера (режим киоска) | Рабочий стол\KIOSK\startup\Kiosk.lnk |
| Ярлык ReadCard | Рабочий стол\KIOSK\startup\ReadCard.lnk |
| Автозапуск при включении ПК | Оба ярлыка копируются в папку автозагрузки Windows |