Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: speechrecognitioncustomcommands.h
Link against: speechrecognitioncustomcommands.lib

This item is not part of the S60 3rd Edition SDK for Symbian OS, Feature Pack 2.

Class RSpeechRecognitionCustomCommands

class RSpeechRecognitionCustomCommands : public RMMFCustomCommandsBase;

Description

This is the main class of Speech Recognition Custom Commands.

Derivation

Members

Defined in RSpeechRecognitionCustomCommands:
AddPronunciation(), AddRule(), Cancel(), CommitChanges(), CreateGrammar(), CreateLexicon(), CreateModelBank(), EndRecSession(), GetAllClientGrammarIDs(), GetAllClientLexiconIDs(), GetAllClientModelBankIDs(), GetAllGrammarIDs(), GetAllLexiconIDs(), GetAllModelBankIDs(), GetAllModelIDs(), GetAllPronunciationIDs(), GetAllRuleIDs(), GetAvailableStorage(), GetEngineProperties(), GetGrammarIDArrayL(), GetLexiconIDArrayL(), GetModelBankIDArrayL(), GetModelCount(), GetModelIDArrayL(), GetPronunciationIDArrayL(), GetResultSetL(), GetRuleIDArrayL(), GetRuleValidity(), GetUtteranceDuration(), LoadEngineParameters(), LoadGrammar(), LoadLexicon(), LoadModels(), PlayUtterance(), RSpeechRecognitionCustomCommands(), Recognize(), Record(), RemoveGrammar(), RemoveLexicon(), RemoveModel(), RemoveModelBank(), RemovePronunciation(), RemoveRule(), SetClientUid(), StartRecSession(), Train(), UnloadRule()

Inherited from RMMFCustomCommandsBase:
iController, iDestinationPckg


Construction and destruction


RSpeechRecognitionCustomCommands()

IMPORT_C RSpeechRecognitionCustomCommands(RMMFController &aController);

Description

Public C++ constructor for RSpeechRecognitionCustomCommands class.

Parameters

RMMFController &aController

A reference to a RMMFController object.

[Top]


Member functions


AddPronunciation()

IMPORT_C TInt AddPronunciation(TLexiconID aLexiconID, TModelBankID aModelBankID, TModelID aModelID, TPronunciationID &aPronunciationID);

Description

Adds a new pronunciation for the given model into the specified lexicon.

Parameters

TLexiconID aLexiconID

The lexicon ID to where the new pronunciation is added.

TModelBankID aModelBankID

The model bank ID.

TModelID aModelID

The model ID.

TPronunciationID &aPronunciationID

A reference to where a new pronunciation ID is assigned.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


AddRule()

IMPORT_C TInt AddRule(TGrammarID aGrammarID, TLexiconID aLexiconID, TPronunciationID aPronunciationID, TRuleID &aRuleID);

Description

Adds a new rule for the given pronunciation into the specified grammar.

Parameters

TGrammarID aGrammarID

The grammar ID to where the new rule is added.

TLexiconID aLexiconID

The lexicon ID.

TPronunciationID aPronunciationID

The pronunciation ID.

TRuleID &aRuleID

A reference to where a new rule ID is assigned.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


Cancel()

IMPORT_C void Cancel();

Description

Cancels the current operation.


CommitChanges()

IMPORT_C TInt CommitChanges();

Description

Commits the current train operation to the database.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


CreateGrammar()

IMPORT_C TInt CreateGrammar(TGrammarID &aGrammarID);

Description

Creates a new grammar.

Parameters

TGrammarID &aGrammarID

A reference to where the grammar ID is stored.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


CreateLexicon()

IMPORT_C TInt CreateLexicon(TLexiconID &aLexiconID);

Description

Creates a new lexicon.

Parameters

TLexiconID &aLexiconID

A reference where lexicon ID is stored.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


CreateModelBank()

IMPORT_C TInt CreateModelBank(TModelBankID &aModelBankID);

Description

Creates a new model bank.

Parameters

TModelBankID &aModelBankID

A reference to where a new model bank ID is assigned.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


EndRecSession()

IMPORT_C TInt EndRecSession();

Description

Ends the current recognition session.

The resources allocated for recognition are freed.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllClientGrammarIDs()

IMPORT_C TInt GetAllClientGrammarIDs();

Description

Returns all grammar IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllClientLexiconIDs()

IMPORT_C TInt GetAllClientLexiconIDs();

Description

Returns all lexicon IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllClientModelBankIDs()

IMPORT_C TInt GetAllClientModelBankIDs();

Description

Returns all modelBank IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllGrammarIDs()

IMPORT_C TInt GetAllGrammarIDs();

Description

Returns all grammar IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllLexiconIDs()

IMPORT_C TInt GetAllLexiconIDs();

Description

Returns all lexicon IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllModelBankIDs()

IMPORT_C TInt GetAllModelBankIDs();

Description

Returns all modelBank IDs owned by the client.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllModelIDs()

IMPORT_C TInt GetAllModelIDs(TModelBankID aModelBankID);

Description

Returns all model IDs that exist in the specified model bank.

Parameters

TModelBankID aModelBankID

The model bank ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllPronunciationIDs()

IMPORT_C TInt GetAllPronunciationIDs(TLexiconID aLexiconID);

Description

Returns all pronunciation IDs that exist in the specified lexicon.

Parameters

TLexiconID aLexiconID

The lexicon ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAllRuleIDs()

IMPORT_C TInt GetAllRuleIDs(TGrammarID aGrammarID);

Description

Returns all rule IDs that exist in the specified grammar.

Parameters

TGrammarID aGrammarID

The grammar ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetAvailableStorage()

IMPORT_C TInt GetAvailableStorage(TInt &aAvailableStorage);

Description

Returns the number of models available for training system wide, based on available disk space.

Parameters

TInt &aAvailableStorage

The number of models that can be held in available storage space.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetEngineProperties()

IMPORT_C TInt GetEngineProperties(const RArray< TInt > &aPropertyId, RArray< TInt > &aPropertyValue);

Description

Returns the engine properties specified by the engine property ID array. On return aPropertyValue contains an array of engine properties.

Parameters

const RArray< TInt > &aPropertyId

A constant reference to an array of engine property IDs.

RArray< TInt > &aPropertyValue

A reference to an array of engine property values.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetModelCount()

IMPORT_C TInt GetModelCount(TModelBankID aModelBankID, TInt &aModelCount);

Description

Returns the number of models in the specified model bank.

Parameters

TModelBankID aModelBankID

The model bank ID.

TInt &aModelCount

The reference where the number of models is set.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetRuleValidity()

IMPORT_C TInt GetRuleValidity(TGrammarID aGrammarID, TRuleID aRuleID, TBool &aValid);

Description

Checks if the rule is valid or not.

Parameters

TGrammarID aGrammarID

The grammar ID.

TRuleID aRuleID

The rule ID.

TBool &aValid

A reference where the validity of the rule is set.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetUtteranceDuration()

IMPORT_C TInt GetUtteranceDuration(TModelBankID aModelBankID, TModelID aModelID, TTimeIntervalMicroSeconds32 &aDuration);

Description

Returns the duration of the utterance for the specified model.

Parameters

TModelBankID aModelBankID

model bank Id

TModelID aModelID

model Id

TTimeIntervalMicroSeconds32 &aDuration

reference where the duration of utterance is set

Return value

TInt

System-wide errors


LoadGrammar()

IMPORT_C TInt LoadGrammar(TGrammarID aGrammarID);

Description

Loads the specified grammar into the recognizer; done prior to recognition.

Parameters

TGrammarID aGrammarID

The grammar ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


LoadLexicon()

IMPORT_C TInt LoadLexicon(TLexiconID aLexiconID);

Description

Loads the specified lexicon into the recognizer; done prior to recognition.

Parameters

TLexiconID aLexiconID

The lexicon ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


LoadModels()

IMPORT_C TInt LoadModels(TModelBankID aModelBankID);

Description

Loads the specified model bank into the recognizer; done prior to recognition.

Parameters

TModelBankID aModelBankID

The model bank ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


PlayUtterance()

IMPORT_C TInt PlayUtterance(TModelBankID aModelBankID, TModelID aModelID);

Description

Plays the previously trained utterance.

Parameters

TModelBankID aModelBankID

The model bank ID.

TModelID aModelID

The model ID, whose utterance is played.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


Recognize()

IMPORT_C TInt Recognize(CSDClientResultSet &aResultSet);

Description

Initiates recognition; performed following loading of model bank, lexicon, and grammar.

Parameters

CSDClientResultSet &aResultSet

A reference where the recognition result is set.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


Record()

IMPORT_C TInt Record(TTimeIntervalMicroSeconds32 aRecordTime);

Description

Records the user utterance for training and recognition.

Parameters

TTimeIntervalMicroSeconds32 aRecordTime

The recording time in microseconds.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemoveGrammar()

IMPORT_C TInt RemoveGrammar(TGrammarID aGrammarID);

Description

Removes the specified grammar from the permanent storage.

Removing a grammar will remove all rules within the grammar.

Parameters

TGrammarID aGrammarID

The grammar ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemoveLexicon()

IMPORT_C TInt RemoveLexicon(TLexiconID aLexiconID);

Description

Removes the specified lexicon from the permanent storage.

Removing a lexicon will remove all pronunciations within the lexicon.

Parameters

TLexiconID aLexiconID

The lexicon ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemoveModelBank()

IMPORT_C TInt RemoveModelBank(TModelBankID aModelBankID);

Description

Removes the specified model bank from the permanent storage.

Removing a model bank will remove all models within the model bank.

Parameters

TModelBankID aModelBankID

The model bank ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemoveModel()

IMPORT_C TInt RemoveModel(TModelBankID aModelBankID, TModelID aModelID);

Description

Removes the specified model from the specified model bank permanently.

Parameters

TModelBankID aModelBankID

The model bank ID.

TModelID aModelID

The model ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemovePronunciation()

IMPORT_C TInt RemovePronunciation(TLexiconID aLexiconID, TPronunciationID aPronunciationID);

Description

Removes the specified pronunciation from the specified lexicon permanently.

Parameters

TLexiconID aLexiconID

The lexicon ID.

TPronunciationID aPronunciationID

The pronunciation ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


RemoveRule()

IMPORT_C TInt RemoveRule(TGrammarID aGrammarID, TRuleID aRuleID);

Description

Removes the specified rule from the specified grammar permanently.

Parameters

TGrammarID aGrammarID

The grammar ID.

TRuleID aRuleID

The rule ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


SetClientUid()

IMPORT_C TInt SetClientUid(TUid aClientUid);

Description

Sets the client UID for client.

Parameters

TUid aClientUid

The client UID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


StartRecSession()

IMPORT_C TInt StartRecSession(TRecognitionMode aMode);

Description

Starts a new recognition session.

Parameters

TRecognitionMode aMode

The recognition mode.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


Train()

IMPORT_C TInt Train(TModelBankID aModelBankID, TModelID &aModelID);

Description

Trains a new model into the specified model bank.

Parameters

TModelBankID aModelBankID

The model bank ID.

TModelID &aModelID

The reference to where a new model ID is assigned.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


UnloadRule()

IMPORT_C TInt UnloadRule(TGrammarID aGrammarID, TRuleID aRuleID);

Description

Unloads the specified rule from the specified grammar in temporary memory, previously loaded with LoadGrammarL(). The rule in the permanent storage remains intact.

Parameters

TGrammarID aGrammarID

The grammar ID.

TRuleID aRuleID

The rule ID.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


LoadEngineParameters()

IMPORT_C TInt LoadEngineParameters(const RArray< TInt > &aParameterId, const RArray< TInt > &aParameterValue);

Description

Uploads the specified parameters into the engine.

Parameters

const RArray< TInt > &aParameterId

An array of parameter IDs.

const RArray< TInt > &aParameterValue

An array of parameter values.

Return value

TInt

An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.


GetPronunciationIDArrayL()

IMPORT_C void GetPronunciationIDArrayL(RArray< TPronunciationID > &aPronunciationIDs);

Description

Gets an array of pronunciation IDs previously requested by GetAllPronunciationIDs.

Parameters

RArray< TPronunciationID > &aPronunciationIDs

An array to store pronunciation IDs.


GetRuleIDArrayL()

IMPORT_C void GetRuleIDArrayL(RArray< TRuleID > &aRuleIDs);

Description

Gets an array of rule IDs previously requested by GetAllRuleIDs.

Parameters

RArray< TRuleID > &aRuleIDs

An array to store rule IDs.


GetModelIDArrayL()

IMPORT_C void GetModelIDArrayL(RArray< TModelID > &aModelIDs);

Description

Gets an array of model IDs previously requested by GetAllModelIDs.

Parameters

RArray< TModelID > &aModelIDs

An array to store model IDs.


GetGrammarIDArrayL()

IMPORT_C void GetGrammarIDArrayL(RArray< TGrammarID > &aGrammarIDs);

Description

Gets an array of grammar IDs previously requested by GetAllGrammarIDs.

Parameters

RArray< TGrammarID > &aGrammarIDs

An array to store grammar IDs.


GetLexiconIDArrayL()

IMPORT_C void GetLexiconIDArrayL(RArray< TLexiconID > &aLexiconIDs);

Description

Gets an array of lexicon IDs previously requested by GetAllLexiconIDs.

Parameters

RArray< TLexiconID > &aLexiconIDs

An array to store lexicon IDs.


GetModelBankIDArrayL()

IMPORT_C void GetModelBankIDArrayL(RArray< TModelBankID > &aModelBankIDs);

Description

Gets an array of modelBank IDs previously requested by GetAllModelBankIDs.

Parameters

RArray< TModelBankID > &aModelBankIDs

An array to store modelBank IDs.


GetResultSetL()

IMPORT_C void GetResultSetL(CSDClientResultSet &aResultSet);

Description

Gets a client result set previously created by a call to Recognise().

Parameters

CSDClientResultSet &aResultSet

The ResultSet used to contain the recognition results