The Call.playAndGetInput() method

The attributes objects that make up the four parameters of the playAndGetInput() method are :

1. PlayAttributes - used to specify whether the caller can interrupt the messages played as part of a voice or DTMF input.
2. Either
   • InputAttributes - used to specify the voice segment or sequence of voice segments to be played to the caller, the time to wait for a response, and the validation that will be performed on the caller's input.
   Or
   • MenuAttributes - an extension of class InputAttributes. Has all the attributes of InputAttributes, plus additional attributes used to specify a complete menu with voice segments, identification labels, DTMF selector key responses and recognized selector word responses.
3. DTMFAttributes - used to specify the maximum number of DTMF key presses allowed in a caller response and also any keys to be used for ending input. Replace with null if DTMF input is not required.
4. RecoAttributes - used to specify the settings for the speech recognition used for this input. Replace with null if voice input is not required.

As shown above, the second parameter of the Call.playAndGetInput() method varies. The attributes object you use as the second parameter depends on whether you are obtaining data from the user, or are asking the user to make a menu selection:

• Obtaining data from the caller

  To obtain information such as a telephone number from the caller, use

  Call.playAndGetInput(PlayAttributes playAttributes, InputAttributes inputAttributes, DTMFAttributes dtmfAttributes, RecoAttributes recoAttributes)

• Getting the caller to make a menu selection

  To get a caller to choose from a list of menu choices, use

  Call.playAndGetInput (PlayAttributes playAttributes, MenuAttributes menuAttributes, DTMFAttributes dtmfAttributes, RecoAttributes recoAttributes)

Example:

public class myVoiceApp extends WVRApplication {
  .
  .
  .
  // Create the attributes objects - use empty constructors so that attributes
  // have default values
  private PlayAttributes myPlayAtts 	= new PlayAttributes();
  private InputAttributes myInputAtts = new InputAttributes();
  private DTMFAttributes myDTMFAtts 	= new DTMFAttributes();
  private RecoAttributes myRecoAtts 	= null;
  // Enter the main application method
  public void VoiceMain() throws WVRException {
    // Create the application properties
    ApplicationProperties appProperties = new ApplicationProperties();
    appProperties.setApplicationName("myApplication");
    applicationProperties.setLocale(Locale.US);
		
    // Create the WVR object, using the application properties
    WVR wvr = new wvr(this, appProperties);
		
    // Create the Call object, using the WVR object
    Call call = wvr.waitForCall();
		
    // Get input from the caller, using the attribute objects created earlier
    InputResult result = call.playAndGetInput(myPlayAtts, myInputAtts, myDTMFAtts, myRecoAtts);
    .
    .
    .
  }//VoiceMain
}