saiAsrSetNewAudioChannel

Specifies whether or not the client can request that the media server obtain audio data from a new audio source.

Prototype

DWORD saiAsrSetNewAudioChannel ( SAI_RECOGNIZER_HANDLE recogHd, BOOL value )

Argument

Description

recogHd

Handle associated with a recognizer resource.

value

One of the following values:

  • TRUE: Client can request audio data from an alternate source.

  • FALSE: Client cannot request audio data from an alternate source.


Return values

Return value

Description

SUCCESS

 

SAIERR_INVALID_PARAMETER

One of the specified arguments is invalid.

SAIERR_UNSUPPORTED_SPEECH_PARAMETER

Recognizer engine does not support the specified parameter.


Details

When saiAsrSetNewAudioChannel is set to TRUE, the recognizer must discard any collected information or line statistics and start fresh for the new recognizer request.

Applications can call saiAsrGetNewAudioChannel to reuse an open recognition session on the media server for multiple telephone calls. This function enables applications to avoid any delay associated with creating a new recognizer and specifying configuration parameters for that recognizer.