В качестве мобильного терминала оператора может использоваться переносное устройство на базе OC «Android» с возможностью чтения NFC карт с установленным приложением «Game-Keeper mobile terminal». Для возможности использования мобильного терминала гостевые карты должны быть бесконтактные стандарта Mi-Fare. Приложение позволяет в разных режимах работы производить списания за услуги, запускать и останавливать тарификации, отображать информацию по карте. Списание очков-денег с карты осуществляется согласно правилам установленными в приложении «Редактор». Технология реализована на базе Microsoft Web Server IIS и инструментах платформы .Net Core.
Рис. 1 Мобильный терминал/приложение Game-Keeper mobile terminal
ОГЛАВЛЕНИЕ:
Схема взаимодействия
Состав дистрибутива
Папка с WEB-сервером pda1 находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\api.int\pda1\.
Папка с gkExtServer находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\gkExtServer\.
Для удобства настройки и навигации необходимо создать папку WEB в корне папки GK и скопировать в неё pda1 и gkExtServer. Если на объекте уже используется gkExtServer, например, для gkAPI, то папку для текущего gkExtServer перед копированием необходимо переименовать.
В состав дистрибутива также входит установочный пакет для разворачивания на самом мобильном терминале.
Для установки необходимо подключить терминал к компьютеру интерфейсным кабелем, скопировать на него установочный пакет app-release.apk и запустить. После установки на рабочем столе появится ярлык для запуска приложения.
Установка и настройка gkExtServer
В папке с модулями gkExtServer, настраиваем конфигурационный файл gkExtServer.ini.
[DbConnect] – связь с gkPosServer
Port = 50300 – порт gkPosServer
ServerName = 127.0.0.1 – ip-адрес, где запущен gkPosServer
[Settings]
ServiceName=pda1 – имя службы gkExtServer (будет отображаться в службах Windows)
HttpPort=50302 – порт gkExtServer
POSID=999
LogLevel=5
;Mode=1
Далее необходимо проинсталлировать службу gkExtServer, запустив через командную строку с ключом /install. Для удобства инсталляции службы в папке с gkExtServer.exe имеется install.bat, который необходимо запустить от имени Администратора. Предварительно в тексте файла необходимо отредактировать путь к gkExtServer.exe.
Запустить службу gkExtServer:
Настройка подключения web-сервиса pda1
Настройка заключается в конфигурировании файла gkconfig.json.
Содержимое файла:
{
"host": "127.0.0.1", - ip-адрес, где запущен gkExtServer
"port": "50302", - порт gkExtServer для pda1
}
Установка платформы .Net Core
Установка и настройка Microsoft Web Server IIS
Установка и настройка Microsoft Web Server IIS
В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.
Вводим имя сайта, в нашем случае это pda1, указываем физический путь к папке pda1, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0.
Настройки в приложении Редактор.
1. В справочнике Зоны, вкладка Терминалы, добавьте мобильный терминал (на каждый терминал отдельная запись) (см. Рис. 1). ID терминала необходимо будет указать в настройках приложения Game-Keeper mobile terminal , в поле POS ID.
Рис. 1 Справочник Зоны/вкладка Терминалы
2. В справочнике Зоны, вкладка Свойства зоны, создайте новую зону или выберите существующую. В поле Примечание укажите ID мобильных терминалов доступных для использования в формате &PDAID=1;&PDAID=2, где 1 и 2 - номер мобильного терминала (№ мобильного терминала=ID терминала) (см. Рис. 2).
Рис. 2 Справочник Зоны/Свойства зоны.
3. В справочнике Ценовые категории создаем новую категорию, делаем ее активной (см. Рис. 3).
ис. 3 Справочник Ценовые категории
4. В справочнике Товары и услуги создаем подгруппу, делаем ее активной (см. Рис. 4).
Рис. 4 Справочник Товары и услуги/вкладка Свойства...
5. Далее в этой подгруппе создаем услугу (см. Рис. 5):
- ID – уникальный идентификационный номер, присваивается автоматически.
- Наименование – любое наименование, в примере Велопрокат;
- Код – указываем цифру аналогично полю ID (в примере 10231);
- Статус – Активен;
- Примечание – в данном случае не заполняем;
- Применение – Услуга;
- Ценовая категория – выбрать ранее созданную ценовую категорию Велопрокат.
- Кассы – отметить галочками все кассы на которых должна быть доступна продажа созданной услуги, в нашем случае обязательно выбрать Мобильный терминал.
Рис. 5 Справочник Товары и услуги/вкладка Товары и услуги
6. В справочнике Уровни и правила для уровня Стандартный создаем правило, где указываем ценовую категорию, в которой создана наша услуга Велопрокат, период действия правила, стоимость услуги, меняем статус на Активен (см. Рис. 6).
Настройки мобильного приложения «Game-Keeper mobile terminal»
1. На смартфоне запустить приложение Game-Keeper mobile terminal.
2. Для перехода в меню настроек приложения необходимо на экране ввода логина 7 раз кликнуть по активному полю (см. Рис. 7).
Рис. 7 Область для вызова меню настроек
3. На экране откроется диалоговое окно: "Внимание! Вы пытаетесь открыть окно настроек. Случайные изменения, сделанные в настройках, могут нарушить работоспособность приложения. Продолжить?". Для продолжения нажмите ДА, для отмены нажмите НЕТ.
4. В открывшемся меню Настройки необходимо заполнить (см. Рис. 8):
- HOST – указываем ip-адрес сервера, где находится вэб-сервис pda1 и его порт в следующем формате: http://172.22.172.22:8082;
- POS ID – данные берём из ID терминала заведённого в Редакторе (см. п. Зоны/закладка Терминалы).
- Режим работы (Work mode) – выбор зависит от схемы работы парка, в данном случае выбираем Продажа услуг (см. Рис. 9).
Рис. 8 меню Настройки
Рис. 9 Выбор режима работы
Заключение
Для возможности использования данного функционала необходимо приобрести лицензию на модуль «Game-Keeper мобильный терминал».
С пользовательским описанием Мобильного терминала можно ознакомиться по ссылке.