В качестве мобильного терминала оператора может использоваться переносное устройство на базе OC «Android» с возможностью чтения NFC карт с установленным приложением «Game-Keeper mobile terminal». Для возможности использования мобильного терминала гостевые карты должны быть бесконтактные стандарта Mi-Fare. Приложение позволяет в разных режимах работы производить списания за услуги, запускать и останавливать тарификации, отображать информацию по карте. Списание очков-денег с карты осуществляется согласно правилам установленными в приложении «Редактор». Технология реализована на базе Microsoft Web Server IIS и инструментах платформы .Net Core.
Схема взаимодействия
Состав дистрибутива
Папка с WEB-сервером pda1 находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\api.int\apiPda1\.
Для удобства настройки и навигации необходимо создать папку WEB в корне папки GK и скопировать в неё apiPda1.
В состав дистрибутива также входит установочный пакет для разворачивания на самом мобильном терминале.
Для установки необходимо подключить терминал к компьютеру интерфейсным кабелем, скопировать на него установочный пакет 2.25.MobiTer.apk и запустить. После установки на рабочем столе появится ярлык для запуска приложения.
Настройка подключения web-сервиса apiPda1
Настройка заключается в конфигурировании файла appsettings.json.
Содержимое файла appsettings.json:
{
"GKPosServer": {
"Url": https://127.0.0.1:50301 - ip-адрес, где запущен gkPosServer, 50301 – PortH из gkPosServer.ini
},
"Logging": {
"LogLevel": {
"Default": "Warning"
}
},
"AllowedHosts": "*"
}
Установка платформы .Net Core
Установка и настройка Microsoft Web Server IIS
Установка и настройка Microsoft Web Server IIS
В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.
Вводим имя сайта, в нашем случае это apiPda1, указываем физический путь к папке apiPda1, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0.
Настройки в приложении «Редактор»
В справочнике «Ценовые категории» создаем категорию, в нашем примере «Велопрокат», делаем ее активной.
В справочнике «Товары и услуги» создаем подгруппу, в нашем примере «Прокаты», делаем ее активной.
Далее в этой подгруппе создаем услугу, в нашем примере «Велопрокат». Делаем ее активной, в поле код указываем цифру аналогично полю ID, в поле Применение выбираем тип «Услуга», выбираем ценовую категорию, созданную ранее «Велопрокат». Важно!!! В поле «Примечание» вписываем параметр &PDAID=1. Это необходимо, чтобы услуги с таким параметром отображались на мобильном терминале оператора. Здесь 1 – любая произвольная цифра, которая присваивается конкретному терминалу. Например, у нас есть 3 мобильных терминала оператора и есть набор оказываемых услуг. Нам нужно, чтобы на каждом терминале отображались лишь определенные услуги и причем разные. Для этого мы в поле «Примечание» для услуг, которые должны отображаться на первом терминале ставим &PDAID=1, на втором терминале &PDAID=2, на третьем терминале &PDAID=3. То есть здесь эти параметры являются идентификаторами самих мобильных терминалов. В настройках на самом терминале дальше необходимо указывать именно их!!!
Далее в справочнике «Уровни и правила» для уровня Стандартный создаем правило, где указываем ценовую категорию, в которой создана наша услуга «Велопрокат», период действия правила, стоимость услуги, меняем статус на Активен.
Настройки мобильного приложения «Game-Keeper mobile terminal»
На смартфоне запускаем ярлык «Game-Keeper mobile terminal». Для перехода в меню конфигурации приложения необходимо 6 (шесть) раз нажать на сером поле в центре экрана.
Заполняем поле HOST, где указываем ip-адрес сервера, где находится вэб-сервис apiPda1 и его порт в следующем формате:
http://172.22.172.22:8082
Заполняем поле POS ID (ID точки продажи в Game-Keeper), ставим значение аналогичное значению в параметре &PDAID=1.
Выбираем Режим работы (Work mode). У терминала может быть два режима работы: Продажа услуг (т.е. разовая оплата) или Прокат (для запуска и остановки тарификаций).
Заключение
Для возможности использования данного функционала необходимо приобрести лицензию на модуль «Game-Keeper мобильный терминал».