Legacy Document

Inside Macintosh: Speech Recognition Manager /

Chapter 1 - Speech Recognition Manager / Speech Recognition Manager Reference

Constants

Notification Flags

You can indicate which recognizer events you want your application be to notified of by setting the recognizer's notification property, which is a property of type kSRNotificationParam. That property's value is a 4-byte unsigned integer. The Speech Recognition Manager defines the following masks for bits in that value:

enum {
   kSRNotifyRecognitionBeginning       = 1L<<0,
   kSRNotifyRecognitionDone            = 1L<<1
};

Constant descriptions

kSRNotifyRecognitionBeginning

If this bit is set, your application will be notified when the user starts speaking and recognition is ready to begin. When your application gets this notification, it must call either SRContinueRecognition or SRCancelRecognition in order for recognition either to continue or be canceled. If you do not call one of these functions, the recognizer will simply wait until you do (and hence appear to have quit working). Note that calling SRCancelRecognition cancels a recognition only for the application that requested it, not for all applications.

kSRNotifyRecognitionDone

If this bit is set, your application will be notified when recognition is finished and the result (if any) of that recognition is available. See the example on page 1-26.