Legacy Document

Inside Macintosh: Speech Recognition Manager /

Chapter 1 - Speech Recognition Manager / Speech Recognition Manager Reference

Constants

Recognition System Properties

A recognition system (that is, an instance of the SRRecognitionSystem class) has a set of properties that you can inspect and change by calling the SRGetProperty and SRSetProperty routines. You specify a property by passing a property selector to those functions. The Speech Recognition Manager defines these property selectors for recognition systems:

enum {
   kSRFeedbackAndListeningModes        = 'fbwn',
   kSRRejectedWord                     = 'rejq',
   kSRCleanupOnClientExit              = 'clup'
};

Constant descriptions

kSRFeedbackAndListeningModes

The feedback and listening modes of the recognition system. The value of this property is an integer that determines some of the features of a recognizer subsequently created by your application. The available values are described below. The default value for version 1.5 is kSRNoFeedbackNoListenModes, but most applications should set this to kSRHasFeedbackHasListenModes.

               enum {
                  kSRNoFeedbackNoListenModes       = 0,
                  kSRHasFeedbackHasListenModes     = 1,
                  kSRNoFeedbackHasListenModes      = 2
               };

If the feedback and listening modes value of a recognition system is set to kSRNoFeedbackNoListenModes, the next created recognizer has no feedback window and doesn't use the listening modes selected by the user in the Speech control panel. (For example, push-to-talk is a listening mode.) If the feedback and listening modes value of a recognition system is set to kSRHasFeedbackHasListenModes, the next created recognizer opens a feedback window that uses the listening modes selected by the user in the Speech control panel. If the feedback and listening modes value of a recognition system is set to kSRNoFeedbackHasListenModes, the next created recognizer has no feedback window but does use the listening modes selected by the user in the Speech control panel.

kSRRejectedWord

The rejected word of the recognition system. The value of this property is a value of type SRWord that will be returned in a recognition result object when a recognizer encounters an unrecognizable utterance. For example, if an utterance is rejected, the kSRLMObjType property of the rejection result is the rejected word. By default, a recognition system's rejected word is spelled "???" and has a reference constant of 0.

kSRCleanupOnClientExit

The cleanup mode of the recognition system. Applications should never set this property. If, however, you don't have a process ID (as issued by the Process Manager), you should set this property to FALSE so that speech objects you allocate will not be associated with any other process. By default, the value of a recognition system's cleanup mode is TRUE.