Creating voice applications

Introduction to Blueworx Voice Response Java development lists the Blueworx Voice Response Java API classes and describes what you can do with them. Using the Blueworx Voice Response Java API classes introduces the basics of using the Blueworx Voice Response Java API classes. Blueworx Voice Response Java examples takes you step-by-step through some of these tasks. This section goes into more detail about using the Java API to create applications:

Saying something to the caller
Once a call has been established between a voice application and a caller (or called party), the remainder of the call consists of a dialog between the application and the caller.
Playing output to the caller
The play() method of the Call class is used to play output to the caller without expecting anything back. The voice prompt cannot be interrupted by the caller. If the caller presses a key, the key is left in the buffer for the next action method (a method which uses the underlying telephony, for example Call.play()), which may or may not clear the buffer.
Getting input from the caller
The Caller’s response
The Call.playAndGetInput() method returns an InputResult object that represents the caller’s input. To process the input, use the InputResult.getValue() method to extract the input information as a String.
Validating input
Your voice application will automatically do some validation of the caller's input using properties that you set in your attributes classes. For example, the maximumKeys property of the DTMFAttributes class will ensure that the caller enters the correct number of keys. To perform more complicate validation you can create your own validation class. This class must implement the InputValidator interface, which has one method, validate(). This method takes as a parameter the InputResult object returned by the Call.playAndGetInput() method used to get the caller's input. The validate() method returns the validated input in the form of a String, or null if the input is not valid. Your implementation of this method is where the validation takes place.
Recording the caller’s voice input
The Call.record() method provides an opportunity for the caller to record some spoken input. Think of it as a voice input field, or even a voice text area. The recorded voice is stored in a voice segment that you specify. The method takes two required parameters and optionally, two additional parameters:
Changing the pacing tone
When asking for the caller's input using speech recognition, or when recording a message from the caller, you can choose to have a pacing tone (beep) played when the application is ready to receive input. See The RecoAttributes class and Recording the caller’s voice input for more information about playing pacing tones.
Internationalizing your applications
Blueworx Voice Response for AIX: Deploying and Managing VoiceXML and Java Applications introduces the concepts of locale, default locale, and current locale, and how you can use these to make the same application speak different languages, without altering the application itself in any way. This section tells you how to do this:
More about handling calls
This section covers topics that you may want to skip on a first reading:
Getting called and calling numbers and application call data
To get called and calling numbers and application call data into your voice application, use the following Call class methods:
Handling voice segments dynamically
This section explains how to delete, import, and export voice segments during application runtime.
Invoking a VoiceXML application from a Java application
The Call.invokeVoiceXML2() method allows you to invoke a VoiceXML 2.1 application from a Java application.
Invoking a state table
Use the Call.invokeStateTable() method to invoke a Blueworx Voice Response for AIX state table. You can only pass string parameters to the state table, so if your state table requires numeric parameters, you need to invoke it from another state table that can accept strings from the Java voice application.