В качестве мобильного терминала оператора может использоваться переносное устройство на базе OC «Android» с возможностью чтения NFC карт . установленным на него с установленным приложением «Game-Keeper mobile terminal». Предназначен для списания средств с карты гостя Game-Keeper на аттракционах и отображения информация о балансе карты. Гостевые карты должны быть бесконтактные MiFare, смартфон с модулем NFC для чтения таких карт. Аттракционы в данном случае заводятся в БД GK как услуги. На терминале происходит списание очков-денег с карты GK по правилу и стоимости Для возможности использования мобильного терминала гостевые карты должны быть бесконтактные стандарта Mi-Fare. Приложение позволяет в разных режимах работы производить списания за услуги, запускать и останавливать тарификации, отображать информацию по карте. Списание очков-денег с карты осуществляется согласно правилам установленными в приложении «Редактор». Технология реализована на базе Microsoft Web Server IIS и инструментах платформы .Net Core.
Рис. 1 Мобильный терминал/приложение Game-Keeper mobile terminal
ОГЛАВЛЕНИЕ:
| Оглавление |
|---|
Схема взаимодействия
Состав дистрибутива
Папка с WEB-сервером pda1 находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\api.int\pda1\.
...
Для удобства настройки и навигации необходимо создать папку WEB в корне папки GK и скопировать в неё pda1 и gkExtServer. Если на объекте уже используют используется gkExtServer для других похожих технологий GK, например, для gkAPI, то папку для нашего текущего gkExtServer перед копированием необходимо переименовать:.
Также в В состав дистрибутива также входит установочный пакет для разворачивания на самом мобильном терминале.
...
Для установки необходимо подключить терминал к компьютеру интерфейсным кабелем, скопировать на него установочный пакет app-release.apk и запустить. После установки на рабочем столе появится соответствующий ярлык для запуска приложения.3.
Установка и настройка gkExtServer
В папке с модулями gkExtServer, настраиваем конфигурационный файл gkExtServer.ini:.
[DbConnect] – связь с gkPosServer
Port = 50300 – порт gkPosServer
ServerName = 127.0.0.1 – ip-адрес, где запущен gkPosServer
...
Запустить службу gkExtServer:
4.
Настройка подключения web-сервиса pda1
Настройка заключается в конфигурировании файла gkconfig.json.
...
"host": "127.0.0.1", - ip-адрес, где запущен gkExtServer
"port": "50302", - порт gkExtServer для pda1
}5.
Установка платформы .Net Core
Установка осуществляется по документу в текущем разделе "Приложение 1 - Установка платформы .Net Core"6.
Установка и настройка Microsoft Web Server IIS
Установка осуществляется по документу в текущем разделе "Приложение 2 - Установка и настройка Microsoft Web Server IIS"
В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.
...
Вводим имя сайта, в нашем случае это pda1, указываем физический путь к папке pda1, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0.
7. Настройки в приложении «Редактор»
В справочнике «Ценовые категории» создаем категорию, в нашем примере «Велопрокат», делаем ее активной:
В справочнике «Товары и услуги» создаем подгруппу, в нашем примере «Прокаты», делаем ее активной.
Далее в этой подгруппе создаем услугу, в нашем примере «Велопрокат». Делаем ее активной, в поле код указываем цифру аналогично полю ID, Применение выбираем тип «Услуга», выбираем ценовую категорию, созданную ранее «Велопрокат». Важно!!! В поле «Примечание» вписываем параметр &PDAID=1. Это нужно, чтобы услуги с таким параметром отображались на мобильном терминале оператора. Здесь 1 – любая произвольная цифра, которая присваивается конкретному терминалу. Например, у нас есть 3 мобильных терминала оператора и есть некоторый набор оказываемых услуг. Нам нужно, чтобы на каждом терминале отображались лишь определенные услуги и причем разные. Для этого мы в поле «Примечание» для услуг, которые должны отображаться на первом терминале ставим &PDAID=1, на втором терминале &PDAID=2, на третьем терминале &PDAID=3. То есть здесь эти параметры являются идентификаторами самих мобильных терминалов. В настройках на самом терминале дальше мы будем указывать именно их!!!
Настройки в приложении Редактор.
| Якорь | ||||
|---|---|---|---|---|
|
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 раза пальцем, откроется меню для конфигурации приложения.Заполняем поле HOST, где запустить приложение 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 Выбор режима работы
Выбираем Режим работы (Work mode). Может принимать 2 значения: продажа услуг (т.е. разовая оплата) или Прокат (для тарификаций).
...
Заключение
Для возможности использования данного функционала необходимо приобрести лицензию на модуль «Game-Keeper мобильный терминал».
С пользовательским описанием Мобильного терминала можно ознакомиться по ссылке.