Overview | Package | Class | Tree | Index | Help
PREV CLASS | NEXT CLASS	FRAMES | NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

Interface javax.speech.EngineCentral

public abstract interface EngineCentral

Provides a list of EngineModeDesc objects that define the available operating modes of a speech engine.

Each speech engine registers an EngineCentral object with the javax.speech.Central class. When requested by the Central class, each registered EngineCentral object provides a list with an EngineModeDesc object that describes each available operating mode of the engine.

The EngineModeDesc objects returned by EngineCentral in its list must implement the EngineCreate interface and be a sub-class of either RecognizerModeDesc or SynthesizerModeDesc. The Central class calls the createEngine method of the EngineCentral interface when it is requested to create an engine. (See EngineCreate for more detail.)

The engine must perform the same security checks on access to speech engines as the Central class.

Note: Application developers do not need to use this interface. EngineCentral is used internally by Central and speech engines.

See Also:

Central, EngineCreate, EngineModeDesc

Method Summary

EngineList

createEngineList(EngineModeDesc require) Create an EngineList containing an EngineModeDesc for each mode of operation of a speech engine that matches a set of required features.

Method Detail

createEngineList

public EngineList createEngineList(EngineModeDesc require)
                                        throws SecurityException

Create an EngineList containing an EngineModeDesc for each mode of operation of a speech engine that matches a set of required features. Each object in the list must be a sub-class of either RecognizerModeDesc or SynthesizerModeDesc and must implement the EngineCreate interface.

The Central class ensures that the require parameter is an instance of either RecognizerModeDesc or SynthesizerModeDesc. This enables the EngineCentral to optimize its search for either recognizers or synthesizers.

Returns null if no engines are available or if none meet the specified requirements.

The returned list should indicate the list of modes available at the time of the call (the list may change over time). The engine can create the list at the time of the call or it may be pre-stored.

Throws:

SecurityException - if the caller does not have accessEngineModeDesc permission

See Also:

EngineCreate, EngineModeDesc, RecognizerModeDesc, SynthesizerModeDesc