The Engine interface is the base interface off of which all engine types inherit.
public abstract Parameters getParameters()
Gets the engine's Parameters object. The engine's optional.parameters.engine property can be queried to determine what parameters are supported. If the engine does not support any parameters, this function returns null.
Exceptions:
public abstract EngineProperties getProperties()
Returns the engine's description object.
Exceptions:
public abstract void initialize()
Initializes the engine, loading the necessary resources to perform the engine's function. Establishing a connection to an engine is a two step process. First, an instance of the engine must be obtained from the SVAPI class. Second, the engine's initialize method must be called. Two-step initialization allows calls to be made before the actual engine initialization takes place.
Exceptions:
See Also: deinitialize
public abstract void deinitialize()
Deinitializes the engine, unloading all resources consumed by the connection. The application should not make any further calls to the engine. Doing so will result in undefined behavior. All engines should override the finalize method and call its deinitialize method.
Exceptions:
See Also: initialize
public abstract void useDesktopAudio()
Causes the engine to connect to the desktop audio device.
Exceptions:
See Also: disconnectAudio, isAudioConnected
public abstract void useDeviceAudio(int Device)
Causes the engine to connect to a local audio audio device. The device identifier is operating system and platform dependent.
Exceptions:
See Also: disconnectAudio, isAudioConnected
public abstract void useTelephoneAudio(Terminal Terminal)
Causes the engine to connect to the audio of a Java telephony call.
Exceptions:
See Also: disconnectAudio, isAudioConnected
public abstract void disconnectAudio()
Disconnects the engine from the audio device or stream.
Exceptions:
See Also: isAudioConnected
public abstract boolean isAudioConnected()
Returns true if the engine is connected to an audio device or stream.
Exceptions:
See Also: disconnectAudio
public abstract String getChannel()
Returns the audio stream's channel identifier. The channel identifiers that the engine supports can be determined by querying the engine's audio.channels property.
Exceptions:
See Also: setChannel, Model.getChannel
public abstract void setChannel(String Channel)
Sets the audio stream's channel identifier. The channel identifiers that the engine supports can be determined by querying the engine's audio.channels property.
Exceptions:
See Also: getChannel, Model.setChannel
public abstract Utterance createUtterance(URL URL)
Creates an utterance from a URL.
Exceptions:
public abstract Utterance createUtterance(byte Data[])
Creates an utterance from binary data.
Exceptions:
public abstract boolean isEngineCompatible(Engine Engine)
Determines if objects obtained from this engine are interchangable with objects obtained from the specified engine. If this function returns true, utterances and models from one of the engines can be used in the other. This is useful for efficient use of multiple technologies that operate on the same utterances and/or models. For example, utterances obtained from a classification engine can be passed directly to an identification engine if this function returns true for the two engines.
Exceptions: