background image

MoniPlus2 Voice Guidance Configuration Guide

 

April 29, 2014 

 

 

 

 

 

 

 

customer will hear only beeps. You should include this information in your orientation script. If no 
orientation script is included, this echoing information should at least be included in the audio message 
defined for the Welcome screen and on screens that contain a masked entry.     

More information about keyboard mapping is included in the 

<Keyboard> Element

 section on page 12.

 

2.3  VG Volume Controls 

During transactions, a customer can change the volume of the audio by pressing the bottom left key  
( - ) on the keypad. The volume control works in a circular manner. The volume will step up with each – 
key press until it reaches the maximum. The next – key press will change the volume to its lowest level 
and then each - key press will increase the volume until it reaches its highest level again.    

Volume control instructions are included in the NH dynamic device orientation text which can optionally 
be added to your own VG file. If you are not using the dynamic device orientation option, you should at 
least include the volume instructions in the text for your own orientation.  

2.4  Increasing Timers for VG Sessions 

Some NDC timers need to be increased to accommodate the customer performing a VG transaction. 
Several timers that involve customer actions, such as making a keyboard response and taking cash, have 
been identified as needing an extended timer value. A parameter in the VG XML file can be included that 
will add additional time to these particular timers. See th

<Config>

 

Element

 on page 7 for more 

information this timer parameter.  

After a VG session has completed, all timers are set back to their original values. 

2.5  MoniMax ATM Hardware Restrictions 

There are some older models of MoniMax ATMs that use a hardware text-to-speech (TTS) engine in 
place of the Microsoft software text-to-speech engine.  The MoniMax ATMs models that have this TTS 
hardware solution are the 5100 (formerly the 9030) and the 7100T (formerly the 7040T). When the 
hardware TTS engine is used on an ATM, the following restrictions apply to the VG described in this 
document: 

 

The maximum number of time a VG message can be repeated is 10 rather than unlimited. 

 

There is a fixed interval of 3 seconds between audio message repeats. 

 

The VG volume cannot be adjusted on a 7100T only. For all other models, the volume can be 
adjusted as explained in this document. 

 

Keep these restrictions in mind if you are implementing MoniPlus2 VG on an ATM that has the hardware 
TTS engine. 

2.6  Deposit Automation Screens VG Support 

Since the check and cash deposit screens included in MoniPlus2 are not part of the host download, but 
rather provided locally in the software by NH, NH provides the VG for these screens, in both English and 
Spanish. This file is not in the same format as the VG file downloaded from the host. A custom PS 
engagement is currently required to make changes to this file.  

Contact your NH representative for more information. 

Summary of Contents for MoniPlus2

Page 1: ...MoniPlus2 Release 02 03 xx Voice Guidance Configuration Guide Ver 2 0 2014 Nautilus Hyosung Inc All Rights Reserved...

Page 2: ...he policy of Nautilus Hyosung Corporation to improve products as new technology components software and firmware become available Therefore Nautilus Hyosung reserves the right to change specifications...

Page 3: ...n Screens VG Support 4 3 VG Transaction Processing 5 3 1 Transaction Request Messages 5 3 2 Transaction Reply Messages 5 3 3 Interactive Transaction Response Messages 5 4 Creating the VG XML File 6 4...

Page 4: ...2 1 Load VG XML File Message with Identifier V 29 6 2 2 Terminal Response to the Load XML File Message 30 7 Terminal Status Messages 31 7 1 Specific Command Reject Message 31 A MoniPlus2 VG XML File...

Page 5: ...ost the VG XML file to an ATM Section 7 Terminal Status Message includes the VG related status messages that the ATM can send to the host Appendix A MoniPlus2 VG XML File Elements Quick Reference cont...

Page 6: ...function in Supervisor to verify the version of software running on the ATMs The application version will be the first entry displayed in the versions list and will be listed on the screen as shown b...

Page 7: ...selected his session options he is instructed to insert his card to begin a transaction Each screen displayed to the customer should have an audio instruction associated with it to guide the customer...

Page 8: ...s needing an extended timer value A parameter in the VG XML file can be included that will add additional time to these particular timers See the Config Element on page 7 for more information this tim...

Page 9: ...ost Refer to the LangOption Element on page 8 for more information on this option Verify that your host application can support the option you select before you implement either addition to the transa...

Page 10: ...d as is on MoniPlus2 ATMs and any NCR VG features not supported by MoniPlus2 will simply be ignored No schema file is currently associated with the MoniPlus2 VG XML file so as long as the file is vali...

Page 11: ...upID String This attribute can be used by the host to identify different Config elements for different downloads It is ignored by the MoniPlus2 application timersAdjust Numeric seconds Adds the define...

Page 12: ...LangOption element 4 4 2 LangOption Element Each language offered must have an LangOption element Three attributes are currently supported for this element 4 4 2 1 LangOption Attributes Tag Values De...

Page 13: ...ssage You will need to use the decimal equivalent for characters that have a predefined use in XML files For example to include a character at the end of the NDC message you would need to include 60 i...

Page 14: ...the audioID for the screen associated with this option Detailed information about this added link is included in the Adding the Dynamically Built Device Orientation Scripts section on page 12 screen...

Page 15: ...press 1 on the keypad to hear ads Yes and 2 on the keypad to skip ads No AudioID YestoAds will play when the customer presses 1 and audioID NotoAds will play when the customer presses 2 The default be...

Page 16: ...od you typically use to distribute the file A new device orientation list is only generated when the VG XML file is reloaded onto the ATM so if you do not reload the file when the devices change the c...

Page 17: ...Reader groupID 0000 Link audioID NHORIENTATIONLINKCashDispenser groupID 0000 Link audioID NHORIENTATIONLINKReceiptPrinter groupID 0000 Link audioID NHORIENTATIONLINKCashAcceptor groupID 0000 Link audi...

Page 18: ...cific portion of the transaction groupID String This attribute can be used by the host to identify different keyboard elements for different downloads and is ignored by the MoniPlus2 application 4 6 K...

Page 19: ...mapping layout is for a screen that has all eight FDKs populated Keyboard keyboardID 120 groupID 0001 Key pos 1 code F6 maps FDK A to key 1 Key pos 2 code F5 maps FDK B to key 2 Key pos 3 code F4 maps...

Page 20: ...want to use has any extension other than wav you need to use the entire filename as the audioID For example if your wav file is called test wav1 you would call the corresponding audioID text wav1 inc...

Page 21: ...of the base screen or in the audioID of the nested screen depending upon which is voiced See Embedded Text Elements in the next section for more information on the Placeholder tag The dynamic data to...

Page 22: ...ed screen with placeholder tags both screens 100 and 200 will be displayed but only audioID 0100 will be spoken The audio of the nested screen contains the placeholder tag and the ParamSourceID refere...

Page 23: ...Text Elements Within the text that you define for the audio you can embed the following elements Tag Description Link Allows the nesting of an audioID within the text of an audio message The Link ele...

Page 24: ...for a short pause in the speech Placeholder Specifies that dynamic data that should be voiced in this location within the audio message Multiple placeholders can be specified in the audio message and...

Page 25: ...1 Text Audio Audio audioID 0105 groupID 0001 keyboardID 110 repetitions 0 Text lang en These audio messages allow a visually impaired person to use an A T M You use the numeric keypad to make selectio...

Page 26: ...the ATM screen flow that needs to be displayed to the customer and therefore voiced for voice guidance The dynamic data in the transaction reply message must be identified by the escape sequence ESC...

Page 27: ...CE EXAMPLE lf UPDATE WITH TWO lf PLACEHOLDERS audioID 0345 should be formatted with two placeholders as shown below Audio audioID 0345 Text lang en Thank you for banking with us Your PlaceHolder accou...

Page 28: ...ceHolder tag in the audio message and the balance amount 128 45 dollars will populate the second PlaceHolder tag Printer Flag w VG Sample This sample shows the use of printer flag w and dynamic data i...

Page 29: ...e Printer Flag VG Sample This sample shows the use of two audioIDs and two data fields to be directly voiced The first audioID Current wav will voice the text in the Current audioID in the XML file 4...

Page 30: ...extend the ITR Screen Timer field value for VG transactions The text to be voiced cannot include audioIDs nor can it include any screen control characters This means that the same messages cannot be...

Page 31: ...any FDKs are defined as active in the Active Keys field the FDKs will be mapped to the numeric keypad as follows FDK Numeric Key A 1 B 2 C 3 D 4 F 8 G 7 H 6 I 5 When the FDKs are mapped to the numeri...

Page 32: ...e numeric keys along with the Enter Clear and Cancel keys will be active on the keypad 3 fs fs fs 201100010000 fs 040 fs so 125 si EC1 SAVINGS 1 si GC2 SAVINGS 2 si IA When the ITR is processed at the...

Page 33: ...work Host A reboot is required after you copy this file onto the ATM 6 2 Downloading the VG XML File to the ATM The host can use the Configuration Data Load Command Load VG XML File message with Ident...

Page 34: ...Identifier V Fixed to V for VG XML configuration load 11 Field Separator Mandatory FS 12 Audio Guidance XML Data This field contains variable length sections of the AudioGuidanceData xml file 13 Field...

Page 35: ...ilable on this ATM when a customer inserts a head jack Note If the terminal receives a Go In Service message before it receives the final XML message all newly downloaded XML file messages will be del...

Page 36: ...Status Descriptor C This field is fixed to C for a Specific Command Reject 11 Field Separator Mandatory FS 12 1 Status Value This field contains the reason for rejecting the command A Message format...

Page 37: ...screen Screen that displays to allow language selection or its substitute opCodePos Opcode position to be populated for a VG session LangOption Language and key parameter pairs that allow a customer...

Page 38: ...generate when the key is pressed Audio Defines the audio messages voiced to the customer ad Identifies an audio message as an advertisement audioID Identifier for the audio element groupID Used by the...

Page 39: ...ID 60 afaLang 1 to 4 questions for options the OrientationScript option must be included to use the dynamic device orientation afaOption name blankScreen screen 0211 yesKeyPos 1 yesAudioID blankYes no...

Page 40: ...oard ABC Keyboard keyboardID 105 Key pos 1 code F6 Key pos 2 code F5 Key pos 3 code F4 Keyboard AB Keyboard keyboardID 106 Key pos 1 code F6 Key pos 2 code F5 Keyboard A Keyboard keyboardID 107 Key po...

Page 41: ...titions 0 Text lang en Do you wish to blank the screen for privacy To blank the screen please press 1 To display screen please press 2 Text Text lang sp La sesi n de audio permite ocultar las pantalla...

Page 42: ...0000 groupID 0000 keyboardID 106 keyText true repetitions 0 Text lang en If you need more time please press 1 for yes press 2 for no Text Text lang sp Necesita mas tiempo para realizar la opercion Par...

Page 43: ...en Please wait Text Audio Audio audioID 0400 groupID 0000 repetitions 0 Text lang en THANK YOU FOR BANKING WITH us TAKE YOUR RECEIPT TRANSACTION COMPLETE Text Audio Audio audioID 0401 groupID 0000 rep...

Page 44: ...osotros SU TARJETA se ha mantenido transacci n completa Text Audio Audio audioID 1403 groupID 0000 repetitions 0 Text lang sp GRACIAS POR bancarias con nosotros Tomar sus notas Transacci n completa Te...

Page 45: ...t Audio Audio audioID 0300 C groupID 0000 Text lang en Cancel Text Audio Audio audioID 0808 groupID 0000 repetitions 0 Text lang en Please insert your deposit Link audioID NHORIENTATIONLINKCashandChec...

Page 46: ...as 16 keys arranged in four columns The three left hand columns of keys are arranged like a standard telephone keypad The fourth column contains four function keys Enter is the top key of this column...

Page 47: ...pt screen Audio audioID NHORIENTATIONLINKMAIN groupID 0000 Text lang en Link audioID NHORIENTATIONLINKIntroduction groupID 0000 Link audioID NHORIENTATIONLINKPinpad groupID 0000 Link audioID NHORIENTA...

Page 48: ...e Orientation 10 12 35 Direct Audio Text Method 26 Downloading the VG XML File to the ATM 29 dynamic data definition 22 E Element List 6 Elements Quick Reference 33 Embedded Text Elements 19 escape se...

Page 49: ...lay Update Field 20 22 screenOffset attribute 8 Software Version 2 Specific Command Reject Message 31 Start and End Tags 6 Supervisor 2 T Terminal Response to the Load XML File Message 30 Terminal Sta...

Reviews: