Настройки вывода пользовательской информации на второй монитор

Для настройки вывода пользовательской информации на второй монитор необходимо:

  1. Установить пакет artix-view командой:

    aptitude install artix-view

    Файлы, необходимые для функционирования приложения artix-view будут расположены в директории /linuxcash/cash/view/.

  2. В конфигурационном файле /linuxcash/cash/view/config/view.ini задать настройки для обмена данными с кассой.

    НаименованиеТип данныхОписаниеПримечания

    port

    		строковый

    Порт для обмена данными с кассовым ПО

    По умолчанию 38080

    Пример настройки
    [ArtixView]
; Настройки приложения artix-view

; Порт для обмена данными с кассовым ПО
; по умолчанию 38080
;port=38080

  3. Активировать модуль viewconnector, который обеспечивает передачу данных с кассы в приложение artix-view. Модуль активируется параметром viewconnector в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [plugins].

    НаименованиеТип данныхВозможные значенияОписаниеПримечания
    viewconnectorлогический
    • on
    • off
    		Активация модуля viewconnectorПо умолчанию off
    Пример настройки
    [plugins]
;viewconnector = off

  4. Настроить модуль viewconnector в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [ViewConnector].

    НаименованиеТип данныхОписаниеПримечания
    serverстроковыйАдрес сервераПо умолчанию http://localhost:38080
    timeoutчисловой

    Таймаут обращения к серверу в секундах

    По умолчанию 1 сек

    intervalчисловойИнтервал отправки сообщенийПо умолчанию 250 мсек
    Пример настройки
    [ViewConnector]
; Настройки плагина для связи с приложением artix-view

; Адрес сервера
; по умолчанию http://localhost:38080
;server = http://localhost:38080

; Таймаут обращения к серверу в секундах
; по умолчанию 1 секунда
;timeout = 1

; Интервал отправки сообщений
; по умолчанию 250 миллисекунд
;interval = 250

  5. Настроить таймаут отображения закрытого чека на втором экране в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [View.Logic].

    НаименованиеТип данныхОписаниеПримечания
    closedDocumentTimeoutчисловой

    Таймаут отображения закрытого чека (в миллисекундах):

    • 0 – закрытый чек не отображается,
    • -1 – закрытый чек отображается до момента открытия нового чека,
    • 10000 – закрытый чек отображается 10 секунд.

    По умолчанию 10000

    Пример настройки
    [View.Logic]
; Настройки бизнес-логики приложения artix-view

; Таймаут отображения закрытого чека(в миллисекундах)
; По умолчанию 10000
;closedDocumentTimeout = 10000

  6. Настроить параметры отображения информации для покупателя в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [View.Style].

    НаименованиеТип данныхОписаниеПримечания
    displayTypeчисловой

    Тип отображения информации:

    • 0 – только чек,

    • 1 – только реклама,

    • 2 – чек слева, реклама справа,

    • 3 – реклама слева, чек справа,

    • 4 – чек вверху, реклама внизу,

    • 5 – реклама вверху, чек внизу,

    • 6 – в режиме ожидания - только реклама, в режиме формирования - только чек.

    Чек не отображается на втором мониторе, если в нем отсутствуют позиции.

    По умолчанию 0

    Пример настройки
    [View.Style]
; Настройки отображения приложения artix-view

; Тип отображения информации
; 0 - только чек
; 1 - только реклама
; 2 - чек слева, реклама справа
; 3 - реклама слева, чек справа
; 4 - чек вверху, реклама внизу
; 5 - реклама вверху, чек внизу
; 6 - в режиме ожидания - только реклама, в режиме формирования - только чек
; по умолчанию 0
;displayType = 0
    Настройки отображения внешнего вида информации для покупателя можно посмотреть в разделе "Настройка внешнего вида второго экрана интерфейсов Touch, Keyboard".
  7. Сконфигурировать экраны. Для монитора, на который будет осуществляться вывод информации для покупателя, необходимо указать приложение /linuxcash/cash/view/artix-view. Подробнее о настройке экранов можно прочитать в статье "Настройка экрана".
  8. Перезапустить кассу. После перезапуска кассы на основном мониторе будет запущена кассовая программа, на втором мониторе будет отображен чек и рекламная информация для покупателя.

 При изменении настроек в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini необходимо перезапустить приложение artix-view командой pkill artix-gui.

Отображение QR-кода для оплаты

В кассовом ПО Artix предусмотрена возможность отображения QR-кода для оплаты на втором мониторе поверх чека и рекламного контента. Для этого необходимо задать параметр showQrCode в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [View.Logic]:

  • при значении true на втором мониторе будет отображен диалог сканирования QR-кода для оплаты:

  • при значении false диалог сканирования QR-кода для оплаты на втором мониторе отображен не будет.
НаименованиеВозможные значенияТип данныхОписаниеПримечания
showQrCode
  • true
  • false
логический

Отображать QR-код в процессе оплаты по коду

По умолчанию true
Пример настройки
[View.Logic]
; Настройки бизнес-логики приложения artix-view
...
; Отображать QR-код в процессе оплаты по коду
; По умолчанию true
;showQrCode = true

Отображение рекламного контента

Размер рекламного контента не должен превышать разрешение экрана.

Системные требования

В таблице приведены системные требования для корректного воспроизведения видео на втором мониторе (качество видео до Full HD включительно).


МинимальныеРекомендованные
Процессор2 ядра по 1.8ГГц

4 ядра по 1.8ГГц

ОЗУ1Gb2Gb

Настройки для рекламного контента

Для корректной работы необходимо выполнить настройку экранов. Подробнее можно прочитать в статье "Настройка экрана".

Для отображения рекламного контента необходимо:

  1. В конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini задать настройки рекламного расписания в секции [View.ADTimetable.<заголовок секции рекламы>]. Для каждой рекламы нужно создать отдельную секцию.

    НаименованиеТип данныхОписаниеПримечания
    indexчисловойПорядковый номер рекламыПо умолчанию 0
    urlстроковыйСсылка на контент

    Ссылка на файл, который находится в директории кассы (file:///путь) или в сети интернет.

    timeчисловойВремя показа рекламыПо умолчанию 60 сек
    Пример настройки
    [View.ADTimetable.<заголовок секции рекламы>]
; Порядковый номер рекламы
; По умолчанию 0
;index = 0

; Ссылка на контент
;url = file:///tmp/example.avi
;url = https://localhost/example.jpg
;url =

; Время показа рекламы
; По умолчанию 1 мин (60 сек)
;time = 60

    Для показа изображений поддержаны следующие форматы: *.jpg, *.png, *.bmp, *.gif.

    Для воспроизведения видео поддержаны следующие кодеки:

    • для кассового ПО на базе Ubuntu 18.04  –  asv1, asv2, cljr, ffv1, flv1, h263, h263p, h264 (рекомендуется), huffyuv, mjpeg, mpeg2video, mpeg4, msmpeg4v2, msmpeg4v3, msvideo1, png, r210, rawvideo, theora, v210, vp8, wmv1, wmv2, zmbv.

      Для кассового ПО на базе Ubuntu 18.04 необходимо предварительно удалить драйвер i965-va-driver.

    Для корректного воспроизведения видео рекомендуется:

    • при использовании оборудования с низкой производительностью подготовить видео-контент с более низким битрейтом,
    • при использовании оборудования с аудио-устройствами удалить звуковую дорожку из видео-файла.

  2. Указать порт для обмена данными с приложением artix-view в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini в секции [ViewConnector].

    НаименованиеТип данныхОписаниеПримечания

    port

    		строковый

    Порт для обмена данными с artix-view

    По умолчанию 38081

    Пример настройки
    [ViewConnector]
; Настройки плагина для связи с приложением artix-view

; Порт для обмена данными с artix-view
; По умолчанию 38081
;port = 38081

  3. В конфигурационном файле /linuxcash/cash/view/config/view.ini задать настройки для обмена данными с кассой.

    НаименованиеТип данныхОписаниеПримечания
    cashAddressстроковыйАдрес кассы для отправки сообщения при окончании показа рекламыПо умолчанию http://localhost:38081
    sendTimeoutцелочисленныйТаймаут отправки сообщения на кассу при окончании показа рекламыПо умолчанию 10 секунд
    repeatOnErrorTimeoutцелочисленныйТаймаут повторения отправки запроса в случае ошибкиПо умолчанию 10 секунд
    hideTimeoutцелочисленныйТаймаут скрытия рекламного виджета при отсутствии сообщенийПо умолчанию 10 секунд
    Пример настройки
    [ArtixView]
; Настройки приложения artix-view

; Адрес кассы
; По умолчанию http://localhost:38081
;cashAddress = http://localhost:38081

; Таймаут отправки сообщения на кассу при окончании показа рекламы
; По умолчанию 10 секунд
;sendTimeout = 10

; Таймаут повторения отправки запроса в случае ошибки
; По умолчанию 10 секунд
;repeatOnErrorTimeout = 10

; Таймаут скрытия рекламного виджета при отсутствии сообщений
; По умолчанию 10 секунд
;hideTimeout = 10
  4. После перезапуска кассы на втором экране будет отображен чек с рекламой.
    Вариант отображения чека:

 При изменении настроек в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini необходимо перезапустить приложение artix-view командой pkill artix-gui.

Порядок отображения рекламы:

  1. С кассы отправляется сообщение с расписанием рекламы к artix-view. После приема сообщения приложение artix-view отображает полученную рекламу.
  2. По истечении времени показа на кассу от artix-view отправляется сообщение об окончании показа рекламы.
  3. После получения статуса показа рекламы касса отправляет следующее сообщение с рекламой. Если сообщение с рекламой не поступило от кассы, то рекламный виджет будет скрыт.

Таким образом рекламный контент будет отображаться на втором мониторе в заданном настройками порядке.

Логирование

По умолчанию логи работы приложения artix-view записываются в файл /linuxcash/logs/current/view.log.

Параметры логирования находятся в файле конфигурации /linuxcash/cash/conf/Artix/artix-view.conf.

Пример настройки
[Log4Qt]
Properties\log4j.appender.root=org.apache.log4j.FileAppender
Properties\log4j.appender.root.file=/linuxcash/logs/current/view.log
Properties\log4j.appender.root.appendFile=true
Properties\log4j.appender.root.layout=org.apache.log4j.TTCCLayout
Properties\log4j.appender.root.layout.DateFormat=ISO8601
Properties\log4j.rootLogger="INFO, root"

По умолчанию логи работы модуля viewconnector записываются в файл /linuxcash/logs/current/viewconnector.log.

Параметры логирования находятся в файле конфигурации /linuxcash/cash/conf/Artix/artix.conf.

Пример настройки
[Log4Qt]
...
Properties\log4j.appender.viewconnector=org.apache.log4j.FileAppender
Properties\log4j.appender.viewconnector.file=/linuxcash/logs/current/viewconnector.log
Properties\log4j.appender.viewconnector.appendFile=true
Properties\log4j.appender.viewconnector.layout=org.apache.log4j.TTCCLayout
Properties\log4j.appender.viewconnector.layout.DateFormat=ISO8601
Properties\log4j.additivity.viewconnector=false
Properties\log4j.logger.viewconnector="INFO, viewconnector"
...


  • No labels