ftalk

Avaya Logo

ftalk

The ftalk instruction plays coded speech stored in a file.

Synopsis

ftalk(ctype.src)

Description

The ftalk instruction is similar to the talk instruction, however it instructs the system to play coded speech stored in a file instead of a buffer.

The ctype.src argument specifies the fully qualified or relative pathname of a file of coded speech to be spoken. The script may pass the pathname as a literally quoted string, or the contents of a null-terminated field. The maximum length of the pathname is 128 characters. There is no limit to the size of the file itself.

When ftalk (as well as talk, tchars, and tnum) instructions are executed, the system queues phrases in a buffer, but the phrases are not immediately played. Phrases are played under either one of the following two conditions:

The script executes a speech-flushing instruction.
The script executes a say or fsay instruction.

The ftalk instruction returns one of the following values in script register 0 (r.0).

Return value	Description
0	The ftalk instruction completed successfully
-1	The ftalk instruction failed to queue the request
-2	One of the following has occurred: The length of the full pathname passed the ftalk instruction was too large A relative pathname was passed in and the setfalk instruction was not previously called to set the prepend directory A relative pathname was passed in and the length of the prepend directory plus the length of the relative pathname was too large