• The message oriented functions, vcePlayMessage and vcePlayList, operate on a specific message or a list of messages. They take a voice handle and message number, or a list of message numbers. Playing starts from the beginning of the first message.

• The position-oriented function vcePlay operates on the current message in the specified context. Playing starts from the current position in the most recently accessed message or list.

If you want to...	Then use...
Start playing from the current position in the current message	vcePlay
Start playing from the beginning of the first message in a list of messages	vcePlayList
Play one message from a specified voice object	vcePlayMessage
Change the current play speed to a specified rate	vceSetPlaySpeed
Change the volume (loudness) of message playback by adjusting the amplification, or gain, applied to the message being played	vceSetPlayGain

Note: If play fails, the value field will contain an error code.

If...	The DONE event contains...
The end of the current message or list is reached	CTA_REASON_FINISHED
The time limit in vcePlay is reached	CTA_REASON_TIMEOUT
Play is stopped by calling vceStop	CTA_REASON_STOPPED
A touch tone digit is received and the corresponding bit in the DTMF abort parameter is set	CTA_REASON_DIGIT
The call is ended	CTA_REASON_RELEASED
Play is stopped because of a speech recognition event	CTA_REASON_RECOGNITION
You play an object that has an encoding that is not supported by the attached device service	CTAERR_FUNCTION_NOT_AVAIL

Note: Starting play with maxspeed greater than 100 requires additional DSP resources beyond that required for playing at normal speed. To determine whether your AG board(s) and configuration can support speed up, refer to the AG Runtime Configuration and Developer's Manual.

Field Name	Default Value	Description
DTMFabort	0xffff	Abort on DTMF (bit mask).
gain	0	Playing gain in decibels, or VCE_CURRENT_VALUE to use the most recent gain setting. The valid range for AG boards is -54 to 24.
speed	100	Initial speed in percent, or VCE_CURRENT_VALUE to use the most recent speed setting. The valid range for AG boards is 50 - maxspeed.
maxspeed	100	Maximum play speed in percent. The valid range for AG boards is 100 - 200.

• The message oriented function, vceRecordMessage, operates on a specific message number. This function creates a new message, replacing the existing message, if any.

• The position-oriented function, vceRecord, operates on the current message in the specified context. Recording starts from the current position in the most recently accessed message.

If you want to...	Then use...
Start recording at the current position in the current message	vceRecord
Record a message into a specified voice object	vceRecordMessage

Note: If record fails, the value field will contain an error code.

If...	The DONE event contains...
The time limit in vceRecord is reached	CTA_REASON_TIMEOUT
No more space is available in the voice object, or recording in overwrite mode reached the end of the existing message	CTA_REASON_FINISHED
Silence is detected at the beginning of recording	CTA_REASON_NO_VOICE
Silence occurs after some energy is recorded	CTA_REASON_VOICE_END
Record is stopped at any time by calling vceStop	CTA_REASON_STOPPED
A touch tone digit is received and the corresponding bit in the DTMF abort parameter is set	CTA_REASON_DIGIT
The call is ended	CTA_REASON_RELEASED
Record is stopped because of a speech recognition event	CTA_REASON_RECOGNITION
You record to an object with an encoding that is not supported by the attached device service	CTAERR_FUNCTION_NOT_AVAIL

Field Name	Default Value	Description
DTMFabort	0xffff	Abort on DTMF (bitmask).
gain	0 dB	The gain in decibels applied to the signal before it is encoded. If Automatic Gain Control is enabled, this is the initial gain when recording starts. Valid range for AG boards is -54 to 24.
novoicetime	5000 ms	The maximum length of silence at the beginning of a recording before recording will be stopped with a reason of CTA_REASON_NO_VOICE. Use zero (0) to disable this timer. Valid range for AG boards is 0 - 65535.
silencetime	3000 ms	The maximum length of silence after audio energy has been detected before record will be stopped with a reason of CTA_REASON_VOICE_END. Use zero (0) to disable this timer. Valid range for AG boards is 0 - 65535.
silenceampl	-45 dBm	The maximum signal level, in dBm, that is considered to be silence. Valid range for AG boards is -51 to -15.
beepfreq	1000 Hz	The frequency of the record beep tone. Use zero (0) to disable the beep. Valid range for AG boards is 200 - 3600.
beepampl	-20 dBm	The amplitude of the beep tone. Valid range for AG boards is -54 to 3.
beeptime	200 ms	The duration of the beep. 0 disables the beep. Valid range for AG boards is 0 - 65535.
AGCenable	0	Flag to enable Automatic Gain Control.

Note: When using AG boards, the parameters presented in the previous table override the corresponding fields in the ADI.RECORD category. ADI.RECORD contains additional fields which you can use to control Automatic Gain Control (AGC) characteristics.

• A VCEEVN_PLAY_DONE event or a VCEEVN_RECORD_DONE event is received.

• One of the terminating conditions described in either Section 3.2.2 or Section 3.3.2 occurs. This does not include the CTA_REASON_STOPPED DONE reason.

Note: CTA_REASON_STOPPED is also returned if playing or recording is stopped when the voice object being played or recorded is closed with vceClose. If you are playing a list, playing is stopped if an object containing any message in the list is closed.

	Most Significant Bit											Least Significant Bit
Bit Position	15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
DTMF Key	D	C	B	A	#	*	9	8	7	6	5	4	3	2	1	0