VoiceSpeak

The VoiceSpeak instruction is used to define the voice string that should be spoken by the voice modem.

Syntax

VoiceSpeak ( "String" + Variable + "String"…, Precision )

In the following program, the code enclosed in the VoiceBeg/EndVoice instructions will be performed when a ring is detected from a voice modem. The datalogger will report the temperature and prompt the user to press the asterisk to end the call. The two messages will be repeated until the datalogger receives the asterisk, a Counter is incremented to 60, or the timeout period expires (2 minutes).

'Declare Variables
Public PTemp, TCTemp, Counter

VoiceBeg
  Counter=0
  Do
    Counter=Counter + 1
    VoiceSpeak ("THE TEMPERATURE IS" + TCTemp + "DEGREES", 2)
    VoiceSpeak ("PRESS STAR TO DISCONNECT", 2)
    '42 is the ASCII code for *
  Loop Until VoiceKey(12000)=42 or Counter=60
EndVoice

BeginProg
  Scan (1,Sec,3,0)
    PanelTemp (PTemp,15000)
    TCDiff (TCTemp,1,mv200C,U1,TypeT,PTemp,True ,0,15000,1.0,0)
  NextScan
EndProg

Remarks

When the VoiceSpeak instruction is added to a program, a list box containing the words of the Voice.txt file is displayed. Only words contained in this list (and defined variables) can be used in voice messages. The text string to be spoken is created by double-clicking words from the list, which adds them to a field at the top of the word list dialog. Variables are inserted within the text string by entering a + sign, the variable name, followed by a + sign if additional text follows. Once the message is complete, press the Insert button to insert the instruction into the program. Note that all non-variables in the String must be enclosed in quotes or an error will be returned when the program is compiled.

NOTE: When creating code for voice modems, the VoiceKey instruction should be used to add a delay before the EndVoice instruction is executed. Otherwise, the datalogger will end the VoiceSpeak command before the spoken message is completed.

Parameters

"String"

Defines the message that will be spoken by the voice modem. The spoken string is comprised of words from the Voice.txt file and variables. The words are enclosed with quotes, and the variables are concatenated with the words using a plus sign (e.g., "The temperature is" + Temp(1) + "degrees").

Type: Strings and Variables

Precision

Indicates the number of places to the right of the decimal that will be used for variables in the spoken message.

Type: Constant or Integer