Microsoft Speech Platform

ISpRecognizer

The ISpRecognizer interface enables applications to control aspects of the speech recognition (SR) engine. Each ISpRecognizer interface represents a single SR engine. The application can connect to each recognizer object one or more recognition contexts, from which the application can control the recognition grammars to be used, start and stop recognition, and receive events and recognition results. The ISpRecognizer interface allows some additional control of the SR engine and its audio input. A standard application may not need to call many of the methods on this interface as the Speech Platform tries to set the engine up sensibly by default.

In the implementations of the ISpRecognizer and ISpRecoContext in the Speech Platform, the speech recognition engine is created in the same process as the application. Only this application can connect to this recognizer. This makes possible, for example, a telephony server application where multiple speech recognition engines will be required.

When to Use

Call methods of the ISpRecognizer interface to configure or retrieve the attributes of the SR engine.

Implemented By

This interface is implemented by the Speech Platform. Application developers use this interface but do not implement it.

How Created

The following object implements this interface. Applications can create this object by creating a COM object with the following CLSID:

SpInprocRecognizer (CLSID_SpInprocRecognizer)

Methods in Vtable Order

ISpRecognizer Methods	Description
ISpProperties	Inherits from ISpProperties and all those methods are accessible from ISpRecognizer.
SetRecognizer	Specifies the SR engine to be used.
GetRecognizer	Retrieves which SR engine is currently being used.
SetInput	Specifies which input stream the SR engine should use.
GetInputObjectToken	Retrieves the input token object for the stream.
GetInputStream	Retrieves the input stream.
CreateRecoContext	Creates a recognition context for this instance of an SR engine.
GetRecoState	Retrieves the state of the recognition engine.
SetRecoState	Sets the state of the recognition engine.
GetStatus	Retrieves current status information for the engine.
GetFormat	Retrieves the format of the current audio input.
IsUISupported	Checks if the SR engine supports a particular user interface component.
DisplayUI	Displays a user interface component.
EmulateRecognition	Emulates a recognition from a text phrase rather than from spoken audio.

Share via