SR_AcousticState API functions


Detailed Description

Contains Acoustic state information.


Data Structures

struct  SR_AcousticState

AcousticState

An AcousticState is a container for the configurations of several items used in recognition:

  • What models are in use (where there is more than one available). E.g. M/F or adapted models.
  • Properties of the channels (microphone, environment, speaker). These properties are updated during recognition. E.g. There may be more than one microphone in use, offering zone-based input. Each zone may require the maintenance of its own channel settings.

AcousticState must offer persistence to reflect optimal settings and preferred use on start-up.

SREC_ACOUSTICSTATE_API
ESR_ReturnCode 
SR_AcousticStateLoad (SR_Recognizer *recognizer, const LCHAR *filename)
SREC_ACOUSTICSTATE_API
ESR_ReturnCode 
SR_AcousticStateSave (SR_Recognizer *recognizer, const LCHAR *filename)

Possible AcousticState <-> Model operations

SREC_ACOUSTICSTATE_API
ESR_ReturnCode 
SR_AcousticStateReset (SR_Recognizer *recognizer)
SREC_ACOUSTICSTATE_API
ESR_ReturnCode 
SR_AcousticStateSet (SR_Recognizer *recognizer, const LCHAR *param_string)
SREC_ACOUSTICSTATE_API
ESR_ReturnCode 
SR_AcousticStateGet (SR_Recognizer *recognizer, const LCHAR **param_string)


Function Documentation

SREC_ACOUSTICSTATE_API ESR_ReturnCode SR_AcousticStateGet ( SR_Recognizer recognizer,
const LCHAR **  param_string 
)

Resets the acoustic state object. The recognizer adapts to the acoustic state of the caller and calling environment during a call in order to improve recognition accuracy. The platform must reset the AcousticState either at the beginning of a new call or at the end of a call in order to reset acoustic state information for a new caller.

Parameters:
recognizer SR_Recognizer handle
Returns:
ESR_INVALID_ARGUMENT if recognizer is null

SREC_ACOUSTICSTATE_API ESR_ReturnCode SR_AcousticStateLoad ( SR_Recognizer recognizer,
const LCHAR filename 
)

Loads an AcousticState from file.

Parameters:
recognizer SR_Recognizer handle
filename File to read from
Returns:
ESR_INVALID_ARGUMENT if recognizer is null

SREC_ACOUSTICSTATE_API ESR_ReturnCode SR_AcousticStateReset ( SR_Recognizer recognizer  ) 

Resets the acoustic state object. The recognizer adapts to the acoustic state of the caller and calling environment during a call in order to improve recognition accuracy. The platform must reset the AcousticState either at the beginning of a new call or at the end of a call in order to reset acoustic state information for a new caller.

Parameters:
recognizer SR_Recognizer handle
Returns:
ESR_INVALID_ARGUMENT if recognizer is null

SREC_ACOUSTICSTATE_API ESR_ReturnCode SR_AcousticStateSave ( SR_Recognizer recognizer,
const LCHAR filename 
)

Saves an AcousticState to a file.

Parameters:
recognizer SR_Recognizer handle
filename File to write into
Returns:
ESR_NOT_IMPLEMENTED

SREC_ACOUSTICSTATE_API ESR_ReturnCode SR_AcousticStateSet ( SR_Recognizer recognizer,
const LCHAR param_string 
)

Resets the acoustic state object. The recognizer adapts to the acoustic state of the caller and calling environment during a call in order to improve recognition accuracy. The platform must reset the AcousticState either at the beginning of a new call or at the end of a call in order to reset acoustic state information for a new caller.

Parameters:
recognizer SR_Recognizer handle
Returns:
ESR_INVALID_ARGUMENT if recognizer is null


Generated on Thu May 1 15:37:26 2008 for SREC by  doxygen 1.5.3