VidyoEngage Kiosk: Local Configuration

The VidyoEngage™ Kiosk installation folder contains a “Settings.txt” settings file. When the application starts, all configured values are loaded, so any changes on the settings file are executed upon restarting the application. Before running the application, it is mandatory to enter a value for the Server URL and Tenant fields. Other values are optional and there are default values for the other settings. If an upgrade is taking place, the current settings file is saved as a backup file and named “Settings-MMDDYYYY-HHMMSS.txt”. All configuration options are described below.

Settings File Structure

The settings file contains many configuration values in the form of key=value, where key is configuration name and value is its deployment-specific value. The left side of the “=” sign should not be changed. If a line starts with “;”, then that line will be ignored. All other characters at the beginning of the line will be ignored.

Key/Values Details

• SERVER
  • Valid values: URL schema only
  • This is the VidyoEngage backend server URL.
• ISGENESYS
  
  • Valid values: True or False
  • This indicates if the Kiosk works with the VidyoEngage Express backend (if True) or Genesys backend (if False).
• Genesys_serverUrl
  • Valid values: URL schema with port + path
  • This is the Genesys backend server URL (including port + path).
• AdditionalKVP
  • Valid values: Key Value Pair
  • This consists of key value pairs where key and value are separated by “:” and each pair is separated by “,” (this is only valid for Genesys backend and it represents other values sent to the server).
• TENANT
  • Valid values: Numeric values only
  • Tenant Id that will be used by the VidyoEngage Kiosk.
• API_KEY
  • Valid values: Alphanumeric values only
  • API Key that is configured for this tenant
• KEYBOARD
  • Valid values: SMALL, MEDIUM, or LARGE
  • Depending on the display screen size, the appropriate keyboard size would look nice. Verify the size that works best for the applicable display screen.
• CAMERA
  • Valid values: Numeric values only
  • The index for the camera to be used by the VidyoEngage Kiosk. For example, 0 for the first camera, 1 for the second camera, and so on.
• MICROPHONE
  • Valid values: Numeric values only
  • The index for the microphone to be used by the VidyoEngage Kiosk. For example, 0 for the first microphone, 1 for the second microphone, and so on.
• SPEAKER
  • Valid values: Numeric values only
  • The index for the speaker to be used by the VidyoEngage Kiosk. For example, 0 for the first speaker, 1 for the speaker, and so on.
• TIMEOUT_OPTION
  • Valid values: Numeric values only
  • This option is used to determine whether there will be a screen timeout in the application. If the TIMEOUT_OPTION is set to 1, then the application screen timeout is active. If it is set to 0 or any other values, there will not be a screen timeout.
• TIMEOUT
  • Valid values: Numeric values only
  • A timeout value (in seconds) is used to take users back to the Home screen. For example, for a five minute timeout, the TIMEOUT should equal 300.
• SPLASH_SCREEN_LEFT_IMAGE
  • Valid values: URL schema only
  • The Start screen left image name must be the PNG image URL and the image name should not have any quotes. The name should appear after the "=" symbol.
• SPLASH_SCREEN_RIGHT_SIDE_TEXT
  • Valid values: Alphanumeric values only
  • The Start screen right side text.
• INSTRUCTION_OPTION
  • Valid values: Numeric values only
  • The instructions on the ENTER NAME and SELECT TOPIC screens.
  • 1 will enable the instructions on the screen and 0 will disable them. Any other settings for INSTRUCTION_OPTION will be disabled by default.
• INSTRUCTION_TEXT
  • Valid values: Alphanumeric values only (limited to 70 characters)
  • The instructions on the ENTER NAME and SELECT TOPIC screens.
• INSTRUCTION_OPTION_WAITING_ROOM
  • Valid values: Numeric values only
  • The instructions on the waiting room screen.
  • 1 will enable the instruction on screen and 0 will disable it.
  • Any other settings for INSTRUCTION_OPTION_WAITING_ROOM will be disabled by default.
• INSTRUCTION_TEXT_WAITING_ROOM
  • Valid values: Alphanumeric value only (limited to 70 characters)
  • The instructions on the waiting room screen.
• SHOW_ERROR_ON_SCREEN
  • Valid values: Numeric values only
  • This parameter determines whether error messages will be shown on the screen.
  • 1 will cause an error message to appear on the screen.
• ERROR_MESSAGE
  • Valid values: Alphanumeric values only (limited to 70 characters)
  • The error message that will be shown on the screen.
• THEME_OPTION
  • Valid values: Numeric values only
  • This parameter determines whether to change the application theme.
  • 1 will enable the theme and 0 will disable it.
  • Any other settings for THEME_OPTION will be disabled by default.
• COLOR_THEME
  • Valid values: A range of 140 HTML color names from https://www.w3schools.com/colors/colors_names.asp
    
    
  • HEAD_LINE_TEXT_COLOR
    • Color for the headline text
  • BODY_TEXT_COLOR
    • Color for the body text
  • SCROLLBAR_COLOR
    • Color for the scrollbar
  • ARROW_COLOR
    • Color for the arrows, which are used to navigate back to the previous screen or navigate to the next screen
  • BUTTON_BACKGROUND_COLOR_PRIMARY
    • Background color of the primary buttons (ACCEPT, SUBMIT, etc.)
  • BUTTON_BACKGROUND_COLOR_SECONDARY
    • Background color of the secondary buttons (REJECT, CANCEL, etc.)
  • BUTTON_FONT_COLOR
    • Color for the button text
  • BORDER_COLOR
    • Color for all borders/underlines in the body
  • TOP_DOT_INNER
    • Color for the top dots, which indicates the screen that is currently displaying
  • SURVEY_STAR_COLOR
    • Color for the asterisk ("*”) on the Survey screen
  • LOCATION
    • Location of the Kiosk
      
      

Settings Default and Valid Value Matrix