Say Numbers Module
The Say Numbers module can speak the supplied number as:
| Digits | "12345" would be spoken as "one two three four five". Up to forty digits will be spoken. |
| Amount Dollars | "12345" would be spoken as "twelve thousand three hundred forty five dollars". Amounts up to twelve digits long will be spoken. |
| Amount Cents | "12345" would be spoken as "one hundred twenty three dollars forty five cents". Amounts up to fourteen digits long will be spoken. |
| Amount Cents, Decimal Point | "12" would be spoken as "twelve dollars zero cents". "12.3" would be spoken as "twelve dollars thirty cents". "12.34" would be spoken as "twelve dollars thirty four cents". Amounts up to fourteen digits long will be spoken. This setting is usually used for speaking amounts retrieved from databases. |
| Number | "12345" would be spoken as "twelve thousand three hundred forty five". Numbers up to twelve digits long will be spoken. |
| DateMMDD | "0123" would be spoken as "twenty third January". Only the first four digits of the supplied string are looked at. |
| DateDDMM | "2301" would be spoken as "twenty third January". Only the first four digits of the supplied string are looked at. |
| DateMMDDHHNN | "01231456" would be spoken as "twenty third January two fifty six pm". Only the first eight digits of the supplied string are looked at. |
| DateDDMMHHNN | "23011456" would be spoken as "twenty third January two fifty six pm". Only the first eight digits of the supplied string are looked at. |
| TimeHHNN | "1745" would be spoken as "five forty five pm", "0730" would be spoken as "seven thirty am" |
| TimeHHNN 24 | "1745" would be spoken as "seventeen forty five" |
Result Variables can be used when specifying what number is to be spoken. Sound files to be played before and after the spoken number can also be selected. Result Variables can also be used in those filenames.
If a filename is specified then VoiceGuide will read in the file contents and read the data specified in the first line of the file.
If Digits, Amount or Number options are selected, and the number to be spoken starts with a "-", then the word "minus" will be spoken first before speaking the reset of the number.
If Date or Time options are selected , and the supplied number is the wrong length or does not make sense in the context of the selected option (eg: the supplied number is 8933 and the DateMMDD option is selected) then nothing will be played and the Fail path will be taken. If the Fail path is not defined then the Success path will be taken. If neither the Fail or Success paths are defined then VoiceGuide will hang up the call.
The Date/Time checking feature allows the Say Number module to be used for verifying validity of any caller-entered times and dates. The Time Switch module can also be used for checking the validity of date/time entered by caller.
Sound files played before & after the number
The sound files used in the module have to be of the same format as VoiceGuide current 'system' sound files (usually found in VoiceGuide's \system\voice\ subdirectory). This would be either "ALaw 8kHz 8bit Mono", or "ULaw 8kHz 8bit Mono".
Multiple sound files can be selected to be played by separating the successive files by commas. eg:
prompts\1.wav, prompts\2.wav
would result in two files from the prompts subdirectory being played (1.wav and 2.wav) one after another.
Changing the way Say Number module speaks numbers
Users can edit the way in which the numbers are spoken, or even add their own Say Number functions.
In VoiceGuide v5 and v6 the way the numbers are spoken can be changed by editing the file: lib_num2wav.vbs located in VoiceGuide's \system\vbs\ subdirectory. This is useful if it is required to say numbers/amounts in a language other then English. Please read the lib_num2wav.vbs file for more information.
In VoiceGuide v7 a DLL file is used to generate the list of WAV files needed to speak the number. The DLL is called vgLib_SayNumbers.dll and is located in VoiceGuide's \system\dll\ subdirectory. The source code (in C#) and full MS Visual Studio project file required to build the DLL can be found in this VoiceGuide subdirectory: \system\dll\Source\vgLib_SayNumbers. After building the new DLL just place it in VoiceGuide's \system\dll\ subdirectory and restart VoiceGuide in order for VoiceGuide to start using the new DLL.
In VoiceGuide v7 you can also select to have the system use the lib_num2wav.vbs to generate the spoken number by changing the VG.INI file setting. In VG.INI, section [moduleSayNumbers], change the entry WavListGenerator from DLL to VBScript.
