Passing 1 enables SR to listen; passing 0 disables listening. This is essentially the same as SR being "ready" or "on standby", but has no affect on loaded language models.

Note that under Mac OS, if you've called SUI_InitializeSR with modes 2 or 3, the recognition engine must also follow the rules set in the Speech Control Panel. The suggested settings are "Key toggle listening on and off" and "Name is: Optional before commands".


Support for Recognition from an Audio File

You can now perform speech recognition from an audio file (16-bit mono 44 KHz AIFF). When you initialize speech using SUI_InitializeSR, pass 2 as the 2nd parameter, which signifies the use of an audio file. Secondly, when you call SUI_SetListenState with a first parameter of 1 (to listen), pass the path name of the audio file as the 2nd parameter.

When recognizing speech from an audio file, it's important to note that the speech engine will perform recognition very quickly, even if the utterances are spaced out in the recording. For this reason, you should listen for complete phrases, and you should not perform logical and/or interface operations. In other words, don't change models based on previous utterances, don't open windows, etc.