Condividi tramite

TransferCall Remarks

  • Articolo
  Microsoft Speech Technologies Homepage

Remarks

Transfers the current call using the Computer Supported Telecommunications Applications (CSTA) SingleStepTransfer service.

Inherits from SmexMessageBase.

When RunSpeech runs this object, it blocks any further speech dialogue until transfer succeeds or fails.

When the TransferCall control completes its operation successfully, the Speech Platform terminates the dialog and by default, closes the SALT interpreter without posting back to the server. To force a postback before SALT interpreter closes, application authors can either set the control's AutoPostback property to True, or call the form.submit method in its OnClientTransferred event handler.

Preserving Call Information

The TransferCall control will not function properly if the CurrentCall object has not been initialized with the correct call information, or if the call information has been lost in a page transfer. Whenever possible, application authors should transfer to a new page by using SpeechCommon.Navigate or the Redirect method of the TransferCall control, both of which automatically persist call information across a page transfer. If it is necessary to use the Response.Redirect or window.navigate methods, authors must explicitly pass the call information to the new page using a query string, as shown in the following example.

"DeviceID=" + encodeURIComponent(RunSpeech.CurrentCall().Get("DeviceID")) + 
"&CallID=" + encodeURIComponent(RunSpeech.CurrentCall().Get("CallID")) + 
"&CallingDevice=" + encodeURIComponent(RunSpeech.CurrentCall().Get("CallingDevice")) + 
"&CalledDevice=" +  encodeURIComponent(RunSpeech.CurrentCall().Get("CalledDevice")) + 
"&MonitorCrossRefID=" + encodeURIComponent(RunSpeech.CurrentCall().Get("MonitorCrossRefID")) +
"&CallState=" + "Established"

CSTA

For more information on CSTA standards, see Standard ECMA-269 (Services for Computer Supported Telecommunications Applications Phase III) and Standard ECMA-323 (XML Protocol for Computer Supported Telecommunications Applications Phase III).

See Also

TransferCall Class | TransferCall Constructor | TransferCall Members | TransferCall Properties | TransferCall Methods | TransferCall Events